在实际开发项目过程中,如果已有自己的开发工程,可以将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移植步骤
获取SDK。
设备OS选择Linux。
连接物联网平台协议选择MQTT。
数据加密选择TLS-CA。
设备认证方案选择设备密钥。
不选择任何高级能力,单击按钮开始生成下载SDK。
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
复制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(上海)的域名后缀 */ ... }
修改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库的链接。
修改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); }
编译:
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