Broadcom WICED 4343W User manual

WICED-UM200-R
5300 California Avenue • Irvine, CA 92617 • Phone: [phone] • Fax: [phone] November 19, 2015
User Manual
WICED
Creating a Cloud-Supported WICED™ IoT Solution
Broadcom Confidential

Broadcom Corporation
5300 California Avenue
Irvine, CA 92617
© 2015 by Broadcom Corporation
All rights reserved
Printed in the U.S.A.
Broadcom®, the pulse logo, Connecting everything®, the Connecting everything logo, WICED™, and
WICED™Wi-Fi are among the trademarks of Broadcom Corporation and/or its affiliates in the United States,
certain other countries and/or the EU. Any other trademarks or trade names mentioned are the property of
their respective owners.
Revision History
Revision Date Change Description
WICED-UM200-R 11/19/2015 Initial release
Broadcom Confidential

Table of ContentsWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 3
Table of Contents
About This Document .................................................................................................................................. 7
Purpose and Audience ............................................................................................................................ 7
Acronyms and Abbreviations................................................................................................................... 7
Document Conventions ........................................................................................................................... 7
References.............................................................................................................................................. 8
Technical Support ........................................................................................................................................ 8
Section 1: Cloud-Supported IoT Solution Overview ........................................................ 9
Introduction................................................................................................................................................... 9
Basic IoT Solution Block Diagram and Description................................................................................ 10
AWS Summary...................................................................................................................................... 10
IoT Device Demonstration Platform Summary ...................................................................................... 11
Section 2: IoT Demonstration Platform Description ...................................................... 12
Overview...................................................................................................................................................... 12
Interfaces..................................................................................................................................................... 15
Ambient-Light Sensor............................................................................................................................ 15
Arduino Shield Headers ........................................................................................................................ 15
JX1 Pinout and Signal Map............................................................................................................ 16
JX2 Pinout and Signal Map............................................................................................................ 17
JX3 Pinout and Signal Map............................................................................................................ 18
JX4 Pinout and Signal Map............................................................................................................ 19
JTAG .............................................................................................................................................. 19
LEDs...................................................................................................................................................... 20
D1—WLAN Activity LED ................................................................................................................ 20
D2 and D3—User LEDs................................................................................................................. 20
D4—JTAG Activity LED ................................................................................................................. 20
D5—UART Activity LED................................................................................................................. 20
D6—3.3V Power LED .................................................................................................................... 20
Micro-USB Connector (J5) .................................................................................................................... 20
PMOD Connector (J6)........................................................................................................................... 21
Power .................................................................................................................................................... 21
Pushbutton Switches (SW1 and SW2).................................................................................................. 21
UART..................................................................................................................................................... 22
Wi-Fi Debug UART Header (J7)............................................................................................................ 22
Wi-Fi JTAG Header (J8)........................................................................................................................ 22
Wi-Fi Module ......................................................................................................................................... 23
Mechanical Information ............................................................................................................................. 25
Broadcom Confidential

Table of ContentsWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 4
Section 3: IoT Platform Application Development ......................................................... 27
Introduction................................................................................................................................................. 27
System Requirements for WICED Application Development................................................................. 28
Downloading and Installing a WICED IDE/SDK ....................................................................................... 28
Downloading a WICED IDE/SDK .......................................................................................................... 29
Installing the WICED IDE/SDK on a Windows System ......................................................................... 30
Installing the WICED IDE/SDK on a MAC OS X System ...................................................................... 31
Updating to WICED SDK 3.4.0-AWS .................................................................................................... 31
WICED SDK Features........................................................................................................................... 32
Connecting to the WICED 4343W IoT Starter Kit..................................................................................... 33
Building and Downloading an App to the Demo Platform...................................................................... 34
Running an App on the Demo Platform ................................................................................................... 38
Debugging an App on the Demo Platform ............................................................................................... 40
Configuring a Terminal Application.......................................................................................................... 42
Setting Up PuTTY for Windows............................................................................................................. 42
Setting Up CoolTerm for OS X .............................................................................................................. 44
Section 4: Sample AWS IoT Applications ....................................................................... 46
Section 5: AWS IoT Service and Device Setup............................................................... 47
Introduction................................................................................................................................................. 47
Getting Started with the AWS IoT Service ............................................................................................... 48
Resolving a Failed-to-Create-Thing Error Message ................................................................................ 51
Viewing and Editing IoT Device Information............................................................................................ 52
Configuring an IoT Device......................................................................................................................... 53
Reconfiguring an IoT Device ................................................................................................................. 54
Broadcom Confidential

