To compile the SDK, you need to install a set of tools depending on the platform you are doing your development on and the one you are targeting. You will also need to clone the current repository.
How to set up the development environment for the C SDK on Ubuntu is described as follows:
-
Make sure all dependencies are installed before building the SDK. For Ubuntu, you can use
apt-getto install the required packages:sudo apt-get update sudo apt-get install -y build-essential make git gcc
-
Clone the latest release of SDK to your local machine:
git clone https://github.com/EnvisionIot/enos-device-sdk-c.git
Use the following commands to build the SDK:
cd enos-device-sdk-c
make menuconfig # customize needed features by kconf
make reconfig # select configuration for Ubuntu
makeThere are many feature configuration options available for building the SDK. For example, you can activate the dynamic activation feature by enabling it in menuconfig.
You can also select other pre-built environments with the following command:
make reconfig
SELECT A CONFIGURATION:
1) config.macos.x86
2) config.ubuntu.x86
3) config.windows.x86
#?For the list of features supported by this SDK and the availability of EnOS device connectivity and management features in all SDKs we provide, see EnOS Device SDK.
-
Connect to EnOS Cloud via an MQTT connection
/* ProductKey, DeviceKey and DeviceSecrect can be obtained in Device Details page in EnOS Console */
char g_product_key[IOTX_PRODUCT_KEY_LEN + 1] = "PRODUCT_KEY";
char g_device_key[IOTX_DEVICE_KEY_LEN + 1] = "DEVICE_KEY";
char g_device_secret[IOTX_DEVICE_SECRET_LEN + 1] = "DEVICE_SECRET";
iotx_enos_dev_meta_info_t master_meta_info;
memset(&g_user_example_ctx, 0, sizeof(user_example_ctx_t));
memset(&master_meta_info, 0, sizeof(iotx_enos_dev_meta_info_t));
memcpy(master_meta_info.product_key, g_product_key, strlen(g_product_key));
memcpy(master_meta_info.device_key, g_device_key, strlen(g_device_key));
memcpy(master_meta_info.device_secret, g_device_secret, strlen(g_device_secret));
/* BROKER_URL is the URL of EnOS MQTT Broker for Devices, which can be obtained in Environment Information page in EnOS Console */
char mqtt_uri[50] = "BROKER_URL";
IOT_Ioctl(IOTX_IOCTL_SET_MQTT_DOMAIN, (void *)mqtt_uri);
int mqtt_port = 11883;
IOT_Ioctl(IOTX_IOCTL_SET_MQTT_PORT, (void *)&mqtt_port);
do {
g_user_example_ctx.master_devid = IOT_EnOS_Open(IOTX_ENOS_DEV_TYPE_MASTER, &master_meta_info);
if (g_user_example_ctx.master_devid >= 0)
{
break;
}
EXAMPLE_TRACE("IOT_EnOS_Open failed! retry after %d ms\n", 2000);
HAL_SleepMs(2000);
} while (1);
do {
res = IOT_EnOS_Connect(g_user_example_ctx.master_devid);
if (res >= 0)
{
break;
}
EXAMPLE_TRACE("IOT_EnOS_Connect failed! retry after %d ms\n", 5000); HAL_SleepMs(5000);
} while (1);-
Report measurement points
void user_sample_post_measurepoint(void)
{
static int cnt = 0;
int res = 0;
char measurepoint_payload[50] = {0};
/* MeasurePoint1 is a measurepoint defined in ThingModel. */
HAL_Snprintf(measurepoint_payload, sizeof(measurepoint_payload), "{\"measurepoints\":{\"MeasurePoint1\":%d}}", cnt++);
res = IOT_EnOS_Report(EXAMPLE_MASTER_DEVID, ITM_MSG_POST_MEASUREPOINT, (unsigned char *)measurepoint_payload, strlen(measurepoint_payload));
EXAMPLE_TRACE("Post Measurepoint Message ID: %d, payload: %s", res, measurepoint_payload);
}
while (1)
{
IOT_EnOS_Yield(EXAMPLE_YIELD_TIMEOUT_MS);
user_sample_post_measurepoint();
cnt++;
if (auto_quit == 1 && cnt > 3600)
{
break;
}
}-
Close the MQTT connection
IOT_EnOS_Close(g_user_example_ctx.master_devid);-
To learn more about EnOS IoT Hub, see EnOS IoT Hub Documentation.
-
To learn more about how to develop your device for EnOS IoT Hub, see EnOS Device Development Guide (C).