Questa pagina è stata tradotta con la traduzione automatica. Fai clic qui per vedere l'ultima versione in inglese.

thingSpeakWrite

Scrive i dati sul canale ThingSpeak

Sintassi

thingSpeakWrite(channelID,data,'WriteKey','channel write API key')

thingSpeakWrite(___,Name,Value)

response = thingSpeakWrite(___)

Descrizione

thingSpeakWrite(channelID,data,'WriteKey','channel write API key') scrive i dati nel canale specificato. La chiave API di scrittura è specificata come una coppia separata da virgole composta da 'WriteKey' e un vettore di caratteri o una stringa che rappresenta la chiave di scrittura del canale.

thingSpeakWrite(___,Name,Value) utilizza opzioni aggiuntive specificate da uno o più argomenti della coppia Name,Value .

response = thingSpeakWrite(___) restituisce la risposta fornita dal server ThingSpeak™ al completamento con successo dell'operazione di scrittura.

Esempi

Scrivi dati su un canale ThingSpeak

Scrivere un singolo valore numerico nel Campo 1 di un canale.

thingSpeakWrite(17504,2.3,'WriteKey','23ZLGOBBU9TWHG2H')

Scrivi più valori e visualizza la risposta

Scrivere valori numerici nei primi quattro campi consecutivi [1,2,3,4] di un canale.

response = thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H')

Scrivere dati non numerici

Scrive dati non numerici nei primi tre campi consecutivi [1,2,3] di un canale.

