Latest revision as of 05:38, 25 February 2021

Overview

WISE-1530 is used Cypress's WICED^® SDKs to develop Wi-Fi and BLE application. WISE-1530 SDK use C/C++ language Runs on Windows^®, Mac^® OS X^®, and Linux^® through Eclipse^®-based integrated development environment (IDE).

Single installer package with support for:

Wi-Fi + Bluetooth combo solution
- Wi-Fi solutions
- Bluetooth (Basic Rate, Enhanced Data Rate and Bluetooth Low Energy)
Sample applications for many popular use cases like
- Connecting to cloud services
- Low-power BLE-based sensors and beacons
- Smart home gateways
- BLE-WiFi introducer
Code snippets to understand WICED APIs

User can refer to WICED Software to get more information.

Setup Development Environment

Preparing for Hardware

The user needs to prepare for hardware as following:

WISE-1530, WISE-1500 and WISE-ED22.
802.11b/g/n (2.4 GHz) Wireless Access Point (AP).
PC Runs on Windows®, Mac® OS X®, and Linux®

Please refer to the following steps for setup a WISE series of boards before using WISE-1530.

Step01: Please prepare boards as below.

① WISE-1530

② WISE-1500

③ WISE-ED22

④ WISE-ED22 reset button

⑤ CN2 on WISE-1500

⑥ SW3 on WISE-1500

Pleas check pin1 and pin2 to “OFF” as default.
Switch pin2 to decide whether running “backup to default” while device

booting. “ON”: enabled, “OFF”: disable

⑦ WISE-1530 reset button, one button on WISE-1500 and the other on WISE-ED22

⑧ Micro USB connector

Drag-n-drop programming
Serial port and debugging
Power supplies for UART1 debug port

⑨ RF connector

⑩ Power connector

Step02: Connect the WISE-ED22 to PC using micro-USB cable(Please refer to WISE-ED22 Connection with target board).

Install Driver ( Download latest driver )

The device will be visible in the Device Manager as below.

WICED Studio

The user can refer to the following steps for setup WICED Studio with WISE-1530 SDK.

Windows Install

Download WICED-Studio_SDK download
Extract the installer exe from the zip file to temp folder on your computer; do not execute the installer from the zip file
Double click the installer exe to install WICED Studio as below picture

After installation in completed, launch WICED Studio IDE from shortcut on desktop
When you see the Select WICED Platform page, choose the 43xxx_Wi-Fi item. You can change in "WICED Platform" in SDK toolbar also.

Copy patch file

Download and unzip WM-BN-BM-22_SDK_5.1.x_platform_patch.zip
Copy platforms and WICED folders to <SDK folder>\43xxx_Wi-Fi\ and select replace

Build Source File

Create a "Make Target" file

Step1: In Make Target window click mouse right button

Step2: Select New...

Step3: Type "snip.gpio-WISE_1530A1"

Field explanation: snip.gpio-WISE_1530A1

snip.gpio: application project name
WISE_1530A1: platform name, for WISE-1530 A1 version platform don't change this field.

＊The platform name had rename to WISE_1530A1. Please the following picture WISE_1530 replace to WISE_1530A1.

Build Project

Double click "Make Target" file to build project.

It is build complete when you see below

Generate a Programming File

It will generate three bin files in <SDK folder>\43xxx_Wi-Fi\build folder when build complete.

Bootloader: waf.bootloader-NoOS-WISE_1530A1.bin
DCT( Device Configuration Table): DCT.bin:
Application: snip.gpio-WISE_1530A1.bin

Download and install J-Link software, we need J-Flash tool to combine three bin files for programming.

Launch J-Flash

Open bootloader bin file

Merge DCT bin file

Merge application bin file

Save as a final bin file

Programming

Generate a programming file then use WISE-ED22 to program WISE-1530. User can refer WISE-ED22 Drag-n-drop Programming section.

Debug Setting

Launch a serial port tool(use tera term in this), then setting as below.

Press WISE-1530 reset button, the screen will show as below.

Example

WISE-1530 Demo(StartKit)

