Golioth Firmware SDK
|
A software development kit for connecting embedded devices to the Golioth IoT cloud.
This SDK can be used on any preemptive operating system that provides an Internet stack. Golioth maintains ports for the following platforms:
More information on these ports can be found in their respective READMEs at examples/<platform>/README.md
The SDK can be ported to additional platforms by following the Porting Guide in the docs
folder.
SDK source: https://github.com/golioth/golioth-firmware-sdk
Documentation: https://docs.golioth.io/firmware/golioth-firmware-sdk
API documentation: https://firmware-sdk-docs.golioth.io/
This repo uses git submodules, so you will need to clone with the --recursive
option:
Or, if you've already cloned but forgot the --recursive
, you can update and initialize submodules with this command:
:warning: Note: Zephyr-based projects should use the West tool to clone the repo. See the
Zephyr Quick Start Guide at examples/zephyr/README.md
.
The examples
directory contains example apps which you can build and run. It is organized by platform (e.g. ESP-IDF, ModusToolbox, etc), so navigate to a specific platform directory and check out the README for further instructions to build and run the examples.
The golioth_basics
example (examples/<platform>/golioth_basics
) is recommended as a starting point, to learn how to connect to Golioth and use services like LightDB State, Stream, Logging, and OTA.
The docs
folder contains additional documentation, such as a platform integration guide and a platform porting guide.
The following table lists the different hardware configurations against which we test the SDK. Each of these devices is verified on each commit by our Continuous Integration system.
The tests fall into three categories. Hardware-in-the-Loop (HIL) integration tests are located in tests/hil
. Unit tests are in tests/unit_tests
. Finally, each of the samples is also continously verified on target.
Board | Platform |
---|---|
ESP32-S3-DevKitC-1 | ESP-IDF (v5.3.0) |
ESP32-C3-DevKitM-1 | ESP-IDF (v5.3.0) |
ESP32-DevKitC-WROVER | ESP-IDF (v5.3.0) |
ESP32-DevKitC-WROVER | Zephyr (v3.7.0) |
nRF52840 DK + ESP32 | Zephyr (v3.7.0) |
MIMXRT1024-EVK | Zephyr (v3.7.0) |
RAK5010 | Zephyr (v3.7.0) |
nRF9160 DK | nRF Connect SDK (v2.7.0) |
CY8CPROTO-062-4343W | ModusToolbox (3.0.0) |