Skip to main content

AT Command Set

This section provides a list of WizFi250 AT commands and their effects. Users can input commands and parameters through USART line. Every command starts with the characters โ€œATโ€. Any other initial character will cause an error in return. Commands and parameters are all ASCII characters, e.g. When you input 'AT+MMSG=1', you can input ASCII characters 'A', 'T', '+', 'M', 'M', 'S', 'G', '=', '1' and 'Enter Key' which should be CR(0x0d), but neither CRLF(0x0d, 0x0a) nor LF(0x0a).

Some parameters are mandatory and the others are optional. (refer to Command Tables) Parameters must be entered in an order of format column given by the command tables. Even though an optional parameter is not used, the comma delimiters must still be included in the command. In most cases, valid commands return the characters [OK]. Invalid inputs return [ERROR]. The possible responses sent by WizFi250 to the user side are described at Responses. Below is a possible example which users can input. As you can see, WizFi250 return "\r\n" back instead of "\r", which means user (host system) always handle '\r\n' as a only delimiter.

input by userAT\r (0x61 0x74 0x0d)
Output from WizFi250AT\r\n[OK]\r\n (0x0d 0x0a 0x5b 0x4f 0x4b 0x5d 0x0d 0x0a)(* โ€œAT\r\nโ€ is Echo back of user input)

Responses#

Responses are listed below.

ResponseMeaning
[OK]Command Request Success
[ERROR]Command Request Fail
[ERROR: INVALID INPUT]Wrong command or parameter
[ERROR: INVALID SCID]Wrong Socket ID
[ERROR: WiFi Status]Wrong WiFi Status (Some commands work only with Wi-Fi Joined status)
[ERROR: Mode Status]Wrong Mode Status (Some commands do not work in Data mode)
[CONNECT x]TCP Connection established & Socket Open
[DISCONNECT x]TCP Connection closed & Socket Close
[Link-Up Event]WiFi Connection was established
[Link-Down Event]WiFi Connection was closed
[Reset Event]System reset occurred (not by user)

Command list#

Basic Commands
ATTerminal Check
WiFi Commands
AT+WJOINWiFi Association
AT+WLEAVEWiFi Disassociation
AT+WSCANWiFi Scan
AT+WSETWiFi Configuration
AT+WSECWiFi Security Configuration
AT+WNETNetwork Configuration
AT+WSTATGet Current WiFi Status
AT+WREGCountry Configuration
AT+WWPSWiFi WPS Connection
AT+WANTWiFi Antenna Configuration
AT+WP2P_STARTStart WiFi Direct
AT+WP2P_STOPStop WiFi Direct
AT+WP2P_PEERLISTGet WiFi Direct peer list
AT+WP2P_INVITEInvite WiFi Direct peer ID
AT+WCHECKCheck Wi-Fi status using Ping and Re-association with AP
Network Commands
AT+SCONSocket Open/Connect
AT+SMGMTSocket Management
AT+SSENDData Send
AT+SDATAReturn to Data Mode
AT+SFORMDefine Data Receive Header Form
Management Commands
AT+MPROFProfile Management
AT+MFDEFPerform Factory Reset
AT+MRESETPerform System Reset
AT+MMSGSet Message Print Level
AT+MMACSet MAC Address
AT+MINFOGet System Information
AT+MECHOSet Echo Mode
AT+MHELPPrint Command Description and Usage
AT+MMCUPSMCU Power Save Enable/Disable
AT+MWIFIPSWi-Fi Power Save Enable/Disable
AT+MCWUIChange WebServer User Information
AT+USETUART Configuration
AT+MSPISPI Configuration
AT+MAIRCMDAir Command Configuration
AT+MEVTMSGPrint [Listen x] as soon as it opens up a socket through TCP server.
AT+MEVTFORMEvent Message Form
Function Commands
AT+FPINGPING Test
AT+FDNSDNS Query
AT+FWEBSLaunch Web Server
AT+FGPIOGPIO Control
AT+FSOCKSOCKET Extension Option
AT+FOTALaunch OTA Mode

Basic Commands#

Basic commands are listed below.


AT#

  • Format:
AT
  • Meaning: Terminal Check

Check if AT Command Terminal is working.

  • Response:
[OK]

WiFi Commands#

Commands related to WiFi are listed below.


AT+WJOIN#

  • Format:
AT+WJOIN
  • Meaning: WiFi Association

In the STA mode, it joins with the BSS selected by AT+WSET, AT+WSEC.
And in the AP mode, it starts to run as an Access Point.

  • There are 2 Wi-Fi modes in WizFi250, STA mode and SoftAP mode. When users execute AT+WJOIN command, the current Wi-Fi mode works as the one previously selected by user input. It can be selected or checked by AT+WSET and AT+WSEC commands, and it is the only way to handle Wi-Fi mode.
  • SoftAP mode does not support WEP security method.
  • Response:
Joining : (SSID)
Successfully joined : (SSID)
[Link-Up Event]
IP Addr : xxx.xxx.xxx.xxx
Gateway : xxx.xxx.xxx.xxx
[OK]
Already Associated :
(Mode)
[OK]

AT+WLEAVE#

  • Format:
AT+WLEAVE
  • Meaning: WiFi Disassociation

    In the STA mode, it leaves current BSS, but in the SoftAP mode, it stops to run as Access Point.

  • Response:
[Link-Down Event]
[OK]
[OK]