List of FiguresWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 5
List of Figures
Figure 1: IoT Solution Example........................................................................................................................ 10
Figure 2: Demonstration Platform—Top View of Key Component Placements............................................... 12
Figure 3: Demonstration Platform Block Diagram............................................................................................ 13
Figure 4: WICED 4343W Starter Kit Demonstration Platform.......................................................................... 14
Figure 5: Light Sensor Circuit .......................................................................................................................... 15
Figure 6: JX1 Pinout ........................................................................................................................................ 16
Figure 7: JX2 Pinout ........................................................................................................................................ 17
Figure 8: JX3 Pinout ........................................................................................................................................ 18
Figure 9: JX4 Pinout ........................................................................................................................................ 19
Figure 10: J6 PMOD Connector Detail ............................................................................................................ 21
Figure 11: Wi-Fi Module Pinout ....................................................................................................................... 23
Figure 12: Carrier Board Silkscreen................................................................................................................. 25
Figure 13: Arduino Uno R3 Board Dimensions on Which the Carrier Board is Based .................................... 26
Figure 14: WICED IDE Windows Setup........................................................................................................... 30
Figure 15: WICED SDK OS X Setup ............................................................................................................... 31
Figure 16: The WICED Integrated Development Environment ........................................................................ 34
Figure 17: AWS High-Level Block Diagram ..................................................................................................... 47
Broadcom Confidential

List of TablesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 6
List of Tables
Table 1: Ambient-Light Sensor Connection to the Wi-Fi Module .....................................................................15
Table 2: JX1 to Wi-Fi Module Signal Mapping ................................................................................................. 16
Table 3: JX2 to Wi-Fi Module Mapping (Including MCU Pin to WICED_GPIO_X Enumeration) ..................... 17
Table 4: JX3 to Wi-Fi Module Signal Mapping (Including MCU Pin to WICED_GPIO_X Enumeration) .......... 18
Table 5: JX4 to Wi-Fi Module Signal Mapping (Including MCU Pin to WICED_GPIO_X Enumeration) .......... 19
Table 6: WLAN Activity LED Connection to the Wi-Fi Module ......................................................................... 20
Table 7: User LED Connections to the Wi-Fi Module ...................................................................................... 20
Table 8: J6 PMOD Connector Pinout............................................................................................................... 21
Table 9: Pushbutton Switches Pinouts ............................................................................................................ 21
Table 10: Wi-Fi Debug UART Header—J7 ..................................................................................................... 22
Table 11: Wi-Fi JTAG Header Signal List ........................................................................................................ 22
Table 12: Wi-Fi Module Pinout and Mapping to the Carrier Board .................................................................. 24
Table 13: Overview of the WICED SDK Top-Level Directory ..........................................................................32
Broadcom Confidential

About This Document
Broadcom®
November 19, 2015 • WICED-UM200-R Page 7
WICED User Manual
About This Document
Purpose and Audience
This document provides information for IoT device and application developers who plan to:
• Use Broadcom®chips in their IoT devices.
• Use the Broadcom WICED™SDK to develop IoT device applications.
• Integrate cloud services into their IoT system solutions.
Acronyms and Abbreviations
In most cases, acronyms and abbreviations are defined on first use.
For a comprehensive list of acronyms and other terms used in Broadcom documents, go to:
http://www.broadcom.com/press/glossary.php.
Document Conventions
The following conventions may be used in this document:
Convention Description
Bold User input and actions: for example, type exit, click OK, press Alt+C
Monospace Code: #include <iostream>
HTML: <td rowspan = 3>
Command line commands and parameters: wl [-l] <command>
< > Placeholders for required elements: enter your <username> or wl <command>
[ ] Indicates optional command-line parameters: wl [-l]
Indicates bit and byte ranges (inclusive): [0:3] or [7:0]
Broadcom Confidential

