Difference between revisions of "WISE-1530 SDK"

From ESS-WIKI
Jump to: navigation, search
Line 180: Line 180:
 
=== Introduction ===
 
=== Introduction ===
  
The Demo application has two main function. One is an BLE and WiFi introducer. 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  [[IoTGateway/WiseSnail|WiseSnail exapmle]]. It demonstrates how to get the sensor value from WISE-1500 built-in sensor and upload data to cloud server.
+
The Demo application has two main function. One is an BLE and WiFi introducer. 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  [[IoTGateway/WiseSnail|WiseSnail]] exapmle. It demonstrates how to get the sensor value from WISE-1500 built-in sensor and upload data to cloud server.
  
 
[[File:WISE-1530 BLE scanner app.jpg|RTENOTITLE]]
 
[[File:WISE-1530 BLE scanner app.jpg|RTENOTITLE]]

Revision as of 05:46, 11 September 2017

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® 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 running the Microsoft Windows 7 operating systems

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

Step01: Please prepare boards as below.

          RTENOTITLE

 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

Step02: Connect the WISE-ED22 to PC using micro-USB cable.

  • The device will be visible in the Device Manager as below, user can use serial tools (putty, tera term ...etc.) to key-in command. 

          Mbed  uart.png

WICED Studio

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

Windows Install

  1. Download WICED-Studio-4.1.1.8-IDE-Installer.exe.zip
  2. Extract the installer exe from the zip file to temp folder on your computer; do not execute the installer from the zip file
  3. Double click the installer exe to install WICED Studio as below picture

WICED installer 1.png

WICED installer 2.png

WICED installer 3-1.png

WICED installer 4.png

WICED installer 5.png

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


WICED installer 6.png

Copy patch file

  1. Download and unzip WISE-1530_SDK_4.1.8_platform_patch.zip
  2. Copy platforms and WICED folders to <SDK folder>\43xxx_Wi-Fi\ and select replace

Build Source File

Make a "Make Target" file

       Step1: In Make Target window click mouse right button

       Step2: Select New...

WICED make target new.png

       Step3: Type "snip.gpio-WISE_1530"

RTENOTITLE

Field explanation: snip.gpio-WISE_1530

  • snip.gpio: application project name
  • WISE_1530: platform name, for WISE-1530 platform don't change this field 

RTENOTITLE



​       

Build Project

Double click "Make Target" file to build project.

RTENOTITLE

It is build complete when you see below 

RTENOTITLE

Generate a Programming File

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

  1. Bootloader: waf.bootloader-NoOS-WISE_1530.bin 
  2. DCT( Device Configuration Table): DCT.bin:
  3. Application: snip.gpio-WISE_1530.bin

RTENOTITLE

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

Launch J-Flash

RTENOTITLE

Open bootloader bin file

RTENOTITLE

Merge DCT bin file

RTENOTITLE

Merge application bin file

RTENOTITLE

Save as a final bin file

WISE-1530 J-Flash Save-as v05.png.png

Programming 

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

Example:

Demo

Introduction

The Demo application has two main function. One is an BLE and WiFi introducer. 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  WiseSnail exapmle. It demonstrates how to get the sensor value from WISE-1500 built-in sensor and upload data to cloud server.

RTENOTITLE

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
  • 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. The driver of HDC1050 named as “hdc1050.c” is located in folder “src/sensor/ti” of source tree of WISE-1520 SDK and the user should refer to it for how to implement driver on WISE-1520 module. Due to the “hdc1050.c” is implemented based on TI RTOS driver framework, the user must to study know how about TI RTOS driver framework and can read it at section “TI-RTOS Drivers” in document “tirtos_User_Guide.pdf” that can be obtained from section "TI".

  • Loop in AgentLite or web service.
When device booting into station mode, it is going to infinite loop for AgentLite. There are many things needed to do including connected to WISE-PaaS server, keep getting data from sensor and data exchanged through AgentLite. On the other hand, when device booting into AP mode, it is going to infinite loop for web service.



The flowchart is about example how to running as below figure.

Step by step usage guide

Step 1: download ble_wifi_introducer.bin to WISE-1530, then see the below on console screen.

WISE-1530 Ble Wifi Introducer start v2.png

Step 2: Install BLE Scanner and launch the app in cell phone.

Step 3: Drop the screen to rescan device, it will list out BLE device nearby. Find the WiFiInt device and press CONNECT button.

WISE-1530 BLE scaaner-1.png 


Step 4: If the connection is successful can see the below picture then press  "CUSTOM SERVICE" button.

WISE-1530 BLE scaaner-2.png


Step 5: Find the UUID: ACA0EF7C-EEAA-48AD-9508-19A6F6B356CE 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.

WISE-1530 BLE scaaner-3.png

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

WISE-1530 BLE scanner-4.png

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

WISE-1530 BLE scanner-5.png