Software Programming Guide For ATWINC1500 Wi Fi Using SAM D21 Xplained Pro Wifi Samd21 Userguide

User Manual:

Open the PDF directly: View PDF .
Page Count: 82

Download
Open PDF In Browser	View PDF

USER GUIDE
Software Programming Guide for ATWINC1500 Wi-Fi
using SAM D21 Xplained Pro
Atmel SmartConnect

Introduction
This software programming guide describes the Atmel® ATWINC1500 Wi-Fi
Network Controller to build state-of-the-art Internet of Things (IoT) applications.
The following topics will be covered:
 How examples are organized
 Target board information
 Instruction for each example

Prerequisites
 Hardware Prerequisites
– Atmel SAM D21 Xplained Pro Evaluation Kit
– Atmel ATWINC1500 extension
– Atmel IO1 extension
– Micro-USB Cable (Micro-A / Micro-B)
 Software Prerequisites
– Atmel Studio 6.2
– Wi-Fi IoT Examples

Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

Table of Contents
Icon Key Identifiers............................................................................................................. 3
1

How the Examples are organized ............................................................................... 4
1.1
1.2
1.3

2

Source Organization ................................................................................................... 6

3

Basic Operation Code ................................................................................................. 7
3.1
3.2

4

Initialization ........................................................................................................................................... 7
Wi-Fi Connection ................................................................................................................................... 7

Examples ..................................................................................................................... 8
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
4.10
4.11
4.12
4.13
4.14
4.15
4.16
4.17
4.18
4.19
4.20
4.21
4.22
4.23
4.24
4.25
4.26
4.27
4.28
4.29
4.30

2

Basic Examples ..................................................................................................................................... 4
Protocol Examples ................................................................................................................................ 4
Advanced Examples.............................................................................................................................. 5

Basic Example: How to Get Chip ID ...................................................................................................... 8
Basic Example: How to Set Debug Level .............................................................................................. 9
Basic Example: How to Get MAC Address .......................................................................................... 11
Basic Example: How to Run STA Mode .............................................................................................. 12
Basic Example: How to Run AP Mode ................................................................................................ 14
Basic Example: How to Run P2P Mode .............................................................................................. 16
Basic Example: How to Change Mode ................................................................................................ 18
Basic Example: How to Scan APs ....................................................................................................... 20
Basic Example: How to Set Deep Sleep ............................................................................................. 22
Basic Example: Security with WEP/WPA ............................................................................................ 24
Basic Example: Connection to Enterprise Security Network ............................................................... 26
Basic Example: Connection to Security WPS ..................................................................................... 28
Basic Example: How to Set Packet Monitoring ................................................................................... 30
Basic Example: Get Signal Status ....................................................................................................... 32
Basic Example: AP Provision .............................................................................................................. 34
Basic Example: HTTP Provision ......................................................................................................... 36
Protocol Example: UDP (Server and Client) ........................................................................................ 38
Protocol Example: UDP Client ............................................................................................................ 42
Protocol Example: UDP Server ........................................................................................................... 44
Protocol Example: TCP Client ............................................................................................................. 46
Protocol Example: TCP Server ........................................................................................................... 48
Protocol Example: NTP Time Client .................................................................................................... 51
Protocol Example: SMTP Send Email ................................................................................................. 54
Protocol Example: Location Client....................................................................................................... 57
Advanced Example: Growl Notification ............................................................................................... 60
Advanced Example: MQTT Chat ......................................................................................................... 64
Advanced Example: Weather Client .................................................................................................... 67
Advanced Example: Wi-Fi Serial ......................................................................................................... 71
Advanced Example: OTA Firmware Upgrade ..................................................................................... 74
Advanced Example: SSL connection .................................................................................................. 78

5

Conclusion ................................................................................................................. 80

6

Revision History ........................................................................................................ 81

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
2
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

Icon Key Identifiers

Delivers contextual information about a specific topic.

Highlights useful tips and techniques.
Highlights objectives to be completed.
Highlights the expected result of an assignment step.
Indicates important information.
Highlights actions to be executed out of the target.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

3 3

1

How the Examples are organized
This example package consists of several example codes and projects. The examples are organized in
different levels of codes to explain ATWINC1500 API usage – from basic Wi-Fi operations to advanced topics.
Here are the three category levels:


Basic Examples



IoT Protocol Examples



Advanced App Scenario

These example materials are delivered by Atmel Software Framework, or by Atmel FAE (such together with
hands-on documentation, datasheets, application notes, software and tools).

1.1

Basic Examples
These examples describe basic Wi-Fi operation in ‘how-to’ manner:

1.2



How to read Chip ID(to identify ATWINC1500 H/W revision difference)



How to adjust debug message level



How to get MAC address of the Wi-Fi module



How to start Wi-Fi in specific operation mode, such as:
–

STA Mode (Station mode, known as a Wi-Fi client)

–

AP mode (Access Point mode)

–

P2P mode (Peer-to-Peer mode, also known as Wi-Fi Direct®)



How to switch mode between STA, AP and P2P modes during the runtime



How to scan AP list that is nearby



How to set deep sleep mode



How to connect to secure Wi-Fi with using WEP/WPA/WPA2 security



How to connect to enterprise security network



How to connect to security WPS



How to set packet monitoring



How to get RF signal status by reading RSSI value



How to set AP provision



How to set HTTP provision

Protocol Examples
After basic code examples, user may want to explore how to send and receive network packets. Here are
protocol examples that can be extended for IoT application.




4

UDP protocol example
–

Server and Client

–

Client

–

Server

TCP protocol example
–

Client

–

Server



NTP Time client – retrieves network time for IoT application



Send email – send email from SMTP server



Location client – get the current location of the network provider using HTTP

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
4
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

1.3

Advanced Examples
These examples demonstrate more complex examples like


Growl client – demonstrates using RESTful API over SSL (essential for IoT application)



MQTT Chat client – demonstrate how to send and receive IoT information using MQTT protocol



Weather client – get the current weather information of the network provider and utilize the IO1 sensor
device



Wi-Fi serial - useful for chatting or controlling a remote device



OTA Firmware Upgrade – ATWINC1500 Firmware upgrade via OTA server



SSL connection - Set up an SSL connection

For customer’s IoT application, these examples are useful to how to use ATWINC1500 APIs and implement a
feature for IoT application.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

5 5

2

Source Organization
There are some folders which are allocated automatically according to user configurations and example source
consists of main.c and main.h.
Here is the structure of application source codes.


ASF
All source codes of ASF modules are located in this folder. You can select various modules with ASF
wizard and it will configure the content in this folder.



config
This folder is consists of configuration header files for SAM D21 and extension boards.



iot
Some of protocol/advanced examples have this folder. It contains the source codes of IoT protocol like
HTTP, MQTT, and so forth.



winc
This is the driver source folder of ATWINC1500 Wi-Fi module.

Some examples may have additional source file. But the structure is similar across the
samples.

6

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
6
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

3

Basic Operation Code
This section explains the basic code for using SAMD21 and ATWINC1500. These codes can be different
according to the purpose of your example.

3.1

Initialization
Initialize SAMD21 board.
/* Initialize the board. */
system_init();

1) Initialize UART console to print debug messages.
/* Initialize the UART console. */
configure_console();
printf(STRING_HEADER);

2) Initialize board support package to use ATWINC1500.
/* Initialize the BSP. */
nm_bsp_init();

3) Initialize Wi-Fi driver. You don’t need to set the Wi-Fi callback function if you don’t use Wi-Fi connection.
(E.g. Get Chip ID example, Get MAC Address example.)
/* Initialize Wi-Fi parameters structure. */
memset((uint8_t *)¶m, 0, sizeof(tstrWifiInitParam));
/* Initialize Wi-Fi driver with data and status callbacks. */
param.pfAppWifiCb = wifi_cb;
ret = m2m_wifi_init(¶m);
if (M2M_SUCCESS != ret) {
printf("main: m2m_wifi_init call error!(%d)\r\n", ret);
while (1) {
}
}

3.2

Wi-Fi Connection
1) Initialize socket module and set socket callback functions to receive socket events and connect
ATWINC1500 module to an AP with given information. These are normally defined in main.h.
/* Initialize Socket module */
socketInit();
registerSocketCallback(socket_event_handler, socket_resolve_handler);
/* Connect to router. */
ret = m2m_wifi_connect((char *)MAIN_WLAN_SSID, sizeof(MAIN_WLAN_SSID),
MAIN_WLAN_AUTH, (char *)MAIN_WLAN_PSK, M2M_WIFI_CH_ALL);

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

7 7

4

Examples

4.1

Basic Example: How to Get Chip ID
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to retrieve the
chip information of the Wi-Fi module. This is a basic operation to identify which HW version is used. It uses the
following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and retrieve information.
1) Code summary.
nmi_get_chipid() function returns the chip ID of ATWINC1500.
nmi_get_rfrevid() function returns RF revision ID.
/* Display WINC1500 chip information. */
printf("Chip ID : \r\t\t\t%x\r\n", (unsigned int)nmi_get_chipid());
printf("RF Revision ID : \r\t\t\t%x\r\n", (unsigned int)nmi_get_rfrevid());

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed
on the terminal window. In the below result, you can see the chip ID of 1502b1 and RF
revision ID of 4. User must be aware of which version of ATWINC1500 module which is
used.
-- ATWINC1500 chip information example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx-Chip ID :

1502b1

RF Revision ID :

4

Done.

ATWINC1500 behavior and corresponding log messages can be different according to
the revision.

8

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
8
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4.2

Basic Example: How to Set Debug Level
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to configure
debug level and print debugging messages of the Wi-Fi module. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and print debugging messages according to the debug level.
1) Code summary.
Enable debug mode by configuring the below code in config\conf_winc.h:
/** Debug Options */
#define CONF_WIFI_M2M_DEBUG

(1)

This example demonstrates setting debug level by M2M_DEBUG_LEVEL(...) macro.
for (int8_t i = 0; i < 5; i++) {
/* Set debug level. */
M2M_DEBUG_LEVEL(i);
printf("\r[set debug level : %d]\r\n", (unsigned int)i);
/* Display debug information. */
printf("\r");
M2M_PRINT("test message.\n");
M2M_ERR("test message.\n");
M2M_INFO("test message.\n");
M2M_REQ("test message.\n");
M2M_DBG("test message.\n");
printf("\r\n");
}

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. The following information will be displayed on the terminal window.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

