AT команды ESP8266 уровня Wi-Fi

Добавлено 13 июня 2018 в 05:06

ESP8266 в своей конфигурации по умолчанию загружается в режим последовательного модема. В этом режиме вы можете общаться с ним с помощью набора AT-команд. AT-команды ESP8266 можно разделить на три категории: базовые, уровень Wi-Fi и уровень TCP/IP. Ниже приведен список всех AT команд уровня Wi-Fi, поддерживаемых ESP8266, с объяснением, что они делают, и как их использовать.

Модуль ESP-12E на базе ESP8266. Wi-Fi AT команды ESP8266
Модуль ESP-12E на базе ESP8266

Варианты команд

Каждая команда имеет до 4 вариантов, изменяющих ее назначение. Вы можете выбирать между ними, добавляя одно из четырех возможных значений в конце основной команды. Эти четыре дополнения могут иметь следующие значения: "", =<parameter|[parameters]>, "?", =?.

ТипФормат командыОписание
ТестAT+<x>=?Запрос внутренних параметров и диапазона их значений для заданной команды.
ЗапросAT+<x>?Возвращает текущее значение параметра.
УстановкаAT+<x>=<…>Установка параметров, заданных в команде пользователем, и запуск этой команды.
ВыполнениеAT+<x>Запуск команды без заданных пользователем параметров.

Примечание:

  • не все команды поддерживают все 4 варианта;
  • квадратные скобки [] обозначают значение по умолчанию; оно либо не требуется, либо может не отображаться;
  • строковые значения необходимо заключать в двойные кавычки, например, AT+CWSAP="ESP756290","21030826", 1,4;
  • скорость передачи данных по умолчанию равна 115200;
  • AT команды должны печататься заглавными буквами и оканчиваться новой строкой (CR LF).

AT команды уровня Wi-Fi

Список команд

КомандаОписание
AT+CWMODE_CURУстанавливает Wi-Fi режим (Станция / Точка доступа / Станция + точка доступа); конфигурация не сохраняется во флеш-памяти.
AT+CWMODE_DEFУстанавливает Wi-Fi режим по умолчанию (Станция / Точка доступа / Станция + точка доступа); конфигурация сохраняется во флеш-памяти.
AT+CWJAP_CURПодключает к точке доступа; конфигурация не сохраняется во флеш-памяти.
AT+CWJAP_DEFПодключает к точке доступа; конфигурация сохраняется во флеш-памяти.
AT+CWLAPOPTУстанавливает конфигурацию команды AT+CWLAP.
AT+CWLAPПеречисляет доступные точки доступа.
AT+CWQAPОтключает от точки доступа.
AT+CWSAP_CURУстанавливает текущую конфигурацию SoftAP (точку доступа) ESP8266; конфигурация не сохраняется во флеш-памяти.
AT+CWSAP_DEFУстанавливает конфигурацию SoftAP (точку доступа) ESP8266; конфигурация сохраняется во флеш-памяти.
AT+CWLIFПолучает IP станций, к которым подключена SoftAP (точка доступа) ESP8266.
AT+CWDHCP_CURВключает/выключает DHCP; конфигурация не сохраняется во флеш-памяти.
AT+CWDHCP_DEFВключает/выключает DHCP; конфигурация сохраняется во флеш-памяти.
AT+CWDHCPS_CURУстанавливает диапазон IP адресов DHCP сервера; конфигурация не сохраняется во флеш-памяти.
AT+CWDHCPS_DEFУстанавливает диапазон IP адресов DHCP сервера; конфигурация сохраняется во флеш-памяти.
AT+CWAUTOCONNПодключает к точке доступа при включении автоматически.
AT+CIPSTAMAC_CURУстанавливает MAC адрес станции ESP8266; конфигурация не сохраняется во флеш-памяти.
AT+CIPSTAMAC_DEFУстанавливает MAC адрес станции ESP8266; конфигурация сохраняется во флеш-памяти.
AT+CIPAPMAC_CURУстанавливает MAC адрес SoftAP (точки доступа) ESP8266; конфигурация не сохраняется во флеш-памяти.
AT+CIPAPMAC_DEFУстанавливает MAC адрес SoftAP (точки доступа) ESP8266; конфигурация сохраняется во флеш-памяти.
AT+CIPSTA_CURУстанавливает IP адрес станции ESP8266; конфигурация не сохраняется во флеш-памяти.
AT+CIPSTA_DEFУстанавливает IP адрес станции ESP8266; конфигурация сохраняется во флеш-памяти.
AT+CIPAP_CURУстанавливает IP адрес SoftAP (точки доступа) ESP8266; конфигурация не сохраняется во флеш-памяти.
AT+CIPAP_DEFУстанавливает IP адрес SoftAP (точки доступа) ESP8266; конфигурация сохраняется во флеш-памяти.
AT+CWSTARTSMARTЗапускает SmartConfig.
AT+CWSTOPSMARTОстанавливает SmartConfig.
AT+CWSTARTDISCOVERВключает режим, в котором ESP8266 может быть найден с помощью WeChat.
AT+CWSTOPDISCOVERВыключает режим, в котором ESP8266 может быть найден с помощью WeChat.
AT+WPSУстанавливает работу WPS.
AT+MDNSУстанавливает работу MDNS.
AT+CWHOSTNAMEУстанавливает имя хоста станции ESP8266.
AT+CWCOUNTRY_CURУстанавливает текущий Wi-FI код страны.
AT+CWCOUNTRY_DEFУстанавливает Wi-FI код страны по умолчанию.

AT команды

