全部产品
Search
文档中心

阿里云物联网平台:Linux开发环境集成SDK

更新时间:Oct 12, 2023

在实际开发项目过程中,如果已有自己的开发工程,可以将Link SDK添加到现有开发工程中进行编译。本文通过示例为您讲解如何将Link SDK添加到一个已有工程中并进行编译。

示例说明

本示例包含一个打印Hello World!的测试程序hello.c,并有一个编译该测试程序的makefile。具体代码内容如下(附hello代码片段):

#include <stdio.h>
#include <stdlib.h>

int main(int argc, char **argv)
{
        printf("Hello World!\n\r");
        return(0);
}

makefile的编码内容如下:

PROG_FILE := hello.c mqtt_basic_demo.c
PROG_OBJS := $(patsubst %.c,%.o,$(PROG_FILE))
PROG = hello

SDK_ROOT = $(shell pwd)/LinkSDK
SDK_INC = -I$(SDK_ROOT)/output/include/
SDK_LIB = $(SDK_ROOT)/output/lib/libaiot.a -lpthread

all:prepare $(PROG_OBJS)
	$(CC) $(CFLAGS) -o $(PROG) $(PROG_OBJS) $(SDK_INC) $(SDK_LIB)

prepare:
	make -C $(SDK_ROOT)

./%.o: %.c
	$(CC) -o $@ -c $< $(CFLAGS) $(SDK_INC) 

clean:
	make -C LinkSDK clean
	rm -f *.o $(PROG) $(SDK_OBJS)

SDK移植步骤

  1. 获取SDK。

    • 设备OS选择Linux

    • 连接物联网平台协议选择MQTT

    • 数据加密选择TLS-CA

    • 设备认证方案选择设备密钥

    不选择任何高级能力,单击按钮开始生成下载SDK。

  2. SDK移植步骤。

    SDK下载之后,将压缩文件解压,并将Link SDK目录复制到hello.c所在目录,如下内容所示:

    $ ls -l
    
    -rwxrwxrwx 1 root root   183  5月 11 19:45 hello.c
    drwxrwxrwx 1 root root  4096  5月 11 17:28 LinkSDK
    -rwxrwxrwx 1 root root   672  5月 11 19:49 makefile
                            
  3. 复制MQTT示例并进行修改。

    LinkSDK/demos/mqtt_basic_demo.c复制到hello.c所在目录,并将mqtt_basic_demo.c文件中的main函数修改为sdk_test,修改后的代码如内容所示:

    /* TODO: 替换为自己设备的设备证书*/
    char *product_key       = "${YourProductKey}";
    char *device_name       = "${YourDeviceName}";
    char *device_secret     = "${YourDeviceSecret}";
    
    /*
        TODO: 替换为自己实例的接入点
    */
    char  *mqtt_host = "${YourInstanceId}.mqtt.iothub.aliyuncs.com";
    
    
    int sdk_test(int argc, char *argv[])
    {
        int32_t     res = STATE_SUCCESS;
        void       *mqtt_handle = NULL;
        char       *url = "iot-as-mqtt.cn-shanghai.aliyuncs.com"; /* 阿里云平台华东2(上海)的域名后缀 */
    
    ...
    }             
  4. 修改makefile包含SDK。

    修改makefile去编译SDK的源代码,以及复制出来的文件mqtt_basic_demo.c(附sdk_test代码片段):

    PROG_FILE := hello.c mqtt_basic_demo.c
    PROG_OBJS := $(patsubst %.c,%.o,$(PROG_FILE))
    PROG = hello
    
    SDK_ROOT = $(shell pwd)/LinkSDK
    SDK_DIR = $(SDK_ROOT)/core $(SDK_ROOT)/core/sysdep $(SDK_ROOT)/core/utils  $(SDK_ROOT)/portfiles/aiot_port $(SDK_ROOT)/external  $(SDK_ROOT)/external/mbedtls/library
    SDK_INC = -I$(SDK_ROOT)/external/mbedtls/include  $(foreach dir, $(SDK_DIR), -I$(dir) )
    SDK_FILES = $(foreach dir, $(SDK_DIR), $(wildcard $(dir)/*.c))
    SDK_OBJS = $(patsubst %.c,%.o,$(SDK_FILES))
    SDK_LIBS = -lpthread
    
    CFLAGS += $(SDK_INC)
    
    main:$(PROG_OBJS) $(SDK_OBJS)
        $(CC) $(CFLAGS) -o $(PROG) $(PROG_OBJS) $(SDK_OBJS) $(SDK_LIBS)
    
    clean:
        rm -f *.o $(PROG) $(SDK_OBJS)

    上面的改动中需要注意的是:

    • SDK_DIR需要包含SDK中设备用到的功能目录,如果您选择了高级功能,那么在LinkSDK/components目录下将会出现相应的目录,那么需要将相关目录也加入到SDK_DIR中。

    • 因为本例中选择使用TLS对数据进行加密,所以编译的时候也编译了SDK中附带的mbedtls,并在SDK_INC中指定了对external/mbedtls/include目录的包含。

    • 因为编译后的程序在Linux平台上运行,会使用到线程相关的库,所以在SDK_LIBS里面指定了对pthread库的链接。

  5. 修改hello.c调用SDK。

    修改hello.c调用文件mqtt_basic_demo.c中的函数sdk_test,初始化SDK并连接阿里云物联网平台:

    #include <stdio.h>
    #include <stdlib.h>
    
    /*声明sdk_test函数*/
    extern int sdk_test(int argc, char *argv[]);
    
    int main(int argc, char **argv)
    {
            printf("Hello World!\n\r");
            /*调用SDK Demo中的sdk_test函数,去初始化SDK并连接阿里云物联网平台*/
            sdk_test(0,NULL);
            return(0);
    }
                            
  6. 编译:make。运行:./hello

    在hello.c所在目录运行make命令进行编译,然后运行生成的hello程序,如果一切顺利将输出类似如下内容:

    Hello World!
    [1687781092.755][LK-0313] MQTT user calls aiot_mqtt_connect api, connect
    [1687781092.755][LK-032A] mqtt host: iot-****.mqtt.iothub.aliyuncs.com
    [1687781092.755][LK-0317] user name: demo******
    establish tcp connection with server(host='iot-******.mqtt.iothub.aliyuncs.com', port=[443])
    success to establish tcp, fd=3
    local port: 52008
    [1687781092.811][LK-1000] establish mbedtls connection with server(host='iot-****.mqtt.iothub.aliyuncs.com', port=[443])
    [1687781092.844][LK-1000] success to establish mbedtls connection, (cost 45338 bytes in total, max used 48306 bytes)
    [1687781092.899][LK-0313] MQTT connect success in 137 ms
    AIOT_MQTTEVT_CONNECT
    heartbeat response