Система AT команд версии V2.0 для ESP8266 и ESP32

By On · Add Comment

Появление нового модуля на базе ESP32 заставило систематизировать систему AT команд, а так же систему обновления и для модулей на базе ESP8266.

Начиная с версии v2.0 в ESP8266 внедряется прошивка AT на основе нового стиля IDF ESP8266_RTOS_SDK, а так же используются разные порты для UART для обновления и для работы с AT командами. Некоторые из команд AT отличаются от старой ESP8266 NonOS AT.
Учитывая, что эти серьезные изменения могут оказать существенное влияние на существующие проекты, рекомендуется, чтобы эта версия использовалась только для реализации новых проектов, а не использовалась в качестве обновления для любых существующих проектов массового производства.
Для обновления ESP8266 AT версии 2,0 можно, также как и для ESP32, загрузить двоичный файл находящийся в папке в ESP8266-IDF-AT/factory, c адреса 0x00000.
Для обновления используется выводы порта UART0 выводы IO1 и IO2, а для работы с AT командами (в IDF ESP8266_RTOS_SDK), необходимо использовать выводы:

GPIO13 – это RXD
GPIO15 – это TXD
GPIO1 – это RTS (необязательно)
GPIO3 – это CTS (необязательно)

Производитель будет поддерживать старую ESP8266 NonOS AT (только для исправление ошибок) в течение определенного, но длительного срока, но для новых изделий рекомендуется использовать переход новую версию ESP8266 IDF AT 2.0.

От себя добавлю переходить на версию 2.0 необходимо работает она значительно шустрее.

Первое отличие коснется команд в имени которых были части _CUR  и _DEF,  хотя и останутся некоторые команды с этими расширениями.

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

 

Для тестирования версии прошивки IDF при подключении к различным ЮСБ-мостам наличие резистора R8 обязательно его сопротивление может быть (для скорости 115200) до 1 КОм. Этот резистор необходим, чтобы при подачи питания на ESP загрузчик модуля разобрался с каким портом работать. Если не сможет в момент теста на выводе IO15 установить низкий уровень, он останеться в режиме бутлоадера. В рабочем изделии при старте необходимо предусмотреть наличие низкого уровня на порту МК в момент старта, для правильного запуска радио-модуля.

Значок
ESP8266 AT V2.0 и ESP32 - Схема в формате pdf 144 downloads 337.31 KB

Ссылки на доп информацию https://github.com/espressif/esp32-at/tree/master/docs

После обновления модуля мы получим сообщение о версии

 

 

ESP AT Commands Set

Вот список команд AT. Некоторые из команд AT могут работать только на ESP32, который будет помечен как [ESP32 Only]; другие могут работать как на ESP8266, так и на ESP32.

Ссылка на оригинал https://github.com/espressif/esp-at/blob/master/docs/ESP_AT_Commands_Set.md

PS Как сгенерировать прошивку ESP8266 AT .

1. Список команд AT

1.1 Базовый список AT-команд

  • AT : Тесты при запуске.
  • AT + RST : перезапуск модуля.
  • AT + GMR : проверяет информацию о версии.
  • AT+GSLP : Enters Deep-sleep mode.
  • ATE : Настраивает эхо-команды AT-команд.
  • AT + RESTORE : восстановление заводских настроек модуля по умолчанию.
  • AT + UART_CUR : текущая конфигурация UART.
  • AT + UART_DEF : конфигурация UART по умолчанию, сохраненная во флэш-памяти.
  • AT + SLEEP : установка режима ожидания.
  • AT + SYSRAM : проверяет оставшееся место в оперативной памяти.
  • AT + SYSMSG : установить формат сообщения.
  • AT + RFPOWER : установка радиочастотной мощности передачи .
  • [Только ESP32] AT + SYSFLASH : установка пользовательских разделов во Flash.
  • [Только ESP32] AT + FS : Операции с файловой системой .
  • AT + SYSROLLBACK : откат к предыдущей прошивке.
  • AT + SYSTIMESTAMP : установить местное время.
  • AT + SYSLOG : включить или отключить запрос кода ошибки AT.
  • AT + SYSLSPCFG : Конфигурируйте источник пробуждения при легком сне.
  • AT + SYSLSP : переход в режим ожидания.

1.2 Список команд Wi-Fi AT

  • AT + CWMODE : Устанавливает режим Wi-Fi (STA / AP / STA + AP).
  • AT + CWJAP : подключается к точке доступа.
  • AT + CWLAPOPT : Устанавливает конфигурацию команды AT + CWLAP.
  • AT + CWLAP : список доступных точек доступа.
  • AT + CWQAP : отключается от точки доступа.
  • AT + CWSAP : Устанавливает конфигурацию ESP32 SoftAP.
  • AT + CWLIF : получает IP-адрес станции, к которой подключена EAP32 SoftAP.
  • AT + CWDHCP : включает / отключает DHCP.
  • AT + CWDHCPS : устанавливает диапазон IP-адресов DHCP-сервера ESP32 SoftAP. Сохраняет настройку во вспышке.
  • AT + CWAUTOCONN : автоматически подключается к точке доступа при включении питания.
  • AT + CIPSTAMAC : Устанавливает MAC-адрес станции ESP32.
  • AT + CIPAPMAC : устанавливает MAC-адрес ESP32 SoftAP.
  • AT + CIPSTA : устанавливает IP-адрес станции ESP32.
  • AT + CIPAP : Устанавливает IP-адрес ESP32 SoftAP.
  • AT + CWSTARTSMART : запускает SmartConfig.
  • AT + CWSTOPSMART : останавливает SmartConfig.
  • AT + WPS : включает функцию WPS.
  • AT + MDNS : настраивает функцию MDNS
  • [Только ESP32] AT + CWJEAP : подключается к точке доступа WPA2 Enterprise.
  • AT + CWHOSTNAME : настраивает имя станции ESP

1.3 Список AT-команд, связанных с TCP / IP

  • AT+CIPSTATUS : Gets the connection status.
  • AT + CIPDOMAIN : функция разрешения доменных имен.
  • AT + CIPSTART : устанавливает TCP-соединение, UDP-передачу или SSL-соединение.
  • AT+CIPSEND : Sends data.
  • AT + CIPSENDEX : отправляет данные, когда длина данных длина или когда в данных появляется \ 0.
  • AT + CIPCLOSE : закрывает соединение TCP/UDP/SSL.
  • AT + CIFSR : получает локальный IP-адрес.
  • AT + CIPMUX : настройка режима нескольких соединений.
  • AT + CIPSERVER : Deletes/Creates TCP or SSL server.
  • AT + CIPSERVERMAXCONN : установите максимальное количество соединений, разрешенных сервером.
  • AT + CIPMODE : настройка режима передачи.
  • AT + SAVETRANSLINK : сохраняет прозрачный канал передачи во флэш-памяти.
  • AT + CIPSTO : устанавливает время ожидания, когда ESP32 работает как сервер TCP.
  • AT + CIPSNTPCFG : Настраивает временную область и SNTP-сервер.
  • AT + CIPSNTPTIME : Запрашивает время SNTP.
  • AT + CIUPDATE : обновление программного обеспечения через Wi-Fi.
  • AT + CIPDINFO : показывает удаленный IP и удаленный порт с + IPD.
  • AT + CIPSSLCCONF : настройка клиента SSL.
  • AT + CIPRECONNINTV : установите прозрачный интервал автоматического подключения Wi-Fi.
  • AT + CIPRECVMODE : установить режим приема сокетов.
  • AT + CIPRECVDATA : получение данных сокета в режиме пассивного приема.
  • AT + CIPRECVLEN : Получить длину данных сокета в режиме пассивного приема.
  • AT + PING : пинг пакеты
  • AT + CIPDNS : настраивает систему доменных имен. Конфигурация будет сохранена во флэш-памяти.