AT+CWMODE_CUR – установить текущий Wi-Fi режим; конфигурация не сохраняется во флеш-памяти.
КомандаКоманда теста:
AT+CWMODE_CUR=?
команда запроса:
AT+CWMODE_CUR?
Назначение: запрос текущего Wi-Fi режима ESP8266
Команда установки:
AT+CWMODE_CUR=<mode>
Назначение: установка текущего Wi-Fi режима ESP8266
Отклик+CWMODE_CUR:<mode>
OK
+CWMODE_CUR:<mode>
OK
OK
Параметры<mode>
  • 1 – режим Station (станция)
  • 2 – режим SoftAP (точки доступа)
  • 3 – режим Station (станция) + SoftAP (точка доступа)
ПримечаниеИзменение конфигурации не сохраняется во флеш-памяти.
ПримерAT+CWMODE_CUR=3
AT+CWMODE_DEF – установить Wi-Fi режим по умолчанию; конфигурация сохраняется во флеш-памяти.
КомандаКоманда теста:
AT+CWMODE_DEF=?
команда запроса:
AT+CWMODE_DEF?
Назначение: запрос текущего Wi-Fi режима ESP8266
Команда установки:
AT+CWMODE_DEF=<mode>
Назначение: установка Wi-Fi режима ESP8266 по умолчанию
Отклик+CWMODE_DEF:<mode>
OK
+CWMODE_DEF:<mode>
OK
OK
Параметры<mode>
  • 1 – режим Station (станция)
  • 2 – режим SoftAP (точки доступа)
  • 3 – режим Station (станция) + SoftAP (точка доступа)
ПримечаниеИзменение конфигурации сохраняется во флеш-памяти в системной области параметров.
ПримерAT+CWMODE_DEF=3
AT+CWJAP_CUR – подключает к точке доступа; конфигурация не сохраняется во флеш-памяти.
КомандаКоманда запроса:
AT+CWJAP_CUR?
Назначение: запросить точку доступа, к которой станция ESP8266 уже подключена.
Команда установки:
AT+CWJAP_CUR=<ssid>,<pwd>[,<bssid>]
Назначение: настроить точку доступа, к которой станции ESP8266 необходимо подключиться.
Отклик+CWJAP_CUR:<ssid>,<bssid>,<channel>,<rssi>
OK
OK

или

+CWJAP_CUR:<error code>
FAIL
Параметры<ssid> – строковый параметр, показывающий SSID целевой точки доступа.
  • <ssid> – SSID целевой точки доступа
  • <pwd> – пароль, максимум: 64 байта ASCII
  • [<bssid>] – MAC адрес целевой точки доступа, используется, когда у нескольких точек доступа одинаковые SSID
  • <error code> – (только для справки)
    • 1 – истекло время ожидания соединения
    • 2 – неправильный пароль
    • 3 – не удается найти целевую точку доступа
    • 4 – соединение не выполнено
Данная команда требует, чтобы активным был режим «Станция». Синтаксис экранирования символов необходим, если SSID или пароль содержат любые специальные символы, такие как , или " или \
ПримечаниеИзменения конфигурации НЕ сохраняются во флеш-памяти.
ПримерыAT+CWJAP_CUR="abc","0123456789"
Например, если SSID целевой точки доступа – это "ab\,c", а пароль – это "0123456789"\", команда будет следующей:
AT+CWJAP_CUR="ab\\\,c","0123456789\"\\"
Если несколько точек доступа имеют одинаковые SSID, например, "abc", целевая точка доступа может быть найдена с помощью BSSID:
AT+CWJAP_CUR="abc","0123456789","ca:d7:19:d8:a6:44"
AT+CWJAP_DEF – подключает к точке доступа; конфигурация сохраняется во флеш-памяти.
КомандаКоманда запроса:
AT+CWJAP_DEF?
Назначение: запросить точку доступа, к которой станция ESP8266 уже подключена.
Команда установки:
AT+CWJAP_DEF=<ssid>,<pwd>[,<bssid>]
Назначение: настроить точку доступа, к которой станции ESP8266 необходимо подключиться.
Отклик+CWJAP_DEF:<ssid>,<bssid>,<channel>,<rssi>
OK
OK

или

+CWJAP_DEF:<error code>
FAIL
Параметры<ssid> – строковый параметр, показывающий SSID целевой точки доступа.
  • <ssid> – SSID целевой точки доступа
  • <pwd> – пароль, максимум: 64 байта ASCII
  • [<bssid>] – MAC адрес целевой точки доступа, используется, когда у нескольких точек доступа одинаковые SSID
  • <error code> – (только для справки)
    • 1 – истекло время ожидания соединения
    • 2 – неправильный пароль
    • 3 – не удается найти целевую точку доступа
    • 4 – соединение не выполнено
Данная команда требует, чтобы активным был режим «Станция». Синтаксис экранирования символов необходим, если SSID или пароль содержат любые специальные символы, такие как , или " или \
ПримечаниеИзменения конфигурации сохраняются в области системных параметров во флеш-памяти.
ПримерыAT+CWJAP_DEF="abc","0123456789"
Например, если SSID целевой точки доступа – это "ab\,c", а пароль – это "0123456789"\", команда будет следующей:
AT+CWJAP_DEF="ab\\\,c","0123456789\"\\"
Если несколько точек доступа имеют одинаковые SSID, например, "abc", целевая точка доступа может быть найдена с помощью BSSID:
AT+CWJAP_DEF="abc","0123456789","ca:d7:19:d8:a6:44"
AT+CWLAPOPT – устанавливает конфигурация для команды AT+CWLAP
Команда установкиAT+CWLAPOPT=<sort_enable>,<mask>
ОткликOK

