Скачать ubidots particle - ubidots particle скачать исходный код

ubidots particle

Другие категории

v3.1.4

Скачать

Частица

Здесь вы узнаете, как отправлять данные в Ubidots с помощью устройств Particle Photon или Electron. Вам просто нужна метка и значение переменной, которые вы хотите отправить вместе с действительным ТОКЕНОМ Ubidots. Кроме того, вы можете получить последнее значение переменной из своей учетной записи Ubidots.

Требования

Устройство частиц
Микро-USB-кабель
подключение к Интернету
Примечание. Для последней версии библиотеки необходимо иметь устройство частиц с прошивкой версии 0.7.0 или выше.

Настраивать

Настройте Wi-Fi-соединение с фотоном. Есть два способа сделать это:
- Используя свой смартфон.
- Подключаем его к компьютеру через USB.
Заявив права на Photon и настроив учетную запись Ubidots, давайте перейдем к веб-IDE Particle.
- В веб-IDE Particle создайте новое приложение и задайте имя.
- Перейдите на вкладку «Библиотека».
- В добавленной библиотеке напишите Ubidots и выберите библиотеку Ubidots.
- Нажмите «ВКЛЮЧИТЬ В ПРИЛОЖЕНИЕ» . И вернитесь в «MYAPP.ino»

Эта библиотека по умолчанию создает новый источник данных. По умолчанию имя этого источника данных будет «Частица», а его меткой будет ваш идентификатор частицы.

Методом по умолчанию является TCP. Если вы хотите изменить его, перейдите в разделы функций и следуйте примеру.

Предупреждение: о сетке частиц

После объявления об прекращении поддержки IoT-протокола Particle Mesh, поскольку Particle больше не производит Mesh-модули, Ubidots решила прекратить его поддержку «из коробки» в этой библиотеке. Если вам по-прежнему необходимо использовать протокол Mesh IoT в своем проекте совместно с нашей библиотекой, скомпилируйте свой проект через Particle CLI с версией v3.1.4 этой библиотеки.

Документация

Конструктор

Убидотс

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

@token, [Обязательно]. ТОКЕН вашего уникального аккаунта Ubidots.
@server, [Необязательно], [Параметры] = [ UBI_INDUSTRIAL ], [По умолчанию] = UBI_INDUSTRIAL .
@iot_protocol, [Необязательно], [Параметры] = [ UBI_HTTP , UBI_TCP , UBI_UDP , UBI_PARTICLE ], [По умолчанию] = UBI_TCP . Протокол Интернета вещей, который вы будете использовать для отправки или получения данных.

Создает экземпляр Ubidots.

ПРИМЕЧАНИЯ

UBI_PARTICLE отправляет данные с помощью веб-перехватчиков, поэтому обязательно следуйте инструкциям по правильной настройке веб-перехватчика здесь.

Методы

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

@variable_label, [Обязательно]. Метка переменной, в которой будет храниться точка.
@value, [Обязательно]. Значение точки.
@context, [Необязательно]. Контекст точки.
@dot_timestamp_секунды, [Необязательно]. Временная метка точки в секундах.
@dot_timestamp_millis, [Необязательно]. Число миллисекунд временной метки точки. Если значения миллисекунд в метке времени не установлены, секунды будут умножены на 1000.

Добавляет точку с соответствующим значением, контекстом и меткой времени для отправки в определенный источник данных после использования add().

Важно: максимальная длина полезной нагрузки составляет 700 байт. Если полезная нагрузка больше, она не будет отправлена должным образом. Вы можете увидеть на своей последовательной консоли полезную нагрузку для отправки, если вы вызовете метод setDebug(bool debug) и передадите ему истинное значение.

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

@device_label, [Обязательно]. Метка устройства, содержащая переменную, из которой извлекаются значения.
@variable_label, [Обязательно]. Метка переменной, из которой извлекаются значения.

Возвращает в виде числа с плавающей запятой последнее значение точки из переменной. IotProtocol getCloudProtocol()

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

@deviceLabel [Обязательный] указатель, в котором хранится метка устройства, из которого извлекаются значения.
@variableLabels [Обязательный] метки переменных, разделенные запятыми, для извлечения значений из

Возвращает упорядоченный список карт со значениями, полученными для предоставленных меток переменных. Доступ к значениям осуществляется по индексу, начиная с позиции 0, и они сопоставляются с каждой меткой переменной, установленной в массиве, разделенном запятыми.

 void addContext(char *key_label, char *key_value)

@key_label, [Обязательно]. Метка ключевого контекста для хранения значений.
@key_value, [Обязательно]. Значение пары ключей.

Добавляет в локальную память новый ключ контекста «ключ-значение». Входные данные метода должны быть указателями на символы. Метод позволяет хранить до 10 пар ключ-значение.

 void getContext(char *context)

@context, [Обязательно]. Указатель типа char, в котором будет храниться контекст.

Создает контекст в соответствии с выбранным протоколом и сохраняет его в указателе контекста.

 void setDebug(bool debug);;

@debug, [Обязательно]. Логический тип для отключения/включения отладочных сообщений.

Сделайте доступными отладочные сообщения через последовательный порт.

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

@device_label, [Необязательно], [По умолчанию] = ИДЕНТИФИКАТОР УСТРОЙСТВА ЧАСТИЦЫ. Метка устройства для отправки данных. Если не установлено, будет использоваться идентификатор устройства PARTICLE DEVICE.
@device_name, [Необязательно], [По умолчанию] = @device_label. Имя устройства, назначенное в противном случае, если устройство еще не существует в вашей учетной записи Ubidots. Если он не установлен, будет использоваться параметр метки устройства. ПРИМЕЧАНИЕ . Имя устройства поддерживается только через TCP/UDP. Если вы используете другой протокол, имя устройства будет таким же, как метка устройства.
@flags, [Необязательно], [Параметры] = [ PUBLIC , PRIVATE , WITH_ACK , NO_ACK ]. Флаги вебхука частиц.

Отправляет все данные, добавленные с помощью метода add(). Возвращает true, если данные были отправлены.