O Link SDK é um kit de desenvolvimento de software para dispositivos fornecido pelo IoT Platform. Esse SDK simplifica o processo de desenvolvimento e permite a conexão dos dispositivos ao IoT Platform. Após obterem o SDK, os fabricantes podem portar o código conforme as necessidades do negócio. Assim, integram o Link SDK aos dispositivos e estabelecem a conexão com o IoT Platform.
Pré-requisitos
Antes de desenvolver com o SDK, execute as operações necessárias no console do IoT Platform para obter as informações sobre dispositivos e tópicos. Para mais detalhes, consulte Guia de conexão de dispositivos.
Informações básicas
Uma grande variedade de dispositivos heterogêneos pode se conectar ao IoT Platform. A plataforma oferece o Link SDK para desenvolvimento no lado do dispositivo e o protocolo padrão Alink.
Para saber mais sobre o uso do protocolo Alink, consulte Configurar dispositivos com base no protocolo Alink.
Recomendamos o uso do Link SDK para desenvolver e conectar dispositivos ao IoT Platform rapidamente. A figura a seguir ilustra o processo de desenvolvimento de um dispositivo com o Link SDK.
Para mais informações sobre termos relacionados, consulte Termos.
Integrar o Link SDK
O método de integração do Link SDK varia conforme o tipo de dispositivo:
Dispositivos IP: suportam o protocolo TCP/IP, como dispositivos Wi-Fi. Essa categoria permite integração direta com o Link SDK.
Dispositivos não IP: não suportam o protocolo TCP/IP, incluindo ZigBee, BT, KNX e ModBus. Esses dispositivos conectam-se ao IoT Platform apenas por meio de um gateway integrado ao Link SDK. Configure um método de comunicação personalizado entre o gateway e seus subdispositivos. Para mais detalhes sobre como configurar o Link SDK for C na conexão de subdispositivos ao IoT Platform, consulte Visão geral de gateways e subdispositivos.
Selecione um tipo de Link SDK
Os Link SDKs suportam diversas linguagens de programação, como C, Java, Python, Node.js, Android e iOS. Selecione o SDK na linguagem adequada ao seu produto.
|
SDK |
Cenário |
Referências de configuração |
Exemplo |
|
Link SDK for C |
Dispositivos embarcados programados em C com recursos limitados |
||
|
Link SDK for Android |
Dispositivos Android |
||
|
Link SDK for Python |
Adequado para dispositivos programados em Python, mas não aplicável ao desenvolvimento de aplicações leves nessa linguagem. |
||
|
Link SDK for Java |
Dispositivos programados em Java |
||
|
Link SDK for iOS |
Dispositivos iOS |
As bibliotecas MQTT open source mais comuns incluem paho.mqtt.c, paho.mqtt.embedded-c, paho.mqtt.android e paho.mqtt.python.
Portar o Link SDK
É obrigatório portar o Link SDK for C para dispositivos embarcados. Os demais tipos de Link SDK permitem integração direta aos dispositivos.
Configure o Link SDK for C personalizado conforme os requisitos dos dispositivos que deseja conectar ao IoT Platform. Para saber como configure o Link SDK for C no console do IoT Platform, consulte Obter o Link SDK for C.
O Link SDK for C foi compilado em C99. A implementação das interfaces de sistema no SDK varia conforme o ambiente de hardware, podendo exigir o porte para o seu ambiente específico. Para mais informações sobre o processo de porte, consulte Portar o Link SDK for C.
Por padrão, o Link SDK for C utiliza a interface POSIX (Portable Operating System Interface) baseada em Linux. Integre o SDK diretamente em dispositivos Linux sem necessidade de porte.
Ambiente de hardware | Sistema operacional | Descrição | Referências |
PC ou System on a Chip (SoC) | Linux | Compilação cruzada necessária para dispositivos embarcados. | |
Windows | Nenhuma implementação de exemplo disponível. Porte o SDK. | ||
Módulo OpenCPU | Sistema operacional de tempo real (RTOS) | Integre o Link SDK com base no Espressif IoT Development Framework (ESP-IDF). |
Configure recursos de conexão e mensagens no desenvolvimento de dispositivos
O IoT Platform suporta múltiplos protocolos e métodos de verifique de dispositivos para conexão. A tabela a seguir descreve as soluções disponíveis.
Recurso | Descrição | Referências |
Conexão multiprotocolo | O IoT Platform permite a conexão de dispositivos via protocolos como Message Queuing Telemetry Transport (MQTT), Constrained Application Protocol (CoAP) e HTTP. A maioria dos dispositivos utiliza o protocolo MQTT. | |
Verificação com certificado único por dispositivo | Cada dispositivo é verificado com credenciais individuais. | |
Verificação com certificado único por produto | Utiliza as mesmas credenciais para verificar todos os dispositivos pertencentes a um mesmo produto, simplificando a gravação de credenciais nos dispositivos. Nota É possível combinar a verificação com certificado único por dispositivo e a verificação com certificado único por produto. Use a verificação por produto para obter as credenciais específicas do dispositivo na primeira conexão com o IoT Platform e, em seguida, utilize a verificação por dispositivo. | |
Verificação baseada em certificado X.509 | Cada dispositivo possui um certificado individual, permitindo a verificação durante o uso do protocolo Transport Layer Security (TLS), o que aumenta a segurança. | |
Gateways e subdispositivos | O gateway atua como proxy para conectar seus subdispositivos ao IoT Platform. Após a conexão, o subdispositivo pode usar seus próprios tópicos para se comunicar com a plataforma. |
Configure recursos de negócio no desenvolvimento de dispositivos
Após conectar-se ao IoT Platform, o dispositivo pode enviar e receber mensagens pela plataforma. Utilize um dos métodos abaixo para envie dados de negócio ao IoT Platform:
Tópicos personalizados: defina seus próprios tópicos e o payload da mensagem. Para mais informações, consulte Usar tópicos personalizados para comunicação.
-
Modelos TSL (Thing Specification Language): defina, envie e entregue propriedades, eventos e serviços do dispositivo com base nos modelos TSL. Para mais detalhes, consulte O que é um modelo Thing Specification Language e Comunicação de dispositivos usando modelos TSL. O modelo TSL é o principal recurso do IoT Platform e oferece as seguintes vantagens:
Armazenamento estruturado de dados: simplifica o desenvolvimento posterior de dados.
Status e dados do dispositivo em cache (device shadow): permite que o dispositivo ou servidor consultem status e dados a qualquer momento.
Visualização de dados: visualize os dados do dispositivo no console do IoT Platform.
Depuração online: depure dispositivos remotamente.
Configure recursos de O&M no desenvolvimento de dispositivos
Se planeja produzir dispositivos em massa após configure os recursos de negócio, recomendamos habilitar os recursos de operação e manutenção (O&M) para facilitar iterações futuras, configurações e solução de problemas. A tabela a seguir lista os recursos de O&M oferecidos pelo IoT Platform.
|
Recurso |
Descrição |
Referências |
|
Atualização Over-the-air (OTA) |
Permite a atualização remota do firmware do dispositivo. |
|
|
Relatório de logs |
Permite que dispositivos enviem logs ao IoT Platform para auxiliar na solução de problemas. |
|
|
Configuração remota |
Suporta a configuração de dispositivos remotamente. |
|
|
Serviço Network Time Protocol (NTP) |
Sincroniza a hora do servidor com os dispositivos. |