или

ERROR
Параметры
  • <sort_enable> – определяет, будет ли результат команды AT+CWLAP отображаться в соответствии с RSSI:
    • 0 – результат упорядочивается в соответствии с RSSI
    • 1 – результат не упорядочивается в соответствии с RSSI
  • <mask> – определяет параметры, отображаемые в результате AT+CWLAP; 0 означает скрытие параметра, соответствующего биту, а 1 означает его отображение.
    • бит 0 – определяет, будет ли показан <ecn> в результате AT+CWLAP
    • бит 1 – определяет, будет ли показан <ssid> в результате AT+CWLAP
    • бит 2 – определяет, будет ли показан <rssi> в результате AT+CWLAP
    • бит 3 – определяет, будет ли показан <mac> в результате AT+CWLAP
    • бит 4 – определяет, будет ли показан <ch> в результате AT+CWLAP
    • бит 5 – определяет, будет ли показан <freq offset> в результате AT+CWLAP
    • бит 6 – определяет, будет ли показан <freq calibration> в результате AT+CWLAP
    • бит 7 – определяет, будет ли показан <pairwise_cipher> в результате AT+CWLAP
    • бит 8 – определяет, будет ли показан <group_cipher> в результате AT+CWLAP
    • бит 9 – определяет, будет ли показан <bgn> в результате AT+CWLAP
    • бит 10 – определяет, будет ли показан <wps> в результате AT+CWLAP
ПримерAT+CWLAPOPT=1,2047
Первый параметр равен 1, это означает, что результат команды AT+CWLAP будет упорядочен в соответствии с RSSI.
Второй параметр равен 2047, то есть 0x7FF, это означает, что соответствующие биты <mask> установлены в 1. В результате AT+CWLAP будут отображены все параметры.
AT+CWLAP – перечисляет доступные точки доступа
КомандаКоманда установки:
AT+CWLAP[=<ssid>,<mac>,<channel>,<scan_type>,<scan_time_min>,<scan_time_max>]
Назначение: запросить точки доступа с определенным SSID и MAC на определенном канале.
Команда выполнения:
AT+CWLAP
Назначение: перечислить все доступные точки доступа.
Отклик+CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<channel>,<freq offset>,<freq cali>,<pairwise_cipher>,<group_cipher>,<bgn>,<wps>
OK
+CWLAP:<ecn>,<ssid>,<rssi>,<mac>,<channel>,<freq offset>,<freq cali>,<pairwise_cipher>,<group_cipher>,<bgn>,<wps>
OK
Параметры
  • [<scan_type>] – необязательный параметр
    • 0 – активное сканирование
    • 1 – пассивное сканирование
  • [<scan_time_min>] – необязательный параметр; единица: миллисекунда; диапазон: [0,1500]
    • для активного режима сканирования <scan_time_min> – это минимальное время сканирования на каждый канал, по умолчанию это 0
    • для пассивного режима сканирования <scan_time_min> не имеет значения, может быть опущено
  • [<scan_time_max>] – необязательный параметр; единица: миллисекунда; диапазон: [0,1500]
    • для активного режима сканирования <scan_time_max> – это максимальное время сканирования на каждый канал; если установить его в 0, то будет использоваться значение по умолчанию, это 120 мс
    • для пассивного режима сканирования <scan_time_max> – это время сканирования на каждый канал, по умолчанию 360 мс
  • <ecn> – метод шифрования
    • 0 – OPEN
    • 1 – WEP
    • 2 – WPA_PSK
    • 3 – WPA2_PSK
    • 4 – WPA_WPA2_PSK
    • 5 – WPA2_Enterprise (на данный момент AT не подключает к точка доступа WPA2_Enterprise)
  • <ssid> – строковый параметр, SSID точки доступа
  • <rssi> – уровень сигнала
  • <mac> – строковый параметр, MAC адрес точки доступа
  • <channel> – номер канала
  • <freq offset> – смещение частоты точки доступа; единица: кГц. Значение ppm составляет <freq offset>/2,4
  • <freq calibration> – калибровка для смещения частоты
  • <pairwise_cipher>
    • 0 – CIPHER_NONE
    • 1 – CIPHER_WEP40
    • 2 – CIPHER_WEP104
    • 3 – CIPHER_TKIP
    • 4 – CIPHER_CCMP
    • 5 – CIPHER_TKIP_CCMP
    • 6 – CIPHER_UNKNOWN
  • <group_cipher> – определения типов шифрования такие же, как <pairwise_cipher>
  • <bgn>
    • бит 0 для режима 802.11b; бит 1 для режима 802.11g; бит 2 для режима 802.11n
    • если значение бита равно 1, будет включен соответствующий режим 802.11; если значение бита рано 0, то этот режим будет выключен
  • <wps> – 0, WPS выключен; 1, WPS включен
ПримерыAT+CWLAP="Wi-Fi","ca:d7:19:d8:a6:44",6
или поиск точек доступа с назначенным SSID
AT+CWLAP="Wi-Fi"
или включение пассивного сканирования
AT+CWLAP=,,,1,,
AT+CWQAP – отключиться от точки доступа
Команда выполненияAT+CWQAP
ОткликOK
Параметры
AT+CWSAP_CUR – настроить SoftAP (точку доступа) ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWSAP_CUR?
Назначение: предоставить параметры конфигурации SoftAP (точки доступа) ESP8266.
Команда установки:
AT+CWSAP_CUR=<ssid>,<pwd>,<chl>,<ecn>[,<max conn>][,<ssid hidden>]
Назначение: настройка SoftAP (точки доступа) ESP8266.
Отклик+CWSAP_CUR:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid hidden>
OK
OK