AT+WSCAN#

  • Format:
AT+WSCAN=<SSID>,<BSSID>,<Channel>
  • Meaning: WiFi Scan

Return the scan results filtered by parameters.

<SSID>: SSID Filter (Optional)
Scan only the AP which has this SSID.
<BSSID>: BSSID Filter (Optional)
Scan only the AP which has this BSSID.
<Channel>: Channel Filter (Optional)
Scan only the AP in this Channel.

When combining these filters, it works at the same time. For example, if you enter AT+WSCAN=TestAP,00:08:DC:11:22:33', it only scans the AP which has TestAP as SSID and 00:08:DC:11:22:33 as BSSID in all the channel.

Examples)

* AT+WSCAN=TestAP
* AT+WSCAN=,,6
* AT+WSCAN=,08:00:DC:11:22:33,11
  • Response:

    Index/SSID/BSSID/RSSI(-dBm)/MaxDataRate(Mbps)/Security/RadioBand (GHz)/Channel ... [OK]

AT+WSET#

  • Format:
AT+WSET=<WiFiMode>,<SSID>,<BSSID>,<Channel>
  • Meaning: WiFi Configuration

<WiFiMode>: WiFi Mode to set (Required)
This changes current WiFi mode.

ParameterMeaning
0Set Wi-Fi mode as STA mode
1Set Wi-Fi mode as AP mode

<SSID>: Target/Own SSID (Required, Max: 32 Character)

ModeMeaning
STAThe SSID of target AP
APIts own SSID to run

<BSSID>: Target BSSID (Optional, Form: xx:xx:xx:xx:xx:xx)

ModeMeaning
STAThe BSSID of target AP
APNot used. if any, it will be ignored

<Channel>: Target/Own Channel (Optional)

ModeMeaning
STAIn STA mode, the Channel of target AP
APIn AP mode, its own Channel to run (Default: 6)

* There are 2 Wi-Fi modes in WizFi250, STA mode and SoftAP mode. When users execute AT+WJOIN command, it works as Wi-Fi mode previously selected by the user. It can be selected or checked by AT+WSET and AT+WSEC commands, and it is the only way to handle Wi-Fi mode.

* AT+WSET, AT+WSEC commands save its parameters into the profile automatically, so the user does not need to save the current profile.

Examples)

* AT+WSET=0,WizFiAP
* AT+WSET=0,WizFiAP,08:00:DC:11:22:33,1
  • Response:

    [OK]

  • Format:

    AT+WSET=?

  • Meaning: Get Current Setting

  • Response:

<WiFiMode>,<SSID>,<BSSID>,<Channel>
[OK]

AT+WSEC#

  • Format:
AT+WSEC=<WiFiMode>,<SecType>,<Key>
  • Meaning: WiFi Security Configuration

<WiFiMode>: Target WiFi mode to set (Required)

ParameterMeaning
0Set Wi-Fi mode as STA mode
1Set Wi-Fi mode as AP mode

<SecType>: Security type (Optional)

ParameterMeaning
OPENNone
WiFi Auto Security
WEPWEP (* Not support at SoftAP mode)
WPAWPA1 - TKIP
WPAAESWPA1 - AES
WPA2AESWPA2 - AES
WPA2TKIPWPA2 - TKIP
WPA2WPA2 - Mixed

<Key>: Security key value

MethodLength
WEP5 or 13 (ASCII), 10 or 26 (HEX)
WPA8 ~ 63 (ASCII), 128 (HEX)

* There are 2 Wi-Fi modes in WizFi250, STA mode and SoftAP mode. When users execute AT+WJOIN command, it works as Wi-Fi mode previously selected by the user. It can be selected or checked by AT+WSET and AT+WSEC commands, and it is the only way to handle Wi-Fi mode.

* AT+WSET, AT+WSEC commands save its parameters into the profile automatically, it works as Wi-Fi mode previously selected by the user.

* Minimum key length is 8 bytes in WiFi Auto Security.
In case of WEP mode and 5 bytes key, you should input the key with HEX type.
AT+WSEC=0,,12345(X)
AT+WSEC=0,,3132333435(O)
In case of OPEN mode, you should input the 8 bytes dummy string. Then WizFi250 will ignore the dummy key in OPEN mode.
AT+WSEC=0,,(X)
AT+WSEC=0,,12345678(O)

Examples)

* AT+WSEC=0,WEP,12345
* AT+WSEC=1,WPA2,12345678
* AT+WSEC=0,,123456789\\ \\
  • Response:

[OK]

  • Format:

    AT+WSEC=?

  • Meaning: Get Security Setting of Current Mode

  • Response:

<WiFiMode>,<SecType>,<Key>
[OK]

AT+WNET#

  • Format:
AT+WNET=<DHCP>,<IP>,<SN>,<GW>
  • Meaning: Network Configuration

<DHCP>: DHCP On/Off (Optional)

ParameterMeaning
0DHCP Off, Static
1DHCP On, DHCP Client
ModeMeaning
STADHCP Client On/Off
APNot used. if any, it will be ignored

<IP>: IP Address (Optional)
<SN>: Subnet Mask (Optional)
<GW>: Gateway Address (Optional)

ModeMeaning
STAAP(Router) gateway address
APNot used. if any, it will be ignored

* When you turn DHCP On in STA Mode, <IP>,<SN>,<GW> are not needed. If you input them at this time, they will be stored in the memory. They can be used later when set as Static(DHCP Off) without inputting these parameters.