1.4 [Только для ESP32] Список команд BLE AT

Загрузить BLE Spec (ESP32 поддерживает Core версии 4.2)

  • [Только ESP32] AT + BLEINIT : инициализация Bluetooth с низким энергопотреблением (BLE)
  • [Только ESP32] AT + BLEADDR : Устанавливает адрес устройства BLE
  • [Только ESP32] AT + BLENAME : устанавливает имя устройства BLE
  • [Только ESP32] AT + BLESCANPARAM : Устанавливает параметры сканирования BLE
  • [Только ESP32] AT + BLESCAN : включает сканирование BLE
  • [Только ESP32] AT + BLESCANRSPDATA : Устанавливает реакцию сканирования BLE
  • [Только ESP32] AT + BLEADVPARAM : устанавливает параметры рекламы BLE
  • [Только ESP32] AT + BLEADVDATA : Устанавливает рекламные данные BLE
  • [Только ESP32] AT + BLEADVSTART : запуск рекламы BLE
  • [Только ESP32] AT + BLEADVSTOP : останавливает рекламу BLE
  • [Только ESP32] AT + BLECONN : устанавливает соединение BLE
  • [Только ESP32] AT + BLEDISCONN : Завершает соединение BLE
  • [Только ESP32] AT+BLEDATALEN : Sets BLE data length
  • [Только ESP32] AT + BLECFGMTU : устанавливает длину BLE MTU
  • [Только ESP32] AT + BLEGATTSSRVCRE : Сервер общих атрибутов (GATTS) создает службы
  • [Только ESP32] AT + BLEGATTSSRVSTART : GATTS запускает службы
  • [Только ESP32] AT + BLEGATTSSRV : GATTS обнаруживает услуги
  • [Только ESP32] AT + BLEGATTSCHAR : GATTS обнаруживает характеристики
  • [Только ESP32] AT + BLEGATTSNTFY : GATTS уведомляет о характеристиках
  • [Только ESP32] AT+BLEGATTSIND : GATTS indicates characteristics
  • [Только ESP32] AT + BLEGATTSSETATTR : GATTS устанавливает атрибуты
  • [Только ESP32] AT + BLEGATTCPRIMSRV : Клиент общих атрибутов (GATTC) обнаруживает первичные службы
  • [Только ESP32] AT + BLEGATTCINCLSRV : GATTS обнаруживает включенные услуги
  • [Только ESP32] AT + BLEGATTCCHAR : GATTC обнаруживает характеристики
  • [Только ESP32] AT + BLEGATTCRD : GATTC считывает характеристики
  • [Только ESP32] AT + BLEGATTCWR : GATTC записывает характеристики
  • [Только ESP32] AT + BLESPPCFG : Устанавливает параметры BLE spp
  • [Только ESP32] AT+BLESPP : Enter BLE spp mode
  • [Только ESP32] AT + BLESECPARAM : установить параметры шифрования BLE
  • [Только ESP32] AT+BLEENC : Initiate BLE encryption request
  • [Только ESP32] AT + BLEENCRSP : Предоставить доступ для запроса безопасности.
  • [Только ESP32] AT + BLEKEYREPLY : Ответьте значение ключа равноправному устройству на этапе соединения lagecy.
  • [Только ESP32] AT + BLECONFREPLY : Ответьте значение comfirm одноранговому устройству на этапе соединения lagecy.
  • [Только ESP32] AT + BLEENCDEV : запрос списка устройств шифрования BLE
  • [Только ESP32] AT + BLEENCCLEAR : очистить список устройств шифрования BLE
  • [Только ESP32] AT + BLESETKEY : Установить BLE статическую пару ключей
  • [Только ESP32] AT+BLEHIDINIT : BLE HID device profile initialization
  • [Только ESP32] AT + BLEHIDKB : BLE HID Информация о клавиатуре отправлена
  • [Только ESP32] AT + BLEHIDMUS : BLE HID информация о мышке отправлена
  • [Только ESP32] AT+BLEHIDCONSUMER : BLE HID consumer information send
  • [Только ESP32] BLE AT Примеры

1.5 [Только ESP32] Список команд ETH AT

  • [Только ESP32] AT + CIPETHMAC : Устанавливает MAC-адрес ESP32 Ethernet.
  • [Только ESP32] AT + CIPETH : Устанавливает IP-адрес ESP32 Ethernet.

1.6 [Только ESP32] Список команд BT AT

Скачать BlueTooth Spec (ESP32 поддерживает Core версии 4.2)

  • [Только ESP32] AT + BTINIT : Классическая инициализация Bluetooth
  • [Только ESP32] AT + BTNAME : устанавливает имя устройства BT
  • [Только ESP32] AT + BTSCANMODE : Устанавливает режим BT SCAN.
  • [Только ESP32] AT + BTSTARTDISC : Запустить обнаружение BT
  • [Только ESP32] AT + BTSPPINIT : инициализация классического Bluetooth SPP профиля
  • [Только ESP32] AT + BTSPPCONN : устанавливает соединение SPP
  • [Только ESP32] AT + BTSPPDISCONN : Завершает соединение SPP
  • [Только ESP32] AT + BTSPPSTART : запуск классического профиля Bluetooth SPP
  • [Только ESP32] AT + BTSPPSEND : отправка данных на удаленное устройство bt spp
  • [Только ESP32] AT + BTA2DPINIT : инициализация классического профиля Bluetooth A2DP
  • [Только ESP32] AT + BTA2DPCONN : устанавливает соединение A2DP
  • [Только ESP32] AT + BTA2DPDISCONN : Завершает соединение A2DP
  • [Только ESP32] AT + BTA2DPSRC : установить или запросить URL аудиофайла
  • [Только ESP32] AT + BTA2DPCTRL : управление воспроизведением аудио
  • [Только ESP32] AT + BTSECPARAM : установите и запросите параметры безопасности Classic Bluetooth
  • [Только ESP32] AT + BTKEYREPLY : введите ключ простой пары
  • [Только ESP32] AT + BTPINREPLY : введите PIN-код устаревшей пары
  • [Только ESP32] AT + BTSECCFM : Ответьте значение подтверждения на одноранговое устройство на этапе устаревшего соединения
  • [Только ESP32] AT + BTENCDEV : список устройств шифрования Query BT
  • [Только ESP32] AT + BTENCCLEAR : очистить список устройств шифрования BT

1.7 [Только ESP32] Список команд MQTT AT

1.8 HTTP AT Список команд

2. Основные AT-команды

2,1 АТ—Tests AT Startup

Выполнить команду:

Отклик:

2.2 AT + RST – перезапускает модуль

Выполнить команду:

Отклик:

2.3 AT+GMR—Checks Version Information

Выполнить команду:

Response:

Параметры:

  • Информация о версии AT : информация о версии AT.
  • Информация о версии SDK : информация о версии SDK.
  • время компиляции : продолжительность времени компиляции BIN.

2.4 AT+GSLP—Enters Deep-sleep Mode

Установить команду:

Отклик:

Параметры:

  • time: the duration of ESP32’s sleep. Unit: ms.
    ESP32 will wake up after Deep-sleep for as many milliseconds (ms) as time indicates.

2.5 ATE—AT Commands Echoing

Выполнить команду:

Response:

Параметры:

  • ATE0 : выключает эхо.
  • ATE1 : включает эхо.

2.6 AT+RESTORE—Restores the Factory Default Settings

Выполнить команду:

Response:

Примечание:

  • The execution of this command will reset all parameters saved in flash, and restore the factory default settings of the module.
  • Чип будет перезапущен при выполнении этой команды.

2.7 AT + UART_CUR – текущая конфигурация UART, не сохраненная во Flash

Команда запроса:

Отклик:

Note:

  • Команда AT+UART_CUR?вернет фактическое значение параметров конфигурации UART, которое может иметь допустимые ошибки по сравнению с установленным значением из-за деления часов.

Set Command:

Отклик:

Параметры:

  • baudrate: UART baud rate
  • databits : биты данных
    • 5: 5-битные данные
    • 6: 6-bit data
    • 7: 7-битные данные
    • 8: 8-битные данные
  • stopbits: stop bits
    • Стоповый бит 1: 1
    • 2: 1,5-битный стоп-бит
    • 3: 2-битный стоп-бит
  • четность : бит четности
    • 0: нет
    • 1: Нечетный
    • 2: даже
  • управление потоком : управление потоком
    • 0: управление потоком не включено
    • 1: включить RTS
    • 2: включить CTS
    • 3: включить RTS и CTS

Примечания:

  • Изменения конфигурации НЕ будут сохранены во флэш-памяти.
  • Использование управления потоком требует поддержки аппаратного обеспечения:
    • IO15 – это UART0 CTS
    • IO14 – это UART0 RTS
  • Диапазон поддерживаемых скоростей передачи: 80 ~ 5000000.

Пример:

2.8 AT+UART_DEF—Default UART Configuration, Saved in Flash

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • скорость передачи : скорость передачи UART
  • databits : биты данных
    • 5: 5-битные данные
    • 6: 6-битные данные
    • 7: 7-bit data
    • 8: 8-битные данные
  • стопбиты : стоповые биты
    • Стоповый бит 1: 1
    • 2: 1,5-битный стоп-бит
    • 3: 2-битный стоп-бит
  • четность : бит четности
    • 0: нет
    • 1: Нечетный
    • 2: даже
  • управление потоком : управление потоком
    • 0: управление потоком не включено
    • 1: включить RTS
    • 2: включить CTS
    • 3: включить RTS и CTS

Примечания:

  • Изменения конфигурации будут сохранены в области NVS и будут действительны при повторном включении чипа.
  • Использование управления потоком требует поддержки аппаратного обеспечения:
    • IO15 – это UART0 CTS
    • IO14 – это UART0 RTS
  • Диапазон поддерживаемых скоростей передачи: 80 ~ 5000000.

Пример:

2.9 AT+SLEEP—Sets the Sleep Mode

Установить команду:

Отклик:

Параметры:

  • спящий режим :
    • 0: отключить спящий режим.
    • 1: режим ожидания модема.

Пример:

2.10 AT + SYSRAM – проверка оставшегося пространства оперативной памяти

Команда запроса:

Отклик:

Parameters:

  • оставшийся объем ОЗУ : оставшееся пространство ОЗУ, единица измерения: байт

Пример:

2.11 AT+SYSMSG—Control to use new or old information

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • состояние :
    • Бит 0: выйти из прозрачной передачи 0: выйти из прозрачной передачи без информации. 1: прекратить прозрачную передачу предоставит информацию.
    • Бит 1: Информация о соединении 0: Использовать старую информацию о соединении. 1: использовать новую информацию о соединении.

Примечания:

  • Изменения конфигурации будут сохранены в области NVS.
  • If set Bit0 to 1 will supply information “+QUITT” when quit transparent transmission.
  • Если бит 1 установлен на 1, это повлияет на информацию о команде AT+CIPSTARTиAT+CIPSERVER,
    • Вместо «XX, CONNECT» он будет выдавать «+ LINK_CONN: status_type, link_id, ip_type, terminal_type, remote_ip, remote_port, local_port». Пример:

    // Использовать новую информацию о соединении и выйти из прозрачной передачи нет информации AT + SYSMSG = 2

2.12 [Только ESP32] AT + SYSFLASH – установка пользовательских разделов во Flash

Команда запроса:

Response:

Установить команду:

Отклик:

Parameters:

  • operation:
    • 0: стереть сектор
    • 1: записать данные в пользовательский раздел
    • 2: read data from the user partition
  • раздел : имя пользовательского раздела
  • смещение : смещение пользовательского раздела
  • длина : длина данных
  • тип : тип пользовательского раздела
  • subtype : подтип пользовательского раздела
  • addr: address of user partition
  • размер : размер пользовательского раздела

Notes:

  • Необходимо загрузить at_customize.bin, чтобы можно было использовать соответствующие команды. Пожалуйста, обратитесь к ESP32_Customize_Partitions для более подробной информации.
  • Важные вещи, на которые следует обратить внимание при удалении пользовательских разделов:
    • При удалении целевого пользовательского раздела параметры полностью offsetи lengthмогут быть опущены. Например, команда AT+SYSFLASH=0,"ble_data"может стереть весь раздел пользователя ble_data.
    • Если параметры offsetи lengthне опущены при удалении пользовательского раздела, они должны быть выровнены по 4 КБ.
  • Введение в разделы содержится в таблицах разделов ESP-IDF .

Пример:

2.13 [Только ESP32] AT + FS – Операции файловой системы

Set Command:

Отклик:

Параметры:

  • type: only FATFS is currently supported
    • 0: FATFS
  • операция :
    • 0: удалить файл
    • 1: записать файл
    • 2: прочитать файл
    • 3: запросить размер файла
    • 4: список файлов в определенном каталоге, в настоящее время поддерживается только корневой каталог
  • смещение : смещение, только для операций записи и чтения
  • длина : длина данных, только для операций записи и чтения

Примечания:

  • Необходимо загрузить at_customize.bin, чтобы можно было использовать соответствующие команды. Определения пользовательских разделов находятся в esp-at / at_customize.csv. Пожалуйста, обратитесь к ESP32_Customize_Partitions для более подробной информации.
  • Если длина прочитанных данных больше, чем фактическая длина файла, будет возвращена только фактическая длина данных файла.

Example:

2.14 AT + RFPOWER -Установить мощность RF TX

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • wifi_power : диапазон [40, 82], единица измерения составляет 0,25 дБм, например, если значение равно 78, то максимальная мощность RF составляет 78 * 0,25 дБм = 19,5 дБм.
  • ble_adv_power : RF TX Мощность рекламы BLE, диапазон: [0, 7]
    • 0: 7dBm
    • 1: 4dBm
    • 2: 1dBm
    • 3: -2 дБм
    • 4: -5 дБм
    • 5: -8 дБм
    • 6: -11 дБм
    • 7: -14 дБм
  • ble_scan_power : мощность радиочастотной передачи сканирования BLE, диапазон: [0, 7], такой же, как ble_adv_power
  • ble_conn_power : мощность RF TX соединения BLE, диапазон: [0, 7], такой же, как ble_adv_power

Примечания: Поскольку мощность RF TX фактически разделена на несколько уровней, и каждый уровень имеет свой собственный диапазон значений, поэтому wifi_powerзапрашиваемое значение esp_wifi_get_max_tx_powerможет отличаться от значения, установленного параметром esp_wifi_set_max_tx_power. И значение запроса не будет больше установленного.

2.15 AT + SYSROLLBACK – откат к предыдущей прошивке

Выполнить команду:

Отклик:

Примечание:

  • Эта команда не будет обновляться через OTA, а только откатится на прошивку, которая находится в другом разделе ota.

2.16 AT + SYSTIMESTAMP —Установить метку местного времени.

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • Unix_timestamp : метка времени Unix, единица измерения – секунды.

Пример:

2.17 AT + SYSLOG : включить или отключить запрос кода ошибки AT.

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • статус :: включить или отключить
    • 0: отключить
    • 1: включить

Пример:
если включить подсказку с кодом ошибки AT:

Если отключить запрос кода ошибки AT:

2.18 AT + SYSLSP – ввод режима легкого сна (только поддержка ESP32)

Выполнить команду: AT + SYSLSP Ответ:

Пример:

2.19 AT + SYSLSPCFG —Настройка источника пробуждения при слабом сне (только поддержка ESP32)

