Azure IoT Gateway SDK Beta

Breaking Changes

• Remove LL from gateway function names.
• Change the MODULE_APIS struct to MODULE_API, with a new layout.
• Change the signature of Module_GetAPIS to const MODULE_API* Module_GetApi(const MODULE_API_VERSION gateway_api_version).
• Change JSON config and the GATEWAY_MODULES_ENTRY struct to support loading modules that are not DLLs/SOs.
• Add a function pointer for Module_CreateFromJson to MODULE_API, and remove from the codebase all HL modules that previously implemented that functionality.
• Rename the function Gateway_Create_From_JSON to Gateway_CreateFromJson.
• Remove UWP adaptation of the gateway SDK.

New Features

• Add a version field to the MODULE_API struct so the gateway will (1) be backward-compatible with old modules, and (2) load backward-compatible modules.

• Allow gateway apps to choose how they load modules by specifying a "loader". The default loader loads modules as DLLs. Gateway_CreateFromJson uses the default loader.

• Add a script to automate version bumps.

• Enable CMake's find_package for the gateway SDK. To use the gateway SDK in your project:

  In your clone of the SDK repo:

  mkdir build && cd build
  cmake ..
  cmake --build .
  cmake --build . --target install # may require elevated privileges
  

  In your project's CMakeLists.txt:

  find_package(azure_iot_gateway_sdk REQUIRED CONFIG)
  target_link_libraries(your_lib gateway_install)
  

Doc Updates

• Add missing headers to C API reference.
• Add Node.js API reference.
• Add how-to document for Node.js modules in the gateway.

Changes/Bug Fixes

• #43 Fix image link in sample_ble.md (@formulahendry).
• Fix Node.js tests and sample in so they can find node.dll on Windows.
• Enable 64-bit Java in Windows build script.
• Move events-related functions out of the public API.
• Rename callbacks_sample to events_sample and move it to the experimental/ subfolder.
• Fix issues reported by valgrind in: gateway, gateway_ut, azure_functions, ble.
• Fix memory leaks in ble, azure_functions_ut, event_system_ut.
• Fix script that updates the gh-pages branch.
• In the hello_world module, don't join a non-existent thread.
• Change building BLE module to be optional, enabled by default

Azure IoT Gateway SDK Beta

Azure IoT Gateway SDK Beta

New Features:

• BREAKING CHANGE - Changed signature from MODULE_APIS* apis Module_GetAPIS() to void Module_GetAPIS(MODULE_APIS* apis)
• Added one more Module Api (Start) to inform modules when Gateway is ready to send/receive messages
• The AddLink/RemoveLink functions now report GATEWAY_MODULE_LIST_CHANGED event
• Gateway_LL_Start reports a GATEWAY_STARTED event
• Added user context to Gateway callbacks
• Add --toolchain-file parameter to build.sh for cross-compiling
• Provide Dockerfile for easier repeatable linux tests
• Add an Azure Functions Module

Bug Fixes:

• configuration_json can be NULL
• Add tests to add the same node.js module twice
• Gateway builds with GCC 4.4
• Hello World Sample releases Lock

Azure IoT Gateway SDK Beta

Azure IoT Gateway SDK Beta

New Features:

• IotHub Module can now use HTTP, AMQP, or MQTT transports
• Java binding supports architectures other than amd64
• Replaced the broadcast message bus with generic Broker interface
• Implemented a message routing system that supports targeted message delivery
• Ability to specify links in gateway configuration (both in code and in JSON configuration)
• Created an EventSystem (Experimental)

Bug Fixes:

• All samples now work out of the box on linux
• .NET binding supports UTF-8 strings in configurations

Azure IoT Gateway SDK Beta

Azure IoT Gateway SDK beta

• Documentation including:
  • Contribution Guidelines
  • Getting Started guide
  • Development environment setup guide
  • Step-by-step instructions for each of the samples
• Samples:
  • Hello World
  • Simulated Device Cloud Upload
  • BLE
• Core features:
  • Broadcast message bus
  • Gateway
  • Message
  • Unit tests, end-to-end tests

Changes since first release

• Bindings for modules in the following languages:
  • .Net
  • Node.js
  • Java
• Code of Conduct in README file
• Cross-compilation build script for Intel Edison
• New functions to serialize messages to/from byte arrays