* In AP mode, DHCP Server will always run despite DHCP option, and Gateway option will not be used, So both options will be ignored.

  • Response:

[OK]

  • Format:

AT+WNET=?

  • Meaning: Get Current Network Setting

    Note that <IP>,<SN>,<GW> address of response are not actual addresses, but addresses stored in the memory. So when DHCP is on, it usually different from actual addresses.

  • Response:

<DHCP>,<IP>,<SN>,<GW>
[OK]

AT+WSTAT#

  • Format:
AT+WSTAT
  • Meaning: Get Current WiFi Status

  • Response:

IF/SSID/IP-Addr/Gateway/MAC/TxPower(dBm)/RSSI(-dBm)
...
[OK]

AT+WREG#

  • Format:
AT+WREG=<Country>
  • Meaning: Country Configuration

Input a two letter country code (ISO 3166-1 A2) like US.

  • Response:

    [OK]

  • Format:

    AT+WREG=?

  • Meaning: Get Current Country Setting

    Refer to ISO 3166-1 A2

  • Response:

<Country>
[OK]

AT+WWPS#

  • Format:
AT+WWPS=<Mode>,<PinNum>
  • Meaning: WiFi WPS Connection

Join with an AP through WPS method

<Mode>: WPS Mode (Required)

ParameterMeaning
0WPS_PBC_MODE
1WPS_PIN_MODE

<PinNum>: Pin Number (Pin Mode: Required, PBC Mode: N/A)
* The maximum pin number letter is 8.

Examples)

* AT+WWPS=0
* AT+WWPS=1,12345670
  • Response:

    [OK]


AT+WANT#

  • Format:
AT+WANT=<Antenna type>
  • Meaning: WiFi Antenna Configuration

You had better not use this command unless it's absolutely necessary.

<Mode>: WiFi Antenna Type (Required)

ParameterMeaning
0u.FL Antenna
1PCB Antenna
3Auto Selection
  • Response:

    [OK]


  • Format:

    AT+WANT=?

  • Meaning: Get Current WiFi Antenna Type

  • Response:

<Antenna Type>
[OK]

AT+WP2P_START#

  • Format:
AT+WP2P_START
  • Meaning: Start WiFi Direct

  • Response:

    STA MAC: CE:52:AF:C6:CF:B5 [OK]

AT+WP2P_STOP#

  • Format:
AT+WP2P_STOP
  • Meaning: Stop WiFi Direct

  • Response:

    [OK]

AT+WP2P_PEERLIST#

  • Format:
AT+WP2P_PEERLIST
  • Meaning: Get WiFi Direct peer list

  • Response:

P2P Peers:
0: 'SHV-E250S' on channel 1
[OK]

AT+WP2P_INVITE#

  • Format:
AT+WP2P_INVITE=<Peer ID>
  • Meaning: Invite WiFi Direct peer ID

    <Peer ID>: Peer ID to invite. This is from <AT+WP2P_PEERLIST> command.(Required)

  • Response:

    [OK]

AT+WCHECK#

  • Format:
AT+WCHECK=<time>,<ping try>,<ping error>
  • Meaning: Check Wi-Fi status using Ping and Re-association with AP

It must be set as service mode in order to use Re-association function.
This function only exist later vision of F/W 1.0.3.5.

To use this option, you must enter a non-zero value.

<time>: try to ping (to gateway) each time. 10 ~ 86400(required, unit:sec)
<ping try>: count of ping. 5 ~ 20(required, unit:number of times)
<ping error>: WizFi250 will be disassociated if ping timeout is more than this. 1 ~ 20(required, unit:number of times)

Examples)

* AT+WCHECK=0,0,0 (Not in use)
* AT+WCHECK=60,5,3 (Recommended. WizFi250 will try to ping to the gateway every 60 seconds. If ping timeout is more than 3, it would be disassociated.)
  • Response:

    [OK]

AT+WADNS#

  • Format:
AT+WADNS=<DNS Server1>,<DNS Server2>
  • Meaning: Add DNS Server

<DNS Server 1>: DNS Server 1
<DNS Server 2>: DNS Server 2

Examples)

* AT+WADNS=8.8.8.8
  • Response:

    [OK]

Network Commands#

Commands related to Network are listed below.


AT+SCON#

  • Format:
AT+SCON=<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>
  • Meaning: Socket Open/Connect ( User can use max 8 sockets. )

Opens a socket and if it is a TCP Client, establishes TCP connection with remote peer device.

<OpenType>: Socket open type (Required)

ParameterMeaning
Oopen at Once
Sregister as a Service
SOopen at Once & register as a Service

* AT ONCE: Assigns a socket immediately and if the socket is a TCP Client, tries to connect peer socket.

* AS SERVICE: Registers its information to the profile. When WiFi Joined, socket open/connect will be performed automatically. If you want to use this after reset, It should be saved by using AT+MPROF=S.

<SocketType>: Socket protocol to use (Required)

ParameterMeaning
TSNTCP Server Normal
TSSTCP Server Secured
TCNTCP Client Normal
TCSTCP Client Secured
USNUDP Server Normal
UCNUDP Client Normal

* 'Secured' means TCP connection through SSL Encryption.