или

ERROR
Параметры
  • <ssid> – строковый параметр, SSID точки доступа
  • <pwd> – строковый параметр, длина пароля 8-64 байта ASCII
  • <chl> – ID канала
  • <ecn> – метод шифрования; WEP не поддерживается:
    • 0 – OPEN
    • 1 – WPA_PSK
    • 2 – WPA2_PSK
    • 3 – WPA_WPA2_PSK
  • [<max conn>] – необязательный параметр; максимальное количество станций, к которым SoftAP (точка доступа) ESP8266 может быть подключена; диапазон [1,8]
  • [<ssid hidden>] – необязательный параметр
    • 0 – SSID вещается широко (по умолчанию)
    • 1 – SSID не вещает широко
Внимание:
Данная команда доступна, если активна SoftAP (точка доступа)
ПримечаниеИзменения конфигурации НЕ сохраняются во флеш-памяти.
ПримерAT+CWSAP_CUR="ESP8266","1234567890",5,3
AT+CWSAP_DEF – настроить SoftAP (точку доступа) ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWSAP_DEF?
Назначение: предоставить параметры конфигурации SoftAP (точки доступа) ESP8266.
Команда установки:
AT+CWSAP_DEF=<ssid>,<pwd>,<chl>,<ecn>[,<max conn>][,<ssid hidden>]
Назначение: настройка SoftAP (точки доступа) ESP8266.
Отклик+CWSAP_DEF:<ssid>,<pwd>,<chl>,<ecn>,<max conn>,<ssid hidden>
OK
OK

или

ERROR
Параметры
  • <ssid> – строковый параметр, SSID точки доступа
  • <pwd> – строковый параметр, длина пароля 8-64 байта ASCII
  • <chl> – ID канала
  • <ecn> – метод шифрования; WEP не поддерживается:
    • 0 – OPEN
    • 1 – WPA_PSK
    • 2 – WPA2_PSK
    • 3 – WPA_WPA2_PSK
  • [<max conn>] – необязательный параметр; максимальное количество станций, к которым SoftAP (точка доступа) ESP8266 может быть подключена; диапазон [1,8]
  • [<ssid hidden>] – необязательный параметр
    • 0 – SSID вещается широко (по умолчанию)
    • 1 – SSID не вещает широко
Так же как и выше.

Внимание:
Данная команда доступна, если активна SoftAP (точка доступа)
ПримечаниеИзменения конфигурации сохраняются в области системных параметров во флеш-памяти.
ПримерAT+CWSAP_DEF="ESP8266","1234567890",5,3
AT+CWLIF – IP станций, к которым подключена SoftAP (точка доступа) ESP8266
Команда выполненияAT+CWLIF
Отклик<ip addr>,<mac>
OK
Параметры
  • <ip addr> – IP адреса станций, к которым подключена SoftAP (точка доступа) ESP8266
  • <mac> – MAC адреса станций, к которым подключена SoftAP (точка доступа) ESP8266
ПримечаниеДанная команда не может получить статические IP адреса. Она работает, только когда включены DHCP и на SoftAP (точке доступа) ESP8266, и на станции, которая подключена к ESP8266.
AT+CWDHCP_CUR – включить/выключить DHCP; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWDHCP_CUR?
Команда выполнения:
AT+CWDHCP_CUR=<mode>,<en>
Назначение: включить/выключить DHCP.
ОткликВключен или выключен DHCP?OK
Параметры
  • бит 0
    • 0 – DHCP станции выключен
    • 1 – DHCP станции включен
  • бит 1
    • 0 – DHCP SoftAP (точки доступа) выключен
    • 1 – DHCP SoftAP (точки доступа) включен
  • <mode>
    • 0 – настраивает SoftAP (точку доступа) ESP8266
    • 1 – настраивает Station (станцию) ESP8266
    • 2 – настраивает и SoftAP (точку доступа), и станцию
  • <en>
    • 0 – DHCP выключен
    • 1 – DHCP включен
Примечания
  • Конфигурация не сохраняется во флеш-памяти.
  • Данная команда установки взаимодействует с AT командами, связанными со статическим IP (с командами из серий AT+CIPSTA и AT+CIPAP):
    • если DHCP включается, то статический IP адрес будет выключен;
    • если статический IP адрес включается, то DHCP будет выключен;
    • будет ли включен DHCP или статический IP адрес, зависит от последней конфигурации.
ПримерAT+CWDHCP_CUR=0,1
AT+CWDHCP_DEF – включить/выключить DHCP; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWDHCP_DEF?
Команда выполнения:
AT+CWDHCP_DEF=<mode>,<en>
Назначение: включить/выключить DHCP.
ОткликВключен или выключен DHCP?OK
Параметры
  • бит 0
    • 0 – DHCP станции выключен
    • 1 – DHCP станции включен
  • бит 1
    • 0 – DHCP SoftAP (точки доступа) выключен
    • 1 – DHCP SoftAP (точки доступа) включен
  • <mode>
    • 0 – настраивает SoftAP (точку доступа) ESP8266
    • 1 – настраивает Station (станцию) ESP8266
    • 2 – настраивает и SoftAP (точку доступа), и станцию
  • <en>
    • 0 – DHCP выключен
    • 1 – DHCP включен
Примечания
  • Конфигурация сохраняется в области пользовательских параметров во флеш-памяти.
  • Данная команда установки взаимодействует с AT командами, связанными со статическим IP (с командами из серий AT+CIPSTA и AT+CIPAP):
    • если DHCP включается, то статический IP адрес будет выключен;
    • если статический IP адрес включается, то DHCP будет выключен;
    • будет ли включен DHCP или статический IP адрес, зависит от последней конфигурации.