9 9

-- ATWINC1500 debug level example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -[set debug level : 0]
test message.
[set debug level : 1]
test message.
(APP)(ERR)[main][186]test message.
[set debug level : 2]
test message.
(APP)(ERR)[main][186]test message.
(APP)(INFO)test message.
[set debug level : 3]
test message.
(APP)(ERR)[main][186]test message.
(APP)(INFO)test message.
(APP)(R)test message.
[set debug level : 4]
test message.
(APP)(ERR)[main][186]test message.
(APP)(INFO)test message.
(APP)(R)test message.
(APP)(DBG)[main][189]test message.
Done.

For a debugging session, the user must turn on the debug option, and analyze the situation. The engineering team also requires the logs to review.

10

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
1
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

4.3

Basic Example: How to Get MAC Address
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to retrieve the
MAC address of the Wi-Fi module. The example uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

1) Code summary.
MAC address is mostly stored in the OTP-ROM. You can get it via m2m_wifi_get_otp_mac_address()
function.
/* Get MAC Address from OTP. */
m2m_wifi_get_otp_mac_address(mac_addr, &u8IsMacAddrValid);

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed
on the terminal window.
-- ATWINC1500 MAC ADDRESS example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -OTP MAC Address : XX:XX:XX:XX:XX:XX
(Or)
USER MAC Address : XX:XX:XX:XX:XX:XX

Default MAC address: The MAC address in OTP ROM (One Time Programmable
ROM).
User Define MAC address: If you want to use a custom MAC address, you should be
set the user define MAC address.
In this example result, you can see the OTP MAC address or USER MAC address.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

11 1
1

4.4

Basic Example: How to Run STA Mode
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to behave as a
station. The example uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and connect to AP as a station mode.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Connect ATWINC1500 to the AP via m2m_wifi_connect() function.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, sizeof(MAIN_WLAN_SSID),
MAIN_WLAN_AUTH, (void *)MAIN_WLAN_PSK, M2M_WIFI_CH_ALL);

wifi_cb() function is called with M2M_WIFI_RESP_CON_STATE_CHANGED message and then it
request an IP address via m2m_wifi_request_dhcp_client() function.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
switch (u8MsgType) {
case M2M_WIFI_RESP_CON_STATE_CHANGED:
{
tstrM2mWifiStateChanged *pstrWifiState = ...;
if (pstrWifiState->u8CurrState == M2M_WIFI_CONNECTED) {
m2m_wifi_request_dhcp_client();
}

wifi_cb() function is called with M2M_WIFI_REQ_DHCP_CONF message and finally get an IP address.
case M2M_WIFI_REQ_DHCP_CONF:
{
uint8_t *pu8IPAddress = (uint8_t *)pvMsg;
printf("Wi-Fi connected\r\n");
printf("Wi-Fi IP is %u.%u.%u.%u\r\n", pu8IPAddress[0],
pu8IPAddress[1], pu8IPAddress[2], pu8IPAddress[3]);
break;

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed
on the terminal window.

12

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
1
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

-- ATWINC1500 station mode example --- SAMD21_XPLAINED_PRO –-- Compiled: xxx xx xxxx xx:xx:xx –
Connecting to XXXXXX.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

13 1
3

4.5

Basic Example: How to Run AP Mode
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to behave as
an AP. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and act as an AP.
1) Code summary.
Configure below code in main.h for AP information.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_CHANNEL

"DEMO_AP"
M2M_WIFI_SEC_OPEN
(6)

In main() function, Initialize AP mode configuration structure (strM2MAPConfig) as below. You can
enable AP mode via m2m_wifi_enable_ap function().
tstrM2MAPConfig strM2MAPConfig = {
MAIN_WLAN_SSID,
MAIN_WLAN_CHANNEL,
MAIN_WLAN_WEP_KEY_INDEX,
MAIN_WLAN_WEP_SIZE,
MAIN_WLAN_WEP_KEY,
MAIN_WLAN_AUTH,
MAIN_WLAN_SSID_MODE,
MAIN_WLAN_DHCP_SERVER_IP
};

/*
/*
/*
/*
/*
/*
/*
/*

Access Point Name. */
Channel to use. */
Wep key index. */
Wep key size. */
Wep key. */
Security mode. */
SSID visible. */
DHCP Server IP */

ret = m2m_wifi_enable_ap(&strM2MAPConfig);

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 AP mode example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
AP mode started. You can connect to XXXXXX.
Station connected
Station IP is xxx.xxx.xxx.xxx

14

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
1
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

The ATWINC1500 supports AP mode operation with the following limitations:
1) Only ONE associated station is supported. After a connection is established with a station, further
connections are rejected.
OPEN and WEP security modes.
The device could not work as a station in this mode (STA/AP Concurrency is not supported).
Now AP mode is ready. You can use smart phone to connect to the ATWINC1500 that is
running as AP mode.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

15 1
5

4.6

Basic Example: How to Run P2P Mode
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to behave as a
P2P device. P2P is also known as Wi-Fi Direct. This demo uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the WINC1500 and act as a P2P device.
1) Code summary.
Configure below code in main.h for P2P information.
#define MAIN_WLAN_DEVICE_NAME
#define MAIN_WLAN_CHANNEL

"ATWINC1500_P2P"
(6)

Set your device name which will be shown in the peer device.
ret = m2m_wifi_set_device_name((uint8_t *)MAIN_WLAN_DEVICE_NAME,
strlen(MAIN_WLAN_DEVICE_NAME));

Set to P2P mode with the channel number which is defined in main.h.
ret = m2m_wifi_p2p(MAIN_WLAN_CHANNEL);

When your mobile device connects to the ATWINC1500, Wi-Fi callback will receive
M2M_WIFI_REQ_DHCP_CONF message.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_REQ_DHCP_CONF:
uint8_t *pu8IPAddress = (uint8_t *)pvMsg;
printf("Wi-Fi connected\r\n");
printf("Wi-Fi IP is %u.%u.%u.%u\r\n",
pu8IPAddress[0], pu8IPAddress[1],
pu8IPAddress[2], pu8IPAddress[3]);

2) Build the program and download it into the board.

3) Start the application.

16

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
1
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 P2P mode example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
P2P mode started. You can connect to XXXXXX.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx

After running P2P mode, Open your smart phone’s Wi-Fi Direct menu, then scan and
connect to ATWINC1500 device.

The ATWINC1500 supports Wi-Fi Direct protocol with the following limitations:
The device can only operate as a Wi-Fi Direct device (Group Owner functionality
will be supported in a future release).
The device cannot work as a station in this mode (STA/P2P Concurrency will be
supported in a future release).

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

17 1
7

4.7

Basic Example: How to Change Mode
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to bring up as a
station, an AP or a P2P mode. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500. For the first time, the device acts as station mode, then switch to AP mode
or P2P mode. For the details in each mode, refer to the MODE_STA, MODE_AP and MODE_P2P example.
1) Code summary.
Configure below code in main.h for AP information.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_CHANNEL

"DEMO_AP"
M2M_WIFI_SEC_OPEN
(6)

Configure below code in main.h for P2P information.
#define MAIN_WLAN_DEVICE_NAME
#define MAIN_WLAN_P2P_CHANNEL

"ATWINC1500_P2P"
(6)

In main() function, It sets to AP mode first and changes to P2P mode after a little delay.
For more details, refer to “How to Run AP mode” example and “How to Run P2P mode” example.
ret = ap_mode_activate_30s();
nm_bsp_sleep(DELAY_FOR_MODE_CHANGE);
ret = p2p_mode_activate_30s();

static int8_t ap_mode_activate_30s (void)
{
...
ret = m2m_wifi_enable_ap(&strM2MAPConfig);
nm_bsp_sleep(HOLD_TIME_IN_MODE);
ret = m2m_wifi_disable_ap();

2) Build the program and download it into the board.
3) Start the application.

18

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
1
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 mode change example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -AP mode, start
AP mode, end
P2P mode, start
P2P mode, end

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

19 1
9

4.8

Basic Example: How to Scan APs
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to how to scan
AP as a station. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and scan AP until defined AP is founded.
1) Code summary.
Configure below code in main.h for the AP to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Request to scan for all channels.
m2m_wifi_request_scan(M2M_WIFI_CH_ALL);

wifi_cb() function is called with M2M_WIFI_RESP_SCAN_DONE message when scanning is done. You
can get the number of found APs as below and request the scan result with a specific channel by calling
m2m_wifi_req_scan_result() function.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_RESP_SCAN_DONE:
tstrM2mScanDone *pstrInfo = (tstrM2mScanDone *)pvMsg;
if (pstrInfo->u8NumofCh >= 1) {
m2m_wifi_req_scan_result(scan_request_index);
scan_request_index++;
}

wifi_cb() function will be called again with M2M_WIFI_RESP_SCAN_RESULT message. You can get the
information of the AP for the specific channel number you gave.
If scan result is same with the AP information in main.h then device will connect to the AP.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_RESP_SCAN_RESULT:
printf("[%d] SSID:%s\r\n",
scan_request_index, pstrScanResult->au8SSID);
...
if ((demo_ssid_len == scan_ssid_len) &&
(!memcmp(pstrScanResult->au8SSID,
(uint8_t *)MAIN_WLAN_SSID, demo_ssid_len))
) {
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

2) Build the program and download it into the board.
3) Start the application.

20

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
2
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 AP scan example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -[1] SSID:DEMO_AP1
[2] SSID:DEMO_AP2
[3] SSID:DEMO_AP
Found DEMO_AP
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

21 2
1

4.9

Basic Example: How to Set Deep Sleep
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to check the
PS (PowerSave) mode. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1

main.c: Initialize the ATWINC1500 and set PS Mode and the get RSSI for the connected AP.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Configure below code in main.h for the power save mode you want to set.
#define MAIN_PS_SLEEP_MODE

M2M_PS_MANUAL