* Actually, there is no Server/Client concept in UDP protocol. This concept is used to decide peer address purposes. If a UDP Server receives any packet, its default peer address will be changed to the address of the packet, so if you send data after that, it goes to the changed address. But If you use UDP Client, its โ€ฆdefault address stored by AT+SCON will never be changed.

<RemoteIP>: Remote IP address

ProtocolParameter Application
TCP ServerN/A
TCP ClientRequired
UDP ServerOptional
UDP ClientRequired

<RemotePort>: Remote port number
Same condition with upper, RemoteIP

<LocalPort>: Local port number (Required)
Local port number should not be duplicated with others which have opened before. When the value is 0, in case the socket was a TCP/UDP Client, a random port number will be selected. If it was a TCP/UDP Server, it will return an error message.

<DataMode>: Mode to run (Optional, default: 0)

ParameterMeaning
0Open as Command mode
1Open as Data mode

* About Command/Data mode, refer to [Command mode & Data mode]

Examples)

* AT+SCON=O,TSN,,,5000,0
* AT+SCON=S,UCN,192.168.0.10,12345,5000,1 (Profile must be saved)
  • Response:

    [OK]

  • Format:

    AT+SCON=?

  • Meaning: Get Previous Input Parameters

    Use for check if previous input parameters are correct.

  • Response:

<OpenType>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>
[OK]

AT+SMGMT#

  • Format:
AT+SMGMT=<SocketID>
  • Meaning: Socket Management - Socket Close

    Closes the selected socket and releases all its resources.

<SocketID>: Socket ID (Required)

ParameterMeaning
0 ~ 7The socket ID to close
ALLAll the opened sockets

* Opened socket information can be found by using '?' option.

Examples)

* AT+SMGMT=5
* AT+SMGMT=ALL
  • Response:

    [OK]

  • Format:

    AT+SMGMT=?

  • Meaning: Socket Management - Get Opened Socket Status

    This prints all of the opened sockets statuses.

  • Response:

Number of Sockets : x (SCID/Socket/Mode/Remote/Local/DataMode)
<SocketID>,<SocketAddr>,<SocketType>,<RemoteIP>,<RemotePort>,<LocalPort>,<DataMode>
...
[OK]

AT+SSEND#

  • Format:
AT+SSEND=<SocketID>,<RemoteIP>,<RemotePort>,<SendSize>,<Timeout>
  • Meaning: Data Send

This is used only in command mode, not in data mode. It is not required in data mode as you can input directly, but if you exit from data mode to command mode by inputting '+++', you can send data through this command.

<SocketID>: Socket ID (Required)

<RemoteIP>: Remote IP Address

ProtocolParameter Application
TCP ServerN/A
TCP ClientN/A
UDP ServerOptional
UDP ClientOptional

* In case of TCP Server waiting for a client on listen state or in case of undecided remote address of the UDP Server (meaning its remote address is 0.0.0.0:0), this command will fail.

<RemotePort>: Remote Port Number
Same condition with upper, RemoteIP

<SendSize>: Data size to send (Required)
Valid Range: 1 ~ 100,000,000 Byte

<Timeout >: Set timeout value (milliseconds unit) (Optional)
If the transmission takes time more time than timeout value, it will fail and return error response. Default value is 10s + (100s / 1 MB)

Examples)

* AT+SSEND=0,,,3
* AT+SSEND=1,192.168.0.100,5000,1000000,50000
  • Response:

    [OK]

AT+SDATA#

  • Format:
AT+SDATA
  • Meaning: Return to Data Mode

    In data mode, it can be changed to command mode temporally by using serial '+++' input. After that, to return to the data mode, you can use this command. If it is not data mode, [ERROR] response will be returned.

  • Response:

    [OK]

AT+SFORM#

  • Format:
AT+SFORM=<Format>,<Start>,<Delim>,<End>,<Cls1>,<Cls2>
  • Meaning: Define Data Receive Header Form

Define the header of received data which is used at command mode. For example, default receiving format look like below.
"{0,192.168.0.216,59834,5}hello(0xd)(0xa)"
This means ASCII code "hello" was received from 192.168.0.216:59834 by socket ID 0, and its length was 5. You can change this format to suit your system through this command. Factory default option is "111111111,7B,2C,7D,0D,0A"

<Format>: Decide each of header items to use. (Required)
If you want to set it to active, input '1', if not, input '0'.

OrderMeaning
0Header Start
1Socket ID
2Delimiter
3Remote IP Address
4Remote Port Number
5Data Length
6Header End
7Data End 1/2
8Data End 2/2

* At default format, '{' '}' is header start and end, ',' is delimiter, 0xd,0xa is data end 1,2.

< Start>: Header Start Character (Required)
< Delim>: Delimiter Character (Required)
< End>: Header End Character (Required)
< Cls1>: Data End Character 1/2 (Required)
< Cls2>: Data End Character 2/2 (Required)

Examples)

* AT+SFORM=111111111,7B,2C,7D,0D,0A
* AT+SFORM=101100110,5B,2F,5D,0D,00
  • Response:

    [OK]

  • Format:

    AT+SFORM=?

  • Meaning: Get Current Data Receive Header Form

  • Response:

<Format>,<Start>,<Delim>,<End>,<Cls1>,<Cls2>
[OK]

AT+SOPT1#

  • Format:
AT+SOPT1=<Option>,<Value>
  • Meaning: S2W miscellaneous option

<Option>: Option to configure (Required) <Value>: Value of the option (Required)

OptionValue
10Escape sequence(+++) Timer(millisecond, default 1000, 1~10000)

Examples)

* AT+SOPT1=10,500
  • Response:

    [OK]

Management Commands#

Commands related to system management are listed below.


AT+MPROF#

  • Format:
AT+MPROF=<Action>
  • Meaning: Profile Management

    You can save/load the environmentalinformation in the RAM to/from flash ROM, or check the setting values in both of them through this command.

<Action>: The action to perform (Required)

ParameterMeaning
VDGet saved profile
VGGet current profile
LLoad profile
SSave profile

* There is no '?' option at this command.

Examples)

* AT+MPROF=S
  • Response:

    [OK]

    +WSET=... +WSEC=... +WNET=... +WREG=... +SCON=... +SFORM=... +MMSG=... +MMAC=... +USET=... +MECHO=... +FWEBS=... [OK]

AT+MFDEF#

  • Format:
AT+MFDEF=FR
  • Meaning: Perform Factory Reset

Factory Reset means that all of environmental variables return back to the default state. (You can check that by using AT+MPROF command)

  • Response:

    [OK]

AT+MRESET#

  • Format:
AT+MRESET
  • Meaning: Perform System Reset

System will reboot after this command.

  • Response:

    [OK]

AT+MMSG#

  • Format:
AT+MMSG=<Level>
  • Meaning: Set Message Print Level

    <Level>: Message Print Level (Required)

ParameterMeaning
1Not Print Responses
2Print Responses, Events (Default)
3Print Responses, Events, Debug Logs

Examples)

* AT+MMSG=2
  • Response:

    [OK]

  • Format:

    AT+MMSG=?

  • Meaning: Get Current Message Print Level

  • Response:

<Level>
[OK]

AT+MMAC#

  • Format:
AT+MMAC=<MAC>
  • Meaning: Set MAC Address

    <MAC>: MAC Address (separated by colon) (Required)

Examples)

* AT+MMAC=00:08:DC:11:22:33
  • Response:

    [OK]

  • Format:

    AT+MMAC=?

  • Meaning: Get Current MAC Address

  • Response:

<MAC>
[OK]

AT+MINFO#

  • Format:
AT+MINFO
  • Meaning: Get System Information

  • Response:

FW version / HW version
<FWver> / <HWver>
[OK]

AT+MECHO#

  • Format:
AT+MECHO=<Action>
  • Meaning: Set Echo Mode

If you turn the echo mode off, you cannot see the characters that you inputted returning. It is easy to use to turn off when Host MCU handles AT Command control.

<Action>: Echo Mode (Required)

ParameterMeaning
0Echo Off
1Echo On (Default)

Examples)

* AT+MECHO=0
  • Response:

    [OK]

  • Format:

    AT+MECHO=?

  • Meaning: Get Current Echo Mode

  • Response:

<Mode>
[OK]

AT+MHELP#

  • Format:
AT+MHELP
  • Meaning: Print Command Description and Usage

    This is command usage guide for user convenience.

  • Response:

    ... [OK]

AT+MMCUPS#

  • Format:
AT+MMCUPS=<Action>,<Timeout>
  • Meaning: MCU Power Save Enable/Disable

MCU Power Save Mode can be selected through this command.

<Action> : MCU Power Save Mode (Required)

ParameterMeaning
0MCU Power Save Mode Disable
1MCU Power Save Mode Enable

* while using MCU Power Save Mode, WizFi250 cannot use serial communication.
<Timeout> : MCU Power Save Timeout value (Required)
Valid Range : 10 ~ 3600000 (unit:ms)
cc

  • Response:

    [OK]

AT+MWIFIPS#

  • Format:
AT+MWIFIPS=<Action>,<Delay>
  • Meaning: Wi-Fi Power Save Enable/Disable

Wi-Fi power save mode can be selected through this command.

<Action> : Wi-Fi Power Save Mode (Required)

ParameterMeaning
0Wi-Fi Power Save Mode Disable
1Wi-Fi Power Save Mode Enable
2Enables power save mode while attempting to maximize throughput

* To using Wi-Fi Power Save Mode, WizFi250 has to connect to Access Point. And WizFi250 can only use this mode in station mode.

<Delay > : Return to Sleep Delay
If it is set with a bigger value, the performance will improve but the power consumption will rise.

ActionApplication
0N/A
1N/A
2Required

* This parameter is used only to set 2 of <Action> parameter.

* It must be set to a multiple of 10. When set to 0, the timeout period default to 2 beacon intervals (approximately 204ms).

* It can be set to 0 ~ 90

  • Response:

    [OK]

  • Format:

    AT+MWIFIPS=?

  • Meaning: Get Current Wi-Fi Power Save Status

<Status > : Current Wi-Fi Power Save Status

Return valueMeaning
0Wi-Fi Power Save Mode Disable
1Wi-Fi Power Save Mode Enable
  • Response:

    [OK]

AT+MCWUI#

  • Format:
AT+MCWUI=<Current ID>,<Current P/W><New ID>,<New P/W>
  • Meaning: Change Web Server's User Information

User ID and User Password used by web server can be changed through this command

<Current ID> : Current ID (Required)
* Default value is admin

<Current P/W> : Current Password (Required)
* Default value is admin

<New ID> : New ID which you want to change (Required)
* Max length of New ID : 20 bytes

<New P/W> : New Password which you want to change (Required)
* Max length of New Password : 20 bytes

Examples)

* AT+MCWUI=admin,admin,newid,newpassword
  • Response:

    [OK]

  • Format:

    AT+MCWUI=?

  • Meaning: Get Current user ID and user P/W

  • Response:

<Current ID>,<Current P/W>
[OK]

AT+USET#

  • Format:
AT+USET=<Baudrate>,<Parity>,<WordLen>,<StopBit>,<FlowCon>
  • Meaning: UART Configuration

    UART parameter can be set through this command. Factory default parameter is "115200,N,8,1,N ".

<Baudrate>: Set the Baud-Rate. (Required)

ParameterMeaning
300300 bps
600600 bps
12001200 bps
24002400 bps
48004800 bps
96009600 bps
1440014400 bps
1920019200 bps
3840038400 bps
5760057600 bps
115200115200 bps
230400230400 bps
460800460800 bps
921600921600 bps
18432001843200 bps

<Parity>: Set the Parity-Bit type. (Required)

ParameterMeaning
NNone
O(Reserved)
E(Reserved)

<WordLen>: Set the Word-Length. (Required)

ParameterMeaning
7(Reserved)
88 bits

* 7 bits word length with no parity bit is not allowed.

<StopBit>: Set the Stop-Bit. (Required)

ParameterMeaning
0.50.5 bits
11 bits
1.51.5 bits
22 bits

<FlowCon>: Set the Flow-Control method. (Required)

ParameterMeaning
NNone
HWHardware Flow Control

Examples)

* AT+USET=115200,N,8,1,N
* AT+USET=921600,N,8,2,HW
  • Response:

    [OK]

  • Format:

    AT+USET=?

  • Meaning: Get Current UART Setting

  • Response:

<Baudrate>,<Parity>,<WordLen>,<StopBit>,<FlowCon>
[OK]

AT+MSPI#

  • Format:
AT+MSPI=<Interface>,<SPI Option>
  • Meaning: SPI Configuration

<Interface>: Choice of interface (Required)
If <Interface> set 0, WizFi250 Will set the interface it received first. For example, If MCU sends UART signal to WizFi250, WizFi250 will be set as UART interface. On the other hand, If MCU send SPI signal to WizFi250, WizFi250 will be set as SPI interface.

ParameterMeaning
0Auto(Default)
1UART
2SPI

<SPI Option>: Configure SPI Option (Optional when use SPI)

ValueBit3Bit2Bit1Bit0
0LSB_FIRSTCLOCK_IDLE_LOWCLOCK_FALLING_EDGE
1MSB_FIRSTCLOCK_IDLE_HIGHCLOCK_RISING_EDGE

Examples(Received through UART interface):

* **AT+MSPI=1,0** (SET UART Interface)

Examples(Received through SPI interface):

* **AT+MSPI=2,0** (SET LSB_FIRST, CLOCK_IDLE_LOW, CLOCK_FALLING_EDGE) \\
* **AT+MSPI=2,1** (SET LSB_FIRST, CLOCK_IDLE_LOW, CLOCK_RISING_EDGE) \\
* **AT+MSPI=2,2** (SET LSB_FIRST, CLOCK_IDLE_HIGH, CLOCK_FALLING_EDGE) \\
* **AT+MSPI=2,3** (SET LSB_FIRST, CLOCK_IDLE_HIGH, CLOCK_RISING_EDGE) \\
* **AT+MSPI=2,8** (SET MSB_FIRST, CLOCK_IDLE_LOW, CLOCK_FALLING_EDGE) \\
* **AT+MSPI=2,9** (SET MSB_FIRST, CLOCK_IDLE_LOW, CLOCK_RISING_EDGE) \\
* **AT+MSPI=2,10** (SET MSB_FIRST, CLOCK_IDLE_HIGH, CLOCK_FALLING_EDGE) \\
* **AT+MSPI=2,11** (SET MSB_FIRST, CLOCK_IDLE_HIGH, CLOCK_RISING_EDGE) \\
  • Response:

    [OK]

  • Format:

    AT+MSPI=?

  • Meaning: Get Current Interface and SPI Option

  • Response:

<Interface>,<SPI Option>
[OK]

AT+MCSTGPIO#

  • Format:
AT+MCSTGPIO
  • Meaning: TBD

  • Response:

    [OK]

AT+MCUSTOM#

  • Format:
AT+MCUSTOM=<custom code>
  • Meaning: Set to customized settings by request of specific customers.

Examples)

Default custom code is WIZNET
* AT+MCUSTOM=WIZNET

  • Response:

    [OK]

  • Format:

    AT+MCUSTOM=?

  • Meaning: Get current custom code

  • Response:

    WIZNET [OK]

AT+MAIRCMD#

  • Format:
AT+MAIRCMD=<OpenType>,<SocketType>,<LocalPort>,<Option>
  • Meaning: Configure Air Command mode

    <OpenType>: Air Command mode type (Required)

ParameterMeaning
Oopen at Once
Sregister as a Service

* AT ONCE: Assigns a Air-Command-socket immediately.

* AS SERVICE: Registers its information to the profile. When WiFi Joined, Air-Command-socket open will be performed automatically. If you want to use this after reset, It should be saved by using AT+MPROF=S

<SocketType>: Air-Command-Socket protocol to use (Required)

ParameterMeaning
TTCP Server Normal
UUDP Server Normal

<LocalPort>: Local port number (Required)
Local port number should not be duplicated with others which have opened before. When the value is 0, in case the socket was a TCP/UDP Client, a random port number will be selected. If it was a TCP/UDP Server, it will return an error message.

<Option>: Reserved (Required)
Examples)

* AT+MAIRCMD=O,T,50001,0
* AT+MAIRCMD=S,U,50001,0
* AT+MAIRCMD=?
  • Response:
<OpenType>,<SocketType>,<LocalPort>,<Option>
[OK]

AT+MEVTMSG#

  • Format:
AT+MEVTMSG=<Status>
  • Meaning: Print [Listen x] as soon as it opens up a socket through TCP server.

It is able to print TCP Server Status with [Listen x].(x:socket number).
A user can decide whether WizFi 250 will print out Listen message or not in initialization mode on TCP server.
This command is made for mbed library.
Uses 1 Parameter and set status of socket as 0,1 for each relevant below table.

<Status>: Printing status (Required)

ParameterMeaning
0No display [Listen x] message
1Display [Listen x] message

Examples)

* AT+MEVTMSG=0
* AT+MEVTMSG=1
  • Response:

    [OK]

AT+MEVTFORM#

  • Format:
AT+MEVTFORM=<format>
  • Meaning: Define Event Message Form

    It is able to control format and printing status of WizFi250 event messages.
    Uses 10 Parameters and set event message as 0,1,2 for each relevant one

<Format>: Event Message Format (Required)
0: No display
1: Full Message
2: Short Message

AT+MEVTFORM=abcdefghij

0(No display)1(Full Message,Default)2(Short Message)
aWizFi250 Version 1.0.3.6 (WIZnet Co.Ltd)\r\n\r\n[0]\r\n
b\r\n[CONNECT %x]\r\n\r\n[1]\r\n
c\r\n[DISCONNECT %x]\r\n\r\n[2]\r\n
d\r\n[Link-Up Event]\r\n\r\n[3]\r\n
e\r\n[Link-Down Event]\r\n\r\n[4]\r\n
f\r\n[Reset Event]\r\n\r\n[5]\r\n
g\r\n[TCP Send Error]\r\n\r\n[6]\r\n
h\r\n[P2P Fail Event]\r\n\r\n[7]\r\n
i\r\n[LISTEN %x]\r\n\r\n[8]\r\n
jJoining : ...
Successfully joined : ...
IP Addr : ...
Gateway : ...
Examples)
* AT+MEVTFORM=1111111111
* AT+MEVTFORM=1222200000
* AT+MEVTFORM=0000000000
  • Response:

    [OK]

  • Format:

    AT+MEVTFORM=?

  • Meaning: Get Current Event Message Form

  • Response:

<Format>
[OK]

Function Commands#

Commands related to additional functions are listed below.


AT+FPING#

  • Format:
AT+FPING=<RepeatCnt>,<TargetIP>
  • Meaning: PING Test

    <RepeatCnt>: Repeat Count (Required)
    Valid Range: 1 ~ 50 (unit:number of times)

<TargetIP>: Target IP Address (Required)

Examples)

* AT+FPING=3,192.168.0.10
  • Response:

    Ping Reply : xxx ms ... [OK]

AT+FDNS#

  • Format:
AT+FDNS=<HostName>,<Timeout>
  • Meaning: DNS Query

    <HostName>: The domain name to search (Required)

<Timeout>: Maximum Delay (milliseconds unit) (Required)
Valid Range: 1,000 ~ 1,000,000 (unit:ms)(Recommend: 1000)

Examples)

* AT+FDNS=www.google.com,1000
  • Response:

    xxx.xxx.xxx.xxx [OK]

AT+FWEBS#

  • Format:
AT+FWEBS=<Action>,<Type>
  • Meaning: Launch Web Server

    Web server can be set through this command. The default setting is to start web server when Wi-Fi link up event occurs. ( Factory default parameter is "0,M" )
    <Action>: The action to perform (Required)

ParameterMeaning
0Web server Stop
1Web server Start

<Type> : The web server launch type (Required)

ParameterMeaning
AWeb server start when Wi-Fi link up event occurs
MWeb server start when enter AT+FWEBS command after Wi-Fi is joined.

* If <Action> parameter is 1 and Wi-Fi is joined, WizFi250 starts web server immediately without regard for <Type> parameter. If Wi-Fi is not joined, web server is started according to <Type> parameter. If you want to use <Type> parameter after reset, it should be saved using AT+MPROF=S

Examples)

* AT+FWEBS=1,A
* AT+FWEBS=0,M
  • Response:

    [OK]

  • Format:

    AT+FWEBS=?

  • Meaning: Get Current WEB Server Status and Type

    <Status>: Current WEB Server status

Return valueMeaning
0Web server Stop
1Web server Run
  • Response:
<Status>,<Type>
[OK]

AT+FGPIO#

  • Format:
AT+FGPIO=<action:0>,<gpio_number>
AT+FGPIO=<action:1>,<gpio_number>,<gpio_value>
AT+FGPIO=<action:2>,<gpio_number>,<config_value>
  • Meaning: GPIO Control Function

GPIO can be set through this command.
<action>: The action to perform (Required)

Return valueMeaning
0Get GPIO value when <mode> is 0
1Set GPIO value when <mode> is 1
2GPIO Initialize

<gpio_number>: Available GPIO number (Required)

Return valueMeaning
1GPIO 1
5GPIO 5
6GPIO 6
7GPIO 7
8GPIO 8

<config_value>: Current GPIO Configuration Value (It can be used when action is 2)

Return valueMeaning
0INPUT_PULL_UP (Input with an internal pull-up resistor)
1INPUT_PULL_DOWN (Input with an internal pull-down resistor)
2INPUT_HIGH_IMPEDANCE (Input - must always be driven, either actively or by an external pullup resistor)
3OUTPUT_PUSH_PULL (Output actively driven high and actively driven low - must not be connected to other active outputs)
4OUTPUT_OPEN_DRAIN_NO_PULL (Output actively driven low but is high-impedance when set high - can be connected to other open-drain/open-collector outputs. Needs an external pull-up resistor)
5OUTPUT_OPEN_DRAIN_PULL_UP (Output actively driven low and is pulled high with an internal resistor when set high - can be connected to other open-drain/open-collector outputs)

<gpio_value>: Current GPIO Value (It can be used when action is 1)

Return valueMeaning
0Low
1High

Examples)

* AT+FGPIO=2,6,3
* AT+FGPIO=0,1
* AT+FGPIO=1,5,1
  • Response:

    If <action> is 0

<gpio_value>
[OK]
ex)
AT+FGPIO=0,1
0
[OK]

If <action> is 1 or 2

[OK]
  • Format:

    AT+FGPIO=?

  • Meaning: Get Current GPIO Setting

<mode>: Current GPIO mode

Return valueMeaning
0Input
1Output

* <mode> can be set to 0 automatically when <config_value> is set to 0,1 or 2. If <config_value> is set to 3,4 or 5, <mode> can be set to 1 automatically.

<gpio_number>: Available GPIO number

<config_value>: Current GPIO Configuration Value

<gpio_value>: Current GPIO Value

Examples)

* AT+FGPIO=?
  • Response:
{<mode>,<gpio_num>,<config_value>,<set_value>}
[OK]
ex)
{1,1,3,0},{1,5,3,0},{1,6,3,0},{1,7,3,0},{1,8,3,0}
[OK]

AT+FSOCK#

  • Format:
AT+FSOCK=<Option>,<Value>
  • Meaning: SOCKET Extension Option

When there is no socket connected, it try to reconnect the server using this option.
6,8 options must be set as service mode(AT+SCON=S) for Auto Reconnection.
Profile(AT+MPROF=S) has to be saved after AT+FSOCK

This function only exist later vision of F/W 1.0.4.1.

This is for extended options of Socket. It will be added continuously.

<Option>: Extended options of Socket (Required)

ParameterMeaning
1TCP Send error timeout (value : 2000~20000ms)
6Recreates Socket then attempts Auto-Reconnection after <Value> seconds (value: 10~1000)
8Automatically resets WizFi250 module. when there is no socket connected (value: 5~1000)

<Value> : Value of extended option (Required)

Examples)

* AT+FSOCK=1,5000
* AT+FSOCK=6,10
* AT+FSOCK=8,30
  • Response:

    [OK]

  • Format:

    AT+FSOCK=?

  • Meaning: Get Current extended options of socket

  • Response:

<Extened option 1><2><3><4><5><6><7><8>
[OK]
ex)
5000,0,0,0,0,10,0,30

AT+FOTA#

  • Format:
AT+FOTA
  • Meaning: Launch OTA Mode

User can update firmware in OTA modewhich can be entered by this command. Refer to Wi-Fi OTA

  • Response:

    [OK]

AT+FWEBSOPT#

  • Format:
AT+FWEBSOPT
  • Meaning: TBD

  • Response:

    [OK]

Command mode & Data mode#

There are two user interface modes between WizFi250 and User-System.

Command mode is the default communication mode and all AT Commands can be used only at this mode. Through AT Commands, users can do 'WiFi Configuration', 'Sending/Receiving Data', 'Managing System', and so on. WizFi250 treats all received data from users as AT command. If all received data follows the correct command format, WizFi250 processes it and returns a proper response to user.

Data mode, on the other hand, is the mode which passes data of application layers to peer devices directly, without AT commands or any other interventions. It can be considered as a black box which passes all USART input to USART output directly. Its concept is simple but to enter this mode, Users need to set the environment properly through AT Commands.

Entering Data mode#

Users can enter Data mode by writing '1' at '<DataMode>' parameter of AT+SCON command. Make sure that there are no open sockets before performing this, because Data mode works with one socket only. (So if you try to open another socket in data mode it will fail). If the socket of Data mode is closed, the mode will be changed to Command mode automatically so users can input AT Commands. If users set AT+SCON command as service with data mode option and save the profile, Data mode will be started when WiFi is joined, so the user does not need to set environments anymore. If the system boots or reboots at that time, WiFi Join will also be started automatically. Users can exit from data mode temporally by entering '+++' in a row (Wait for a second until [OK] response show up). Any AT Command can be entered during Data mode except AT+SCON command. If you want to return to data mode again, you just need to enter AT+SDATA. If you want to exit Data mode completely, close the socket by using 'AT+SMGMT=0' or 'AT+SMGMT=ALL'.

Data transmission in Command mode#

In Command mode, you can make more than one socket, and you can send/receive data through opened sockets at the same time by using AT Command. You can send data to specific socket opened through AT+SSEND command and receive data with information header which informs you on the socket number, the peer address and the received data length.