Справочник команд
Читать
Редактировать
Команда 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-номер ячейки бота, который необходимо запустить. Формат ответа Примеры команды Совместимые устройства ААЕ-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 адреса устройства
Статус команды Активна
Описание команды Чтение IP адреса Параметры ? Формат ответа 192.168.50.139 Примеры команды IPA? Совместимые устройства ААЕ-1734, ААЕ-1738 Может использоваться для чтения Да
Команда LIBVERЗапрос версии библиотеки
Статус команды Активна
Описание команды Параметры Без параметров Формат ответа LIBVER? – возвращает версию библиотеки в формате x.x.x.x, где x – цифра. Примеры команды Совместимые устройства ААЕ-1734, ААЕ-1738 Может использоваться для чтения Да
Команда NAMEЗапись или чтение имени сети WiFi
Статус команды Активна
Описание команды Указать имя 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 Может использоваться для чтения Да