Link SDK es un kit de desarrollo de software para el lado del dispositivo proporcionado por IoT Platform. Este SDK simplifica el proceso de desarrollo y permite que los dispositivos se conecten a IoT Platform. Una vez que los fabricantes obtienen el SDK, pueden portar el código según sus requisitos de negocio. De este modo, integran Link SDK en sus dispositivos y los conectan a IoT Platform.
Requisitos previos
Antes de desarrollar con el SDK, debe completar las operaciones necesarias en la consola de IoT Platform para obtener la información requerida sobre dispositivos y topics. Para más información, consulte Device connection guide.
Contexto
Una gran cantidad de dispositivos heterogéneos puede conectarse a IoT Platform. Esta plataforma proporciona Link SDK para el desarrollo en el lado del dispositivo, así como el protocolo estándar Alink.
Para más información sobre cómo usar el protocolo Alink, consulte Configure devices based on the Alink protocol.
Se recomienda utilizar Link SDK para desarrollar rápidamente y conectar dispositivos a IoT Platform. La siguiente figura describe el proceso de uso de Link SDK para desarrollar un dispositivo.
Para más información sobre términos relacionados, consulte Terms.
Integrar Link SDK
El método para integrar Link SDK varía según el tipo de dispositivo:
Dispositivos IP: dispositivos compatibles con el protocolo TCP/IP, como los dispositivos Wi-Fi. Este tipo de dispositivos puede integrarse directamente con Link SDK.
Dispositivos sin IP: son aquellos que no admiten el protocolo TCP/IP, como dispositivos ZigBee, BT, KNX y ModBus. Estos dispositivos solo pueden conectarse a IoT Platform mediante una puerta de enlace que tenga integrado Link SDK. Es posible configurar un método de comunicación personalizado entre la puerta de enlace y sus subdispositivos. Para más información sobre cómo configurar Link SDK for C con el fin de conectar un subdispositivo a IoT Platform, consulte Overview of gateways and sub-devices.
Seleccionar un tipo de Link SDK
Los Link SDK admiten varios lenguajes de programación, como C, Java, Python, Node.js, Android e iOS. Puede seleccionar el SDK en el lenguaje adecuado según su producto.
|
SDK |
Escenario |
Referencias de configuración |
Ejemplo |
|
Link SDK for C |
Dispositivos embebidos programados en C con recursos limitados |
||
|
Link SDK for Android |
Dispositivos Android |
||
|
Link SDK for Python |
Adecuado para dispositivos programados en Python, pero no aplicable al desarrollo de aplicaciones ligeras en este lenguaje. |
||
|
Link SDK for Java |
Dispositivos programados en Java |
||
|
Link SDK for iOS |
Dispositivos iOS |
Las bibliotecas MQTT de código abierto más comunes incluyen paho.mqtt.c, paho.mqtt.embedded-c, paho.mqtt.android y paho.mqtt.python.
Portar Link SDK
Debe portar Link SDK for C a dispositivos embebidos. Los demás tipos de Link SDK pueden integrarse directamente en los dispositivos.
Puede configurar Link SDK for C de forma personalizada según los requisitos de los dispositivos que desea conectar a IoT Platform. Para más información sobre cómo configurar Link SDK for C en la consola de IoT Platform, consulte Get Link SDK for C.
Link SDK for C está compilado en C99. La implementación de las interfaces del sistema en el SDK varía según el entorno de hardware, por lo que podría ser necesario portarlo a dicho entorno. Para más información sobre cómo portar el SDK, consulte Port Link SDK for C.
De forma predeterminada, Link SDK for C utiliza la Interfaz de Sistema Operativo Portátil (POSIX) basada en Linux. Puede integrar directamente el SDK en dispositivos Linux sin necesidad de portarlo.
Entorno de hardware | Sistema operativo | Descripción | Referencias |
PC o sistema en chip (SoC) | Linux | Se requiere compilación cruzada para dispositivos embebidos. | |
Windows | No hay implementación de ejemplo disponible. Debe portar el SDK. | ||
Módulo OpenCPU | Sistema operativo en tiempo real (RTOS) | Puede integrar Link SDK mediante el Framework de Desarrollo IoT de Espressif (ESP-IDF). |
Configurar funciones de conexión y mensajería en el desarrollo de dispositivos
IoT Platform admite múltiples protocolos y métodos de verificación de dispositivos que diversos equipos pueden utilizar para conectarse. La siguiente tabla describe las soluciones de conexión disponibles.
Función | Descripción | Referencias |
Conexión multiprotocolo | IoT Platform permite la conexión de dispositivos mediante protocolos como Message Queuing Telemetry Transport (MQTT), Constrained Application Protocol (CoAP) y HTTP. La mayoría de los dispositivos utilizan el protocolo MQTT. | |
Verificación con certificado único por dispositivo | Cada dispositivo se verifica mediante credenciales independientes. | |
Verificación con certificado único por producto | Se utilizan las mismas credenciales para verificar todos los dispositivos pertenecientes a un mismo producto, lo cual simplifica el proceso de grabación de credenciales en los dispositivos. Nota La verificación con certificado único por dispositivo y la verificación con certificado único por producto pueden usarse en conjunto. La verificación por producto permite obtener las credenciales específicas del dispositivo durante su primera conexión a IoT Platform; posteriormente, se aplica la verificación individual por dispositivo. | |
Verificación basada en certificados X.509 | Cada dispositivo cuenta con un certificado propio y se verifica cuando se utiliza el protocolo Transport Layer Security (TLS), lo que mejora la seguridad. | |
Puertas de enlace y subdispositivos | La puerta de enlace actúa como proxy de sus subdispositivos para conectarse a IoT Platform. Una vez conectado, el subdispositivo puede usar sus propios topics para comunicarse con la plataforma. |
Configurar funciones de negocio en el desarrollo de dispositivos
Una vez que un dispositivo se conecta a IoT Platform, puede enviar y recibir mensajes a través de esta. El dispositivo puede emplear cualquiera de los siguientes métodos para enviar datos de negocio a la plataforma:
Topics personalizados: Puede definir topics personalizados y la carga útil del mensaje. Para más información, consulte Use custom topics for communication.
-
Modelos de Thing Specification Language (TSL): Permite definir, enviar y entregar propiedades, eventos y servicios del dispositivo basándose en modelos TSL. Para más información, consulte What is a Thing Specification Language model y Device communication using TSL models. El modelo TSL es la función clave de IoT Platform y ofrece las siguientes ventajas:
Almacenamiento estructurado de datos: simplifica el posterior proceso de desarrollo de datos.
Estado y datos del dispositivo en caché (device shadow): El dispositivo o el servidor pueden consultar el estado y los datos del dispositivo en cualquier momento.
Visualización de datos: Permite consultar los datos del dispositivo desde la consola de IoT Platform.
Depuración en línea: Facilita la depuración remota de dispositivos.
Configuración de funciones de O&M en el desarrollo de dispositivos
Si planea producir dispositivos en masa después de configurar sus funciones comerciales, le recomendamos configurar las funciones de operación y mantenimiento (O&M) para facilitar la iteración, configuración y solución de problemas posteriores. A continuación se describen las funciones de O&M que proporciona IoT Platform.
|
Función |
Descripción |
Referencias |
|
Actualización OTA |
Admite la actualización remota del firmware del dispositivo. |
|
|
Reporte de registros |
Permite que los dispositivos envíen registros a IoT Platform. Puede solucionar problemas en los dispositivos con base en estos registros. |
|
|
Configuración remota |
Admite la configuración remota de dispositivos. |
|
|
Servicio NTP |
Sincroniza la hora del servidor con los dispositivos. |