ПримерAT+CWDHCP_DEF=0,1
AT+CWDHCPS_CUR – устанавливает диапазон IP адресов, выделяемых DHCP SoftAP (точки доступа) ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWDHCPS_CUR?
Команда установки:
AT+CWDHCPS_CUR=<enable>,<lease time>,<start IP>,<end IP>
Назначение: устанавливает диапазон IP адресов для DHCP сервера SoftAP (точки доступа) ESP8266.
Отклик+CWDHCPS_CUR:<lease time>,<start IP>,<end IP>
OK
OK
Параметры
  • <enable>:
    • 0 – выключить настройки и использовать диапазон IP адресов по умолчанию;
    • 1 – включить настройки диапазона IP адресов, и параметры, приведенные ниже, будут установлены;
  • <lease time> – время аренды; единица: минута; диапазон: [1, 2880];
  • <start IP> – стартовый адрес из диапазона IP адресов, которые могут быть предоставлены DHCP сервером SoftAP (точки доступа) ESP8266;
  • <end IP> – конечный адрес из диапазона IP адресов, которые могут быть предоставлены DHCP сервером SoftAP (точки доступа) ESP8266;
Примечания
  • Изменения конфигурации НЕ сохраняются во флеш-памяти.
  • Данная AT команда включена, когда ESP8266 запущен, как SoftAP (точка доступа), и когда DHCP включен. IP адрес должен быть в той же подсети, что и IP адрес SoftAP (точки доступа) ESP8266.
ПримерыAT+CWDHCPS_CUR=1,3,"192.168.4.10","192.168.4.15"

или

AT+CWDHCPS_CUR=0 // выключает установки и использует диапазон IP адресов по умолчанию.
AT+CWDHCPS_DEF – устанавливает диапазон IP адресов, выделяемых DHCP SoftAP (точки доступа) ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWDHCPS_DEF?
Команда установки:
AT+CWDHCPS_DEF=<enable>,<lease time>,<start IP>,<end IP>
Назначение: устанавливает диапазон IP адресов для DHCP сервера SoftAP (точки доступа) ESP8266.
Отклик+CWDHCPS_DEF:<lease time>,<start IP>,<end IP>
OK
OK
Параметры
  • <enable>:
    • 0 – выключить настройки и использовать диапазон IP адресов по умолчанию;
    • 1 – включить настройки диапазона IP адресов, и параметры, приведенные ниже, будут установлены;
  • <lease time> – время аренды; единица: минута; диапазон: [1, 2880];
  • <start IP> – стартовый адрес из диапазона IP адресов, которые могут быть предоставлены DHCP сервером SoftAP (точки доступа) ESP8266;
  • <end IP> – конечный адрес из диапазона IP адресов, которые могут быть предоставлены DHCP сервером SoftAP (точки доступа) ESP8266;
Примечания
  • Изменения конфигурации сохраняются в области пользовательских параметров во флеш-памяти.
  • Данная AT команда включена, когда ESP8266 запущен, как SoftAP (точка доступа), и когда DHCP включен. IP адрес должен быть в той же подсети, что и IP адрес SoftAP (точки доступа) ESP8266.
ПримерыAT+CWDHCPS_DEF=1,3,"192.168.4.10","192.168.4.15"

или

AT+CWDHCPS_DEF=0 // выключает установки и использует диапазон IP адресов по умолчанию.
AT+CWAUTOCONN – подключаться автоматически к точке доступа или нет
Команда установкиAT+CWAUTOCONN=<enable>
ОткликOK
Параметры<enable>:
  • 0 – НЕ подключаться автоматически к точке доступа при включении питания;
  • 1 – подключаться автоматически к точке доступа при включении питания;
Станция ESP8266 по умолчанию подключается к точке доступа автоматически при включении.
ПримечаниеИзменения конфигурации сохраняются в области системных параметров во флеш-памяти.
ПримерAT+CWAUTOCONN=1
AT+CIPSTAMAC_CUR – установить MAC адрес станции ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPSTAMAC_CUR?
Команда установки:
AT+CIPSTAMAC_CUR=<mac>
Назначение: установить MAC адрес станции ESP8266.
Отклик+CIPSTAMAC_CUR:<mac>
OK
OK
Параметры<mac> – строковый параметр, MAC адрес станции ESP8266.
Примечания
  • Изменения конфигурации НЕ сохраняются во флеш-памяти.
  • MAC адрес SoftAP (точки доступа) ESP8266 отличается от адреса станции ESP8266. Пожалуйста, убедитесь, что вы не установили одинаковые адреса им обоим.
  • Бит 0 MAC адреса ESP8266 НЕ МОЖЕТ быть равен 1. Например, MAC адрес может быть таким "18:...", но не может быть таким "15:...".
ПримерAT+CIPSTAMAC_CUR="18:fe:35:98:d3:7b"
AT+CIPSTAMAC_DEF – установить MAC адрес станции ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPSTAMAC_DEF?
Команда установки:
AT+CIPSTAMAC_DEF=<mac>
Назначение: установить MAC адрес станции ESP8266.
Отклик+CIPSTAMAC_DEF:<mac>
OK
OK
Параметры<mac> – строковый параметр, MAC адрес станции ESP8266.
Примечания
  • Изменения конфигурации сохраняются в области пользовательских параметров во флеш-памяти.
  • MAC адрес SoftAP (точки доступа) ESP8266 отличается от адреса станции ESP8266. Пожалуйста, убедитесь, что вы не установили одинаковые адреса им обоим.
  • Бит 0 MAC адреса ESP8266 НЕ МОЖЕТ быть равен 1. Например, MAC адрес может быть таким "18:...", но не может быть таким "15:...".