Technical Support
Broadcom®
November 19, 2015 • WICED-UM200-R Page 8
WICED User Manual
References
The references in this section may be used in conjunction with this document.
For Broadcom documents, replace the “xx” in the document number with the largest number available in the
repository to ensure that you have the most current version of the document.
Technical Support
Broadcom provides customer access to a wide range of information, including technical documentation,
schematic diagrams, product bill of materials, PCB layout information, and software updates through its
customer support portal. For a CSP account, contact your Broadcom Sales or Engineering support
representative.
General WICED support is available to registered users in the Broadcom Support Community forum:
http://community.broadcom.com/welcome
Note: Broadcom provides customer access to technical documentation and software through its
Broadcom Support Community website (community.broadcom.com).
Document (or Item) Name Number
Broadcom Items
[1] Single-Chip IEEE 802.11 b/g/n MAC/Baseband/Radio with Bluetooth 4.1, an FM
Receiver, and Wireless Charging
4343W-DS1xx-R
Broadcom Confidential

Cloud-Supported IoT Solution OverviewWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 9
Section 1: Cloud-Supported IoT Solution
Overview
Introduction
A typical cloud-supported IoT solution contains two core elements:
1. One or more IoT devices (as publishers and/or subscribers)
2. A cloud solution that supports:
– A secure messaging service for reading data from publishers and writing data to subscribers
– Management application development
– An application management console and a management command-line interface
– An IoT device state-shadowing service
– A database storage service
– A computing service
– A notification service
To help those developing the first core element listed above, Broadcom provides connectivity devices (chips
and/or boards), a software development kit (SDK), supporting documentation, and ongoing support via its
community website (community.broadcom.com). For the purposes of this document, a Broadcom BCM4343W
chip is used on an AVNET-developed IoT device demonstration platform and a special SDK with some simple
applications (see Section 4: “Sample AWS IoT Applications,” on page 46) is made available. For more
information on the sample SDK (which is named WICED SDK 3.4.0-AWS), see “Downloading and Installing a
WICED IDE/SDK” on page 28.
The second core element, the cloud solution, is a collection of Amazon Web Services (AWS), particularly the
new AWS IoT service, which is in beta as of the publication of this document.
Besides the block diagram that follows in this section, the remaining sections in this document provide the
following information:
•Section 2: “IoT Demonstration Platform Description,” on page 12
This section describes an IoT demonstration platform based on the Broadcom BCM4343W.
•Section 3: “IoT Platform Application Development,” on page 27
This section describes how to get started developing applications that will get loaded and executed on the
IoT demonstration platform described in Section 2: “IoT Demonstration Platform Description,” on page 12.
•Section 4: “Sample AWS IoT Applications,” on page 46
This section summarizes a few simple IoT applications that are a combination of WICED applications
running on the IoT demonstration platform and cloud-based applications that use AWS.
•Section 5: “AWS IoT Service and Device Setup,” on page 47
This section provides information on setting up and using AWS.
Broadcom Confidential