In main() function, set power save mode as defined above.
if (MAIN_PS_SLEEP_MODE == M2M_PS_MANUAL) {
printf("M2M_PS_MANUAL\r\n");
m2m_wifi_set_sleep_mode(MAIN_PS_SLEEP_MODE, 1);
} else if (MAIN_PS_SLEEP_MODE == M2M_PS_DEEP_AUTOMATIC) {
printf("M2M_PS_DEEP_AUTOMATIC\r\n");
tstrM2mLsnInt strM2mLsnInt;
m2m_wifi_set_sleep_mode(M2M_PS_DEEP_AUTOMATIC, 1);
strM2mLsnInt.u16LsnInt = M2M_LISTEN_INTERVAL;
m2m_wifi_set_lsn_int(&strM2mLsnInt);
}

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, sizeof(MAIN_WLAN_SSID), ...

The ATWINC1500 goes to sleep mode automatically in M2M_PS_DEEP_AUTOMATIC mode. The
ATWINC1500 will wake up upon any request/callback (Wi-Fi/SOCKET) and the host driver will allow the
SoC to sleep again after handling the request.
But you have to request sleep in M2M_PS_MANUAL mode and ATWINC1500 will go to sleep for the given
period.
m2m_wifi_request_sleep(MAIN_REQUEST_SLEEP_TIME);

2) Build the program and download it into the board.
3) On the computer, open and configure a terminal application as the follows.
4) Start the application.

22

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
2
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 PowerSave mode example --- SAMD21_XPLAINED_PRO –-- Compiled: xxx xx xxxx xx:xx:xx –
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
RSSI for the current connected AP (-xx)

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

23 2
3

4.10

Basic Example: Security with WEP/WPA
This example demonstrates how to connect ATWINC1500 Wi-Fi device to AP with WEP, WPA Security. It uses
the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and connect to AP using security mode WEP, WPA.
1) Code summary.
Case 1: WEP
To test WEP security, modify MAIN_WLAN_DEVICE_NAME, MAIN_WLAN_WEP_KEY_INDEX and
MAIN_WLAN_WEP_KEY_40 or MAIN_WLAN_WEP_KEY_104 in main.h.
#define
#define
#define
#define

MAIN_WLAN_DEVICE_NAME
MAIN_WLAN_WEP_KEY_INDEX
MAIN_WLAN_WEP_KEY_40
MAIN_WLAN_WEP_KEY_104

"DEMO_AP"
1
"1234567890"
"1234567890abcdef1234567890"

Use case 1 in main() function and select wep64_parameters or wep128_parameters as security parameters.
tstrM2mWifiWepParams wep64_parameters = { MAIN_WLAN_WEP_KEY_INDEX,
sizeof(MAIN_WLAN_WEP_KEY_40), MAIN_WLAN_WEP_KEY_40};
tstrM2mWifiWepParams wep128_parameters = { MAIN_WLAN_WEP_KEY_INDEX,
sizeof(MAIN_WLAN_WEP_KEY_104), MAIN_WLAN_WEP_KEY_104};
m2m_wifi_connect((char *)MAIN_WLAN_DEVICE_NAME,
strlen((char *)MAIN_WLAN_DEVICE_NAME), M2M_WIFI_SEC_WEP,
&wep64_parameters, M2M_WIFI_CH_ALL);

Case 2: WPA
To test WPA security, use case 2 in main() function and modify MAIN_WLAN_PSK in main.h.
#define MAIN_WLAN_PSK

"12345678"

Connect to the AP with the given information.
m2m_wifi_connect((char *)MAIN_WLAN_DEVICE_NAME, ...

2) Prepare an AP that supports WEP and WPA/WPA2 Security and configure Wi-Fi Security. For more
information, refer to AP manufacturer's manual.
3) Run the application. If the device connected successfully, IP address which is assigned by DHCP will be
displayed on the terminal program.

24

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
2
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 security connection with WEP,WPA security example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
Connecting to XXXXXX.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

25 2
5

4.11

Basic Example: Connection to Enterprise Security Network
This example demonstrates how to connect ATWINC1500 Wi-Fi device to AP with WPA/WPA2 enterprise
security. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

RADIUS server
main.c: Initialize the ATWINC1500 and connect to an AP with Security WPA/PWA2 enterprise.
1) Code summary.
Modify MAIN_WLAN_802_1X_USR_NAME, MAIN_WLAN_802_1X_PWD to the name and the password,
respectively. Modify MAIN_WLAN_DEVICE_NAME to wireless network name.
#define MAIN_WLAN_DEVICE_NAME
#define MAIN_WLAN_802_1X_USR_NAME
#define MAIN_WLAN_802_1X_PWD

"DEMO_AP"
"atmeluser"
"12345678"

Connect to the AP with the given information.
m2m_wifi_connect((char *)MAIN_WLAN_DEVICE_NAME, sizeof(MAIN_WLAN_DEVICE_NAME),
M2M_WIFI_SEC_802_1X, (char *)&gstrCred1x, M2M_WIFI_CH_ALL);

2) Prepare an AP that supports WPA/WPA2 enterprise security.
You need to know following things before configuring RADIUS server settings in the AP. Ask your network
administrator to get there information and configure it in the AP.


User name



Password



Name of wireless network



Root certificate file

3) Download the root certificate to ATWINC1500 using RootCertDownload.bat file. For more details, refer to
the “Atmel-42417-SAMD21-ATWINC1500-Platform_Getting_Started_Guide” document.
4) Build and run the application. If the device connected successfully the IP address, which is assigned by
DHCP will be displayed on the terminal program.

26

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
2
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 security connection with WPA/WPA2 enterprise example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
Connection successfully completed.

For using the security enterprise network, the root certificate must be installed. For
more details about downloading the root certificate, refer to the “Atmel-42417SAMD21-ATWINC1500-Platform_Getting_Started_Guide” document.
802.1x EAP (Extensible Authentication Protocol).

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

27 2
7

4.12

Basic Example: Connection to Security WPS
This example demonstrates how to connect ATWINC1500 Wi-Fi device to AP with WPS Security. It uses the
following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1

main.c: Initialize the ATWINC1500 and connect AP using WPS.
1) Code summary.
Case 1: Button method
To test WPS button method, configure WPS push button feature in main.h as below and use case 1 in
main() function.
#define MAIN_WPS_PUSH_BUTTON_FEATURE

"true"

if (MAIN_WPS_PUSH_BUTTON_FEATURE) {
/* case 1 WPS Push Button method */
if (!gbPressButton) {
btn_init();
}
}

When pressing SW0 button on the SAMD21, it will trigger WPS in btn_press() function.
m2m_wifi_wps(WPS_PBC_TRIGGER, NULL);

wifi_cb() will receive M2M_WIFI_REQ_WPS message and it can connect to the AP with given information.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_REQ_WPS:
{
m2m_wifi_connect((char *)pstrWPS->au8SSID, ...

Case 2: PIN method
To test WPS PIN method, configure WPS PIN number and WPS push button feature in main.h as below
and use case 2 in main() function.
#define MAIN_PIN_NUMBER
#define MAIN_WPS_PUSH_BUTTON_FEATURE

"12345670"
"false"

if (!MAIN_WPS_PUSH_BUTTON_FEATURE) {
/* case 2 WPS PIN method */
m2m_wifi_wps(WPS_PIN_TRIGGER, (const char *)MAIN_WPS_PIN_NUMBER);
}

28

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
2
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

2) Prepare an AP that supports Wi-Fi Protected Setup (WPS).
3) Press WPS button on the AP when using WPS button method or enter WPS PIN number in the AP setup
menu and start the AP. (For more information, refer to AP product documentation.)
4) Run the application. Press SW0 button on the SAMD21 when using WPS button method. The
ATWINC1500 will be connected to the AP automatically without security information.
In WPS button method, following information will be displayed on the terminal window.
-- ATWINC1500 security connection with Wi-Fi Protected Setup(WPS) example -- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
SW0 button pressed
Device is connecting using WPS Push Button option
Wi-Fi request WPS
SSID : xxxxxx, AuthType : x, PW : xxxxxxxx
Request Wi-Fi connect
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx

In WPS PIN method, following information will be displayed on the terminal window.
-- ATWINC1500 security connection with Wi-Fi Protected Setup(WPS) example -- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Wi-Fi request WPS
SSID : xxxxxx, AuthType : x, PW : xxxxxxxx
Request Wi-Fi connect
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

29 2
9

4.13

Basic Example: How to Set Packet Monitoring
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to monitor all
wireless data packets. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1

main.c: Initialize the ATWINC1500 and then configure to monitoring parameters and start the packet
monitoring.
1) Code summary.
Set the below MAC address in the main.c that you want to monitor.
/** Source MAC address for monitoring. */
static const uint8_t SRC_MAC_ADDR[6] = {0xa4, 0xeb, 0xd3, 0xfc, 0x9f, 0x0d};
/** Destination MAC address for monitoring. */
static const uint8_t DST_MAC_ADDR[6] = {0xa4, 0xeb, 0xd3, 0xfc, 0x9f, 0x0d};

Register a monitoring callback function in the Wi-Fi initialization parameter.
Activate one of 2 memcpy() functions in start_packet_monitoring() function and call m2m_wifi_enable_monitoring_mode() function to start monitoring mode.
int main(void)
{
...
/* Initialize Wi-Fi parameters structure. */
param.pfAppMonCb = monitoring_cb; /* Register monitoring callback
function. */
...
/* Start the packet monitoring. */
start_packet_monitoring();
void start_packet_monitoring()
{
...
/* memcpy(wifi_monitor_conf.au8SrcMacAddress, SRC_MAC_ADDR,
sizeof(SRC_MAC_ADDR)); */
memcpy(wifi_monitor_conf.au8DstMacAddress, DST_MAC_ADDR,
sizeof(DST_MAC_ADDR));
m2m_wifi_enable_monitoring_mode(&wifi_monitor_conf, payload_buffer,
sizeof(payload_buffer), 0);

You can see the packet data in monitoring callback function.
void monitoring_cb(tstrM2MWifiRxPacketInfo *pstrWifiRxPacket,
uint8 *pu8Payload, uint16 u16PayloadSize)

2) Build the program and download it into the board.
3) Start the application.

30

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
3
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 packet monitoring example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
Packet monitoring started.
-----------Channel : 11
FrameType : 0xFF
FrameSubtype : 0xFF
Source MAC address : 00:00:00:00:00:00
Destination MAC address : 78:F7:BE:FA:92:5A
-----------monitoring_cb() MONITOR PACKET u8FrameType:0x00, u8FrameSubtype:0xD0
monitoring_cb() SRC MAC address : 00:26:66:1A:08:5C
monitoring_cb() DST MAC address : 78:F7:BE:FA:92:5A
monitoring_cb() MONITOR PACKET u8FrameType:0x00, u8FrameSubtype:0x50
monitoring_cb() SRC MAC address : 00:26:66:C6:00:2A
monitoring_cb() DST MAC address : 78:F7:BE:FA:92:5A
monitoring_cb() MONITOR PACKET u8FrameType:0x08, u8FrameSubtype:0x88
monitoring_cb() SRC MAC address : 00:26:66:1A:08:5D
monitoring_cb() DST MAC address : 78:F7:BE:FA:92:5A
...

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

31 3
1

4.14

Basic Example: Get Signal Status
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to check the
signal strength such as RSSI. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and get RSSI for the connected AP.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Connect to the AP with the given information.
m2m_wifi_connect((char *) MAIN_WLAN_SSID, ...

Call m2m_wifi_req_curr_rssi() to receive RSSI.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_REQ_DHCP_CONF:
m2m_wifi_req_curr_rssi();

You can get RSSI value when wifi_cb() function is called with M2M_WIFI_RESP_CURRENT_RSSI message.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_RESP_CURRENT_RSSI:
{
int8_t *rssi = (int8_t *)pvMsg;
printf("RSSI for the current connected AP (%d)\r\n",
(int8_t)(*rssi));
}

2) Build the program and download it into the board.
3) Start the application.

32

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
3
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 signal statistics example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
RSSI for the current connected AP (-48)

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

33 3
3

4.15

Basic Example: AP Provision
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to start
Provision Mode. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and start Provision Mode until one of various APs is selected.
1) Code summary.
Initialize socket module and create TCP server socket.
addr.sin_family = AF_INET;
addr.sin_port = _htons((MAIN_WIFI_M2M_SERVER_PORT));
addr.sin_addr.s_addr = 0;
socketInit();
registerSocketCallback(socket_cb, NULL);
...
while (1) {
m2m_wifi_handle_events(NULL);
if (tcp_server_socket < 0) {
/* Open TCP server socket */
if ((tcp_server_socket = socket(AF_INET, SOCK_STREAM, 0))

Enable AP mode before the main loop. (Refer to “How to Run AP Mode” example)
ret = m2m_wifi_enable_ap(&strM2MAPConfig);

After your Android device is connected to ATWINC1500 sends AP configuration, disable AP mode and
connect to the AP with the given information.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
case SOCKET_MSG_RECV:
m2m_wifi_disable_ap();
nm_bsp_sleep(500);
m2m_wifi_connect((char *)str_ssid, …

2) Build the program and download it into the board.
3) Start the application.

34

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
3
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 AP Provision example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -AP Provision mode started.
On the android device, connect to WINC1500_PROVISION_AP then run setting
app.
socket_cb: Ready to listen.
4) Install provision_ap.apk in the source package to your Android device. You can also build the Android application source and install it.
5) Connect your Android device to ATWINC1500.
6) Launch the Android application to configure AP, press the Connect button then SSID button will be available.
7) Input connection info, then press Apply button.

8) ATWINC1500 will be connected to the AP which you configured.
Wi-Fi connected. IP is xxx.xxx.xxx.xxx
socket_cb: Client socket is created.
Disable to AP
Connecting to XXXXXX.
wifi_cb: DISCONNECTED
wifi_cb: CONNECTED
Wi-Fi connected. IP is xxx.xxx.xxx.xxx

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

35 3
5

4.16

Basic Example: HTTP Provision
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to start
Provision Mode. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and start Provision Mode until one of various AP is selected.
1) Code summary.
Configure below code in main.h for provision information.
#define MAIN_M2M_DHCP_SERVER_IP
#define MAIN_HTTP_PROV_SERVER_DOMAIN_NAME
#define MAIN_M2M_DEVICE_NAME

{192, 168, 1, 1}
"atmelconfig.com"
"WINC1500_00:00"

Start provision mode before the main loop.
m2m_wifi_start_provision_mode((tstrM2MAPConfig *)&gstrM2MAPConfig,
(char *)gacHttpProvDomainName, 1);

When your mobile device sends configuration information, wifi_cb() function will be called with
M2M_WIFI_RESP_PROVISION_INFO message and you can connect to the AP with the given information.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_RESP_PROVISION_INFO:
tstrM2MProvisionInfo *pstrProvInfo = (tstrM2MProvisionInfo *)pvMsg;
if (pstrProvInfo->u8Status == M2M_SUCCESS) {
m2m_wifi_connect((char *)pstrProvInfo->au8SSID,
strlen((char *)pstrProvInfo->au8SSID),
pstrProvInfo->u8SecType,
pstrProvInfo->au8Password, M2M_WIFI_CH_ALL);
}

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 HTTP Provision example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Provision Mode started.
Connect to [atmelconfig.com] via AP[WINC1500_xx:xx] and fill up the page
1) Connect your mobile device to ATWINC1500 AP (ATWINC1500_xx:xx).

36

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
3
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

2) Browse the webpage (atmel.com) to setup AP, fill up the page then press Connect.

3) ATWINC1500 will be connected to the AP what you configured.
wifi_cb:
wifi_cb:
wifi_cb:
wifi_cb:
wifi_cb:

M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx
M2M_WIFI_RESP_CON_STATE_CHANGED: DISCONNECTED.
M2M_WIFI_RESP_PROVISION_INFO:
M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

37 3
7

4.17

Protocol Example: UDP (Server and Client)
This program demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to test UDP
socket. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the Wi-Fi module and test UDP server and client.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define
#define
#define
#define
#define
#define
#define

MAIN_WLAN_SSID
MAIN_WLAN_AUTH
MAIN_WLAN_PSK
MAIN_WIFI_M2M_PRODUCT_NAME
MAIN_WIFI_M2M_SERVER_IP
MAIN_WIFI_M2M_SERVER_PORT
MAIN_WIFI_M2M_REPORT_INTERVAL

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"
"NMCTemp"
0xFFFFFFFF
(6666)
(1000)

Initialize socket module.
addr.sin_family = AF_INET;
addr.sin_port = _htons(MAIN_WIFI_M2M_SERVER_PORT);
addr.sin_addr.s_addr = _htonl(MAIN_WIFI_M2M_SERVER_IP);
socketInit();
registerSocketCallback(socket_cb, NULL);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

In the main loop, after the device is connected to the AP, create an RX socket and bind it.
if (rx_socket < 0) {
if ((rx_socket = socket(AF_INET, SOCK_DGRAM, 0)) < 0) {
continue;
}
bind(rx_socket, (struct sockaddr *)&addr, sizeof(struct sockaddr_in));
}

In socket_cb() function, prepare a buffer to receive data.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
if (u8Msg == SOCKET_MSG_BIND) {
recvfrom(sock, gau8SocketTestBuffer, MAIN_WIFI_M2M_BUFFER_SIZE, 0);

38

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
3
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

Create a TX socket in the main loop.
if (tx_socket < 0) {
uint32 u32EnableCallbacks = 0;
if ((tx_socket = socket(AF_INET, SOCK_DGRAM, 0)) < 0) {
continue;
}
setsockopt(tx_socket, SOL_SOCKET, SO_SET_UDP_SEND_CALLBACK,
&u32EnableCallbacks, 0);
}

After binding is completed, send a data from the TX socket to the RX socket.
ret = sendto(tx_socket, &msg_temp_report, sizeof(t_msg_temp_report), 0,
(struct sockaddr *)&addr, sizeof(addr));

You can receive data in socket_cb() function with SOCKET_MSG_RECVFROM message.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
} else if (u8Msg == SOCKET_MSG_RECVFROM) {
tstrSocketRecvMsg *pstrRx = (tstrSocketRecvMsg *)pvMsg;
if (pstrRx->pu8Buffer && pstrRx->s16BufferSize) {

2) Build the program and download it into the board both device A and device B.
3) Start the application of device A and device B.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

39 3
9

The application of device A is now programmed and running. Following information will
be displayed on the terminal window.
-- ATWINC1500 UDP example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF : IP is xxx.xxx.xxx.xxx
socket_cb: bind success!
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
UDP test Complete!

40

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
4
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

The application of device B is now programmed and running. Following information will
be displayed on the terminal window.
-- ATWINC1500 UDP example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF : IP is xxx.xxx.xxx.xxx
socket_cb: bind success!
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
main: message sent
socket_cb: received app message
UDP test Complete!

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

41 4
1

4.18

Protocol Example: UDP Client
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to test
UDP socket. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the Wi-Fi module and test UDP server.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define
#define
#define
#define
#define
#define
#define

MAIN_WLAN_SSID
MAIN_WLAN_AUTH
MAIN_WLAN_PSK
MAIN_WIFI_M2M_PRODUCT_NAME
MAIN_WIFI_M2M_SERVER_IP
MAIN_WIFI_M2M_SERVER_PORT
MAIN_WIFI_M2M_REPORT_INTERVAL

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"
"NMCTemp"
0xFFFFFFFF
(6666)
(1000)

Initialize socket module
addr.sin_family = AF_INET;
addr.sin_port = _htons(MAIN_WIFI_M2M_SERVER_PORT);
addr.sin_addr.s_addr = _htonl(MAIN_WIFI_M2M_SERVER_IP);
socketInit();

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, Create a TX socket in the main loop.
if (tx_socket < 0) {
if ((tx_socket = socket(AF_INET, SOCK_DGRAM, 0)) < 0) {
continue;
}
}

After binding is completed, send a data from the TX socket to the RX socket.
ret = sendto(tx_socket, &msg_temp_report, sizeof(t_msg_temp_report), 0,
(struct sockaddr *)&addr, sizeof(addr));

2) Build the program and download it into the board.
3) Start the application.

42

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
4
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 UDP client example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED : CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF : IP is xxx.xxx.xxx.xxx
main: message sent
. . .
main: message sent
UDP client test Complete!

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

43 4
3

4.19

Protocol Example: UDP Server
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to test
UDP socket. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the Wi-Fi module and test UDP client.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define
#define
#define
#define
#define
#define
#define

MAIN_WLAN_SSID
MAIN_WLAN_AUTH
MAIN_WLAN_PSK
MAIN_WIFI_M2M_PRODUCT_NAME
MAIN_WIFI_M2M_SERVER_IP
MAIN_WIFI_M2M_SERVER_PORT
MAIN_WIFI_M2M_REPORT_INTERVAL

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"
"NMCTemp"
0xFFFFFFFF
(6666)
(1000)

Initialize socket module and create UDP server socket.
addr.sin_family = AF_INET;
addr.sin_port = _htons(MAIN_WIFI_M2M_SERVER_PORT);
addr.sin_addr.s_addr = _htonl(MAIN_WIFI_M2M_SERVER_IP);
socketInit();
registerSocketCallback(socket_cb, NULL);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, create an RX socket and bind it in the main loop.
if (rx_socket < 0) {
if ((rx_socket = socket(AF_INET, SOCK_DGRAM, 0)) < 0) {
continue;
}
bind(rx_socket, (struct sockaddr *)&addr, sizeof(struct sockaddr_in));
}

In socket_cb() function, prepare a buffer to receive data.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
if (u8Msg == SOCKET_MSG_BIND) {
recvfrom(sock, gau8SocketTestBuffer, MAIN_WIFI_M2M_BUFFER_SIZE, 0);

44

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
4
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

You can receive data in socket_cb() function with SOCKET_MSG_RECVFROM message when a client
device sends data. (Use “UDP Client” example.)
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
} else if (u8Msg == SOCKET_MSG_RECVFROM) {
tstrSocketRecvMsg *pstrRx = (tstrSocketRecvMsg *)pvMsg;
if (pstrRx->pu8Buffer && pstrRx->s16BufferSize) {

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 UDP server example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED : CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF : IP is xxx.xxx.xxx.xxx
socket_cb: bind success!
socket_cb: received app message.(1)
. . .
socket_cb: received app message.(10)
UDP server test Complete!

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

45 4
5

4.20

Protocol Example: TCP Client
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to test
TCP client. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the Wi-Fi module and test TCP client.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define
#define
#define
#define
#define
#define
#define

MAIN_WLAN_SSID
MAIN_WLAN_AUTH
MAIN_WLAN_PSK
MAIN_WIFI_M2M_PRODUCT_NAME
MAIN_WIFI_M2M_SERVER_IP
MAIN_WIFI_M2M_SERVER_PORT
MAIN_WIFI_M2M_REPORT_INTERVAL

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"
"NMCTemp"
0xFFFFFFFF
(6666)
(1000)

Initialize socket module and register socket callback function.
addr.sin_family = AF_INET;
addr.sin_port = _htons(MAIN_WIFI_M2M_SERVER_PORT);
addr.sin_addr.s_addr = _htonl(MAIN_WIFI_M2M_SERVER_IP);
socketInit();
registerSocketCallback(socket_cb, NULL);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, create a TCP client socket and connect to server in the main loop.
if (tcp_client_socket < 0) {
if ((tcp_client_socket = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
continue;
}
}
ret = connect(tcp_client_socket, (struct sockaddr *)&addr, ...);

46

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
4
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

Connect, send and recv operations will be executed sequentially in socket_cb() function.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
case SOCKET_MSG_CONNECT:
{
if (pstrConnect && pstrConnect->s8Error >= 0)
send(tcp_client_socket, &msg_wifi_product, ...);
}
...
case SOCKET_MSG_SEND:
{
recv(tcp_client_socket, gau8SocketTestBuffer, ...);
}
...
case SOCKET_MSG_RECV:
{
tstrSocketRecvMsg *pstrRecv = (tstrSocketRecvMsg *)pvMsg;
if (pstrRecv && pstrRecv->s16BufferSize > 0) {
printf("socket_cb: recv success!\r\n");
printf("TCP Client Test Complete!\r\n");
}
}

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 TCP client example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
m2m_wifi_state: M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx
socket_cb: connect success!
socket_cb: send success!
socket_cb: recv success!
TCP Client Test Complete!

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

47 4
7

4.21

Protocol Example: TCP Server
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to test
TCP server. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the Wi-Fi module and test TCP server.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define
#define
#define
#define
#define
#define
#define

MAIN_WLAN_SSID
MAIN_WLAN_AUTH
MAIN_WLAN_PSK
MAIN_WIFI_M2M_PRODUCT_NAME
MAIN_WIFI_M2M_SERVER_IP
MAIN_WIFI_M2M_SERVER_PORT
MAIN_WIFI_M2M_REPORT_INTERVAL

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"
"NMCTemp"
0xFFFFFFFF
(6666)
(1000)

Initialize socket module and register socket callback function.
addr.sin_family = AF_INET;
addr.sin_port = _htons(MAIN_WIFI_M2M_SERVER_PORT);
addr.sin_addr.s_addr = _htonl(MAIN_WIFI_M2M_SERVER_IP);
socketInit();
registerSocketCallback(socket_cb, NULL);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, create a TCP server socket and bind it in the main loop.
if (tcp_server_socket < 0) {
if ((tcp_server_socket = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
continue;
}
bind(tcp_server_socket, (struct sockaddr *)&addr, ...);
}

48

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
4
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

Five operations (bind / listen / accept / recv / send) will be executed sequentially in socket_cb() function.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
case SOCKET_MSG_BIND:
{
tstrSocketBindMsg *pstrBind = (tstrSocketBindMsg *)pvMsg;
if (pstrBind && pstrBind->status == 0)
listen(tcp_server_socket, 0);
}
...
case SOCKET_MSG_LISTEN:
{
tstrSocketListenMsg *pstrListen = (tstrSocketListenMsg *)pvMsg;
if (pstrListen && pstrListen->status == 0)
accept(tcp_server_socket, NULL, NULL);
}
...
case SOCKET_MSG_ACCEPT:
{
tstrSocketAcceptMsg *pstrAccept = (tstrSocketAcceptMsg *)pvMsg;
if (pstrAccept) {
accept(tcp_server_socket, NULL, NULL);
tcp_client_socket = pstrAccept->sock;
recv(tcp_client_socket, gau8SocketTestBuffer, ..., 0);
}
}
...
case SOCKET_MSG_RECV:
{
tstrSocketRecvMsg *pstrRecv = (tstrSocketRecvMsg *)pvMsg;
if (pstrRecv && pstrRecv->s16BufferSize > 0)
send(tcp_client_socket, &msg_wifi_product, ..., 0);
}
...
case SOCKET_MSG_SEND:
{
printf("socket_cb: send success!\r\n");
printf("TCP Server Test Complete!\r\n");
printf("close socket\n");
}

2) Build the program and download it into the board.
3) Start the application.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

49 4
9

The application is now programmed and running. Following information will be displayed on the terminal.
-- ATWINC1500 TCP server example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx
socket_cb: bind success!
socket_cb: listen success!
socket_cb: accept success!
socket_cb: recv success!
socket_cb: send success!
TCP Server Test Complete!
close socket

50

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
5
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

4.22

Protocol Example: NTP Time Client
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to retrieve
time information from time server. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the chip and retrieve info.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, create a UDP socket and bind it in the main loop.
if (udp_socket < 0) {
udp_socket = socket(AF_INET, SOCK_DGRAM, 0);
if (udp_socket < 0) {
continue;
}
/* Initialize default socket address structure. */
addr_in.sin_family = AF_INET;
addr_in.sin_addr.s_addr = _htonl(MAIN_DEFAULT_ADDRESS);
addr_in.sin_port = _htons(MAIN_DEFAULT_PORT);
bind(udp_socket, (struct sockaddr *)&addr_in, ...);
}

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

51 5
1

Initialize socket module and send an NTP time query to the NTP server in resolve_cb() function
static void resolve_cb(uint8_t *pu8DomainName, uint32_t u32ServerIP)
{
...
if (udp_socket >= 0) {
addr.sin_family = AF_INET;
addr.sin_port = _htons(MAIN_SERVER_PORT_FOR_UDP);
addr.sin_addr.s_addr = u32ServerIP;
ret = sendto(udp_socket, (int8_t *)&cDataBuf, ...);
}

Receive NTP time from the server and convert it in socket_cb() function.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
case SOCKET_MSG_BIND:
{
if (pstrBind && pstrBind->status == 0)
ret = recvfrom(sock, gau8SocketBuffer, ..., 0);
}
...
case SOCKET_MSG_RECVFROM:
{
uint32_t secsSince1900 = packetBuffer[40] << 24 |
packetBuffer[41] << 16 | packetBuffer[42] << 8 |
packetBuffer[43];
const uint32_t seventyYears = 2208988800UL;
uint32_t epoch = secsSince1900 - seventyYears;
printf("socket_cb: The GMT time is %lu:%02lu:%02lu\r\n",
(epoch % 86400L) / 3600, (epoch % 3600) / 60,
epoch % 60);
}

2) Build the program and download it into the board.
3) Start the application.

52

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
5
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 time client example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx
m2m_ip_resolve_handler : DomainName pool.ntp.org
socket_cb: The GMT time is xx:xx:xx

If the server connection is unstable may not be operated normally.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

53 5
3

4.23

Protocol Example: SMTP Send Email
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to send
email for SMTP server. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the chip and send an email.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

#define MAIN_SENDER_RFC
#define MAIN_RECIPIENT_RFC

""
""

#define MAIN_TO_ADDRESS
#define MAIN_FROM_ADDRESS
#define MAIN_FROM_PASSWORD

"recipient@gmail.com"
"sender@gmail.com"
"12345678"

Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

54

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
5
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

After the device is connected to the AP, try to connect SMTP server. After then, smtpStatehandler will be
executed sequentially until socket status become SocketComplete.
if (gu8SocketStatus == SocketInit) {
if (tcp_client_socket < 0) {
gu8SocketStatus = SocketWaiting;
if (smtpConnect() != SOCK_ERR_NO_ERROR) {
gu8SocketStatus = SocketInit;
}
}
} else if (gu8SocketStatus == SocketConnect) {
gu8SocketStatus = SocketWaiting;
if (smtpStateHandler() != MAIN_EMAIL_ERROR_NONE) {
...
}
} else if (gu8SocketStatus == SocketComplete) {
printf("main: Email was successfully sent.\r\n");
close_socket();
}

Connect to the socket and receive data following SMTP status.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
...
case SOCKET_MSG_CONNECT:
{
if (pstrConnect && pstrConnect->s8Error >= SOCK_ERR_NO_ERROR)
recv(tcp_client_socket, gcHandlerBuffer, ..., 0);
}
...
case SOCKET_MSG_RECV:
{
switch (gu8SmtpStatus) {
case SMTP_INIT:
...
case SMTP_HELO:
...
case SMTP_AUTH:
...
case SMTP_AUTH_USERNAME:
...
case SMTP_AUTH_PASSWORD:
...
case SMTP_FROM:
...
case SMTP_RCPT:
...
case SMTP_DATA:
...
case SMTP_MESSAGE_DATAEND:
...
}
}

2) Build the program and download it into the board.
3) Start the application.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

55 5
5

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 send email example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx
Host IP is 173.194.72.108
Host Name is smtp.gmail.com
Recipient email address is recipient@gmail.com
main: Email was successfully sent.

For using the Gmail, the root certificate must be installed. For more details about
downloading the root certificate, refer to the “Atmel-42417-SAMD21-ATWINC1500Platform_Getting_Started_Guide” document.
If the server connection is unstable may not be operated normally.
Limitations/Known issues
1. Email is sent to only 1 recipient.
2. Only plain text Email is supported.

56

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
5
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

4.24

Protocol Example: Location Client
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to get
location of the network provider. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the ATWINC1500 and get location information.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Configure HTTP client.
configure_http_client();

Get the default config data and specify user configuration. Then http_client_init() and http_client_register_callback() function will be executed sequentially.
static void configure_http_client(void)
{
...
http_client_get_config_defaults(&httpc_conf);
httpc_conf.recv_buffer_size = 256;
httpc_conf.timer_inst = &swt_module_inst;
httpc_conf.user_agent = "curl/7.10.6";
ret = http_client_init(&http_client_module_inst, &httpc_conf);
if (ret < 0) {
while (1) {
} /* Loop forever. */
}
http_client_register_callback(&http_client_module_inst, ...);
}

Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

57 5
7

After the device is connected to the AP, HTTP request will be sent.
static void wifi_callback(uint8_t msg_type, void *msg_data)
{
...
case M2M_WIFI_REQ_DHCP_CONF:
{
http_client_send_request(&http_client_module_inst, ...);
}

4 operations will be executed sequentially.
static void http_client_callback(...)
{
switch (type) {
case HTTP_CLIENT_CALLBACK_SOCK_CONNECTED:
printf("Connected\r\n");
break;
case HTTP_CLIENT_CALLBACK_REQUESTED:
printf("Request complete\r\n");
break;
case HTTP_CLIENT_CALLBACK_RECV_RESPONSE:
if (data->recv_response.content != NULL) {
if (json_create(...) == 0 && json_find(...) == 0) {
printf("Location : %s\r\n", loc.value.s);
}
}
break;
case HTTP_CLIENT_CALLBACK_DISCONNECTED:
printf("Disconnected reason:%d\r\n", data->disconnected.reason);
...
}
}

The first sequence beginning with socket connected.
After request complete, third sequence will be executed and you can get the location data.
2) Build the program and download it into the board.
3) Start the application.

58

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
5
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 location client example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
Connected
Request complete
Received response 200 data size 178
Location : {latitude},{longitude}
Disconnected reason:-104

If disconnect reason is equal to -ECONNRESET(-104), it means Server disconnected
your connection due to the keep alive timeout. This is a normal operation.
This example obtains the location of your network provider not your current position.
If the server connection is unstable may not be operated normally.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

59 5
9

4.25

Advanced Example: Growl Notification
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro.
This example transmits a notification from the ATWINC1500 device (based on a certain trigger) to a public
remote server which in turn sends it a phone application.
The initiated notification from the ATWINC1500 device is directed to a certain subscriber on the server. The
supported applications are PROWL (for iPhone notifications) and NMA (for ANDROID notifications).
It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize growl and send notification message.
1) Code summary.
Configure below code in main.h for your account.
#define PROWL_API_KEY
#define NMA_API_KEY

"6ce3b9ff6c29e5c5b8960b28d9e987aec5ed603a"
"0757fe93214fc2cdf2ad42a5005ee0aa83a7a8ea242c0b80"

Get mac address and set the device name with mac address.
m2m_wifi_get_mac_address(gau8MacAddr);
set_dev_name_to_mac((uint8_t *)gacDeviceName, gau8MacAddr);
set_dev_name_to_mac((uint8_t *)gstrM2MAPConfig.au8SSID, gau8MacAddr);
m2m_wifi_set_device_name((uint8_t *)gacDeviceName, ...);

Start provision mode.
m2m_wifi_start_provision_mode((tstrM2MAPConfig *)&gstrM2MAPConfig,
(char *)gacHttpProvDomainName, 1);

60

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
6
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

When your mobile device sends configuration information, wifi_cb() function will be called with
M2M_WIFI_RESP_PROVISION_INFO message and you can connect to the AP with the given information.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_RESP_PROVISION_INFO:
tstrM2MProvisionInfo *pstrProvInfo = (tstrM2MProvisionInfo *)pvMsg;
if (pstrProvInfo->u8Status == M2M_SUCCESS) {
m2m_wifi_connect((char *)pstrProvInfo->au8SSID,
strlen((char *)pstrProvInfo->au8SSID),
pstrProvInfo->u8SecType,
pstrProvInfo->au8Password, M2M_WIFI_CH_ALL);
}

After the device is connected to the AP, initialize the growl key and execute message handler.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
...
case M2M_WIFI_REQ_DHCP_CONF:
{
...
NMI_GrowlInit((uint8_t *)PROWL_API_KEY, (uint8_t *)NMA_API_KEY);
growl_send_message_handler();
}
...
}

Notification message will be sent thru the below function.
static int growl_send_message_handler(void)
{
...
NMI_GrowlSendNotification(NMA_CLIENT, (uint8_t *)"Growl_Sample",
(uint8_t *)"Growl_Event", (uint8_t *)"growl_test", NMA_CONNECTION_TYPE);
return 0;
}

2) Build the program and download it into the board.
3) Start the application.

The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 simple growl example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Provision Mode started.
Connect to [atmelconfig.com] via AP[WINC1500_08:CA] and fill up the page.
4) Connect your mobile device to ATWINC1500 AP [WINC1500_08:CA].
5) Browse the webpage (atmel.com) to setup AP, fill up the page then press Connect.
Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

61 6
1

6) ATWINC1500 will be connected to the AP what you entered.
7) Growl message will be sent.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
wifi_cb: M2M_WIFI_RESP_PROVISION_INFO.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
send Growl message
Growl CB : 20
This example supports sending GROWL notifications to the following servers.


PROWL for iOS push notifications (https://www.prowlapp.com/)



NMA for Android push notifications (http://www.notifymyandroid.com/)

In order to enable the GROWL application (for sending notifications) working, you need to set your own API
key to represent your account. Create your own by following instructions:


Create a NMA account at http://www.notifymyandroid.com/ and create an API key. Copy the obtained
key string in the file main.h in the macro NMA_API_KEY as the following.



Create a PROWL account at https://www.prowlapp.com/ and create an API key. Copy the obtained API
key string in the file main.h in the macro PROWL_API_KEY as the following.
#define NMA_API_KEY "f8bd3e7c9c5c10183751ab010e57d8f73494b32da73292f6"
#define PROWL_API_KEY "117911f8a4f2935b2d84abc934be9ff77d883678"
For using the growl, the root certificate must be installed. For more details about
downloading the root certificate, refer to the “Atmel-42417-SAMD21-ATWINC1500Platform_Getting_Started_Guide” document.

62

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
6
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

Launch the Growl or NMA application to receive notification.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

63 6
3

4.26

Advanced Example: MQTT Chat
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to chat
using MQTT protocol. It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the board, connect to an MQTT broker and chat with other devices.
1) Code summary.
Configure below code in main.h for the MQTT broker and AP information to be connected.
static const char main_mqtt_broker[] = "test.mosquitto.org";
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Configure MQTT module. You can set the timer instance and register callback for MQTT messages.
/* Initialize the MQTT service. */
configure_mqtt();

static void configure_mqtt(void)
{
...
mqtt_get_config_defaults(&mqtt_conf);
mqtt_conf.timer_inst = &swt_module_inst;
mqtt_conf.recv_buffer = mqtt_buffer;
mqtt_conf.recv_buffer_size = MAIN_MQTT_BUFFER_SIZE;
result = mqtt_init(&mqtt_inst, &mqtt_conf);
result = mqtt_register_callback(&mqtt_inst, mqtt_callback);

Setup the user name first and then topic value will be set with MAIN_CHAT_TOPIC + user name.
printf("Enter the user name (Max %d characters)\r\n", MAIN_CHAT_USER_NAME_SIZE);
scanf("%s", mqtt_user);
printf("User : %s\r\n", mqtt_user);
sprintf(topic, "%s%s", MAIN_CHAT_TOPIC, mqtt_user);

Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

64

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
6
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, call mqtt_connect() function to connect the socket.
static void wifi_callback(uint8 msg_type, void *msg_data)
{
...
case M2M_WIFI_REQ_DHCP_CONF:
...
mqtt_connect(&mqtt_inst, main_mqtt_broker);
}

MQTT callback will receive MQTT_CALLBACK_SOCK_CONNECTED message then start sending CONNECT message to the MQTT broker.
static void mqtt_callback(struct mqtt_module *module_inst, int type, union
mqtt_data *data)
{
...
case MQTT_CALLBACK_SOCK_CONNECTED:
{
mqtt_connect_broker(module_inst, 1, NULL, NULL, mqtt_user,
NULL, NULL, 0, 0, 0);

MQTT callback will receive MQTT_CALLBACK_CONNECTED message then register subscription with a
specific topic.
static void mqtt_callback(struct mqtt_module *module_inst, int type, union
mqtt_data *data)
{
...
case MQTT_CALLBACK_CONNECTED:
{
mqtt_subscribe(module_inst, MAIN_CHAT_TOPIC "#", 0);

If other device sends a message with this topic then MQTT callback will receive
MQTT_CALLBACK_RECV_PUBLISH message.
static void mqtt_callback(struct mqtt_module *module_inst, int type, union
mqtt_data *data)
{
...
case MQTT_CALLBACK_RECV_PUBLISH:

If user inputs some string via terminal, publish MQTT message as below.
static void check_usart_buffer(char *topic)
{
if (uart_buffer_written >= MAIN_CHAT_BUFFER_SIZE) {
mqtt_publish(&mqtt_inst, topic, uart_buffer,
MAIN_CHAT_BUFFER_SIZE, 0, 0);
uart_buffer_written = 0;
}

2) Build the program and download it into the board.
3) Start the application.
4) On the terminal window, enter the user name through the terminal window.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

65 6
5

-- ATWINC1500 Wi-Fi MQTT chat demo --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Preparation of the chat has been completed.

The user name should not contain a white space.
5) After chatting initialization completed, enjoy the chat.

The Initialization may take longer than a few minutes according to the network environment.
Application is now successfully running. Below shows two user are talking to each
other device connected to the same MQTT chat server.
Enter the user name (Max 64 characters)
User : demo_user
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
Preparation of the chat has been completed.
demo_user >> hi!
demo_user >> anybody there?
other_user >> I'm here
other_user >> hi

Maximum message length should be shorter than 128-bytes.
If the server connection is unstable may not be operated normally.

66

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
6
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

4.27

Advanced Example: Weather Client
This example demonstrates the use of the ATWINC1500 with the SAMD21 Xplained Pro board to retrieve
weather information from weather server (openweathermap.org). It uses the following hardware:


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize the chip and retrieve info.
1) Code summary.
Configure below code in main.h for AP information to be connected.
Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

Get MAC address and set the device name with MAC address.
m2m_wifi_get_mac_address(gau8MacAddr);
set_dev_name_to_mac((uint8_t *)gacDeviceName, gau8MacAddr);
set_dev_name_to_mac((uint8_t *)gstrM2MAPConfig.au8SSID, gau8MacAddr);
m2m_wifi_set_device_name((uint8_t *)gacDeviceName, ...);

Start provision mode.
m2m_wifi_start_provision_mode((tstrM2MAPConfig *)&gstrM2MAPConfig,
(char *)gacHttpProvDomainName, 1);

When your mobile device sends configuration information, wifi_cb() function will be called with
M2M_WIFI_RESP_PROVISION_INFO message and you can connect to the AP with the given information.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
case M2M_WIFI_RESP_PROVISION_INFO:
tstrM2MProvisionInfo *pstrProvInfo = (tstrM2MProvisionInfo *)pvMsg;
if (pstrProvInfo->u8Status == M2M_SUCCESS) {
m2m_wifi_connect((char *)pstrProvInfo->au8SSID,
strlen((char *)pstrProvInfo->au8SSID),
pstrProvInfo->u8SecType,
pstrProvInfo->au8Password, M2M_WIFI_CH_ALL);
}

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

67 6
7

After the device is connected to the AP, gethostbyname() function will be called.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
...
case M2M_WIFI_REQ_DHCP_CONF:
{
...
gbConnectedWifi = true;
gethostbyname((uint8_t *)MAIN_WEATHER_SERVER_NAME);
}
...
}

Create a TCP client socket and connect to server in the main loop.
if (gbConnectedWifi && !gbTcpConnection) {
if (gbHostIpByName) {
if (tcp_client_socket < 0) {
if ((tcp_client_socket = socket(...)) < 0) {
continue;
}
}
if (connect(tcp_client_socket, ...) != SOCK_ERR_NO_ERROR) {
continue;
}
gbTcpConnection = true;
}
}

Socket callback function will receive SOCKET_MSG_CONNECT message then it requests weather information to the server with a city name.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
case SOCKET_MSG_CONNECT:
sprintf(gau8ReceivedBuffer, ..., MAIN_CITY_NAME, ...);
...
send(tcp_client_socket, gau8ReceivedBuffer, ...);
recv(tcp_client_socket, ...);
break;
case SOCKET_MSG_RECV:
{
}

}

68

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
6
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

Socket callback function will receive SOCKET_MSG_RECV message with weather information.
You can also get the current temperature via IO1 sensor board as below.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
case SOCKET_MSG_RECV:
...
getTemperature();

}

static void getTemperature(void)
{

...
double s8SensorTemperature = at30tse_read_temperature();

2) Build the program and download it into the board.
3) Start the application.
The application is now programmed and running. Following information will be displayed on the terminal window.
-- ATWINC1500 weather client example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx –
Provision Mode started.
Connect to [atmelconfig.com] via AP[WINC1500_08:CA] and fill up the page.
4) Connect your mobile device to ATWINC1500 AP [WINC1500_08:CA].
5) Browse the webpage (atmel.com) to setup AP, fill up the page then press Connect.
6) ATWINC1500 will be connected to the AP what you entered.
7) The weather info will be printed.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

69 6
9

Wi-Fi IP is xxx.xxx.xxx.xxx
wifi_cb: M2M_WIFI_RESP_PROVISION_INFO.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx
Host IP is 144.76.102.166
Host Name is openweathermap.org
City: Seoul
Weather Condition: sky is clear
Temperature from sensor : 27 degrees
Temperature from server : 3 degrees
Temperature difference : 24 degrees

If the server connection is unstable may not be operated normally.

70

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
7
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

4.28

Advanced Example: Wi-Fi Serial
This example demonstrates how to emulate serial ports between two devices. It reads input data from
serial interface and sends it via Wi-Fi connection and terminal window will print the messages which you
typed or received. It can be useful for chatting or controlling a remote device. It uses the following
hardware and you need to prepare two pairs of SAMD21 and ATWINC1500 boards.


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

main.c: Initialize devices and USART interface. Create TCP sockets, send/receive messages and print
them on the terminal window.
1) Code summary.
Configure below code in main.h for AP information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

Configure USART module to read user input data.
static void configure_console(void)
{
...
stdio_serial_init(&cdc_uart_module, CONF_STDIO_USART_MODULE,
&usart_conf);
/* Register USART callback for receiving user input. */
usart_register_callback(&cdc_uart_module, uart_callback,
SART_CALLBACK_BUFFER_RECEIVED);
usart_enable_callback(&cdc_uart_module, USART_CALLBACK_BUFFER_RECEIVED);
usart_enable(&cdc_uart_module);
}

Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

71 7
1

After the device is connected to the AP, create TCP server socket and bind it in the main loop.
if ((tcp_server_socket = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
continue;
}
...
bind(tcp_server_socket, (struct sockaddr *)&addr, sizeof(struct sockaddr_in));

If there is user input data then handle_input_message() function in the main loop calls parse_command()
function to parse user data and execute the handler function according to the command.
uint8_t parse_command(char *buffer, uint8_t remote)
{
for (i = i_st; i < i_ed; i++) {
if (!strcmp(cmd_list[i].cmd_string, cmd_buf)) {
cmd_list[i].cmd_handler(
buffer + strlen(cmd_list[i].cmd_string) + 1);
break;
}
}

Or handle_input_message() function prints user data in the terminal window and sends it to the remote
device.
void handle_input_message(void)
{
...
if (tcp_connected == 1) {
PRINT_LOCAL_MSG(uart_buffer);
send(tcp_client_socket, uart_buffer, msg_len + 1, 0);
}

When receiving data from the remote device, it handles the received message to print it or executer a
proper command.
There are several commands for Wi-Fi serial functionality in this example.
2)

Build the program and download it into the board.

3) Start the application.
4) On the terminal window, the following text should appear:
-- ATWINC1500 Wi-Fi Serial example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -Wi-Fi connected.
Wi-Fi IP is xxx.xxx.xxx.xxx
socket_cb: bind success.
socket_cb: listen success.
5) Check IP address of each board and execute connection on one device by typing the below command on
the terminal window with the other device's address. Use prefix "<<" to execute local commands.

72

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
7
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

2

<>" to execute
remote commands.
>>control ledon
(Or)
>>control ledoff

Application reads data from serial interface.
User commands can be modified to execute various actions.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

73 7
3

4.29

Advanced Example: OTA Firmware Upgrade
This project is available for a specific H/W version of ATWINC1500 which has 4Mb
flash memory.

This example demonstrates how to upgrade ATWINC1500 Firmware via OTA. It downloads
ATWINC1500 firmware from OTA Download server. OTA Download server is a web server. You can
upload a new firmware image and download it to your device. It uses the following hardware and you
need to prepare two pairs of SAMD21 and ATWINC1500 boards and a web server.


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

OTA Download Server (Web Server)

main.c: Initialize devices and set the server information. It connects to the OTA Download Server.
1) Set your OTA Download server.
2) Upload OTA firmware binary to the root folder in your server. (e.g. http://192.168.0.137/m2m_ota.bin)
3) Code summary.
Configure below code in main.h for AP information to be connected.
#define
#define
#define
#define

MAIN_WLAN_SSID
MAIN_WLAN_AUTH
MAIN_WLAN_PSK
MAIN_OTA_URL

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"
"http://192.168.0.137/m2m_ota.bin"

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

Initialize OTA function.
m2m_ota_init(OtaUpdateCb, OtaNotifCb);

After the device is connected to the AP, m2m_ota_start_update() function will be executed in the wifi_cb()
function.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
...
case M2M_WIFI_REQ_DHCP_CONF:
m2m_ota_start_update((uint8_t *)MAIN_OTA_URL);

74

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
7
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

4

If successfully downloaded, m2m_ota_switch_firmware() function will be called thru OtaUpdateCb().
static void OtaUpdateCb(uint8_t u8OtaUpdateStatusType, uint8_t
u8OtaUpdateStatus)
{
m2m_ota_switch_firmware();
}

After then, you can see the “OTA Success. Press reset your board.”
4) Build the program and download it into the board.
5) Start the application.
6) The following text should appear on the terminal window:
-- ATWINC1500 OTA Firmware upgrade example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -m2m_wifi_connect.
Wi-Fi connected
Wi-Fi IP is xxx.xxx.xxx.xxx.
When you get the IP address then OTA get started.
7) The following text should appear on the terminal window:

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

75 7
5