Introduction

The Demo application has two main function. One is an BLE and WiFi introducer example. It demonstrates GATT database initialization, DCT configuration, processing read/write requests from a BLE client, and sending data to the client. The BLE WiFi Introducer has two components, an app running on a WICED devices, and an app(BLE Scanner) running on Android device. The other is AgentLite exapmle. It demonstrates how to get the sensor value from WISE-1500 sensors and upload data to cloud server.

Detailed about WISE-1530 Demo

The detailed behavior about this example is explained as following:

System initiation.

Initiation hardware, Wi-Fi wlan connectivity, button1 thread…etc.

BLE and WiFi introducer

WISE-1530 will attempt use default SSID and password connection to AP. If success, WISE-1530 will Loop in AgentLite. Otherwise BLE will advertising for set SSID and password. The manipulation follow as below Step by step usage guide .

Initiation sensor and access data from it.

The TI HDC1050 has been design-in on WISE-1500. It’s a digital humidity sensor with integrated temperature sensor. The HDC1050 is initialized in example and the user can get data of humidity and temperature from it.

Loop in AgentLite or web service.

When device connect to AP, there are many things needed to do including connected to WISE-PaaS server, keep getting data from sensor and data exchanged through AgentLite. It is going to infinite loop for cloud service.

Step by step usage guide

Step 1: Download and unzip WISE_1530_patch.zip, then copy WISE_1530 folder to <SDK folder>\43xxx_Wi-Fi\ apps. Project Explorer window will appear WISE_1530 folder. You can press 'F5' to refresh if you do not see.

Step 2: Create a "WISE_1530.StartKit-WISE_1530A1" target file and build the application.

Step 3: Follow "Generate a Programming File" to generate a bin file, then download bin file to WISE-1530. You will see below message in console screen if success.

Step 4 to step 8 are manipulated on your phone.

Step 4: Install and launch the BLE Scanner app.

Step 5:Pull down the screen to rescan devices and it will list nearby BLE devices. Find the WiFiInt device and press CONNECT button.

Step 6: If the connection is successful, you can see the picture below. Press the "CUSTOM SERVICE" button.

Step 7: Find the UUID: ACA0EF7C-EEAA-48AD-9508-19A6F6B356 for SSID characteristic. Press the "W" button to enter input window. Input new SSID name then press the OK button. Last, user can press "R" button to check new SSID name.

Step 8: Find the UUID: 40B7DE33-93E4-4C8B-A876-D833B415A6CE for Password characteristic then procedure as Step7.

Step 9: If the join is successful can see network IP on console screen.

Step 10: If Connect to broker and WISESnail success, user can see temperature, humidity, GPIO1 and GPIO2 on cloud server.

Memory/Flash Usage

The WISE-1530 has 1 MBytes flash and 256 KBytes RAM. The Start kit flash and memory usage ia as below.

Module	Flash	Static RAM
Adv_WiseSnail	18284	27096
Bluetooth_Embedded_Low_Energy_Stack	154	57
bluetooth_low_energy	78493	9348
button_manager	588	4
command_console	3688	404
command_console_wifi	11146	0
crc	1060	0
DHCP_Server	1524	132
DNS	1724	44
GPIO_button	120	4
Host MCU-family library	15718	2492
Interrupt Vectors	388	0
libc	48018	3364
MQTT_Client	5643	736
Networking	5113	13280
NetX-Duo - Interfaces & Stacks	0	16
Other	170044	2930
Packet Buffers	0	23088
platform	1620	308
RAM Initialisation	4028	0
resources	385936	0
Ring_Buffer	112	0
Startup Stack & Link Script fill	144	25
Supplicant - BESL	3470	812
ThreadX	8596	400
TLV	28	0
WICED	5452	1040
WICED_Bluetooth_Firmware_Driver	36692	0
wiced_log	290	1104
wifi_utils	1082	36
WWD	20429	3176
TOTAL (bytes)	825556	89896

I/O Test (factory)

Introduction