Basic IoT Solution Block Diagram and DescriptionWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 10
Basic IoT Solution Block Diagram and Description
Figure 1 shows a simple IoT solution example.
Figure 1: IoT Solution Example
Figure 1 shows three entities: a light sensor IoT device, a motor controller IoT device (for controlling window
blind opening and closing), and AWS. The light sensor regularly publishes light intensity readings taken at a
certain location. Rule assessments and computations within AWS determine if the window blinds at the same
location should be adjusted.
AWS Summary
In Figure 1 on page 10, AWS services and tools provide:
• A secure bidirectional communication service that provides a publication/subscription broker that uses the
Message Queuing Telemetry Transport (MQTT) protocol.
– Allows light intensity readings to be sent from the light sensor IoT device to AWS.
– Allows motor control information to be sent from AWS to the motor-control IoT device (for adjusting
window blinds).
• State shadowing of the connected IoT devices.
• A rules engine that uses SQL-like syntax for evaluating user-supplied rules.
Rule evaluation can lead to other actions. For example, initiating a computation (using the Lambda service),
sending an MQTT message to an IoT device (for example, to adjust the blinds), pushing notifications to other
Internet-connected devices, etc.
For more information on AWS, see Section 5: “AWS IoT Service and Device Setup,” on page 47.
Broadcom Confidential

Basic IoT Solution Block Diagram and DescriptionWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 11
IoT Device Demonstration Platform Summary
The demonstration platform, otherwise known as the WICED 4343W IoT Starter Kit, supports the following
features and interfaces:
• A certified AVNET BCM4343W-based Wi-Fi module board (also referred to as the SoC module) with the
following features:
– IEEE 802.11b/g/n Wi-Fi.
– Bluetooth 4.1 with an upgrade path to Bluetooth 4.2.
– An STM32F411 ARM Cortex M4 MCU.
– 512 KB of flash.
– 128 KB of SRAM.
– 8 Mb of SPI serial flash.
– Dual fractal PCB antennas that support antenna diversity.
• An Arduino form-factor carrier board (also referred to as a base board) with the following features and
interfaces:
– Arduino-compatible shield expansion connectors that support:
– Four GPIO.
– Three analog inputs.
–TwoI
2C ports (one of which is shared).
– One SPI port.
– Two UARTs (one of which is shared).
– One 2×6, PMOD-compatible, peripheral expansion connector (contains the shared I2C port).
– USB-based JTAG debugger/programmer and serial UART port.
– A reset push-button switch.
– A user push-button switch.
– Two user LEDs.
– Four status LEDs (UART, JTAG and WLAN activity, and 3.3V power).
– One ambient light sensor.
– A Micro-USB connector used to power (5V) a high-capacity 3.3V regulated supply and for data
communications.
– 3.3V I/O.
For complete information on the IoT device demonstration platform shown in Figure 1 on page 10, see Section
2: “IoT Demonstration Platform Description,” on page 12.
For information on getting started developing IoT device applications using the combination of the
demonstration platform and the Broadcom WICED SDK, see Section 3: “IoT Platform Application Development,”
on page 27.
Broadcom Confidential

IoT Demonstration Platform DescriptionWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 12
Section 2: IoT Demonstration Platform
Description
Overview
The demonstration platform contains two boards: a BCM4343W-based Wi-Fi module board and a carrier board
that provides access to interfaces, power, switches, etc. The Wi-Fi module board is attached to the carrier board.
The demonstration platform is also sometimes referred to as the WICED BCM4343W IoT Starter Kit.
Throughout the remainder of the document, the two attached boards that comprise the demonstration platform
are referred to as the carrier board and the Wi-Fi module.
Figure 2 shows a top view of key component placements on the demonstration platform.
Figure 2: Demonstration Platform—Top View of Key Component Placements
See Figure 4 on page 14 for a picture of the actual board and Figure 12 on page 25 for a silkscreen of the board.
Broadcom Confidential

OverviewWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 13
Figure 3 is a demonstration platform block diagram. See “Interfaces” on page 15 for more information on each
of the interfaces shown in the figure.
Figure 3: Demonstration Platform Block Diagram
Broadcom Confidential

OverviewWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 14
Figure 4 shows the WICED 4343W Starter Kit demonstration platform as well as its interfaces. For more
information on the various interfaces, see “Interfaces” on page 15.
Figure 4: WICED 4343W Starter Kit Demonstration Platform
Broadcom Confidential

InterfacesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 15
Interfaces
Ambient-Light Sensor
The carrier board includes a low-cost, SMD phototransistor, ambient light sensor from EverLight. The sensor
output connects directly to the ADC input of the Wi-Fi module microcontroller (STM32F711).
Ta b l e 1 provides the light sensor connection to the Wi-Fi module.
Figure 5 shows the light sensor circuit.
Figure 5: Light Sensor Circuit
Arduino Shield Headers
Arduino-compatible shield header sockets facilitate design expansion.
Assignment of peripheral I/O between carrier board connectors JX1–JX4 and the Wi-Fi module are provided in
“JX1 Pinout and Signal Map” on page 16 through “JX4 Pinout and Signal Map” on page 19.
Table 1: Ambient-Light Sensor Connection to the Wi-Fi Module
Light Sensor Wi-Fi Module Pinout
Pin Net Name Pin Net Name
1 ADC_LIGHT_SNS 43 MICRO_ADC_IN15
Broadcom Confidential

InterfacesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 16
JX1 Pinout and Signal Map
Figure 6 shows the JX1 header pinout and Ta b l e 2 shows the JX1 signal mapping to the Wi-Fi module.
Figure 6: JX1 Pinout
Table 2: JX1 to Wi-Fi Module Signal Mapping
JX1 Wi-Fi Module
Pin Signal Name
Arduino R3 UNO
Name Pin Name
JX1-1 N/C – – N/C
JX1-2 3V3 IOREF 16, 26 VDD_3V3_SIP, VBAT_SIP
JX1-3 RESET RESET 36 MICRO_RST_N
JX1-4 3V3 3.3V 16, 26 VDD_3V3_SIP, VBAT_SIP
JX1-5 5V 5V – 5V
JX1-6 GND GND 1, 15, 17,
25, 27, 39,
44, 45
GND
JX1-7 GND GND GND
JX1-8 N/C VIN N/C –
Broadcom Confidential

InterfacesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 17
JX2 Pinout and Signal Map
Figure 7 shows the JX2 header pinout and Ta b l e 3 shows the JX2 signal mapping to the Wi-Fi module.
Figure 7: JX2 Pinout
Table 3: JX2 to Wi-Fi Module Mapping (Including MCU Pin to WICED_GPIO_X Enumeration)
JX2 Wi-Fi Module WICED Software Detail
Pin Signal Name
Arduino R3
UNO Name Pin Name
MCU
Pin
wiced_gpio_t
enumeration
JX2-1 ADC_IN1 A0 37 MICRO_ADC_IN1 A1 WICED_GPIO_2
JX2-2 ADC_IN2 A1 40 MICRO_ADC_IN2 A2 WICED_GPIO_3
JX2-3 ADC_IN3 A2 41 MICRO_ADC_IN3 A3 WICED_GPIO_4
JX2-4 MICRO_WKUP A3 38 MICRO_WKUP A0 WICED_GPIO_1
JX2-5 I2C2_SDA A4 3 MICRO_I2C2_SDA B9 WICED_GPIO_21
JX2-6 I2C2_SCL A5 2 MICRO_I2C2_SCL B10 WICED_GPIO_20
Broadcom Confidential

InterfacesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 18
JX3 Pinout and Signal Map
Figure 8 shows the JX3 header pinout and Ta b l e 4 shows the JX3 signal mapping to the Wi-Fi module.
Figure 8: JX3 Pinout
Table 4: JX3 to Wi-Fi Module Signal Mapping (Including MCU Pin to WICED_GPIO_X Enumeration)
JX3 Wi-Fi Module WICED Software Detail
Pin Signal Name
Arduino R3
UNO Name Pin Name
MCU
Pin
wiced_gpio_t
enumeration
JX3-10 I2C1_SCL D15 28 MICRO_I2C1_SCL B6 WICED_GPIO_11
JX3-9 I2C1_SDA D14 29 MICRO_I2C1_SDA B7 WICED_GPIO_12
JX3-8 – AREF – – – –
JX3-7 GND GND – – – –
JX3-6 SPI_SCK D13 4 MICRO_SPI2_SCK B13 WICED_GPIO_23
JX3-5 SPI_MISO D12 6 MICRO_SPI2_MISO B14 WICED_GPIO_24
JX3-4 SPI_MOSI D11 7 MICRO_SPI2_MOSI B15 WICED_GPIO_25
JX3-3 SPI_SS D10 5 MICRO_SPI2_SSN B12 WICED_GPIO_22
JX3-2 UART6_TX D9 8 USART6_TX_I2S2_MCK C6 WICED_GPIO_13
JX3-1 UART6_RX D8 9 USART6_RX_I2S2_CK C7 WICED_GPIO_14
Broadcom Confidential

InterfacesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 19
JX4 Pinout and Signal Map
Figure 9 shows the JX4 header pinout and Ta b l e 5 shows the JX4 signal mapping to the Wi-Fi module.
Figure 9: JX4 Pinout
JTAG
The JTAG interface signals are routed to the Wi-Fi module STM32F411 microcontroller. They provide a
programming and debugging interface to the BCM4343W.
Table 5: JX4 to Wi-Fi Module Signal Mapping (Including MCU Pin to WICED_GPIO_X Enumeration)
JX4 Wi-Fi Module WICED Software Detail
Pin Signal Name
Arduino R3
UNO Name Pin Name
MCU
Pin
wiced_gpio_t
enumeration
JX4-8 GPIO_D7 D7 33 MICRO_GPIO_B C3 WICED_GPIO_17
JX4-7 GPIO_D6 D6 32 MICRO_GPIO_17 C2 WICED_GPIO_28
JX4-6 GPIO_D5 D5 30 MICRO_GPIO_2 C1 WICED_GPIO_27
JX4-5 GPIO_D4 D4 31 MICRO_GPIO_1 C0 WICED_GPIO_26
JX4-4 UART_RTS D3 13 MICRO_UART_RTS A12 WICED_GPIO_16
JX4-3 UART_CTS D2 12 MICRO_UART_CTS A11 WICED_GPIO_15
JX4-2 UART_TX D1 10 MICRO_UART_TX A9 WICED_GPIO_9
JX4-1 UART_RX D0 11 MICRO_UART_RX A10 WICED_GPIO_10
Broadcom Confidential

InterfacesWICED User Manual
Broadcom®
November 19, 2015 • WICED-UM200-R Page 20
LEDs
The board has six LEDs as status indicators.
D1—WLAN Activity LED
The WLAN activity LED is blue when the Wi-Fi module sends/receives Wi-Fi data. The LED is activated by
source current from the WIFI_GPIO_1 signal.
D2 and D3—User LEDs
There are two user LEDs, USER1 (green) and USER2 (red). The LED control signals are GPIO from the Wi-Fi
module microcontroller (STM32F411). They are active-low signals controlled by user application firmware.
D4—JTAG Activity LED
The JTAG activity LED is blue when the Wi-Fi module microcontroller is being programmed via the JTAG interface.
D5—UART Activity LED
The UART activity LED is blue when there is Wi-Fi module serial console activity.
D6—3.3V Power LED
The 3.3V green power LED, which is connected to the output of the 3.3V regulator, is illuminated when the power
supply output status is good.
Micro-USB Connector (J5)
A Micro-USB connector (J5) provides power as well as access to a dual-interface device. The dual-interface
device provides UART communication (via Channel B) and a JTAG interface (Channel A) for programming and
debugging.
The FT2232HQ USB to serial device (U2) on the carrier board implements the UART and JTAG interfaces.
Table 6: WLAN Activity LED Connection to the Wi-Fi Module
User LEDs on Carrier Board Wi-Fil Module Pinout
LED Name Color Pin Net Name
WLAN (D1) Blue 14 WIFI_GPIO_1
Table 7: User LED Connections to the Wi-Fi Module
User LEDs on Carrier Board Wi-Fil Module Pinout
LED Name Color Pin Net Name
USER1 (D3) Green 42 MICRO_GPIO_5
USER2 (D2) Red 35 MICRO_GPIO_28
Broadcom Confidential