Exponenta Banner

thingSpeakWrite

Запишите данные к каналу ThingSpeak

свернуть все на странице

Синтаксис

thingSpeakWrite(channelID,data,'WriteKey','channel Write API key')
thingSpeakWrite(___,Name,Value)
response = thingSpeakWrite(___)

Описание

пример

thingSpeakWrite(channelID,data,'WriteKey','channel Write API key') пишут данные в заданный канал. Ключ API Записи задан как пара, разделенная запятой, состоящая из 'WriteKey' и вектора символов или строки, представляющей ключ записи канала.

пример

thingSpeakWrite(___,Name,Value) дополнительные опции использования заданы одним или несколькими аргументами пары Name,Value.

пример

response = thingSpeakWrite(___) возвращает ответ, обеспеченный сервером ThingSpeak™ на успешном завершении операции записи.

Примеры

свернуть все

Открыть скрипт

Запишите одно числовое значение в Поле 1 канала.

thingSpeakWrite(17504,2.3,'WriteKey','23ZLGOBBU9TWHG2H')
Открыть скрипт

Запишите числовые значения в первые четыре последовательных поля [1,2,3,4] из канала.

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

response = 

  struct with fields:

         Field1: '2.3'
         Field2: '1.2'
         Field3: '3.2'
         Field4: '0.1'
         Field5: []
         Field6: []
         Field7: []
         Field8: []
       Latitude: []
      Longitude: []
      ChannelID: 17504
        Created: 13-Nov-2018 09:21:25
    LastEntryID: 3758
       Altitude: []
Открыть скрипт

Запишите нечисловые данные в первые три последовательных поля [1,2,3] из канала.

thingSpeakWrite(17504,{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')
Открыть скрипт

Запишите смешанные значения в непоследовательные поля [1,4,6] из канала.

thingSpeakWrite(17504,'Fields',[1,4,6],'Values',{2.3,'on','good'},'WriteKey','23ZLGOBBU9TWHG2H')
Открыть скрипт

Обновите три поля, и широту записи, долготу и высотные данные для записи.

thingSpeakWrite(17504,[1.1,2.3,4],'Location',[-40,23,3500],'WriteKey','23ZLGOBBU9TWHG2H')
Открыть скрипт

Запишите широту, долготу и высотные данные к каналу, не добавляя значения в поля.

thingSpeakWrite(17504,'Location',[-40,23,3500],'WriteKey','23ZLGOBBU9TWHG2H')
Открыть скрипт

Запишите метку времени для значения, записанного в канал. Обеспеченная метка времени интерпретирована как местное время.

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

tStamp = 

  datetime

   13-Nov-2018 08:53:23
Открыть скрипт

Запишите матрицу данных к первым трем полям канала. Обеспеченные метки времени интерпретированы как местное время.

% 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)
Открыть скрипт

Запишите расписание данных к первым двум полям канала. Обеспеченные метки времени интерпретированы как местное время.

% 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)

Входные параметры

свернуть все

Идентификационный номер канала, заданный как положительное целое число.

Данные, чтобы записать, чтобы образовать канал, заданный в виде числа или числового вектора, массива ячеек, строки массивов ячеек, таблицы или расписания. Если вы задаете скалярные данные, значение записано в первое поле в канале (Поле 1). Для вектора или 1D массива ячеек, данные записаны в последовательные поля начиная с Поля 1.

Пример: thingSpeakWrite(17504,{2,3,'on','good'},'WriteKey','channel write api key');

Аргументы в виде пар имя-значение

Укажите необязательные аргументы в виде пар ""имя, значение"", разделенных запятыми. Имя (Name) — это имя аргумента, а значение (Value) — соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: thingSpeakWrite(17504,[1.1,2.2],'Fields',[1,2,3],'WriteKey','channel write api key');

Поля IDs канала, заданные как пара, разделенная запятой, состоящая из 'Fields' и положительного целочисленного значения 1 на n.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Fields',[1,2,3,4],'WriteKey','channel write api key');

Значения данных, заданные как пара, разделенная запятой, состоящая из 'Values' и числового скаляра, числового вектора, массива ячеек, строки массивов ячеек, таблицы или значений расписания. Задайте данные, которые будут записаны, чтобы образовать канал поля, заданные параметром 'Fields'.

Пример: thingSpeakWrite(17504,'Fields',[1,3,4],'Values',[1,2,3],'WriteKey','channel write api key');

Информация о местонахождении данных в канале, заданном как пара, разделенная запятой, состоящая из 'Location' и числового массива. Информация о местоположении включает широту, долготу и высоту. Этот пример пишет ту же информацию о местоположении для каждой из трех точек, предоставленных полю 1.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'Location',[-40,23,200],'WriteKey',' write api key');

Период тайм-аута связи сервера, заданный как пара, разделенная запятой, состоящая из 'TimeOut' и числового значения. Период тайм-аута является номером секунд, позволил, чтобы thingSpeakRead соединился с сервером, прежде чем запрос будет отключен.

Пример: thingSpeakWrite(17504,[2.3,1.2,3.2,0.1],'WriteKey','channel Write API key','Timeout',15);

Метка времени значений данных, записанных в поля в канале записи, заданном как пара, разделенная запятой, состоящая из 'Timestamp' и значения. Значение должно быть значением MATLAB® datetime. Все метки времени должны быть уникальными. Если вы представляете дублирующиеся метки времени, все ваши обновления отклоняются, в противном случае только обновления с метками времени уже в канале отклоняются.

Примечание

Не задавайте 'Timestamp', если вы задали 'Values' как расписание.

Пример: 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')]);

Типы данных: datetime

Выходные аргументы

свернуть все

Ответ канала операции записи, возвращенной как структура с полями в порядке, показанном в таблице. Поля структуры указывают на значения, записанные в поля канала:

Поле Описание
FieldX

Данные FieldX для записи, до восьми полей

Latitude

Широта для операции записи

Longitude

Долгота для операции записи

Channel ID

Идентификационный номер канала

Created

Datetime операции записи и записи канала

Last EntryID

ID записи для нового обновления канала

Created

Datetime даты создания канала

Updated

Datetime, когда настройки каналов были в последний раз изменены

Last EntryID

ID записи для нового обновления канала

Altitude

Повышение для операции записи

Ограничения

  • Все метки времени должны быть уникальными. Вы не можете записать новые данные с метками времени, которые совпадают с существующими данными в канале.

  • Позволенная частота обновления для канала ограничивается на основе вашего типа лицензии. Смотрите Часто Задаваемые Вопросы и Как Купить для определенной информации. Обновления с многократными въездами, такой как в таблице или расписании, ограничиваются более медленной частотой обновления. Для пользователей бесплатных учетных записей количество сообщений в одном вызове thingSpeakWrite ограничивается 960 сообщениями. Для пользователей заплаченных учетных записей предел является 14 400 сообщениями. Попытки опубликовать на уровне быстрее, чем позволенный предел возвратят следующую ошибку: Запросы являются слишком частыми. Для получения дополнительной информации смотрите Ограничения в документации.

Больше о

свернуть все

ThingSpeak

ThingSpeak является сервисом аналитической платформы IoT, который позволяет вам агрегировать, визуализировать и анализировать живые потоки данных в облаке. Смотрите Параметры лицензии и Коммерческое Использование для получения дополнительной информации.

Смотрите также

Функции

Введенный в R2019a

Документация MATLAB
Поддержка