The I/O Test application is a WISE-1530 I/O testing example. It's need extra I/O board(WISE-ED30) to plug in to WISE-1500. The hardware setup as below. This instance could test m2.com I/O that WISE-1530 supported(M2.COM Pinout), include GPIO, ADC, I2C. SPI...etc interface. It used WICED SDK API to read and write I/O.

I/O Test Use WICED API

Step 1: Download and unzip WISE_1530_patch.zip, then copy WISE_1530 folder to <SDK folder>\43xxx_Wi-Fi\ apps.

Step 2: I/O test source code please refer as below files.

Step 3: Create a "WISE_1530.factory-WISE_1530A1" target file and build the application. Download firmware to WISE-1530 then press reset button.

Step 4: You will see below message in console screen if success. Input '1' to select I/O Function Test, the screen will show I/O test items.Input 1~7 to test I/0 and 0 to return previous page.

I/O Test Use SUSI API

The I/O Test example also support SUSI API (please refer SUSI_API).The SUSI support GPIO, I2C, SPI, ADC and PWM APIs. You can simple revise setting to accomplish SUSI API I/O Test.

Step 1: The SUSI API I/O test source code are as below files.

Step 2: Open SimpleCli.mk and change USE_SUSI_API to 1.

Step 3: Double click "WISE_1530.factory-WISE_1530A1" target file and build the application. Then download the firmware to WISE-1530, you can see the screen that same as I/O Function Test.

@@ Line 78: / Line 78: @@
 === Windows Install ===
-#Download [https://community.cypress.com/servlet/JiveServlet/downloadBody/13651-102-1-14558/WICED-Studio-5.2.0.22-IDE-Installer.zip WICED-Studio-5.2.0.22-IDE-Installer.zip]
+#Download [https://www.cypress.com/products/wiced-software WICED-Studio_SDK download]
 #Extract the installer exe from the zip file to temp folder on your computer; do not execute the installer from the zip file
 #Double click the installer exe to install WICED Studio as below picture
@@ Line 102: / Line 102: @@
 === Copy patch file ===
-#Download and unzip [[Media:WM-BN-BM-22_SDK_5.1.x_platform_patch_v1.5.zip|WM-BN-BM-22_SDK_5.1.x_platform_patch.zip]]
+#Download and unzip [[Media:WM-BN-BM-22_SDK_5.1.x_platform_patch_v1.6.zip|WM-BN-BM-22_SDK_5.1.x_platform_patch.zip]]
 #Copy&nbsp;platforms and WICED folders to &lt;SDK folder&gt;\43xxx_Wi-Fi\ and select replace
@@ Line 124: / Line 124: @@
 *WISE_1530A1: platform name, for WISE-1530&nbsp; A1 version platform don't change this field.
-The platform name had rename to&nbsp;WISE_1530A1. Please the following picture WISE_1530&nbsp;replace to&nbsp;WISE_1530A1.
+＊The platform name had rename to&nbsp;WISE_1530A1. Please the following picture WISE_1530&nbsp;replace to&nbsp;WISE_1530A1.
 [[File:WICED make target snip.gpio.png|RTENOTITLE]]
@@ Line 182: / Line 182: @@
 == Debug Setting ==
-Lauch&nbsp;a serial port tool(use tera term in this), then setting as below.
+Launch&nbsp;a serial port tool(use tera term in this), then setting as below.
 [[File:Serial tool setting.png|386x314px|Serial tool setting.png]]
@@ Line 188: / Line 188: @@
 Press&nbsp;WISE-1530 reset button, the screen will show as below.
-[[File:WISE 1530 snip.gpio screen.png|586x363px]]
+[[File:WISE 1530 snip.gpio screen.png|586x363px|WISE 1530 snip.gpio screen.png]]
 = Example =
@@ Line 226: / Line 226: @@
-Step 2: Create a "WISE_1530.StartKit-WISE_1530" target file and build the application.
+Step 2: Create a "WISE_1530.StartKit-WISE_1530A1" target file and build the application.
-[[File:WISE-1530 startkit.png.png]]
+[[File:WISE-1530 startkit v2.png]]
 Step 3: Follow "[http://ess-wiki.advantech.com.tw/view/WISE-1530_SDK#Generate_a_Programming_File Generate a Programming File]" to generate a bin file, &nbsp;then download&nbsp;bin file to WISE-1530. You will see below message in console screen if success.
