Протокол AT-Modem

Уведомление
Сообщение	`+STARTED`

Команда
Сообщение	`AT`
Ответ	`OK`

Команда
Сообщение	`ATE` `<echo>`
Ответ	OK
Ошибка	FAIL
Параметры	`<echo>` 0 - выключить 1 - включить
Пример	`ATE1` `ATE0`

Команда
Сообщение	`AT+VERSION`
Ответ	`+VERSION`:`<dev-model>`,`<app-name>`,`<app-version>`,`<app-date>` OK
Параметры	`<dev-model>` - модель устройства `<app-name>` - название прошивки `<app-version>` - версия прошивки `<app-date>` - дата выпуска прошивки

Команда
Сообщение	`AT+UID`
Ответ	`+UID`:`<uid>` OK
Параметры	`<uid>` - уникальный идентификатор устройства

Команда
Сообщение	`AT+RESET`
Ответ	OK

Команда
Сообщение	`AT+SLEEP`
Ответ	OK

Запрос
Сообщение	`AT+WFMODE?`
Ответ	+WFMODE:`<mode>` OK
Параметры	`<mode>` - режим работы 0 - выключен 1 - станция 2 - точка доступа 3 - станция + точка доступа

Установка
Сообщение	`AT+WFMODE=` `<mode>`
Ответ	OK
Ошибка	+WFMODE:`<error>` FAIL
Параметры	см. таблицу "Запрос"
Пример	`AT+WFMODE=0` `AT+WFMODE=1`

Тест
Сообщение	`AT+WFMODE=?`
Ответ	+WFMODE:`<mode>` OK
Параметры	см. таблицу "Запрос"

Команда
Сообщение	`AT+WFSCANAP`
Ответ	+WFSCANAP:`<ssid>`,`<mac>`,`<channel>`,`<auth>`,`<rssi>`,`<bandwidth>`,`<pairwise_cipher>`,`<group_cipher>`,`<phy>`,`<wps>` OK
Ошибка	+WFSCANAP:`<error>` FAIL
Параметры	`<ssid>` - название `<mac>` - MAC-адрес `<channel>` - канал `<auth>` - тип авторизации (список значений) `<rssi>` - мощность сигнала в dBm `<bandwidth>` - используемая полоса частот 0 - HT20 1 - 20 MHz 2 - HT40 3 - 40 MHz 4 - 80 MHz 5 - 160 MHz 6 - 80 + 80 MHz `<pairwise_cipher>` - тип парного шифра (список значений) `<group_cipher>` - тип группового шифра (список значений) `<phy>` - маска поддерживаемой сети bit0 - 802.11b bit1 - 802.11g bit2 - 802.11n `<wps>` - поддержка wps

Запрос
Сообщение	`AT+WFSCANAPOPT?`
Ответ	+WFSCANAPOPT:`<mask>` OK
Ошибка	+WFSCANAPOPT:`<error>` FAIL
Параметры	`<mask>` - маска отображаемых параметров bit0 - параметр `ssid` bit1 - параметр `mac` bit2 - параметр `channel` bit3 - параметр `authmode` bit4 - параметр `rssi` bit5 - параметр `bandwidth` bit6 - параметр `pairwise_cipher` bit7 - параметр `group_cipher` bit8 - параметр `phy` bit9 - параметр `wps` Значения битов: 0 - не передавать параметр 1 - передавать параметр

Установка
Сообщение	`AT+WFSCANAPOPT=` `<mask>`
Ответ	+WFSCANAPOPT:`<mask>` OK
Параметры	см. таблицу "Запрос"
Пример	`AT+WFSCANAPOPT=1023`

Тест
Сообщение	`AT+WFSCANAPOPT=?`
Ответ	+WFSCANAPOPT:`<mask>` OK
Параметры	см. таблицу "Запрос"

