Changelog
Follow up on the latest improvements and updates.
RSS
Highlights:
- Zephyr port updated to Zephyr v3.7
- NCS port updated to NCS v2.7
- ESP-IDF port updated to ESP-IDF v5.3
Added:
- native_simplatform support in Zephyr's twister execution offw_updateexample
Changed:
- Use VERSIONfile to specify application version infw_updateexample
- Better error message on manifest decode error
- Updated libcoap version to v4.3.4a
- Merged GOLIOTH_SAMPLE_{,PSK_}SETTINGSKconfig settings
- Added extern "C"in headers for improved C++ compatibility
Fixed:
- CoAP keepalive behavior with Zephyr
- Memory leak by freeing post_block memory in purge_request_mbox()
- Disabled FreeRTOS logging backend on client disconnect
- Stop client during client destroy in golioth_client_destroy()
Known Issues:
- [Zephyr only] Espressif devices have a regression in Zephyr 3.7 that frequently causes crashes during flash operations. We recommend remaining on Zephyr 3.6 and Golioth Firmware SDK [0.14.0] until the issue is is resolved. For more information see https://github.com/zephyrproject-rtos/zephyr/issues/77952
- [Zephyr only] Boards utilizing the ESP AT WiFi driver, such as the nRF52840 DK + ESP32, frequently fail to complete DTLS handshakes when using certificate authentication due to an issue with DTLS fragment handling when operating in passive mode, which is required for DNS resolution in Zephyr 3.7. For more information see https://github.com/zephyrproject-rtos/zephyr/issues/77993
Workarounds:
- The MIMXRT1024-EVK received a new upstream Ethernet driver that was found to have sporadic "Link Down/Up" events that cause a loss of connectivity when downloading binaries during OTA Firmware Update. All Zephyr examples in this release include an overlay file for this board that reverts to the old driver.
Highlights:
- Added blockwise uploads for streaming data to Pipelines
- Improved efficiency of blockwise operations
- Reduced log verbosity
Added:
- A new golioth_stream_set_blockwise_sync()API for uploading larger payloads to Pipelines. This is useful when the size of your payload exceeds the MTU of your underlying transport (typically 1024 bytes).
- native_sim Zephyr target is now tested in CI
Changed:
- CoAP retransmissions are no longer reported individually. Instead, a count of the number of retransmissions in the last 10 seconds is reported. This reduces the chattiness of CoAP client logs.
- Blockwise transfers make more efficient use of semaphores and allocations, reducing CPU overhead, overall memory usage, and heap fragmentation.
- Blockwise upload user callbacks are now passed the size of the block, and should no longer rely on a hardcoded block size.
- Reduced log levels of some messages from INFO to DEBUG.
Fixed:
- Gracefully handle allocation errors during synchronous operations.
- Honor content-type in blockwise uploads
- Small typo in Kconfig help
Removed
- Removed BLE provisioning service from Golioth ESP-IDF examples. Users are free to copy this utility into their own repos and use it if they desire. This code is offered as-is and without warranty.
Fixed:
- Infinite loop in OTA manifest observation retry logic that occurred when retries were exhausted.
- Documentation: update links to Stream service
Changed
- Registering an OTA manifest observation will be retried until successful, with a delay that doubles after each unsuccessful attempt. Use CONFIG_GOLIOTH_FW_OBSERVATION_RETRY_MAX_DELAY_MS to configure the maximum delay (defaults to 5 minutes).
Removed:
- Removed automatic ESP-IDF logging - this will be reintroduced in a future
release with more configuration options.
Added:
- Improved "client not running" error logs with additional context
Fixed:
- Zephyr: Fix crash when repeatedly stopping and starting the client
- Zephyr: Fix up to 10 second delay when stopping client
- Zephyr: Fixed hang when attemtping to stop an already stopped client
- Fixed dropped function call when assert()is disabled
- Return error instead of crashing on NULL input
Added:
- ESP-IDF: added ability to send native logging system messages to the Golioth remote logging service.
Changed:
- OTA firmware update observation will retry multiple times when failing to register.
- Status added to the CoAP request struct for passing error codes.
Fixed:
- Zephyr: correctly handle the client connection stop command.
- Zephyr: reestablish observations after reconnect.
Breaking Changes:
- Previously, it was possible to implicitly include default Kconfig settings from the Zephyr examples into client applications. This was unintentional and has been fixed. As a result, if your application was relying on those defaults, you'll now need to set those Kconfig values explicitly in your application.
Added:
- Zephyr: Add socket hello_nrf91_offload example to demonstrate DTLS sockets offload
- Zephyr: add rak5010_nrf52840 support to all examples
- ESP-IDF: add fw_update example to demonstrate OTA firmware update
- ESP-IDF: add settings example to demonstrate device settings service
Changed:
- Zephyr: example code now explicitly sources Kconfig.defconfig file to select necessary Kconfig symbols from the example common files
- Zephyr: update runtime settings in examples to take effect without needing a reboot
- Update libcoap version to v4.3.4a
Fixed:
- Documentation updates
- Certificate Provisioning: Increase nRF52840 network buffers to avoid failing handshake
Known Issues:
- Default Kconfig values may not propagate correctly if the Golioth SDK
is not listed first in the West manifest. To workaround this, ensure
that Golioth is listed first in your application's manifest.
Added:
- CONFIG_GOLIOTH_RPC_MAX_RESPONSE_LEN to control the size of the buffer
used to hold the RPC response
Changed:
- Improved how the Golioth Zephyr log backend handles network disconnects
to avoid interfering with the application's control of logging levels
- Removed default dependency on floating point support
Fixed:
- Enable log shell commands in Zephyr Certificate Provisioning example
- Build error when compiling with NCS and without newlib
- Correctly handle TOO_MANY_REQUESTS responses from the server in NCS
Highlights
- Zephyr port updated to Zephyr v3.6
- NCS port updated to NCS v2.5.2
- ESP-IDF port updated to ESP-IDF v5.2.1
- New examples for ESP-IDF
- Initial support for native_simtarget in Zephyr
Breaking Changes
Added:
- New examples for ESP-IDF: hello,rpc,lightdb state
- Additional hardware-in-the-loop integration tests
- west patchcommand for applying git patches
- native_simsupport (requires patches on top of Zephyr v3.6)
- nRF91 LTE monitor log level is now configurable
- Zephyr console now returns an error when attempting to store a PSK-ID or PSK that is too long
Changed:
- Improved NACK handling during initial connection
- OTA module now decodes all items in a manifest
- RPC returns NOT_FOUNDinstead ofUNKNOWNwhen receiving an RPC
for an unregistered method
- Improved and clarified documentation
- Improved and stablized HIL test infrastructure
- Documentation updated to reflect change from Device Name to Certificate ID in device certificates
Removed:
- Individual type functions for Stream service
- Zephyr port no longer depends on CONFIG_POSIX_API
Fixed:
- Fixed range checking for int type settings
- Fixed incorrect error code for receiving an unknown setting
- Fixed crash when disabling Zephyr log backend
- Fixed buffer allocation failures on nRF52840DK
- Fixed free()of unallocated buffer
- Zephyr CoAP client was not notifying port layer of disconnections
- Some kconfig settings had no effect in the ESP-IDF port
- Some kconfig options could not be overriden in the Zephyr port
Highlights
- The Zephyr CoAP library is now used instead of libcoap for Zephyr ports
- Zephyr ports can specify a TLS credential tag to use for authentication, in particular this will enable the use of offloaded DTLS sockets.
Breaking Changes
- Remove golioth_prefix from filenames and move header files undergolioth/folder.
- Remove golioth.hheader - users must now include individual headers for each service that they use.
- Stream and State: change jsonandcborobject set calls to specify type in the parameters (instead of separate function calls).
- RPC: This service must now be initialized prior to use by calling golioth_rpc_init(client);
- Settings: This service must now be initialzied prior to use by calling golioth_settings_init(client);
- Services (e.g. stream, fw_update, etc.) are disabled by default - be sure to enable them in your project configuration.
- Typedefs have been removed throughout the codebase - instead use the underlying struct or enum types
- Remove lightdb_fromlightdb_streamfunctions to differentiate from LIghtDB State
Added:
- Automated Hardware-in-the-Loop test framework
- Basic cross-platform connection HIL test
- Tests for all Zephyr examples
- Add kconfig option for default log level for SDK logs
- Lightb State examples now show how to use CBOR
Changed:
- Improved network connection management
- Wait for network traffic and request queue concurrently - this removes the need to wakeup every 1 second to check for requests
- Pass structs by reference instead of value in golioth_sys_* APIs
- Use bool instead of int for binary Kconfig options
- Improved organization of Kconfig options
- ESP-IDF examples use FreeRTOS APIs directly instead of Golioth abstractions
- LightDB State and Stream are now separate services in the SDK
- DFU example has been renamed to fw_update
- Use golioth_content_type enum instead of libcoap content types
Removed:
- Magtag demo for ESP-IDF - this hardware is out of stock
- Golioth time module - this was a thin wrapper around golioth_sys
- golioth_statistics module - this internal memory tracking module is being replaced by out-of-source tooling
- remote_shell - This was an experimental feature that was never released. If you are interested in remote shell functionality in the future, please reach out to Golioth!
- Integration guide - see docs.golioth.io for the latest documentation on integration Golioth into your product
Fixed:
- Various documentation fixes
- Removed double check for CONFIG_GOLIOTH_SAMPLE_COMMON
- Fix stack overflow in logging thread
- Drop logs with unsupported log levels
- Attempting to use a disabled service now fails at build time instead of at run time
new
improved
Web Console
New in Web Console v1.25.4
Feature 📦: New authentication service domain (
auth.golioth.io
).Feature 📦: All projects now associated with an organization.
Improvement ✨: Navigation breadcrumbs now always show current organization and project.
Improvement ✨: Switching projects now takes you directly to the new project devices page.
Improvement ✨: Switching organization now takes you directly to the first project devices page.
Improvement ✨: User account page now shown in dedicated view without sidebar.
Load More
→