Установить команду:

Отклик:

Параметры:

  • источник пробуждения :
    • 0: пробуждение по таймеру.
    • 1: пробуждение от уарта.
    • 2: пробуждение от GPIO.
  • param :
    • Если источником пробуждения является таймер, этот параметр – время до пробуждения, единицы измерения – миллисекунды.
    • Если источником пробуждения является UART. этот параметр номер Uart.
    • Если источником пробуждения является GPIO, параметром является номер ввода-вывода.
  • уровень пробуждения : используется только для GPIO, 0: низкий уровень, 1: высокий уровень.

Пример:

3 Wi-Fi AT команды

3.1 AT + CWMODE —Устанавливает режим Wi-Fi (Station / SoftAP / Station + SoftAP)

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • режим :
    • 0: нулевой режим, WiFi RF будет отключен
    • 1: режим станции
    • 2: режим SoftAP
    • 3: режим SoftAP + Station

Примечание:

  • Изменения конфигурации будут сохранены в области NVS.

Пример:

3.2 AT + CWJAP – подключается к точке доступа

Команда запроса:

Отклик:

Параметры:

  • ssid : строковый параметр, показывающий SSID точки доступа.
  • bssid : MAC-адрес точки доступа.
  • канал : канал
  • rssi : уровень сигнала

Установить команду:

Отклик:

или + CWJAP: ERROR Параметры:

  • SSID : идентификатор сети целевой AP.
    • Синтаксис escape-символов необходим, если SSID или пароль содержат какие-либо специальные символы, такие как, или «или \».
  • pwd : пароль, MAX: 64-байтовый ASCII.
  • [bssid] : MAC-адрес целевой точки доступа, используемый, когда несколько точек доступа имеют одинаковый SSID.
  • [pci_en] : включить аутентификацию PCI, которая отключит соединение OPEN и WEP AP.
  • [reconn] : включить переподключение Wi-Fi; по истечении времени ожидания маяка ESP32 автоматически переподключится.
  • код ошибки : (только для справки)
    • 1: время ожидания соединения.
    • 2: неверный пароль.
    • 3: не удается найти целевой AP.
    • 4: соединение не удалось.
    • другие: произошла неизвестная ошибка.

Примечание:

  • Изменения конфигурации будут сохранены в области NVS.
  • Эта команда требует, чтобы режим Station был активным.

Примеры:

3.3 AT + CWLAPOPT – устанавливает конфигурацию для команды AT + CWLAP

Установить команду:

Отклик:

Параметры:

  • sort_enable : определяет, будет ли результат команды AT + CWLAP отображаться в соответствии с RSSI:
    • 0: результат не упорядочен в соответствии с RSSI.
    • 1: результат упорядочен по RSSI.
  • маска : определяет параметры, показанные в результате AT+CWLAP;
    • 0 означает, что параметр не соответствует биту, а 1 означает его отображение.
    • бит 0: определяет, будет ли ecn отображаться в результате AT+CWLAP.
    • бит 1: определяет, будет ли ssid отображаться в результате AT+CWLAP.
    • бит 2: определяет, будет ли rssi отображаться в результате AT+CWLAP.
    • бит 3: определяет, будет ли mac отображаться в результате AT+CWLAP.
    • Бит 4: определяет, будет ли канал отображаться в результате AT+CWLAP.

Пример:

3,4 AT + CWLAP -Lists Доступные точки доступа

Установить команду:

Выполнить команду:

Отклик:

Параметры:

  • ecn : метод шифрования.
    • 0: ОТКРЫТО
    • 1: WEP
    • 2: WPA_PSK
    • 3: WPA2_PSK
    • 4: WPA_WPA2_PSK
    • 5: WPA2_Enterprise (AT пока не может подключиться к точке доступа WPA2_Enterprise.)
  • ssid : строковый параметр, SSID точки доступа.
  • rssi : уровень сигнала.
  • mac : строковый параметр, MAC-адрес точки доступа.
  • тип_сканирования : тип сканирования Wi-Fi, активный или пассивный.
    • 0: активное сканирование
    • 1: пассивное сканирование
  • scan_time_min : минимальное время активного сканирования на канал, единицы: миллисекунда, диапазон [0,1500], если тип сканирования пассивный, этот параметр недействителен.
  • scan_time_max : максимальное время активного сканирования на канал, единицы: миллисекунда, диапазон [0,1500]. если этот параметр равен нулю, встроенное ПО будет использовать время по умолчанию, тип активного сканирования – 120 мс, тип пассивного сканирования – 360 мс.

Примеры:

3.5 AT + CWQAP – отключение от точки доступа

Выполнить команду:

Отклик:

3.6 AT + CWSAP – Настройка EAP32 SoftAP

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • ssid : строковый параметр, SSID точки доступа.
  • pwd : строковый параметр, длина пароля: 8 ~ 64 байта ASCII.
  • канал : идентификатор канала.
  • ecn : метод шифрования; WEP не поддерживается.
    • 0: ОТКРЫТО
    • 2: WPA_PSK
    • 3: WPA2_PSK
    • 4: WPA_WPA2_PSK
  • [max conn] (необязательный параметр): максимальное количество станций, к которым может быть подключена ESP32 SoftAP; в пределах [1, 10].
  • [ssid hidden] (необязательный параметр):
    • 0: SSID транслируется. (настройка по умолчанию)
    • 1: SSID не транслируется.

Примечание:

  • Эта команда доступна только тогда, когда SoftAP активен.
  • Изменения конфигурации будут сохранены в области NVS.

Пример:

3.7 AT + CWLIF – IP станций, к которым подключена EAP32 SoftAP

Выполнить команду:

Отклик:

Параметры:

  • ip addr : IP-адрес станций, к которым подключен ESP32 SoftAP.
  • mac : MAC-адрес станций, к которым подключена ESP32 SoftAP.

Примечание:

  • Эта команда не может получить статический IP. Он работает только в том случае, если включены оба протокола DHCP ESP32 SoftAP и станции, к которой подключен ESP32.

3.8 AT + CWDHCP – включает / отключает DHCP

Команда запроса:

Ответ: состояние

Установить команду:

Отклик:

Параметры:

  • работа :
    • 0: отключить
    • 1: включить
  • режим :
    • Бит 0: станция DHCP
    • Бит 1: SoftAP DHCP
  • состояние :
    • DHCP отключен или включен?
    • Бит 0: – 0: DHCP станция отключена. 1: DHCP станция включена.
    • Бит 1: – 0: SoftAP DHCP отключена. 1: SoftAP DHCP включена.

Примечания:

  • Изменения конфигурации будут сохранены в области NVS.
  • Эта команда set взаимодействует с AT-командами, связанными со статическим IP-адресом (команды, связанные с AT + CIPSTA и AT + CIPAP):
    • Если DHCP включен, статический IP будет отключен;
    • Если статический IP включен, DHCP будет отключен;
    • Будь то DHCP или статический IP, который включен, зависит от последней конфигурации.

Примеры:

3.9 AT + CWDHCPS —Устанавливает IP-адрес, выделенный ESP32 SoftAP DHCP (конфигурация сохраняется во Flash.)

Команда запроса:

Отклик:

Установить команду:

Отклик:

Parameters:

  • enable :
    • 0: отключить настройки и использовать диапазон IP-адресов по умолчанию.
    • 1: Включите настройку диапазона IP-адресов, и должны быть установлены параметры ниже.
  • время аренды : время аренды, единица измерения: минута, диапазон [1, 2880].
  • start IP : начальный IP-адрес диапазона IP-адресов, который можно получить с DHCP-сервера ESP32 SoftAP.
  • end IP : конечный IP-адрес диапазона IP-адресов, который можно получить с DHCP-сервера ESP32 SoftAP.

