.NET Framework
.NET Framework 4.6.1 (or higher) shall be installed. This might come with the operating system or the setup of the development environment. See Development environment section if this is the case.
Development environment
A development environment that supports development of .NET Framework 4.6.1 (or higher) DLLs is required. An example of such a development environment is Microsoft Visual Studio (2017 or higher).
For developing cross platform solutions or solutions for Linux or MacOS (.NET Core, .NET standard) it is highly recommended to use the newest version of Microsoft Visual Studio 2017. For development of .NET Core applications use the .NET Core SDK.
Further information about Microsoft Visual Studio versions and its prerequisites can be found here.
Visual Studio 2013/2015
Falcon SDK version 5.6.6 is the last one supporting Visual Studio 2013 and 2015. Because of restrictions in Visual Studio 2013 and 2015, it is not possible to use the .NET Standard versions of the Falcon assemblies; therefore versions for .NET Framework 4.6.1 are provided additionally (see below).
.NET Core SDK CLI
In this case, the "dotnet build" command of the .NET Core SDK can be used in order to compile applications.
Falcon .NET SDK
The Falcon .NET SDK version 5.6.724.33934 shall be installed, i.e. a number of DLLs will be installed. In a Microsoft Visual Studio project at least the following DLLs shall be referenced:
- Knx.Bus.Common
- Knx.Bus.Cryptography
- Knx.Falcon.Sdk
The following files and assemblies shall to be present in the build output directory:
- The USB interface description file knx_interfaces.xml and the KNX master data file knx_master.xml. This ensures that KNX USB interfaces and KNX master data will be available for Falcon in case ETS is not installed. If these files are present in both folders, i.e. C:\ProgramData\KNX\Falcon and C:\ProgramData\KNX\Falcon\XML\project-14 then Falcon will compare the file versions and use the one with the higher version. In contrast to ETS, Falcon does not update the master data.
- All remaining DLLs/assemblies of the SDK directory.
For development environments like Visual Studio 2013 and 2015, which do not fully support .NET Standard, versions of the Falcon assemblies referencing .NET Framework 4.6.1 instead of .NET Standard 2.0, are provided in the sub-folder net461. Future Falcon SDK versions will only provide the .NET Standard versions.