Download ubidots particle - download do código-fonte ubidots particle

ubidots particle

Outras categorias

v3.1.4

Baixar

Partícula

Aqui você aprenderá como enviar dados para Ubidots usando dispositivos Particle Photon ou Electron. Você só precisa do rótulo da variável e do valor que deseja enviar junto com um TOKEN válido do Ubidots. Além disso, você pode obter o último valor de uma variável da sua conta Ubidots.

Requisitos

Dispositivo de Partículas
Cabo micro USB
Conexão com a Internet
Obs.: Para a última versão da biblioteca é necessário ter seu dispositivo partícula com firmware versão 0.7.0 ou superior.

Configurar

Configure a conexão WiFi com o fóton. Existem duas maneiras de fazer isso:
- Usando seu smartphone.
- Conectando-o ao seu computador via USB.
Depois de reivindicar seu Photon e configurar sua conta Ubidots, vamos para o IDE Web do Particle.
- No IDE Web do Particle, crie um novo aplicativo e defina o nome.
- Vá para a guia da biblioteca.
- Na biblioteca contribuída, escreva Ubidots e selecione a biblioteca Ubidots.
- Clique em INCLUIR NO APP . E volte para "MYAPP.ino"

Esta biblioteca cria por padrão novas fontes de dados. O nome desta fonte de dados será "Particle" por padrão, e seu rótulo será seu ID de partícula.

O método padrão é TCP, se você quiser alterá-lo vá para as seções de recursos e siga o exemplo.

Aviso: Sobre malha de partículas

Após o anúncio da descontinuação do protocolo Particle Mesh IoT, como o Particle não está mais produzindo unidades Mesh, a Ubidots decidiu parar para apoiá-lo imediatamente nesta biblioteca. Se você ainda precisar usar o protocolo Mesh IoT em seu projeto em conjunto com nossa biblioteca, compile seu projeto através do Particle CLI com a versão v3.1.4 desta biblioteca.

Documentação

Construtor

Ubidots

 Ubidots(char* token, UbiServer server, IotProtocol iot_protocol)

@token, [Obrigatório]. Seu TOKEN de conta exclusivo da Ubidots.
@server, [Opcional], [Opções] = [ UBI_INDUSTRIAL ], [Padrão] = UBI_INDUSTRIAL .
@iot_protocol, [Opcional], [Opções] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [Padrão] = UBI_TCP . O protocolo IoT que você usará para enviar ou recuperar dados.

Cria uma instância Ubidots.

NOTAS

UBI_PARTICLE envia dados usando webhooks, portanto, siga as instruções para configurar seu webhook corretamente aqui.

Métodos

 void add(char *variable_label, float value, char *context, unsigned long dot_timestamp_seconds, unsigned int dot_timestamp_millis)

@variable_label, [Obrigatório]. O rótulo da variável onde o ponto será armazenado.
@valor, [Obrigatório]. O valor do ponto.
@contexto, [Opcional]. O contexto do ponto.
@dot_timestamp_seconds, [Opcional]. O carimbo de data/hora do ponto em segundos.
@dot_timestamp_millis, [Opcional]. O número do carimbo de data/hora do ponto em milissegundos. Se os valores de milissegundos do carimbo de data/hora não forem definidos, os segundos serão multiplicados por 1000.

Adiciona um ponto com seu valor, contexto e carimbo de data/hora relacionados para ser enviado a uma determinada fonte de dados, uma vez usado add().

Importante: O comprimento máximo do payload é de 700 bytes, se o seu payload for maior ele não será enviado corretamente. Você pode ver em seu console serial a carga a ser enviada se você chamar o método setDebug(bool debug) e passar um valor verdadeiro para ele.

 float get(const char* device_label, const char* variable_label)

@device_label, [Obrigatório]. O rótulo do dispositivo que contém a variável da qual recuperar valores.
@variable_label, [Obrigatório]. O rótulo da variável da qual recuperar valores.

Retorna como float o último valor do ponto da variável. IotProtocol getCloudProtocol()

 std::map<int, float> tcpMap getMultipleValues(const char* deviceLabel, const char* variableLabels)

@deviceLabel Ponteiro [obrigatório] que armazena o rótulo do dispositivo do qual recuperar valores.
@variableLabels [Obrigatório] rótulos de variáveis separados por vírgula para recuperar valores de

Retorna uma lista ordenada de mapas com os valores recuperados para os rótulos de variáveis fornecidos. Os valores podem ser acessados por índice, começando na posição 0, e são mapeados para cada rótulo de variável definido no array separado por vírgula.

 void addContext(char *key_label, char *key_value)

@key_label, [Obrigatório]. O rótulo de contexto chave para armazenar valores.
@key_value, [Obrigatório]. O valor do par de chaves.

Adiciona à memória local uma nova chave de contexto de valor-chave. As entradas do método devem ser ponteiros char. O método permite armazenar até 10 pares de valores-chave.

 void getContext(char *context)

@contexto, [Obrigatório]. Um ponteiro char onde o contexto será armazenado.

Constrói o contexto de acordo com o protocolo escolhido e o armazena no ponteiro context char.

 void setDebug(bool debug);;

@debug, [Obrigatório]. Tipo booleano para ativar/desativar mensagens de depuração.

Disponibilize mensagens de depuração através da porta serial.

 bool send(const char* device_label, const char* device_name, PublishFlags flags);

@device_label, [Opcional], [Padrão] = ID DO DISPOSITIVO DE PARTÍCULAS. O rótulo do dispositivo para enviar dados. Se não for definido, o PARTICLE DEVICE ID será usado.
@device_name, [Opcional], [Padrão] = @device_label. O nome do dispositivo atribuído caso o dispositivo ainda não exista na sua conta Ubidots. Se não for definido, o parâmetro de rótulo do dispositivo será usado. NOTA : O nome do dispositivo só é suportado através de TCP/UDP; se você usar outro protocolo, o nome do dispositivo será igual ao rótulo do dispositivo.
@flags, [Opcional], [Opções] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ]. Sinalizadores de webhook de partículas.

Envia todos os dados adicionados usando o método add(). Retorna verdadeiro se os dados foram enviados.