Notes:

  • Изменения конфигурации будут сохранены в области NVS.
  • Эта команда AT включена, когда ESP8266 работает как SoftAP, и когда включен DHCP.
  • IP-адрес должен находиться в том же сегменте сети, что и IP-адрес ESP32 SoftAP.

Примеры:

3.10 AT + CWAUTOCONN – автоматически подключается к точке доступа или нет

Установить команду:

Отклик:

Parameters:

  • enable :
    • 0: НЕ подключается автоматически к точке доступа при включении питания.
    • 1: автоматически подключается к точке доступа при включении питания.

Note:

  • Изменения конфигурации будут сохранены в области NVS.
  • Станция ESP32 подключается к точке доступа автоматически при включении по умолчанию.

Пример:

3.11 AT + CIPSTAMAC – устанавливает MAC-адрес станции ESP32

Команда запроса:

Отклик:

Установить команду:

Response:

Параметры:

  • mac : строковый параметр, MAC-адрес станции ESP8266.

Notes:

  • Изменения конфигурации будут сохранены в области NVS.
  • MAC-адрес ESP32 SoftAP отличается от MAC-адреса станции ESP32. Пожалуйста, убедитесь, что вы не установили одинаковый MAC-адрес для них обоих.
  • Бит 0 MAC-адреса ESP32 НЕ МОЖЕТ быть равен 1.
    • Например, MAC-адрес может быть «1a:…», но не «15:…».
  • FF: FF: FF: FF: FF: FF и 00: 00: 00: 00: 00: 00 являются недействительными MAC и не могут быть установлены.

Пример:

3.12 AT+CIPAPMAC—Sets the MAC Address of the ESP32 SoftAP

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • mac : строковый параметр, MAC-адрес EAP8266 SoftAP.

Примечания:

  • Изменения конфигурации будут сохранены в области NVS.
  • MAC-адрес ESP32 SoftAP отличается от MAC-адреса станции ESP32. Пожалуйста, убедитесь, что вы не установили одинаковый MAC-адрес для них обоих.
  • Бит 0 MAC-адреса ESP32 НЕ МОЖЕТ быть равен 1.
    • Например, MAC-адрес может быть «18:…», но не «15:…».
  • FF:FF:FF:FF:FF:FF and 00:00:00:00:00:00 are invalid MAC and cannot be set.

Пример:

3.13 AT+CIPSTA—Sets the IP Address of the ESP32 Station

Query Command:

Отклик:

Установить команду:

Отклик:

Параметры:

  • ip: string parameter, the IP address of the ESP32 Station.
  • [шлюз] : шлюз.
  • [Маска подсети]: netmask.

Примечания:

  • Изменения конфигурации будут сохранены в области NVS.
  • Команда set взаимодействует с командами AT, связанными с DHCP (команды, связанные с AT + CWDHCP):
    • Если статический IP включен, DHCP будет отключен;
    • If DHCP is enabled, static IP will be disabled;
    • Будь то DHCP или статический IP, который включен, зависит от последней конфигурации.

Пример:

3.14 AT + CIPAP – устанавливает IP-адрес EAP32 SoftAP

Команда запроса:

Отклик:

Set Command:

Отклик:

Параметры:

  • ip : строковый параметр, IP-адрес ESP32 SoftAP.
  • [шлюз] : шлюз.
  • [маска сети] : маска сети.

Notes:

  • Изменения конфигурации будут сохранены в области NVS.
  • Команда set взаимодействует с командами AT, связанными с DHCP (команды, связанные с AT + CWDHCP):
    • Если статический IP включен, DHCP будет отключен;
    • Если DHCP включен, статический IP будет отключен;
    • Будь то DHCP или статический IP, который включен, зависит от последней конфигурации.

Пример:

3.15 AT+CWSTARTSMART—Starts SmartConfig

Выполнить команду:

Установить команду:

Response:

Параметры:

  • тип :
    • 1: ESP-TOUCH
    • 2: AirKiss
    • 3: ESP-TOUCH + AirKiss

Примечания:

  • For details on SmartConfig please see ESP-TOUCH User Guide.
  • SmartConfig доступен только в режиме станции ESP32.
  • Сообщение Smart get Wi-Fi infoозначает, что SmartConfig успешно получил информацию AP. ESP32 попытается подключиться к целевой точке доступа.
  • Сообщение Smartconfig connected Wi-Fiраспечатывается, если соединение установлено успешно.
  • Используйте команду, AT+CWSTOPSMARTчтобы остановить SmartConfig перед выполнением других команд. Пожалуйста, убедитесь, что вы не выполняете другие команды во время SmartConfig.

Пример:

3.16 AT + CWSTOPSMART—Stops SmartConfig

Выполнить команду:

Отклик:

Примечание:

  • Независимо от того, успешно ли выполняется SmartConfig или нет, перед выполнением любых других AT-команд всегда звоните, AT+CWSTOPSMARTчтобы освободить внутреннюю память, занятую SmartConfig.

Example:

3.17 AT + WPS – включает функцию WPS

Установить команду:

Отклик:

Параметры:

  • enable :
    • 1: включить WPS / Wi-Fi Protected Setup (реализовано с помощью конфигурации PBC / Push Button).
    • 0: отключить WPS (реализовано PBC).

Notes:

  • WPS необходимо использовать, когда включена станция ESP32.
  • WPS не поддерживает шифрование WEP / Wired-Equivalent Privacy.

Пример:

3.18 AT + MDNS—Configurates the MDNS Function

Установить команду:

Отклик:

Параметры:

  • enable :
    • 1: включает функцию MDNS; следующие три параметра должны быть установлены.
    • 0: отключает функцию MDNS; следующие три параметра не нужно устанавливать.
  • имя хоста : имя хоста MDNS
  • service_name : имя службы MDNS
  • порт : порт MDNS

Пример:

3.19 AT+CWJEAP—Connects to an WPA2 Enterprise AP.

Команда запроса:

Отклик:

Set Command:

Отклик:

или + CWJEAP: Параметры ОШИБКИ тайм-аута:

  • SSID: the SSID of the Enterprise AP.
    • Синтаксис escape-символов необходим, если SSID или пароль содержат какие-либо специальные символы, такие как, или «или \».
  • method : метод аутентификации предприятия wpa2.
    • 0: EAP-TLS.
    • 1: EAP-PEAP.
    • 2: EAP-TTLS.
  • identity: identity for phase 1, string limited to 1~32.
  • username : имя пользователя для фазы 2, должно быть задано для режимов EAP-PEAP и EAP-TTLS, равно как и для EAP-TLS, строка ограничена 1 ~ 32.
  • пароль : пароль для фазы 2, должен быть установлен для режимов EAP-PEAP и EAP-TTLS, а также для EAP-TLS, строка ограничена 1 ~ 32.
  • Безопасность:
    • Бит0: сертификат клиента
    • Бит 1: сертификат сервера

Пример:

Примечание:

  • Изменения конфигурации будут сохранены в области NVS.
  • Эта команда требует, чтобы режим Station был активным.
  • Режим TLS будет использовать сертификат клиента, убедитесь, что включен.

3.20 AT+CWHOSTNAME : Configures the Name of ESP Station

Команда запроса:

Отклик:

Установить команду:

Response:

Если режим станции не включен, команда вернет:

Параметры:

  • имя хоста : имя хоста станции ESP, максимальная длина 32 байта.

Примечание:

  • Изменения конфигурации не сохраняются во флэш-памяти.

Example:

4. Связанные с TCP / IP AT-команды

4.1 AT+CIPSTATUS—Gets the Connection Status

Выполнить команду:

Отклик:

Параметры:

  • stat : состояние интерфейса ESP32 Station.
    • 0: станция ESP32 неактивна.
    • 1: станция ESP32 не используется.
    • 2: Станция ESP32 подключена к точке доступа, и ее IP-адрес получен.
    • 3: Станция ESP32 создала передачу TCP или UDP.
    • 4: передача TCP или UDP станции ESP32 отключена.
    • 5: Станция ESP32 НЕ подключается к точке доступа.
  • link ID : идентификатор соединения (0 ~ 4), используемый для нескольких соединений.
  • тип : строковый параметр, «TCP» или «UDP».
  • remote IP : строковый параметр, обозначающий удаленный IP-адрес.
  • удаленный порт : номер удаленного порта.
  • локальный порт : номер локального порта ESP32.
  • tetype :
    • 0: ESP32 работает как клиент.
    • 1: ESP32 работает как сервер.

4.2 AT + CIPDOMAIN – функция разрешения доменных имен

Выполнить команду:

Отклик:

Параметр:

  • имя домена : имя домена.

Пример:

4.3 AT + CIPSTART – устанавливает соединение TCP, передачу UDP или соединение SSL

4.3.1 Установить TCP-соединение

Установить команду:

Отклик:

Или, если соединение TCP уже установлено, ответом будет: УЖЕ СОЕДИНЕННАЯ ОШИБКА Параметры:

  • link ID: ID of network connection (0~4), used for multiple connections.
  • тип : строковый параметр, указывающий тип соединения: «TCP», «UDP» или «SSL».
  • remote IP: string parameter indicating the remote IP address.
  • удаленный порт : номер удаленного порта.
  • [TCP keep alive] (необязательный параметр): интервал времени обнаружения, когда TCP поддерживается живым; эта функция отключена по умолчанию.
    • 0: disable TCP keep-alive.
    • 1 ~ 7200: интервал времени обнаружения; единица измерения: секунда
  • [local IP] (необязательный параметр): выберите, какой IP-адрес хотите использовать, это полезно при использовании как Ethernet, так и WiFi; этот параметр по умолчанию отключен. Если вы хотите использовать этот параметр, должен быть указан в первую очередь, также допустимо значение null.

Examples:

4.3.2 Установить UDP-передачу

Установить команду:

Отклик:

Or if the UDP transmission is already established, the response is: ALREADY CONNECTTED ERROR Parameters:

  • link ID : идентификатор сетевого подключения (0 ~ 4), используемый для нескольких подключений.
  • тип : строковый параметр, указывающий тип соединения: «TCP», «UDP» или «SSL».
  • remote IP : строковый параметр, обозначающий удаленный IP-адрес.
  • удаленный порт : номер удаленного порта.
  • [UDP local port] (необязательный параметр): UDP-порт ESP32.
  • [Режим UDP] (необязательный параметр): при прозрачной передаче UDP значение этого параметра должно быть 0.
    • 0: конечный объект UDP не изменится; Это значение по умолчанию.
    • 1: конечный объект UDP может измениться один раз.
    • 2: одноранговый объект назначения UDP может измениться.
  • [local IP] (необязательный параметр): выберите, какой IP-адрес хотите использовать, это полезно при использовании как Ethernet, так и WiFi; этот параметр по умолчанию отключен. Если вы хотите использовать этот параметр и должны быть указаны в первую очередь, также допустимо значение null.

Примечание:

  • Чтобы использовать параметр UDP mode, параметр UDP local port должен быть установлен первым.

Пример:

[Только ESP32] 4.3.3 Установка SSL-соединения

Установить команду:

Отклик:

Или, если соединение TCP уже установлено, ответом будет: УЖЕ СОЕДИНЕННАЯ ОШИБКА Параметры:

  • идентификатор ссылки: ID of network connection (0~4), used for multiple connections.
  • тип : строковый параметр, указывающий тип соединения: «TCP», «UDP» или «SSL».
  • remote IP : строковый параметр, обозначающий удаленный IP-адрес.
  • удаленный порт : номер удаленного порта.
  • [TCP keep alive] (необязательный параметр): интервал времени обнаружения, когда TCP поддерживается живым; эта функция отключена по умолчанию.
    • 0: disable the TCP keep-alive function.
    • 1 ~ 7200: интервал времени обнаружения, единица измерения: секунда (с).
  • [local IP] (необязательный параметр): выберите, какой IP-адрес хотите использовать, это полезно при использовании как Ethernet, так и WiFi; этот параметр по умолчанию отключен. Если вы хотите использовать этот параметр, должен быть указан в первую очередь, также допустимо значение null.

Примечания:

  • ESP32 может установить не более одного SSL-соединения.
  • SSL-соединение не поддерживает сквозной режим UART-WiFi (прозрачная передача).
  • SSL-соединение требует большого объема памяти; в противном случае это может привести к перезагрузке системы.

Пример:

4.4 AT + CIPSEND – отправляет данные

Установить команду:

Отклик:

Начните получать серийные данные. Когда требование длины данных выполнено, начинается передача данных. Если соединение не может быть установлено или прерывается во время передачи данных, система возвращает:

Если данные успешно переданы, система возвращает:

Выполнить команду:

Отклик:

Введите прозрачную передачу с интервалом 20 мс между каждым пакетом и максимум 2048 байтов на пакет. При получении одного пакета, содержащего +++, ESP32 возвращается в обычный командный режим. Пожалуйста, подождите хотя бы одну секунду перед отправкой следующей AT-команды. Эта команда может использоваться только в прозрачном режиме передачи, который требует одного соединения. Для прозрачной передачи UDP значение должно быть 0 при использовании AT + CIPSTART.

Или же

Параметры:

  • link ID : идентификатор соединения (0 ~ 4) для нескольких соединений.
  • длина : длина данных, МАКС .: 2048 байтов.
  • [remote IP] (необязательный параметр): удаленный IP может быть установлен при передаче UDP.
  • [удаленный порт] (необязательный параметр): удаленный порт можно настроить при передаче UDP.

4.5 AT + CIPSENDEX – отправляет данные

Установить команду:

Отклик:

Send data of designated length. Wrap return after the set command. Begin receiving serial data. When the requirement of data length, determined by , is met, or when \0 appears in the data, the transmission starts. If connection cannot be established or gets disconnected during transmission, the system returns:

Если данные успешно переданы, система возвращает: SEND OK Параметры:

  • идентификатор ссылки: ID of the connection (0~4), for multiple connections.
  • длина : длина данных, МАКС .: 2048 байтов.
    • Когда выполняется требование длины данных, определяемое length, или когда появляется строка \ 0, начинается передача данных. Вернитесь в обычный командный режим и дождитесь следующей AT-команды.
    • При отправке \ 0, пожалуйста, отправьте как \\ 0.

4.6 AT + CIPCLOSE – закрывает соединение TCP / UDP / SSL

Установить команду (для нескольких подключений):

Параметры:

  • link ID : идентификационный номер соединения, которое будет закрыто; когда ID = 5, все соединения будут закрыты.

Выполнить команду (для одиночного соединения):

Response:

4.7 AT + CIFSR – получает локальный IP-адрес

Выполнить команду:

Response:

Параметры:

  • IP address:
    • IP-адрес ESP32 SoftAP;
    • IP-адрес станции ESP32.

Примечания:

  • Только когда станция ESP32 подключена к точке доступа, IP-адрес станции может быть запрошен.

4.8 AT + CIPMUX – включает / отключает несколько подключений

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • режим :
    • 0: одиночное соединение
    • 1: несколько соединений

Notes:

  • Режим по умолчанию – режим одиночного соединения.
  • Несколько соединений могут быть установлены только когда прозрачная передача отключена ( AT+CIPMODE=0).
  • This mode can only be changed after all connections are disconnected.
  • Если TCP-сервер работает, он должен быть удален ( AT+CIPSERVER=0), прежде чем активируется режим единого соединения.

Пример:

4.9 AT + CIPSERVER – Удаляет / Создает сервер TCP или SSL

Установить команду:

Отклик:

Параметры:

  • режим :
    • 0: удалить сервер.
    • 1: создать сервер.
  • порт : номер порта; 333 по умолчанию.
  • [Только ESP32] [SSL] (необязательный параметр): строка «SSL», чтобы установить сервер SSL
  • [Только ESP32] [SSL CA enable] (необязательный параметр):
    • 0: отключить CA.
    • 1: включить CA.

Примечания:

  • Сервер TCP может быть создан только тогда, когда активировано несколько подключений ( AT+CIPMUX=1).
  • Монитор сервера будет создан автоматически при создании TCP-сервера. И только один сервер разрешен.
  • When a client is connected to the server, it will take up one connection and be assigned an ID.

Пример:

4.10 AT + CIPSERVERMAXCONN —Установите максимальное количество соединений, разрешенных сервером

Команда запроса:

Response:

Установить команду:

Отклик:

Параметры:

  • num : максимальное количество клиентов, которым разрешено подключаться к серверу TCP или SSL.

Примечания:

  • Чтобы настроить эту конфигурацию, вы должны вызвать команду AT+CIPSERVERMAXCONN=numперед созданием сервера.

Пример:

4.11 AT + CIPMODE — Настраивает режим передачи

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • режим :
    • 0: нормальный режим передачи.
    • 1: транзитный режим UART-Wi-Fi (прозрачная передача), который может быть включен только в режиме единого соединения TCP или в режиме UDP, когда удаленный IP-адрес и порт не изменяются.

Примечания:

  • Изменения конфигурации НЕ будут сохранены во флэш-памяти.
  • Если во время передачи по протоколу UART-WiFi разрывается соединение TCP, ESP32 будет пытаться восстановить соединение, пока не будет введен +++вход для выхода из передачи.
  • Если это обычная передача TCP и соединение TCP разрывается, ESP32 выдаст запрос и не будет пытаться восстановить соединение.

Пример:

4,12 AT+SAVETRANSLINK—Saves the Transparent Transmission Link in Flash

4.12.1. Сохранение одного TCP-соединения во Flash

Установить команду:

Отклик:

Parameters:

  • режим :
    • 0: нормальный режим, ESP32 НЕ войдет в режим сквозного подключения UART-WiFi при включении питания.
    • 1: ESP32 will enter UART-WiFi passthrough mode on power-up.
  • удаленный IP : удаленный IP или имя домена.
  • удаленный порт : удаленный порт.
  • [тип] (необязательный параметр): TCP или UDP, TCP по умолчанию.
  • [TCP keep alive] (необязательный параметр): TCP поддерживается живым. Эта функция по умолчанию отключена.
    • 0: отключает функцию поддержания активности TCP.
    • 1 ~ 7200: интервал времени обнаружения активности; единица измерения: секунда

Notes:

  • Эта команда сохранит режим сквозного прохождения UART-WiFi и его ссылку в области NVS. ESP32 войдет в режим сквозного прохождения UART-WiFi при любых последующих циклах питания.
  • Пока удаленный IP-адрес (или имя домена) и порт действительны, конфигурация будет сохранена во флэш-памяти.

Example:

4.12.2 Сохранить UDP-передачу во Flash

Установить команду:

Отклик:

Параметры:

  • mode:
    • 0: нормальный режим; ESP32 НЕ войдет в режим сквозного подключения UART-WiFi при включении питания.
    • 1: ESP32 входит в режим сквозного подключения UART-WiFi при включении питания.
  • удаленный IP : удаленный IP или имя домена.
  • удаленный порт : удаленный порт.
  • [Тип](optional parameter): UDP, TCP by default.
  • [UDP local port] (необязательный параметр): локальный порт, когда прозрачная передача UDP включена при включении питания.

Примечания:

  • Эта команда сохранит режим сквозного прохождения UART-WiFi и его ссылку в области NVS. ESP32 войдет в режим сквозного прохождения UART-WiFi при любых последующих циклах питания.
  • Пока удаленный IP-адрес (или имя домена) и порт действительны, конфигурация будет сохранена во флэш-памяти.

Пример:

4.13 AT+CIPSTO—Sets the TCP Server Timeout

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметр:

  • time: TCP server timeout within the range of 0 ~ 7200s.

Примечания:

  • ESP32, настроенный как сервер TCP, будет отключаться от клиента TCP, который не связывается с ним до истечения времени ожидания.
  • Если AT+CIPSTO=0соединение никогда не истечет. Эта конфигурация не рекомендуется.

Example:

4.14 AT + CIPSNTPCFG – устанавливает часовой пояс и сервер SNTP

Команда запроса:

Отклик:

Выполнить команду:

Отклик:

Установить команду:

Отклик:

Параметры:

  • enable :
    • 1: сервер SNTP настроен.
    • 0: сервер SNTP не настроен.
  • часовой пояс : часовой пояс, диапазон: [-11,13].
  • SNTP server1 : первый сервер SNTP.
  • SNTP server2 : второй SNTP-сервер.
  • SNTP server3 : третий SNTP-сервер.

Примечание:

  • Если три сервера SNTP не настроены, используется следующая конфигурация по умолчанию: «cn.ntp.org.cn», «ntp.sjtu.edu.cn», «us.pool.ntp.org».

Пример:

4.15 AT+CIPSNTPTIME—Queries the SNTP Time

Команда запроса:

Отклик:

Пример:

4.16 AT + CIUPDATE – обновление программного обеспечения через Wi-Fi

Выполнить команду:

Отклик:

Выполнить команду:

Отклик:

Parameters:

  • режим ota :
    • 0: OTA через TCP
    • 1: OTA с помощью SSL, пожалуйста , убедитесь , make menuconfig Component config AT OTA based upon sslвключен.
  • версия : AT версии, например, v1.2.0.0, v1.1.3.0,v1.1.2.0
  • n :
    • 1: найти сервер.
    • 2: подключиться к серверу.
    • 3: получить версию программного обеспечения.
    • 4: начать обновление.

Пример:

Или же

Примечания:

  • The speed of the upgrade is susceptible to the connectivity of the network.
  • ОШИБКА будет возвращена, если обновление завершится неудачно из-за неблагоприятных условий в сети. Пожалуйста, подождите некоторое время, прежде чем повторить попытку.

Примечание:

  • При использовании Espressif в AT BIN , AT+CIUPDATEзагрузит новый AT BIN из Espressif Cloud.
  • При использовании скомпилированного пользователем AT BIN пользователям необходимо реализовать собственную функцию AT + CIUPDATE FOTA. Проект esp-at предоставляет пример FOTA .
  • Пользователям предлагается позвонить, AT+RESTOREчтобы восстановить заводские настройки по умолчанию после обновления прошивки AT.

4.17 AT + CIPDINFO – Показывает удаленный IP и порт с «+ IPD»

Установить команду:

Отклик:

Параметры:

  • режим :
    • 0: не показывает удаленный IP и порт с «+ IPD».
    • 1: показывает удаленный IP и порт с «+ IPD».

Example:

4.18 + IPD – получает данные сети

Команда:

Параметры:

  • [remote IP]: remote IP, enabled by command AT+CIPDINFO=1.
  • [удаленный порт] : удаленный порт, включается командой AT+CIPDINFO=1.
  • link ID : идентификационный номер соединения.
  • len : длина данных.
  • данные : данные получены.

Примечание:

  • Команда действительна в обычном командном режиме. Когда модуль получает сетевые данные, он отправляет данные через последовательный порт с помощью +IPDкоманды.