thingSpeakWrite(17504,{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')

Scrivi dati misti

Scrivi valori misti in campi non consecutivi [1,4,6] di un canale.

thingSpeakWrite(17504,'Fields',[1,4,6],'Values',{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')

Scrivi i dati di campo e posizione

Aggiorna tre campi e scrivi i dati di latitudine, longitudine e altitudine per la voce.

thingSpeakWrite(17504,[1.1,2.3,4],'Location',[-40,23,35],'WriteKey','23ZLGOBBU9TWHG2H')

Scrivi solo i dati sulla posizione

Scrivi i dati di latitudine, longitudine e altitudine su un canale senza aggiungere valori ai campi.

thingSpeakWrite(17504,'Location',[-40,23,3500],'WriteKey','23ZLGOBBU9TWHG2H')

Scrivi dati con timestamp

Scrivere un timestamp per il valore da scrivere su un canale. Il timestamp fornito viene interpretato come ora locale.

tStamp = datetime('now')
thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','23ZLGOBBU9TWHG2H','TimeStamp',tStamp)

Scrivere una matrice di dati

Scrivere una matrice di dati nei primi tre campi di un canale. I timestamp forniti vengono interpretati come ora locale.

% Generate Random Data
data = randi(10,10,3);

% Generate timestamps for the data
tStamps = datetime('now')-minutes(9):minutes(1):datetime('now');

channelID = 17504; % Change to your Channel ID
writeKey = '23ZLGOBBU9TWHG2H'; % Change to your Write API Key

% Write 10 values to each field of your channel along with timestamps
thingSpeakWrite(channelID,data,'TimeStamp',tStamps,'WriteKey',writeKey)

Scrivere un orario dei dati

Scrivere un calendario di dati nei primi due campi di un canale. I timestamp forniti vengono interpretati come ora locale.

% Generate random data
dataField1 = randi(10,10,1);
dataField2 = randi(10,10,1);

% Generate timestamps for the data
tStamps = [datetime('now')-minutes(9):minutes(1):datetime('now')]';

% Create timetable
dataTable = timetable(tStamps,dataField1,dataField2);
channelID = 17504; % Change to your channel ID
writeKey  = '23ZLGOBBU9TWHG2H'; % Change to your Write API Key

% Write 10 values to each field of your channel along with timestamps
thingSpeakWrite(channelID,dataTable,'WriteKey',writeKey)

Argomenti di input

channelID — Numero identificativo del canale

numerico

Il numero di identificazione del canale, specificato come numero intero positivo.

data — Dati da scrivere sul canale

vettore | numerico | tavolo | orario

Dati da scrivere sul canale, specificati come scalare numerico o vettore numerico, matrice di celle, stringa di matrici di celle, tabella o tabella oraria. Se si specificano dati scalari, il valore viene scritto nel primo campo del canale (campo 1). Per un vettore o una matrice di celle 1-D, i dati vengono scritti in campi consecutivi a partire dal Campo 1.

Esempio thingSpeakWrite(17504,{2,3,'on','good'},'WriteKey','channel write api key');

channel write API key — Scrivi la chiave API del canale

vettore di caratteri della chiave API | stringa scalare della chiave API

Chiave API di scrittura del canale, specificata come coppia separata da virgole composta da 'WriteKey' e un vettore di caratteri che rappresenta la chiave API di scrittura del canale. La chiave API Write è necessaria per scrivere i dati in un canale. Puoi trovare la chiave API di scrittura per un canale nella scheda Chiavi API della visualizzazione del canale ThingSpeak . Salva il tuo canale Scrivi la chiave API in una variabile per comodità.

Esempio thingSpeakRead(12397,'WriteKey','XXXXXXXXXXXXXXXX');

Argomenti nome-valore

Specificare coppie di argomenti facoltative come Name1=Value1,...,NameN=ValueN, dove Name è il nome dell'argomento e Value è il valore corrispondente. Gli argomenti nome-valore devono apparire dopo gli altri argomenti, ma l'ordine delle coppie non ha importanza.

Prima di R2021a, utilizzare le virgole per separare ciascun nome e valore e racchiudere Name tra virgolette.

Esempio thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','channel write api key');

Fields — Campi canale

numerico

ID dei campi del canale, specificati come coppia separata da virgole composta da 'Fields' e un valore intero positivo 1 per n.

Esempio thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Fields',[1,2,3,4],'WriteKey','channel write api key');

Values — Valori dei dati

numerico | vettore | tavolo | orario

Valori di dati, specificati come coppia separata da virgole composta da 'Values' e scalare numerico, vettore numerico, una matrice di celle, una stringa di matrici di celle, tabella o valori di orario. Specificare i dati da scrivere nei campi del canale specificati dal parametro 'Fields' .

Esempio thingSpeakWrite(17504,'Fields',[1,3,4],'Values',[1,2,3],'WriteKey','channel write api key');

Location — Informazioni sulla posizione dei dati

numerico

Informazioni sulla posizione dei dati nel canale, specificate come coppia separata da virgole composta da 'Location' e array numerico. Le informazioni sulla posizione includono latitudine, longitudine e altitudine. In questo esempio vengono scritte le stesse informazioni sulla posizione per ciascuno dei tre punti forniti nel campo 1.

Esempio thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Location',[-40,23,200],'WriteKey',' write api key');

Timeout — Periodo di timeout della connessione al server

10 (predefinito) | numerico

Periodo di timeout della connessione al server, specificato come coppia separata da virgole composta da 'TimeOut' e un valore numerico. Il periodo di timeout è il numero di secondi concessi a thingSpeakRead per connettersi al server prima che la richiesta venga terminata.

Esempio thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','write API key','Timeout',15);

Timestamp — Timestamp dei valori dei dati

datetime

Timestamp dei valori dei dati scritti nei campi nel canale di scrittura, specificati come una coppia separata da virgole composta da 'Timestamp' e un valore. Il valore deve essere un valore MATLAB^® datetime . Tutti i timestamp devono essere univoci. Se invii timestamp duplicati, tutti i tuoi aggiornamenti verranno rifiutati, altrimenti verranno rifiutati solo gli aggiornamenti con timestamp già presenti nel canale.

Nota

Non specificare 'Timestamp' se hai specificato 'Values' come orario.

Esempio thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','channel write api key','Timestamp',[datetime('2/6/2018 9:27:12','format','MM/dd/uuuu HH:mm:ss')]);

Tipi di dati: datetime

Argomenti di output

response — Risposta del canale dell'operazione di scrittura

struttura

Risposta del canale dell'operazione di scrittura, restituita come struttura con i campi nell'ordine mostrato nella tabella. I campi della struttura indicano i valori scritti nei campi del canale:

Campo	Descrizione
FieldX	Dati FieldX per l'immissione, fino a otto campi
Latitude	Latitudine per l'operazione di scrittura
Longitude	Longitudine per l'operazione di scrittura
Channel ID	Numero di identificazione del canale
Created	Data e ora dell'operazione di scrittura e della voce del feed
Last EntryID	ID voce per l'aggiornamento del canale più recente
Created	Data e ora della data di creazione del canale
Updated	Data e ora dell'ultima modifica delle impostazioni dei canali
Last EntryID	ID voce per l'aggiornamento del canale più recente
Altitude	Elevazione per l'operazione di scrittura

Limitazioni

• Tutti i timestamp devono essere univoci. Non è possibile scrivere nuovi dati con timestamp che corrispondano ai dati esistenti nel canale.

• La frequenza di aggiornamento consentita per un canale è limitata in base al tipo di licenza. Vedi Frequently Asked Questions e How to Buy per informazioni specifiche. Gli aggiornamenti con più voci, ad esempio in una tabella o in un orario, sono limitati alla frequenza di aggiornamento più lenta. Per gli utenti di account gratuiti, il numero di messaggi in una singola chiamata a thingSpeakWrite è limitato a 960 messaggi. Per gli utenti di account a pagamento il limite è di 14.400 messaggi. I tentativi di pubblicare a una velocità superiore al limite consentito restituiranno il seguente errore: Le richieste sono troppo frequenti. Per ulteriori informazioni, vedere Limitazioni nella documentazione.

Ulteriori informazioni

ThingSpeak

ThingSpeak è un servizio di piattaforma di analisi IoT che consente di aggregare, visualizzare e analizzare flussi di dati in tempo reale nel cloud. Vedi License Options e Commercial Use per ulteriori informazioni.

Cronologia versioni

Introdotto in R2019a

Vedi anche

Funzioni

• thingSpeakRead | webwrite (MATLAB)