SmartThings SDK for Direct Connected Devices for C
The SmartThings SDK for Direct Connected Devices for C is the IoT core device library that allow device applications to securely connect to the SmartThings Cloud. To facilitate the development of device application in your original chipset SDK that installed before, we provide this core device library as a separate repository. You may simply link it to develop a device application in your existing development environment.
We also provide examples so that so that you can refer to how this core device library can be linked in existing original chipset SDKs and device applications can be developed.
It is distributed in source form and written in C99 for the purpose of portability to most platforms.
This core device library provides the following features :
This core device library includes platform-dependent parts that should be built in a specific toolchain or SDK. That is, if you do NOT use the pre-porting environment, you must first port them to the appropriate environment.
After porting, you can use this library completely under the specific environment. For more information on detailed workflow below, please refer to the Getting Started. Maybe, we think it's more helpful to you
This core device library has platform-dependent directories. In current SDK version, those that must be ported are present in src/port/bsp
, src/port/net
and src/port/os
.
By default, we have already provided several implementations based on some operating systems(e.g. FreeRTOS, LINUX) and chipsets(e.g. ESPRESSIF, REALTEK, Raspberry Pi). These porting examples in those directories make it easier for you to port to additional chipsets and operating systems.
For instructions on how to port this SDK, please see the Porting Guide.
This core device library should be built according to the chipset development environment to be applied. If this environment is not ready yet, you can build it in the POSIX environment based on Ubuntu as shown below.
But, unlike the resource limited MCU devices, you can NOT check the onboarding process in the POSIX environment because it does not support a SoftAP function by default. Therefore, as a starting point of this SDK, we strongly recommend that you build one of the MCU device examples provided in example
directory to use all features without limitations.
Basically, you can build this core device library through cmake
in the Ubuntu.
sudo apt-get install libssl-dev libpthread-stubs0-dev
Clone the source code.
Download the source code via git clone
.
$ git clone https://github.com/SmartThingsCommunity/st-device-sdk-c.git
Build a POSIX example application.
Go to a example directory and then build.
$ cd st-device-sdk-c/example/posix
$ cmake -B build
$ cd build
$ make
We are managing two git branch categories. One is develop
branch. The other is release/v{version}
branchs. In devleop
branch, we are merging latest developing features actively. In release/v{version}
branchs, we branch out from devleop
branch and keep them stable updating bugfix and small amendment. If you want to use latest SDK features for test or POC, we recommand devleop
branch as base. Or if you want to apply the SDK in real product and consider commercializing, we recommand release/v{version}
branchs as base.
develop
branch : Latest devleoping features. Recommand for new feature test or POC.release/v{version}
branchs : Tested and stable branchs. Recommand for Commercial product.For more information, please review the following documents:
If you have any issue, or want to commercialize your IoT devices using this SDK, please contact [email protected] or open new issue.
This library is licensed under the Apache License Ver2.0.