ПримерAT+CIPSTAMAC_DEF="18:fe:35:98:d3:7b"
AT+CIPAPMAC_CUR – установить MAC адрес точки доступа SoftAP ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPAPMAC_CUR?
Назначение: предоставить MAC адрес точки доступа SoftAP ESP8266.
Команда установки:
AT+CIPAPMAC_CUR=<mac>
Назначение: установить MAC адрес точки доступа SoftAP ESP8266.
Отклик+CIPAPMAC_CUR:<mac>
OK
OK
Параметры<mac> – строковый параметр, MAC адрес точки доступа SoftAP ESP8266.
Примечания
  • Изменения конфигурации НЕ сохраняются во флеш-памяти.
  • MAC адрес SoftAP (точки доступа) ESP8266 отличается от адреса станции ESP8266. Пожалуйста, убедитесь, что вы не установили одинаковые адреса им обоим.
  • Бит 0 MAC адреса ESP8266 НЕ МОЖЕТ быть равен 1. Например, MAC адрес может быть таким "18:...", но не может быть таким "15:...".
ПримерAT+CIPSTAMAC_CUR="1a:fe:36:97:d5:7b"
AT+CIPAPMAC_DEF – установить MAC адрес точки доступа SoftAP ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPAPMAC_DEF?
Назначение: предоставить MAC адрес точки доступа SoftAP ESP8266.
Команда установки:
AT+CIPAPMAC_DEF=<mac>
Назначение: установить MAC адрес точки доступа SoftAP ESP8266.
Отклик+CIPAPMAC_DEF:<mac>
OK
OK
Параметры<mac> – строковый параметр, MAC адрес точки доступа SoftAP ESP8266.
Примечания
  • Изменения конфигурации сохраняются в области пользовательских параметров во флеш-памяти.
  • MAC адрес SoftAP (точки доступа) ESP8266 отличается от адреса станции ESP8266. Пожалуйста, убедитесь, что вы не установили одинаковые адреса им обоим.
  • Бит 0 MAC адреса ESP8266 НЕ МОЖЕТ быть равен 1. Например, MAC адрес может быть таким "18:...", но не может быть таким "15:...".
ПримерAT+CIPAPMAC_DEF="1a:fe:36:97:d5:7b"
AT+CIPSTA_CUR – установить IP адрес станции ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPSTA_CUR?
Назначение: предоставить текущий IP адрес станции ESP8266.
Команда установки:
AT+CIPSTA_CUR=<ip>[,<gateway>,<netmask>]
Назначение: установить текущий IP адрес станции ESP8266.
Отклик+CIPSTA_CUR:<ip>
+CIPSTA_CUR:<gateway>
+CIPSTA_CUR:<netmask>

OK
OK
ПараметрыВнимание:
IP адрес станции ESP8266 может быть запрошен, только когда она подключена к точке доступа.
  • <ip> – строковый параметр, IP адрес станции ESP8266;
  • [<gateway>] – шлюз;
  • [<netmask>] – маска подсети.
Примечания
  • Изменения конфигурации НЕ сохраняются во флеш-памяти.
  • Команда установки взаимодействует с AT командами, связанными с DHCP (команды из серии AT+CWDHCP):
    • если включается статический IP адрес, DHCP будет выключен;
    • если включается DHCP, статический IP адрес будет выключен;
    • будет ли включен DHCP или статический IP адрес, зависит от последней конфигурации.
ПримерAT+CIPSTA_CUR="192.168.6.100","192.168.6.1","255.255.255.0"
AT+CIPSTA_DEF – установить IP адрес станции ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPSTA_DEF?
Назначение: предоставить IP адрес станции ESP8266 по умолчанию.
Команда установки:
AT+CIPSTA_DEF=<ip>[,<gateway>,<netmask>]
Назначение: установить IP адрес станции ESP8266 по умолчанию.
Отклик+CIPSTA_DEF:<ip>
+CIPSTA_DEF:<gateway>
+CIPSTA_DEF:<netmask>

OK
OK
ПараметрыВнимание:
IP адрес станции ESP8266 может быть запрошен, только когда она подключена к точке доступа.
  • <ip> – строковый параметр, IP адрес станции ESP8266;
  • [<gateway>] – шлюз;
  • [<netmask>] – маска подсети.
Примечания
  • Изменения конфигурации сохраняются в области пользовательских параметров во флеш-памяти.
  • Команда установки взаимодействует с AT командами, связанными с DHCP (команды из серии AT+CWDHCP):
    • если включается статический IP адрес, DHCP будет выключен;
    • если включается DHCP, статический IP адрес будет выключен;
    • будет ли включен DHCP или статический IP адрес, зависит от последней конфигурации.
ПримерAT+CIPSTA_DEF="192.168.6.100","192.168.6.1","255.255.255.0"
AT+CIPAP_CUR – установить IP адрес точки доступа SoftAP ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPAP_CUR?
Назначение: предоставить текущий IP адрес точки доступа SoftAP ESP8266.
Команда установки:
AT+CIPAP_CUR=<ip>[,<gateway>,<netmask>]
Назначение: установить текущий IP адрес точки доступа SoftAP ESP8266.
Отклик+CIPAP_CUR:<ip>
+CIPAP_CUR:<gateway>
+CIPAP_CUR:<netmask>