4.19 AT + CIPSSLCCONF – Настройка SSL-клиента

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • link ID : идентификатор соединения (0 ~ макс.), для нескольких соединений, если значение max, это означает все соединения. По умолчанию максимум 5.
  • auth_mode :
    • 0: no authorization.
    • 1: загрузить сертификат и закрытый ключ для авторизации на сервере.
    • 2: загрузить CA для сертификата авторизации сервера и закрытого ключа клиента.
    • 3: оба разрешения.
  • pki_number : индекс сертификата и закрытого ключа, если только один сертификат и закрытый ключ, значение должно быть 0.
  • ca_number : индекс CA, если только один CA, значение должно быть 0.

Примечания:

  • Вызовите эту команду перед установкой SSL-соединения, если вы хотите, чтобы конфигурация вступила в силу немедленно.
  • Изменения конфигурации будут сохранены в области NVS. Если вы используете AT + SAVETRANSLINK для установки режима сквозной передачи SSL, ESP установит соединение SSL на основе этой конфигурации после следующего включения.

4.20 AT + CIPRECONNINTV —Установите прозрачный интервал автоматического подключения для передачи по Wi-Fi.

Установить команду:

Параметры:

  • интервал : интервал времени для автоматического переподключения, по умолчанию 1, диапазон от 1 до 36000, единица измерения 100 мс.

Пример:

4.21 + IPD – получает данные сети

Команда:

Параметры:

  • [remote IP] : удаленный IP, включается командой AT+CIPDINFO=1.
  • [удаленный порт] : удаленный порт, включается командой AT+CIPDINFO=1.
  • link ID : идентификационный номер соединения.
  • len : длина данных.
  • данные : данные получены.

Примечание:

  • Команда действительна в обычном командном режиме. Когда модуль получает сетевые данные, он отправляет данные через последовательный порт с помощью +IPDкоманды.

4.22 AT + CIPRECVMODE —Set Socket Receive Mode

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • режим : режим приема данных сокета является активным режимом по умолчанию.
    • 0: активный режим – ESP AT немедленно отправит все полученные данные сокета на MCU хоста через UART с заголовком «+ IPD».
    • 1: пассивный режим – ESP AT сохранит полученные данные сокета во внутреннем буфере (по умолчанию 5840 байтов) и будет ждать, пока MCU хоста прочитает данные. Если буфер заполнен, передача через сокет будет заблокирована.

Пример:

Примечания:

  • Конфигурация предназначена только для передачи по TCP и SSL и не может использоваться в режиме сквозного доступа WiFi-UART. Если это передача UDP в пассивном режиме, при заполнении буфера данные будут пропущены.
  • Если пассивный режим включен, когда ESP AT получает данные сокета, он будет выводить следующее сообщение в различных сценариях:
    • для режима множественного подключения (AT + CIPMUX = 1) сообщение: +IPD,link ID,len
    • for single connection mode (AT+CIPMUX=0), the message is: +IPD,len
    • len общая длина данных сокета в буфере

4.23 AT + CIPRECVDATA – получение данных сокета в режиме пассивного приема

Установить команду:

Response:

Параметры:

  • link_id : идентификатор соединения в режиме нескольких соединений.
  • len : длина данных, которую вы хотите получить, макс. 2048 байт за раз.
  • actual_len : длина данных, которые вы на самом деле получаете
  • данные : данные, которые вы получаете

Пример:

Примечания:

  • В случае разъединения буферизованные данные сокета все еще будут там и могут быть прочитаны MCU, пока вы не отправите AT+CIPCLOSE, или вместо этого новое соединение заняло предыдущий link_id.

4.24 AT + CIPRECVLEN – получение длины данных сокета в режиме пассивного приема

Команда запроса:

Отклик:

Параметры:

  • длина данных ссылки : длина всех данных, буферизованных для ссылки

Пример:

Примечания:

  • Для ссылки ssl он вернет длину зашифрованных данных, поэтому возвращаемая длина будет больше, чем реальная длина данных.

4.25 AT + PING : пакеты пинга

Установить команду:

Отклик:

или же

Parameters:

  • IP : строка; IP-адрес хоста или доменное имя
  • время : время отклика пинга, единица измерения: миллисекунда.

Пример:

4.26 AT+CIPDNS : Configures Domain Name System.

Команда запроса:

Отклик:

Установить команду:

Отклик:

или же

Параметры:

  • enable :
    • 0: Включить автоматические настройки DNS с DHCP, DNS будет восстановлен 222.222.67.208, только после обновления DHCP он вступит в силу.
    • 1: Включить ручные настройки DNS, если не установлен DNS IP, будет использоваться 222.222.67.208по умолчанию.
  • DNS IP1 : первый DNS-IP. Для команды set, только для ручных настроек DNS; для команды запроса это текущая настройка DNS.
  • DNS IP2: the second DNS IP. For set command, only for manual DNS settings; for query command, it is current DNS setting.
  • DNS IP3 : третий DNS IP. Для команды set, только для ручных настроек DNS; для команды запроса это текущая настройка DNS.

Пример:

Примечания:

  • Изменения конфигурации будут сохранены в области NVS.
  • Три параметра не могут быть установлены на одном сервере.
  • Сервер DNS может меняться в зависимости от конфигурации маршрутизатора, к которому подключен чип ESP.

5. [Только ESP32] BLE-связанные AT-команды

5.1 [Только ESP32] AT + BLEINIT —BLE Initialization

Команда запроса:

Отклик:

Если BLE не инициализирован, он вернется

Если BLE инициализирован, он вернется

Установить команду:

Отклик:

Параметр:

  • init :
    • 0: deinit ble
    • 1: роль клиента
    • 2: роль сервера

Примечания:

  • Необходимо загрузить at_customize.bin, чтобы можно было использовать соответствующие команды. Пожалуйста, обратитесь к ESP32_Customize_Partitions для более подробной информации.
  • Перед использованием команд BLE AT необходимо сначала вызвать эту команду, чтобы запустить процесс инициализации.
  • После инициализации роль BLE изменить нельзя. Пользователь должен вызвать AT + RST, чтобы сначала перезапустить систему, а затем повторно запустить роль BLE.
  • Если вы используете ESP32 в качестве сервера BLE, сервисный бин должен быть загружен во Flash.
    • Чтобы узнать, как создать сервисный бин, пожалуйста, обратитесь к esp-at / tools / readme.md.
    • Адрес загрузки бина службы – это адрес «ble_data» в esp-at / partitions_at.csv.

Пример:

5.2 [Только ESP32] AT + BLEADDR – устанавливает адрес устройства BLE

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметр:

  • addr_type :
    • 0: публичный адрес
    • 1: случайный адрес

Примечания:

  • Статический адрес должен соответствовать следующим требованиям:
    • Два старших разряда адреса должны быть равны 1
    • По крайней мере один бит случайной части адреса должен быть 0
    • По крайней мере, один бит случайной части адреса должен быть 1

Пример:

5.3 [Только ESP32] AT + BLENAME – устанавливает имя устройства BLE

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметр:

  • имя_устройства : имя устройства BLE

Примечания:

  • Имя устройства BLE по умолчанию – «BLE_AT».

Пример:

5.4 [Только ESP32] AT + BLESCANPARAM – Устанавливает параметры сканирования BLE

Команда запроса:

Отклик:

Установить команду:

Отклик:

Параметры:

  • scan_type:
    • 0: пассивное сканирование
    • 1: активное сканирование
  • own_addr_type :
    • 0: публичный адрес
    • 1: случайный адрес
    • 2: RPA public address
    • 3: случайный адрес RPA
  • filter_policy :
    • 0: BLE_SCAN_FILTER_ALLOW_ALL
    • 1: BLE_SCAN_FILTER_ALLOW_ONLY_WLST
    • 2: BLE_SCAN_FILTER_ALLOW_UND_RPA_DIR
    • 3: BLE_SCAN_FILTER_ALLOW_WLIST_PRA_DIR
  • scan_interval: scan interval
  • scan_window : окно сканирования

Примечания:

  • scan_window НЕ МОЖЕТ быть больше, чем scan_interval.

Пример: