ATWILC1000/ATWILC3000 Baremetal Wi-Fi®/BLE Link Controller Software Design Guide Introduction The SmartConnect ATWILC* Baremetal is an IEEE® 802.11b/g/n link controller and Bluetooth® 5 controller SoC for Internet of Things (IoT) applications. This feature allows for the addition of Wi-Fi and Bluetooth to an MPU/MCU application via an SDIO/SPI to Wi-Fi and UART to Bluetooth. The ATWILC* family contains two flavors: • ATWILC1000, which is a Wi-Fi only SoC • ATWILC3000, which is Wi-Fi and Bluetooth/BLE SoC Note: All references to the ATWILC* module include ATWILC1000 and ATWILC3000, unless otherwise noted. Features Wi-Fi • Ultra Low Cost IEEE 802.11b/g/n RF/PH/MAC SoC • Low-Power Consumption with Different Power-Saving Modes • Wi-Fi IEEE 802.11 b/g/n with Station (STA), Access Point (AP), and Wi-Fi Direct® Client Modes • Wi-Fi Protected Setup (WPS) for STA Mode • Support of WEP, WPA/WPA2 Personal • Support for WPA/WPA2 and Enterprise Security for STA Mode (supported only on ATWILC1000) – Supported cipher suites • TLS_RSA_WITH_AES_128_CBC_SHA • TLS_RSA_WITH_AES_128_CBC_SHA256 – Supported authentication mode(s) • EAP-TTLS with MsChapv2.0 • Serial Peripheral Interface (SPI), Secure Digital Input/Output (SDIO), and Inter-Integrated Circuit (I2C) support • Ethernet Data Interface • Low Footprint Host Driver with the Following Capabilities: – 8-, 16-, and 32-bit MCU support – Little- and big-endian support – Consumes about 8 KB of code memory and 1 KB of data memory on the host MCU • Concurrency Support for the Following Modes: – Station-to-AP – Station-to-P2P Client © 2019 Microchip Technology Inc. User Guide DS70005353D-page 1 ATWILC1000/ATWILC3000 – AP-to-P2P Client Bluetooth (ATWILC3000) • Bluetooth 5 • Host Control Interface (HCI) via High Speed Universal Asynchronous Receiver/Transmitter (UART) © 2019 Microchip Technology Inc. User Guide DS70005353D-page 2 ATWILC1000/ATWILC3000 Table of Contents Introduction......................................................................................................................1 Features.......................................................................................................................... 1 1. Overview....................................................................................................................6 1.1. Host Driver Architecture............................................................................................................... 6 1.2. ATWILC* Wi-Fi System Architecture............................................................................................ 8 2. ATWILC* Initialization and Simple Application.........................................................10 2.1. ATWILC* Device Selection.........................................................................................................10 2.2. BSP Initialization........................................................................................................................ 10 2.3. ATWILC* Host Driver Initialization..............................................................................................10 2.4. ATWILC* Event Handling............................................................................................................11 3. ATWILC* Configuration............................................................................................14 3.1. Device Parameters.....................................................................................................................14 3.2. ATWILC* Wi-Fi Modes of Operation...........................................................................................14 3.3. Network Parameters...................................................................................................................16 3.4. Wi-Fi Power-Saving Parameters................................................................................................17 3.5. Bluetooth Low Energy Power Saving.........................................................................................18 4. Wi-Fi Station Mode.................................................................................................. 21 4.1. Scan Configuration Parameters................................................................................................. 21 4.2. Wi-Fi Scan..................................................................................................................................21 4.3. On Demand Wi-Fi Connection................................................................................................... 22 4.4. Wi-Fi Security.............................................................................................................................23 4.5. Generate CertOut.h Client Certificate.....................................................................................23 4.6. Example Code............................................................................................................................23 5. Wi-Fi AP Mode........................................................................................................ 25 5.1. Setting ATWILC* AP Mode.........................................................................................................25 5.2. Capabilities.................................................................................................................................25 5.3. Sequence Diagram.....................................................................................................................25 5.4. AP Mode Code Example............................................................................................................26 6. Wi-Fi Direct (P2P) Mode..........................................................................................28 6.1. ATWILC* Capabilities................................................................................................................. 28 6.2. ATWILC* Limitations.................................................................................................................. 28 6.3. ATWILC* P2P States..................................................................................................................28 6.4. ATWILC* P2P Listen State.........................................................................................................28 6.5. ATWILC* P2P Connection State................................................................................................ 28 6.6. ATWILC* P2P Disconnection State............................................................................................29 6.7. P2P Mode Code Example..........................................................................................................29 7. Wi-Fi Protected Setup............................................................................................. 31 7.1. WPS Configuration Methods......................................................................................................31 © 2019 Microchip Technology Inc. User Guide DS70005353D-page 3 ATWILC1000/ATWILC3000 7.2. WPS Limitations.........................................................................................................................31 7.3. WPS Control Flow......................................................................................................................32 7.4. WPS Code Example...................................................................................................................32 8. Concurrency............................................................................................................ 34 8.1. Concurrency Limitations.............................................................................................................34 8.2. Controlling Second Interface......................................................................................................34 8.3. Station-AP Concurrency.............................................................................................................34 8.4. Station-P2P Client Concurrency.................................................................................................35 9. Data Send/Receive..................................................................................................38 9.1. Send Ethernet Frame.................................................................................................................38 9.2. Receive Ethernet Frame............................................................................................................ 38 9.3. Concurrency Send......................................................................................................................39 9.4. Concurrency Receive.................................................................................................................39 9.5. Bluetooth Packets...................................................................................................................... 39 10. Host Interface Protocol............................................................................................40 10.1. Chip Initialization Sequence.......................................................................................................41 10.2. Transfer Sequence Between HIF Layer and ATWILC* Firmware.............................................. 43 10.3. HIF Message Header Structure..................................................................................................45 10.4. HIF Layer APIs...........................................................................................................................46