OK
OK
Параметры
  • <ip> – строковый параметр, IP адрес точки доступа SoftAP ESP8266;
  • [<gateway>] – шлюз;
  • [<netmask>] – маска подсети.
Примечания
  • Изменения конфигурации НЕ сохраняются во флеш-памяти.
  • В настоящее время ESP8266 поддерживает IP адреса только класса C.
  • Команда установки взаимодействует с AT командами, связанными с DHCP (команды из серии AT+CWDHCP):
    • если включается статический IP адрес, DHCP будет выключен;
    • если включается DHCP, статический IP адрес будет выключен;
    • будет ли включен DHCP или статический IP адрес, зависит от последней конфигурации.
ПримерAT+CIPAP_CUR="192.168.5.1","192.168.5.1","255.255.255.0"
AT+CIPAP_DEF – установить IP адрес точки доступа SoftAP ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CIPAP_DEF?
Назначение: предоставить IP адрес точки доступа SoftAP ESP8266 по умолчанию.
Команда установки:
AT+CIPAP_DEF=<ip>[,<gateway>,<netmask>]
Назначение: установить IP адрес точки доступа SoftAP ESP8266 по умолчанию.
Отклик+CIPAP_DEF:<ip>
+CIPAP_DEF:<gateway>
+CIPAP_DEF:<netmask>

OK
OK
Параметры
  • <ip> – строковый параметр, IP адрес точки доступа SoftAP ESP8266;
  • [<gateway>] – шлюз;
  • [<netmask>] – маска подсети.
Примечания
  • Изменения конфигурации сохраняются в области пользовательских параметров во флеш-памяти.
  • В настоящее время ESP8266 поддерживает IP адреса только класса C.
  • Команда установки взаимодействует с AT командами, связанными с DHCP (команды из серии AT+CWDHCP):
    • если включается статический IP адрес, DHCP будет выключен;
    • если включается DHCP, статический IP адрес будет выключен;
    • будет ли включен DHCP или статический IP адрес, зависит от последней конфигурации.
ПримерAT+CIPAP_DEF="192.168.5.1","192.168.5.1","255.255.255.0"
AT+CWSTARTSMART – запустить SmartConfig
КомандаКоманда выполнения:
AT+CWSTARTSMART
Назначение: запустить SmartConfig (тип SmartConfig это ESP-TOUCH + AirKiss).
Команда установки:
AT+CWSTARTSMART=<type>
Назначение: запустить SmartConfig с указанным типом.
ОткликOK
Параметры<type>
  • 1 – ESP-TOUCH
  • 2 – AirKiss
  • 3 – ESP-TOUCH+AirKiss
СообщенияПри запуске SmartConfig будут выданы следующие сообщения:
smartconfig type:<type>          // AIRKISS или ESPTOUCH
smart get wifi info                 // получение SSID и пароля
ssid:<SSID точки доступа>
password:<пароль точки доступа>
// ESP8266 попытается подключиться к точке доступа
WIFI CONNECTED
WIFI GOT IP
smartconfig connected wifi   // если подключение прошло неудачно, то будет выдано сообщение "smartconfig connect fail"
Примечания
  • Подробности о SmartConfig смотрите в ESP-TOUCH User Guide.
  • SmartConfig доступен только в режиме станции ESP8266.
  • Сообщение smart get wifi info означает, что SmartConfig успешно получил информацию о точке доступа. ESP8266 попытается подключиться к целевой точке доступа.
  • Сообщение smartconfig connected wifi выводится, если соединение прошло успешно. Перед использованием других команд используйте команду AT+CWSTOPSMART, чтобы остановить SmartConfig. Пожалуйста убедитесь, что не выполняете других команд во время SmartConfig.
  • Начиная с AT v.1.0, SmartConfig может получать тип протокола (AirKiss или ESP-TOUCH) автоматически с помощью команды AT+CWSTARTSMART.
ПримерAT+CWMODE=1
AT+CWSTARTSMART
AT+CWSTOPSMART – остановить SmartConfig
Команда выполненияAT+CWSTOPSMART
ОткликOK
Параметры
ПримечаниеНезависимо от того, успешно или нет прошел SmartConfig, перед выполнением любых других AT команд всегда вызывайте AT+CWSTOPSMART, чтобы освободить внутреннюю память, занятую SmartConfig.
ПримерAT+CWSTOPSMART
AT+CWSTARTDISCOVER – включить режим, в котором ESP8266 может быть найден с помощью WeChat
Команда установкиAT+CWSTARTDISCOVER=<WeChat number>,<dev_type>,<time>
ОткликOK
Параметры
  • <WeChat number> – официальный аккаунт WeChat, который должен быть получен от WeChat;
  • <dev_type> – тип устройства, который должен быть получен от WeChat;
  • <time> – временной интервал, с которым ESP8266 будет посылать пакеты; единица: секунда; диапазон: 0 – 24x3600
    • 0 – ESP8266 не берет на себя инициативу по отправке пакетов, он тольк отвечает на запросы из WeChat;
    • в противном случае – временной интервал, с которым ESP8266 регулярно отправляет пакеты для обнаружения WeChat в той же локальной сети.
Примечание
  • Подробности о функции обнаружения WeChat смотрите в http://iot.weixin.qq.com.
  • Перед использованием данной команды станция ESP8266 должна быть подключена к точке доступа, и должен быть получен IP адрес.