(1)Chip ID = 1502b1
(1)Flash ID = c21320c2, Size = 4 MBit
(1)Working Image offset = 0x3000 Rollback = 0x40000
(2)(M2M)(Efuse) successfully loaded from bank 1.
(2)EFUSE:MAC
(2)(M2M)MAC_ADDR = xx:xx:xx:xx:xx:xx
(3)NMI M2M SW VERSION 18.0
(3)NMI MIN DRV VERSION 18.0
(3)Built at Jan 19 2015 23:48:51
(3)__ROM_FIRMWARE__
(4)(M2M)LOAD SEC
(6)(M2M)1000 400 2f000 2fc00 38000
(7)(M2M)Wifi Connect
(7)(M2M)SSID
: NW01
(7)(M2M)AUTH
: WPA-Personal
(7)(M2M)PSK
: nmisemi2
(8)(M2M)Channel : 256
(8)Reset MAC
(9)>> Sleep clk src <= Int. osc
(9)>> wakeup_delay = 1500 us
(9)>> pds = [652 652 6526 1957 3 ]
(9)-----------------------------------------(489)MAC State <3>
(494)MAC State <4>
(494)Join on 11
(494)>> sta_wait_join 179
(494)MAC State <5>
(494)MAC State <6>
(495)Init Auth.
(495)MAC State <7>
(495)MAC State <9>
(495)MAC State <10>
(496)MAC State <1>
(496)!@#$ Rate DN (MCS-5) !@#$
(496)Assoc Success.
(498)(M2M)WIFI Connected
(499)(DHCP)<- DISCOVER
(500)Tsf join
(510)Tsf join Done
(532)(DHCP)-> OFFER
(563)(DHCP)-> ACK
(563)(DHCP)Self IP
: "xxx.xx.xxx.xxx"

You can find firmware version and build time information.
(3)NMI M2M SW VERSION 18.0
(3)NMI MIN DRV VERSION 18.0
(3)Built at Jan 19 2015 23:48:51

76

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
7
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

6

8) If connected to OTA Server, the following text should appear on the terminal window:
(770)(M2M)(OTA) Invalidate RB Image
Start Writing.. at 40000 Size 204380
(809)STATS
0
0
5 25
0, err: 16 - stuck: 0
(809)!@#$ Rate DN (48.0 Mbps) !@#$
(910)!@#$ Rate DN (MCS-4) !@#$
(1079)(M2M)Verification OK 204380
(1080)(M2M)(OTA) Update image done successfully
(1080)(M2M)Socket 6 Closed
(1083)(M2M)(OTA) SWap image done successfully
(1084)(M2M)(OTA) Switching firmware done.
9) If success OTA firmware upgrading, the following text should appear on the terminal window:
Wi-Fi IP is xxx.xxx.xxx.xxx
OtaUpdateCb 1 0
OtaUpdateCb m2m_ota_switch_firmware start.
OtaUpdateCb 2 0
OTA Success. Press reset your board.

Application reads data from serial interface.
(1)Chip ID = 1502b1
(1)Flash ID = c21320c2, Size = 4 MBit
(1)Working Image offset = 0x3000 Rollback = 0x40000
(2)(M2M)(Efuse) successfully loaded from bank 1.
(2)EFUSE:MAC
(2)(M2M)MAC_ADDR = xx:xx:xx:xx:xx:xx
(3)NMI M2M SW VERSION 18.0
(3)NMI MIN DRV VERSION 18.0
(3)Built at Jan 19 2015 23:48:51
(3)__ROM_FIRMWARE__

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

77 7
7

4.30

Advanced Example: SSL connection
This example demonstrates how to set up an SSL connection.


The SAMD21 Xplained Pro



The ATWINC1500 on EXT1 header

Server

main.c: Initialize devices and connect to a server using SSL.
1) Code summary.
Configure below code in main.h for AP and the server information to be connected.
#define MAIN_WLAN_SSID
#define MAIN_WLAN_AUTH
#define MAIN_WLAN_PSK

"DEMO_AP"
M2M_WIFI_SEC_WPA_PSK
"12345678"

#define MAIN_SSL_BUF_LEN
#define MAIN_HOST_NAME
#define MAIN_HOST_PORT

1024
"www.google.com"
443

Initialize socket module and register socket callback function.
socketInit();
registerSocketCallback(socket_cb, resolve_cb);

Connect to the AP.
m2m_wifi_connect((char *)MAIN_WLAN_SSID, ...

After the device is connected to the AP, gethostbyname() function will be executed.
static void wifi_cb(uint8_t u8MsgType, void *pvMsg)
{
...
case M2M_WIFI_REQ_DHCP_CONF:
gethostbyname((uint8_t *)MAIN_HOST_NAME);

In the main loop, try to connect to the SSL server.
if (sslConnect() != SOCK_ERR_NO_ERROR) {
gu8SocketStatus = SocketInit;
}

If successfully connected, socket_cb() function will be called with SOCKET_MSG_CONNECT message.
static void socket_cb(SOCKET sock, uint8_t u8Msg, void *pvMsg)
{
switch (u8Msg) {
case SOCKET_MSG_CONNECT:
if (pstrConnect && pstrConnect->s8Error >= SOCK_ERR_NO_ERROR)
printf("Successfully connected.\r\n");
break;

78

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
7
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

8

2)

Build the program and download it into the board.

3) Start the application.
4) The following text should appear on the terminal window:
-- ATWINC1500 SSL example --- SAMD21_XPLAINED_PRO --- Compiled: xxx xx xxxx xx:xx:xx -wifi_cb: M2M_WIFI_RESP_CON_STATE_CHANGED: CONNECTED
wifi_cb: M2M_WIFI_REQ_DHCP_CONF: IP is xxx.xxx.xxx.xxx
Host IP is 173.194.127.115
Host Name is www.google.com
Successfully connected.

The device is connected to a server using SSL.
To set up an SSL connection, a root certificate must be installed. For more details
about downloading the root certificate, refer to the “Atmel-42417-SAMD21ATWINC1500-Platform_Getting_Started_Guide” document.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

79 7
9

5

Conclusion
This software programming guide explains example of use of the Atmel ATWINC1500 Wi-Fi module along with
the Wi-Fi Software API for the SAM D21 Xplained Pro board.
The following topics have been covered:


Basic example of controlling ATWINC1500 module



Simple protocol examples



IoT application example

You have seen how the ATWIN1500 Wi-Fi module makes it easy to add Wi-Fi capabilities to a SAM D21 host
MCU.

80

Software
Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
8
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

0

6

Revision History
Doc Rev.

Date

42418A

03/2015

Comments
Initial document release.

Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro [USERGUIDE]
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

81 8
1

Atmel Corporation

1600 Technology Drive, San Jose, CA 95110 USA

T: (+1)(408) 441.0311

│

F: (+1)(408) 436.4200

www.atmel.com

© 2015 Atmel Corporation. / Rev.: Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015.
Atmel®, Atmel logo and combinations thereof, Enabling Unlimited Possibilities®, and others are registered trademarks or trademarks of Atmel Corporation in U.S. and
other countries. ARM®, ARM Connected® logo, and others are the registered trademarks or trademarks of ARM Ltd. Other terms and product names may be
trademarks of others.
DISCLAIMER: The information in this document is provided in connection with Atmel products. No license, express or implied, b y estoppel or otherwise, to any intellectual property right
is granted by this document or in connection with the sale of Atmel products. EXCEPT AS SET FORTH IN THE ATMEL TERMS AND CONDITIONS OF SALES L OCATED ON THE
ATMEL WEBSITE, ATMEL ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATIN G TO ITS PRODUCTS
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON -INFRINGEMENT. IN NO EVENT
SHALL ATMEL BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMA GES (INCLUDING, WITHOUT LIMITATION, DAMAGES
FOR LOSS AND PROFITS, BUSINESS INTERRUPTION, OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT , EVEN IF ATMEL
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Atmel makes no rep resentations or warranties with respect to the accuracy or completeness of the contents of this
document and reserves the right to make changes to specifications and products descriptions at any time without notice. Atmel does not make any commitment to update the information
contained herein. Unless specifically provided otherwise, Atmel products are not suitable for, and shall not be used in, auto motive applications. Atmel products are not intended,
authorized, or warranted for use as components in applications intended to support or sustain life.
SAFETY-CRITICAL, MILITARY, AND AUTOMOTIVE APPLICATIONS DISCLAIMER: Atmel products are not designed for and will not be used in conne ction with any applications where
the failure of such products would reasonably be expected to result in significant personal injury or death (“Safety-Critical Applications”) without an Atmel officer's specific written consent.
Safety-Critical Applications include, without limitation, life support devices and systems, equipment or sys tems for the operation of nuclear facilities and weapons systems. Atmel
products are
not designed
nor intended for use
in military
or aerospace applications
or environments
desiPro
gnated
by Atmel as military-grade. Atmel products are not
Software
Programming
Guide
for ATWINC1500
Wi-Fi
using SAMunless
D21specifically
Xplained
[USERGUIDE
designed nor
intended for use in automotive applications unless specifically designated by Atmel as automotive -grade.
Atmel-42418A-Software-Programming-Guide-for-ATWINC1500-WiFi-using-SAMD21-Xplained-Pro_UserGuide_032015

82

8
2

]



---

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
PDF Version                     : 1.6
Linearized                      : No
Encryption                      : Standard V1.2 (40-bit)
User Access                     : Print, Copy, Annotate, Fill forms, Extract, Assemble, Print high-res
Language                        : nb-NO
Tagged PDF                      : Yes
XMP Toolkit                     : Adobe XMP Core 5.2-c001 63.139439, 2010/09/27-13:37:26
Format                          : application/pdf
Creator                         : Atmel Corporation
Description                     : This software programming guide describes the Atmel ATWINC1500 Wi-Fi Network Controller to build state-of-the-art Internet of Things (IoT) applications.
Title                           : Software Programming Guide for ATWINC1500 Wi-Fi using SAM D21 Xplained Pro
Create Date                     : 2015:03:27 06:44:23+01:00
Creator Tool                    : Microsoft® Word 2013
Modify Date                     : 2015:03:27 06:45:21+01:00
Metadata Date                   : 2015:03:27 06:45:21+01:00
Producer                        : Microsoft® Word 2013
Document ID                     : uuid:e4a26c5f-34ef-46a3-b281-e7e6ce3452b5
Instance ID                     : uuid:8cf8a3f7-57b7-4b34-90a3-d31d8b08fbde
Page Count                      : 82
Author                          : Atmel Corporation
Keywords                        : Atmel, SmartConnect, IoT, Wi-Fi, SAMD21, ATWINC1500, Micro-USB, Micro-A, Micro-B, kit, software, guide
Subject                         : This software programming guide describes the Atmel ATWINC1500 Wi-Fi Network Controller to build state-of-the-art Internet of Things (IoT) applications.

EXIF Metadata provided by EXIF.tools