Запрос
Сообщение	`AT+WFSTAIP?`
Ответ	+WFSTAIP=`<static>`,`<ip>`,`<mask>`,`<gateway>` OK
Ошибка	+WFSTAIP:`<error>` FAIL
Параметры	`<static>` 0 - использовать DHCP 1 - статический IP-адрес `<ip>` - IP-адрес станции `<mask>` - маска подсети `<gateway>` - адрес основного шлюза

Установка
Сообщение	`AT+WFSTAIP=` `<static>`[,`<ip>`,`<mask>`,`<gateway>`]
Ответ	OK
Ошибка	см. таблицу "Запрос"
Параметры	см. таблицу "Запрос"
Пример	`AT+WFSTAIP=0` `AT+WFSTAIP=1,"192.168.1.2","255.255.255.0","192.168.1.1"`

Запрос
Сообщение	`AT+WFSTAMAC?`
Ответ	+WFSTAMAC=`<mac>` OK
Ошибка	+WFSTAMAC:`<error>` FAIL
Параметры	`<mac>` - MAC-адрес станции

Установка
Сообщение	`AT+WFSTAMAC=` `<mac>`
Ответ	OK
Ошибка	см. таблицу "Запрос"
Параметры	см. таблицу "Запрос"
Пример	`AT+WFSTAMAC="11:22:33:44:55:66"`

Команда
Сообщение	`AT+WFCONNAP=` `<ssid>` [,`<password>`,`<mac>`]
Ответ	OK
Ошибка	+WFCONNAP:`<error>` FAIL
Параметры	`<ssid>` - название точки доступа `<password>` - пароль для авторизации `<mac>` - MAC-адрес
Пример	`AT+WFCONNAP="Ntc","12345678","11:22:33:44:55:66"`

Уведомление
Сообщение	`+STA_CONNECTED`

Уведомление
Сообщение	`+STA_DISCONNECTED:` `<reason>`
Параметры	`<reason>` - причина отключения (список значений)

Команда
Сообщение	`AT+WFDISCONNAP`
Ответ	OK
Ошибка	+WFDISCONNAP:`<error>` FAIL

Запрос
Сообщение	`AT+WFAPIP?`
Ответ	+WFAPIP=`<ip>`,`<mask>` OK
Ошибка	+WFAPIP:`<error>` FAIL
Параметры	`<ip>` - адрес основного шлюза `<mask>` - маска подсети

Установка
Сообщение	`AT+WFAPIP=` `<ip>`[,`<mask>`]
Ответ	OK
Ошибка	см. таблицу "Запрос"
Параметры	см. таблицу "Запрос"
Пример	`AT+WFAPIP="192.168.1.1","255.255.255.0"`

Запрос
Сообщение	`AT+WFAPMAC?`
Ответ	+WFAPMAC=`<mac>` OK
Ошибка	+WFAPMAC:`<error>` FAIL
Параметры	`<mac>` - MAC-адрес точки доступа

Установка
Сообщение	`AT+WFAPMAC=` `<mac>`
Ответ	OK
Ошибка	см. таблицу "Запрос"
Параметры	см. таблицу "Запрос"
Пример	`AT+WFAPMAC="11:22:33:44:55:66"`

Команда
Сообщение	`AT+WFAPCONF=` `<ssid>` [,`<password>`,`<channel>`,`<auth>`,`<max_conn>`,`<hidden>`]
Ответ	OK
Ошибка	+WFAPCONF:`<error>` FAIL
Параметры	`<ssid>` - название `<password>` - пароль `<channel>` - канал 1 .. 13 - допустимые значения `<auth>` - тип авторизации (список значений) `<max_conn>` - максимальное количество станций (клиентов) `<hidden>` 0 - видимая точка доступа 1 - скрытая точка доступа
Пример	`AT+WFAPCONF="Ntc","12345678",1,1,5,0`

Команда
Сообщение	`AT+PING`=`<ip>`[,`<timeout>`,`<interval>`,`<data-size>`,`<count>`]
Ответ	+PING,`<n>`:`<result>` +PING:`<req>`,`<resp>`,`<full-time>` OK
Ошибка	+PING:`<error>` FAIL
Параметры	`<ip>` - IP-адрес `<timeout>` - таймаут на запрос (мс, по умолчанию 250) `<interval>` - интервал между запросами (мс, по умолчанию 250) `<data-size>` - размер данных (байт, по умолчанию 16) `<count>` - количество запросов (по умолчанию 4) `<n>` - номер запроса `<result>` - результат: время ответа или таймаут `<req>` - количество запросов `<resp>` - количество ответов `<full-time>` - общее время
Пример	`AT+PING="192.168.1.1"`

Команда
Сообщение	`AT+DNS`=`<domain>`
Ответ	+DNS:`<ip>` OK
Ошибка	+DNS:`<error>` FAIL
Параметры	`<domain>` - доменное имя `<ip>` - IP-адрес
Пример	`AT+DNS="ya.ru"`

Команда
Сообщение	`AT+UDPOPEN`[=`<src-port>`,`<dst-addr>`,`<dst-port>`,`<index>`]
Ответ	+UDPOPEN:`<index>` OK
Ошибка	+UDPOPEN:`<error>` FAIL
Параметры	`<src-port>` - исходящий порт (если не указан, то присваивается автоматически) `<dst-addr>` - DNS/IP-адрес получателя `<dst-port>` - порт получателя `<index>` - номер сокета (если не указан, то будет назначен автоматически)
Пример	`AT+UDPOPEN` `AT+UDPOPEN=,"example.com",12345`

Команда
Сообщение	`AT+TCPCONN`=`<dst-addr>`,`<port>`[,`<index>`]
Ответ	+TCPCONN:`<index>` OK
Ошибка	+TCPCONN:`<error>` FAIL
Параметры	`<dst-addr>` - целевой DNS/IP-адрес `<port>` - целевой порт `<index>` - номер сокета (если не указан, то будет назначен автоматически)
Пример	`AT+TCPCONN="192.168.1.100",12345`

Уведомление
Сообщение	`+CONNECTED`,`<index>`
Параметры	`<index>` - номер сокета

Уведомление
Сообщение	`+DISCONNECTED`,`<index>`
Параметры	`<index>` - номер сокета

Команда
Сообщение	`AT+TCPLISTEN`=`<port>`[,`<conn-count>`,`<index>`]
Ответ	+TCPLISTEN:`<index>` OK
Ошибка	+TCPLISTEN:`<error>` FAIL
Параметры	`<port>` - порт `<conn-count>` - максимальное число подключений `<index>` - номер сокета (если не указан, то будет назначен автоматически)
Пример	`AT+TCPLISTEN=12345`

Команда
Сообщение	`AT+CLOSE`=`<index>`
Ответ	OK
Ошибка	+CLOSE:`<error>` FAIL
Параметры	`<index>` - номер сокета
Пример	`AT+CLOSE=0`

Команда
Сообщение	`AT+WRITE`=`<index>`,`<data>`[,`<dst-addr>`,`<port>`]
Ответ	OK
Ошибка	+WRITE:`<error>` FAIL
Параметры	`<index>` - номер сокета `<data>` - данные в текстовом или HEX-формате: HEX-формат - по два символа на один байт Текст - печатный текст, заключенный в кавычки Только для UDP-сокета: `dst-addr` - DNS/IP-адрес назначения `port` - порт назначения. Можно не указывать, если параметры были указаны при открытии, в предыдущей отправке данных или уже были приняты данные от исходящего соединения
Пример	`AT+WRITE=0,3031323334` `AT+WRITE=0,"01234"`

Команда
Сообщение	`AT+WRITEB`=`<index>`,`<size>`[,`<dst-addr>`,`<port>`]`<CRLF>` `<BIN>`
Ответ	OK
Ошибка	+WRITEB:`<error>` FAIL
Параметры	`<index>` - номер сокета `<size>` - размер данных `<CRLF>` - Разделитель текстовой и бинарной части сообщения (последовательность байт `0x0D`, `0x0A`) `<BIN>` - данные в BIN-формате Только для UDP-сокета: `dst-addr` - DNS/IP-адрес назначения `port` - порт назначения. Можно не указывать, если параметры были указаны при открытии, в предыдущей отправке данных или уже были приняты данные от исходящего соединения

Запрос
Сообщение	`AT+DATAMODE?`
Ответ	+DATAMODE=`<data-mode>` OK
Параметры	`<data-mode>` - режим приёма данных: 0 - Автоматический выбор, на основе последнего использования команд отправки данных (`AT+WRITE` - HEX или `AT+WRITEB` - BIN). По умолчанию используется HEX формат. 1 - Приём данных в формате HEX (уведомление `+READ`) 2 - Приём данных в формате BIN (уведомление `+READB`)

Установка
Сообщение	`AT+DATAMODE=` `<data-mode>`
Ответ	OK
Ошибка	+DATAMODE:`<error>` FAIL
Параметры	см. таблицу "Запрос"
Пример	`AT+DATAMODE=1`

Уведомление
Сообщение	`+READ`,`<index>`[,`<addr>`,`<port>`]:`<size>`,`<data>`
Параметры	`<index>` - номер сокета `<addr>` - DNS/IP-адрес отправителя (только если UDP сокет) `<port>` - порт отправителя (только если UDP сокет) `<size>` - размер данных `<data>` - данные в HEX формате (по два символа на один байт)

Уведомление
Сообщение	`+READB`,`<index>`[,`<addr>`,`<port>`]:`<size>` `<CRLF>` `<BIN>`
Параметры	`<index>` - номер сокета `<addr>` - DNS/IP-адрес отправителя (только если UDP сокет) `<port>` - порт отправителя (только если UDP сокет) `<size>` - размер данных `<CRLF>` - Разделитель текстовой и бинарной части сообщения (последовательность байт `0x0D`, `0x0A`) `<BIN>` - данные в BIN формате

Уведомление
Сообщение	`+CLOSED`,`<index>`
Параметры	`<index>` - номер сокета

Команда
Сообщение	`AT+SSTAT`
Ответ	`+SSTAT`:`<index>`,`<type>`,`<local-port>`[,`<remote-ip>`,`<remote-port>`] OK
Параметры	`<index>` - номер сокета `<type>` - тип сокета: 1 - UDP 2 - TCP сервер 3 - TCP исходящее клиентское соединение 4 - TCP входящее клиентское соединение `<local-port>` - локальный порт `<remote-ip>` - удалённый IP-адрес `<remote-port>` - удалённый порт

Команда
Сообщение	`AT+FWINFO`
Ответ	`+FWINFO`:`<index>`,`<id>`,`<app-name>`,`<app-version>`,`<app-date>`,`<active>` OK
Параметры	`<index>` - номер прошивки `<id>` - идентификатор прошивки `<app-name>` - название прошивки `<app-version>` - версия прошивки `<app-date>` - дата выпуска прошивки `<active>` - работает в данный момент

Команда
Сообщение	`AT+FWSEL`=`<index>`
Ответ	OK
Ошибка	+FWSEL:`<error>` FAIL
Параметры	`<index>` - номер прошивки

Команда
Сообщение	`AT+FWWRITE`=`<id>`,`<address>`,`<data>`
Ответ	OK
Ошибка	+FWWRITE:`<error>` FAIL
Параметры	`<id>` - идентификатор прошивки, для основной прошивки равен 0 (можно не указывать) `<address>` - адрес (смещение) `<data>` - данные в HEX формате (по два символа на один байт)

Команда
Сообщение	`AT+FWWRITEB`=`<id>`,`<address>`,`<data-size>` `<CRLF>` `<BIN>`
Ответ	OK
Ошибка	+FWWRITEB:`<error>` FAIL
Параметры	`<id>` - идентификатор прошивки, для основной прошивки равен 0 (можно не указывать) `<address>` - адрес (смещение) `<data-size>` - размер данных `<CRLF>` - Разделитель текстовой и бинарной части сообщения (последовательность байт `0x0D`, `0x0A`) `<BIN>` - данные в BIN

Команда
Сообщение	`AT+FWUPDATE`[=`<id>`,`<size>`,`<crc>`]
Ответ	OK
Ошибка	+FWUPDATE:`<error>` FAIL
Параметры	`<id>` - идентификатор прошивки `<size>` - размер записанного файла прошивки `<crc>` - контрольная сумма прошивки

Значение	Описание
`-1`	Общая ошибка
`1`	Недостаточно памяти
`2`	Недопустимый аргумент
`3`	Недопустимое состояние
`4`	Недопустимый размер
`5`	Запрашиваемый ресурс не найден
`6`	Операция или функция не поддерживается
`7`	Истекло время ожидания операции
`8`	Получен некорректный ответ
`9`	Неверная CRC или контрольная сумма
`10`	Некорректная версия
`11`	Недопустимый MAC-адрес
`12`	Операция не завершена полностью
`13`	Операция не разрешена
`21`	Wi-Fi не был инициализирован
`22`	Wi-Fi не был запущен
`23`	Wi-Fi не был остановлен
`24`	Ошибка Wi-Fi
`25`	Ошибка режима Wi-Fi
`26`	Ошибка внутреннего состояния Wi-Fi
`27`	Ошибка внутреннего блока управления станции или точки доступа
`28`	Ошибка внутреннего модуля NVS Wi-Fi
`29`	Недопустимый MAC-адрес
`30`	Недопустимый SSID
`31`	Недопустимый пароль
`32`	Ошибка таймаута
`33`	Wi-Fi в режиме сна (RF выключен), и пробуждение не удалось
`34`	Вызывающий поток был бы заблокирован
`35`	Станция все еще в состоянии отключения
`38`	Не удалось отправить событие в задачу Wi-Fi
`39`	Недопустимое состояние Wi-Fi
`40`	Возвращается, когда Wi-Fi останавливается
`41`	Wi-Fi соединение не ассоциировано
`42`	Передача Wi-Fi запрещена
`43`	Нет доступного ID потока
`44`	Таймаут приема ответа на настройку TWT
`45`	Ошибка отправки кадра настройки TWT
`46`	Запрос настройки TWT отклонен точкой доступа
`47`	Кадр отброшен
`48`	Операция сканирования в процессе выполнения

Значение	Описание
`0`	open
`1`	WEP
`2`	WPA_PSK
`3`	WPA2_PSK
`4`	WPA_WPA2_PSK
`5`	Wi-Fi EAP security
`6`	Wi-Fi EAP security
`7`	WPA3_PSK
`8`	WPA2_WPA3_PSK
`9`	WAPI_PSK
`10`	OWE
`11`	WPA3_ENT_SUITE_B_192_BIT
`12`	WIFI_AUTH_WPA3_PSK
`13`	WIFI_AUTH_WPA3_PSK
`14`	DPP
`15`	WPA3-Enterprise Only
`16`	WPA3-Enterprise Transition

Значение	Описание
`1`	Неизвестна
`2`	Истек срок аутентификации
`3`	Деаутентификация из-за выхода из сети
`4`	Разрыв связи из-за неактивности
`5`	Слишком много подключенных станций
`6`	Получен кадр класса 2 от неаутентифицированной STA
`7`	Получен кадр класса 3 от непривязанной STA
`8`	Разрыв связи из-за выхода из сети
`9`	Ассоциация без аутентификации
`10`	Разрыв связи из-за низкой мощности
`11`	Разрыв связи из-за неподдерживаемого канала
`12`	Разрыв связи из-за перехода BSS
`13`	Некорректный информационный элемент (IE)
`14`	Ошибка проверки MIC
`15`	Таймаут 4-этапного рукопожатия
`16`	Таймаут обновления группового ключа
`17`	Различие IE в 4-этапном рукопожатии
`18`	Недопустимый групповой шифр
`19`	Недопустимый парный шифр
`20`	Недопустимый AKMP
`21`	Неподдерживаемая версия RSN IE
`22`	Некорректные возможности RSN IE
`23`	Ошибка аутентификации 802.1X
`24`	Отклоненный набор шифров
`25`	TDLS-узел недоступен
`26`	Неуказанная ошибка TDLS
`27`	SSP запросил разрыв связи
`28`	Отсутствует соглашение о роуминге SSP
`29`	Плохой шифр или AKM
`30`	Нет авторизации в этом местоположении
`31`	Изменение сервиса исключает TS
`32`	Неуказанная причина QoS
`33`	Недостаточно пропускной способности
`34`	Отсутствуют подтверждения (ACK)
`35`	Превышен TXOP
`36`	Станция покидает сеть
`37`	Конец блочного подтверждения (BA)
`38`	Неизвестное блочное подтверждение (BA)
`39`	Таймаут
`46`	Разрыв связи инициирован узлом
`47`	Разрыв связи инициирован точкой доступа
`48`	Некорректное количество FT-кадров
`49`	Некорректный PMKID
`50`	Некорректный MDE
`51`	Некорректный FTE
`67`	Ошибка установки линии передачи
`68`	Альтернативный канал занят
`200`	Таймаут маячковых сигналов (Beacon)
`201`	Точка доступа не найдена
`202`	Ошибка аутентификации
`203`	Ошибка ассоциации
`204`	Таймаут рукопожатия
`205`	Ошибка подключения
`206`	Сброс TSF точки доступа
`207`	Роуминг
`208`	Слишком долгое время возврата ассоциации
`209`	Таймаут запроса SA
`210`	Не найдена точка доступа с совместимой защитой
`211`	Не найдена точка доступа в пределах порога аутентификации
`212`	Не найдена точка доступа в пределах порога RSSI

Значение	Описание
`0`	не используется
`1`	WEP40
`2`	WEP104
`3`	TKIP
`4`	CCMP
`5`	TKIP and CCMP
`6`	AES-CMAC-128
`7`	SMS4
`8`	GCMP
`9`	GCMP-256
`10`	AES-GMAC-128
`11`	AES-GMAC-256

¶ Команды

¶ +STARTED

¶ AT

¶ ATE

¶ AT+VERSION

¶ Пример использования

¶ AT+UID

¶ AT+RESET

¶ AT+SLEEP

¶ AT+WFMODE

¶ AT+WFSCANAP

¶ Пример сканирования

¶ AT+WFSCANAPOPT

¶ AT+WFSTAIP

¶ AT+WFSTAMAC

¶ AT+WFCONNAP

¶ +STA_CONNECTED

¶ +STA_DISCONNECTED

¶ AT+WFDISCONNAP

¶ AT+WFAPIP

¶ AT+WFAPMAC

¶ AT+WFAPCONF

¶ AT+PING

¶ AT+DNS

¶ AT+UDPOPEN

¶ AT+TCPCONN

¶ +CONNECTED

¶ +DISCONNECTED

¶ AT+TCPLISTEN

¶ AT+CLOSE

¶ AT+WRITE

¶ Пример использования

¶ AT+WRITEB

¶ Пример использования

¶ AT+DATAMODE

¶ +READ

¶ +READB

¶ +CLOSED

¶ AT+SSTAT

¶ Пример использования

¶ AT+FWINFO

¶ AT+FWSEL

¶ AT+FWWRITE

¶ AT+FWWRITEB

¶ AT+FWUPDATE

¶ Дополнительно

¶ Коды ошибок

¶ Типы авторизаций

¶ Типы шифров

¶ Причины отключения