ПримерAT+CWSTARTDISCOVER="gh_9e2cff3dfa51","122475",10
AT+CWSTOPDISCOVER – выключить режим, в котором ESP8266 может быть найден с помощью WeChat
Команда выполненияAT+CWSTOPDISCOVER
ОткликOK
ПримерAT+CWSTOPDISCOVER
AT+WPS – включить работу WPS
Команда установкиAT+WPS=<enable>
ОткликOK
Параметры<enable>
  • 1 – включить WPS/Wi-Fi Protected Setup
  • 0 – выключить WPS
Примечания
  • WPS должен использоваться, когда включена станция ESP8266.
  • WPS не поддерживает шифрование WEP/Wired-Equivalent Privacy.
ПримерAT+CWMODE=1
AT+WPS=1
AT+MDNS – включить работу MDNS
Команда установкиAT+MDNS=<enable>,<hostname>,<server_name>,<server_port>
ОткликOK

или

opmode mismatch when mdns
ERROR
Параметры
  • <enable>:
    • 1 – включить работу MDNS; следующие три параметра должны быть установлены;
    • 0 – выключить работу MDNS; следующие три параметра должны быть не установлены;
  • <hostname> – имя хоста MDNS;
  • <server_name> – имя сервера MDNS;
  • <server_port> – порт сервера MDNS.
Примечания
  • Пожалуйста, не используйте в <hostname> и <server_name> специальных символов (таких как .) и названий протоколов (например, http).
  • Режим точки доступа SoftAP ESP8266 в настоящее время не поддерживает работу MDNS.
ПримерAT+MDNS=1,"espressif","iot",8080
AT+CWHOSTNAME – установить имя станции ESP8266
КомандаКоманда запроса:
AT+CWHOSTNAME?
Назначение: проверить имя станции ESP8266.
Команда установки:
AT+CWHOSTNAME=<hostname>
Назначение: установить имя хоста станции ESP8266.
Отклик+CWHOSTNAME:<hostname>
OK


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

+CWHOSTNAME:<null>
OK
OK

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

ERROR
Параметры<hostname> – имя хоста станции ESP8266, максимальная длина равна 32 байта.
Примечания
  • Изменения конфигурации не сохраняются во флеш-памяти.
  • Имя хоста станции ESP8266 по умолчанию – это ESP_XXXXXX; где XXXXXX – 3 младших байта MAC адреса, например, +CWHOSTNAME:<ESP_A378DA>.
ПримерAT+CWMODE=3
AT+CWHOSTNAME="my_test"
AT+CWCOUNTRY_CUR – установить Wi-Fi код страны для ESP8266; конфигурация не сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWCOUNTRY_CUR?
Назначение: проверить текущий Wi-Fi код страны ESP8266.
Команда установки:
AT+CWCOUNTRY_CUR=<country_policy>,<country_code>,<start_channel>,<total_channel_number>
Назначение: установить текущий Wi-Fi код страны ESP8266.
Отклик+CWCOUNTRY_CUR:<country_policy>,<country_code>,<start_channel>,<total_channel_number>
OK


Команда AT+CWCOUNTRY_CUR? вернет действующее значение WiFi кода страны, которое может измениться так же, как и точка доступа, к которой подключен ESP8266.
OK
Параметры
  • <country_policy>:
    • 0 – изменит код страны на такой же, какой у точки доступа, к которой подключен;
    • 1 – код страны не изменит, он всегда будет установлен командой
  • <country_code> – код страны, длина может быть максимум 3 символа; но третий символ – это специальный символ, который не будет показан при запросе с помощью команды AT+CWCOUNTRY_CUR?
  • <start_channel> – канал, с которого начинать;
  • <total_channel_number> – общее количество каналов.
ПримечанияИзменения конфигурации не сохраняются во флеш-памяти.
ПримерAT+CWMODE=3
AT+CWCOUNTRY_CUR=1,"CN",1,13
AT+CWCOUNTRY_DEF – установить Wi-Fi код страны по умолчанию для ESP8266; конфигурация сохраняется во флеш-памяти
КомандаКоманда запроса:
AT+CWCOUNTRY_DEF?
Назначение: проверить Wi-Fi код страны ESP8266, установленный по умолчанию.
Команда установки:
AT+CWCOUNTRY_DEF=<country_policy>,<country_code>,<start_channel>,<total_channel_number>
Назначение: установить Wi-Fi код страны ESP8266 по умолчанию и сохранить его во флеш-памяти.
Отклик+CWCOUNTRY_DEF:<country_policy>,<country_code>,<start_channel>,<total_channel_number>
OK


Команда AT+CWCOUNTRY_DEF? вернет значение WiFi кода страны по умолчанию, которое сохранено во флеш-памяти.
OK
Параметры
  • <country_policy>:
    • 0 – изменит код страны на такой же, какой у точки доступа, к которой подключен;
    • 1 – код страны не изменит, он всегда будет установлен командой
  • <country_code> – код страны, длина может быть максимум 3 символа; но третий символ – это специальный символ, который не будет показан при запросе с помощью команды AT+CWCOUNTRY_DEF?
  • <start_channel> – канал, с которого начинать;
  • <total_channel_number> – общее количество каналов.
ПримечанияИзменения конфигурации сохраняются в области пользовательских параметров во флеш-памяти.
ПримерAT+CWMODE=3
AT+CWCOUNTRY_DEF=1,"CN",1,13

Теги

ADC / АЦП (аналого-цифровой преобразователь)AT командаESP8266EspressifGPIORAMUARTWi-FiWi-Fi модульОтладочная плата

На сайте работает сервис комментирования DISQUS, который позволяет вам оставлять комментарии на множестве сайтов, имея лишь один аккаунт на Disqus.com.

В случае комментирования в качестве гостя (без регистрации на disqus.com) для публикации комментария требуется время на премодерацию.