@@ Line 236: / Line 236: @@
-Step 4 to step 8 are&nbsp;manipulated in cell phone.
+Step 4 to step 8 are&nbsp;manipulated on&nbsp;your&nbsp;phone.
 Step 4:&nbsp;Install and launch the BLE Scanner app.
@@ Line 242: / Line 242: @@
 [[File:WISE-1530 BLE scanner app.jpg|RTENOTITLE]]
-Step 5: Drop&nbsp;the screen to rescan device, it will list out BLE device nearby. Find the '''WiFiInt '''device and press CONNECT button.
+Step 5:Pull down the screen to rescan devices and it will list nearby BLE devices. Find the '''WiFiInt '''device and press CONNECT button.
 [[File:WISE-1530 BLE scaaner-1.png|244x430px|WISE-1530 BLE scaaner-1.png]]&nbsp;
-Step 6: If the connection is successful can see the below picture then press&nbsp;&nbsp;"CUSTOM SERVICE" button.
+Step 6: If the connection is successful, you can see the picture below. Press the "CUSTOM SERVICE" button.
 [[File:WISE-1530 BLE scaaner-2.png|244x430px|WISE-1530 BLE scaaner-2.png]]
@@ Line 254: / Line 254: @@
 [[File:WISE-1530 BLE scaaner-3.png|495x431px|WISE-1530 BLE scaaner-3.png]]
-Step 8:&nbsp; Find the UUID: 40B7DE33-93E4-4C8B-A876-D833B415A6CE&nbsp;for Password characteristic then procedure as Step5.
+Step 8:&nbsp; Find the UUID: 40B7DE33-93E4-4C8B-A876-D833B415A6CE&nbsp;for Password characteristic then procedure as Step7.
 [[File:WISE-1530 BLE scanner-4.png|244x430px|WISE-1530 BLE scanner-4.png]]
@@ Line 429: / Line 429: @@
-Step 3:&nbsp;Create a "WISE_1530.factory-WISE_1530" target file and build the application. Download firmware to WISE-1530 then press reset button.
+Step 3:&nbsp;Create a "WISE_1530.factory-WISE_1530A1" target file and build the application. Download firmware to WISE-1530 then press reset button.
-[[File:WISE-1530 IO testing target file v2.png]]
+[[File:WISE-1530 IO testing target file v2.png|RTENOTITLE]]
 Step 4: You will see below message in console screen if success. Input '1' to select I/O Function Test, the screen will show I/O test items.Input 1~7 to test I/0 and 0 to return previous page.&nbsp;
@@ Line 449: / Line 449: @@
 [[File:WISE-1530 SUSU setting.png|RTENOTITLE]]
-Step 3: Double click "WISE_1530.factory-WISE_1530" target file and build the application. Then download the firmware to WISE-1530, you can see the screen that same as I/O Function Test.
+Step 3: Double click "WISE_1530.factory-WISE_1530A1" target file and build the application. Then download the firmware to WISE-1530, you can see the screen that same as I/O Function Test.

Difference between revisions of "WISE-1530 SDK"

Latest revision as of 05:38, 25 February 2021

Contents

Overview

Setup Development Environment

Preparing for Hardware

WICED Studio

Windows Install

Copy patch file

Build Source File

Create a "Make Target" file

Build Project

Generate a Programming File

Launch J-Flash

Open bootloader bin file

Merge DCT bin file

Merge application bin file

Save as a final bin file

Programming

Debug Setting

Example

WISE-1530 Demo(StartKit)

Introduction

Detailed about WISE-1530 Demo

Step by step usage guide

Memory/Flash Usage

I/O Test (factory)

Introduction

I/O Test Use WICED API

I/O Test Use SUSI API

Navigation menu

Personal tools

Namespaces

Variants

Views

More

Search

Navigation

Tools