Справочник команд
Читать
Редактировать
Команда
Описание команды
Параметры
Формат ответа
Примеры команды
Совместимые устройства
Статус команды
Может использоваться для чтения
BLINK MODE
BLINK MODE=blink_mode ARRAY=x;x;x
blink_mode – режим мигания.
SINGLE – однократный;
MULTI – многократный
ARRAY – длительность свечения заданная через знак ;
Сигнал BLINK (3.3) формируется на Рин SRB (8)
Пример
BLINK MODE=SINGLE ARRAY=2;3;10
ААЕ-1734, ААЕ-1738
Активна
BSTA CEL=<NC>
Запустить телеграмм бота.
Получить информацию запущен ли бот, указанный в CEL. Если параметр CEL=ALL - выдать информацию о всех имеющихся телеграм ботам.
CEL-номер ячейки бота, который необходимо запустить.
Получить информацию запущен ли бот, указанный в CEL. Если параметр CEL=ALL - выдать информацию о всех имеющихся телеграм ботам.
ААЕ-1734, ААЕ-1738
CMDLIST
CMDLIST DEL ID=<TASK_ID>
Удаление из списка
CMDLIST EDIT ID=<TASK_ID> CMD=<NEW_COMMAND_STRING>
Редактирование:
CMDLIST STATUS ID=<TASK_ID>?
Запрос статуса:
CMDLIST CLEAR или CMDLIST DEL ID=ALL
Полная очистка списка (удаление всех команд):
ААЕ-1734, ААЕ-1738
Активна
Да
HWCFG
Запрос- ответ конфигурации аппаратуры устройства
?
{"Name":"AAE-1734","SN":"352501","Version":"1.0.0.0","Date":"2025-02-05 14:00:05.001","Interfaces":["BT","WiFi",{"ID":"USB","Spec":"VCOM","Baud":9600}],"Memories":[{"ID":"SPI","Access":"RW","Size":8388608},{"ID":"ROM","Access":"R","Size":2040109465}],"Inputs":[{"ID":"In1","Type":"Input","DataType":"Bool","SampleRate":10},{"ID":"In2","Type":"Input","DataType":"Bool","SampleRate":10},{"ID":"In3","Type":"Input","DataType":"Bool","SampleRate":10},{"ID":"In4","Type":"Input","DataType":"Bool","SampleRate":10},{"ID":"ADC1","Type":"Input","DataType":"Float","Min":0,"Max":1,"Unit":"V"},{"ID":"ADC2","Type":"Input","DataType":"Float","Min":0,"Max":1,"Unit":"V"},{"ID":"ADC3","Type":"Input","DataType":"Float","Min":0,"Max":36,"Unit":"V"},{"ID":"ADC4","Type":"Input","DataType":"Float","Min":0,"Max":36,"Unit":"V"},{"ID":"Thermo1","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo2","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo3","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo4","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo5","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo6","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo7","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05},{"ID":"Thermo8","Type":"Input","DataType":"Float","Min":-55,"Max":125,"Inc":0.05}],"Outputs":[{"ID":"Out1","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out2","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out3","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out4","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out5","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out6","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out7","Type":"Output","DataType":"Bool","SampleRate":10},{"ID":"Out8","Type":"Output","DataType":"Bool","SampleRate":10}]}1992
HWCFG?
ААЕ-1734, ААЕ-1738
Активна
Да
IDN
Запрашивает у прибора строку его идентификатора.
? - опция обозначения режима чтения, указывается в конце команды
Model #SerialNumber
Model - модель устройства
SerialNumber - СН устройства
Команда:
IDN?
Ответ:
AEE-1234 #01234567
ААЕ-1734, ААЕ-1738
Активна
Да
IDND
Команда записывает или читает имя и СН прибора и пользовательскую запись об имени
? (опция обозначения режим чтения)
MODE=DEFAULT (опция)
MODE=USER (опция)
Ответ при записи- повторение записанного
Ответ при чтении (?) Имя устройства, СН (DEFAULT) и пользовательское название (USER)
1. IDND? (параметр Mode user- умолчание)
пример ответа AAE-1738 #4361
или "Прибор 1 Суханова" , если записано USER NAME
2. IDND MODE=DEFAULT?
пример ответа AAE-1738 #4361
3. IDND MODE=USER?
пример ответа "Прибор 1 Суханова"
4. IDND MODE=DEFAULT NAME="AME-1234 #12345"
пример ответа MODE=DEFAULT NAME="AME-1234 #12345"
5. IDND MODE=USER NAME="Прибор 1 Суханова"
пример ответа MODE=USER NAME="Прибор 1 Суханова"
ААЕ-1734, ААЕ-1738
Разрабатывается
IPA
Чтение IP адреса
?
192.168.50.139
IPA?
ААЕ-1734, ААЕ-1738
Активна
Да
LIBVER
Без параметров
LIBVER? – выводит версию библиотеки в формате x.x.x.x, где x – цифра.
ААЕ-1734, ААЕ-1738
Активна
Да
NAME
Указать имя WiFi-сети, к которой необходимо подключаться. Команда записывает эти данные в EEPROMприбора. Имя сети будет прочитано при следующем включении прибора, т.е. для вступления данных в силу необходимо включить и выключить питание прибора.
SSID (для записи)
? (для чтения)
SSID (при чтении)
NAME SSID
NANE?
ААЕ-1734, ААЕ-1738
Активна
Да
NOTIF (ранее INTERRUPT)
Сообщение прерывания передаётся в программу по инициативе прибора, без предварительной команды запроса информации.
Прибор гарантирует, что сообщение прерывания не будет отправлено внутри уже ведущейся передачи данных от прибора к приложению, но оно может быть передано между передачей команды из приложения в прибор и возвратом в приложение ответа на эту команду. Программа должна обнаруживать и корректно обрабатывать такую ситуацию.
Общий формат сообщения состоит из ключевого слова INTERRUPT, двоеточия и данных события прерывания в формате JSON.
в формате JSON
Нажата кнопка:
---
INTERRUPT:{
"TimeStamp":"2025-03-05 19:25:51.456",
"EventType":"ButtonDown",
"EventSource":"Button 2",
"EventData":{"Value":1}
Кнопка отпущена:
---
INTERRUPT:{
"TimeStamp":"2025-03-05 19:25:51.912",
"EventType":"ButtonUp",
"EventSource":"Button 2",
"EventData":{"Value":0}
}
Изменилось состояние входного канала:
---
INTERRUPT:{
"TimeStamp":"2025-03-05 19:25:51.912",
"EventType":"ValueChanged",
"EventSource":"Input 3",
"EventData":{"Value":0}
}
- прерывания в формате JSON
ААЕ-1734, ААЕ-1738
Разрабатывается
Да
OUTP CH=x VAL=y
CH= x, где x номер канала начиная с 1
VAL=y, где y значение 1 - включен и 0 - значение выключен
[2025-06-19 15:04:21.341]: OUTP CH=2 VAL=0
этот ответ подтверждает прием команды, но не подтверждает выполнение команды.
На выполнение команды требуется врем до 1 секунды
для подтверждения выполнения команды, переключения состояния выхода - нужно сделать запрос состояния - команды чтения состояния OUTP? (ответ по маске) или OUTP CH=ALL? (ответ в формате Json)
2025-06-19 15:04:21.337]: OUTP CH=2 VAL=0
[2025-06-19 15:04:21.341]: OUTP CH=2 VAL=0
ААЕ-1734, ААЕ-1738
Активна
OUTP CH=x?
Параметры
x - номер канала
ALL - по всем каналам
Ответ зависит от параметров запроса
1. для параметра x ответ в формате 1 (включен) или 0 (выключен)
2. для параметра ALL ответ в формате JSON
[2025-06-19 15:03:52.152]: {"TimeStamp":"2025-6-19 11:3:51.332","Values":[{"Number":1,"Value":0},{"Number":2,"Value":1},{"Number":3,"Value":0},{"Number":4,"Value":1},{"Number":5,"Value":1},{"Number":6,"Value":0},{"Number":7,"Value":1},{"Number":8,"Value":0}]}
где
[2025-06-19 15:03:52.152]: {"TimeStamp":"2025-6-19 11:3:51.332",
отметка времени
"Values":[{"Number":1,"Value":0},
номер канала и его значение
{"Number":2,"Value":1},{"Number":3,"Value":0},{"Number":4,"Value":1},{"Number":5,"Value":1},{"Number":6,"Value":0},{"Number":7,"Value":1},{"Number":8,"Value":0}]}
всего для 8 каналов, но в 1734 - только 4 рабочих канала
[2025-06-19 15:04:26.305]: OUTP CH=ALL?
[2025-06-19 15:04:26.311]: {"TimeStamp":"2025-6-19 11:4:25.610","Values":[{"Number":1,"Value":0},{"Number":2,"Value":0},{"Number":3,"Value":0},{"Number":4,"Value":1},{"Number":5,"Value":1},{"Number":6,"Value":0},{"Number":7,"Value":1},{"Number":8,"Value":0}]}
ААЕ-1734, ААЕ-1738
Активна
Да
OUTP?
нет
HH - шестнадцатеричный код состояния выходов. Старший разряд - старший по номеру выход (8-й), младший разряд - младший по номеру выход (1)
2025-06-19 15:25:08.256]: OUTP?
[2025-06-19 15:25:08.260]: 50
ААЕ-1734, ААЕ-1738
Активна
Да
PASS
Указать пароль сети, к которой необходимо подключаться. Пароль к сети будет прочитан при следующем включении прибора, т.е. для вступления данных в силу необходимо включить и выключить питание прибора.
password (для записи)
? (для чтении)
password (при чтении)
PASS password
PASS?
ААЕ-1734, ААЕ-1738
Активна
THERMO?
Команда чтения опроса всех подключённых по однопроводному интерфейсу датчиков температуры
ответ в формате JSON.
Без параметров
{"TimeStamp":"2025-2-27 11:38:16.615","Sensors":[{"Model":"DS18B20","Type":"Thermo","Address":"402065632105196243106","Min":-55,"Max":125,"Accu":0.5,"Resolution":12,"Power Mode":"External","Temperature":25.875},{"Model":"DS18B20","Type":"Thermo","Address":"401971581571422699148","Min":-55,"Max":125,"Accu":0.5,"Resolution":12,"Power Mode":"External","Temperature":25.1875},{"Model":"DS18B20","Type":"Thermo","Address":"401352815114883105","Min":-55,"Max":125,"Accu":0.5,"Resolution":12,"Power Mode":"External","Temperature":24.4375}]}
в ответе в формате JSON присутствует
"TimeStamp" - отметка времени измерения, поступившая из прибора
"Sensors" - это ключ к массиву датчиков
{"TimeStamp":"11:38:16.615","Sensors{"Model":"DS18B20","Type":"Thermo","Address":"402065632105196243106","Min":-55,"Max":125,"Accu":0.5,"Resolution":12,"Power Mode":"External","Temperature":25.875},
THERMO?
ААЕ-1734, ААЕ-1738
Активна
Да
THERMODIAG?
Без параметров
Значение температуры в удобном для восприятия виде.
ААЕ-1734, ААЕ-1738
Активна
Да
TIME?
Возвращает время в формате: day_of _week, month dd yyyy hh:mm:ss.
Пример: Thursday, January 30 2020 15:00:19
?
2025-3-5T19:49:25+251
TIME?
ААЕ-1734, ААЕ-1738
Активна
Да
UTCN
Задать смещение часового пояса UTC, где XX–смещение. Смещение может быть представлено, как положительным, так и отрицательным числом.
Прочитать текущее смещение часового пояса.
XX (XX–смещение. Смещение может быть представлено, как положительным, так и отрицательным числом.)
?
-5
4
UTCN -4
UTCN 4
UTCN?
ААЕ-1734, ААЕ-1738
Активна
Да
VOLT
Команда чтения VOLT CH=1? возвращает значение напряжения
Минимальное значение 0000 (целое число)
Максимальное значение 2048 (целое число)
Замечание 1: внутри текста ответа недопустимы символы новой строки.
Замечание 2: хотя команда VOLT всегда получает измеренное значение напряжения, с её помощью можно получать и производные измерения, например, силу тока с помощью встроенного шунта. В этом случае соответствующим образом должны изменяться передаваемые поля коэффициентов пересчёта и единиц измерений (AddCoeff, MulCoeff и Unit).
CH=<channel_number>|ALL?
Единственный параметр - номер канала (от 1 до 4), вместо номера может быть указан идентификатор ALL, в этом случае требуется вернуть массив значений для всех каналов.
Ответ:
Для всех каналов:
{"TimeStamp":"2025-03-05 19:25:51.456",
"ADC":[
{"Number":1,"Value":1920,"Min":0,"Max":4095,"Resolution":12,"AddCoeff":-10.12,"MulCoeff":4.88E-3,"Unit":"V"},
{"Number":2,"Value":2048,"Min":0,"Max":4095,"Resolution":12,"AddCoeff":-10.13,"MulCoeff":4.88E-3,"Unit":"V"},
{"Number":3,"Value":2047,"Min":0,"Max":4095,"Resolution":12,"AddCoeff":-10.11,"MulCoeff":4.87E-3,"Unit":"V"},
{"Number":4,"Value":2049,"Min":0,"Max":4095,"Resolution":12,"AddCoeff":-10.12,"MulCoeff":4.882E-3,"Unit":"V"}
]}
Для одного канала:
{"TimeStamp":"2025-03-05 19:25:51.456",
"ADC":[
{"Number":3,"Value":2047,"Min":0,"Max":4095,"Resolution":12,"AddCoeff":-10.11,"MulCoeff":4.87E-3}
]}
VOLT CH=1?
VOLT CH=ALL?
ААЕ-1734, ААЕ-1738
Разрабатывается
Да