-
Notifications
You must be signed in to change notification settings - Fork 20
/
208XX_readme.txt
167 lines (149 loc) · 8.86 KB
/
208XX_readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
------------------------------------------------------------------------------------
BT 208XX SDK
------------------------------------------------------------------------------------
Overview
--------
The Cypress CYW20819, CYW20820, and CYW89820 are ultra-low-power dual-mode Bluetooth
5.0 wireless MCU devices. They have a stand-alone baseband processor with an
integrated 2.4 GHz transceiver supporting BR/EDR/BLE. They are identical except
that the CYW20820 and CYW89820 have an internal Power Amplifier (iPA) with
programmable BDR transmit power up to 10.5 dBm. CYW208XX is used to refer to all
those parts. Similarly, CYW9208XXEVB is used to refer to the CYW920819EVB-02,
CYW920820EVB-02, and CYW989820EVB-01 boards.
SDK Software Features
----------------------
- Dual mode Bluetooth stack included the ROM (BR/EDR and BLE).
- BT stack and profile level APIs for embedded BT application development.
- WICED HCI protocol to simplify host/MCU application development.
- APIs and drivers to access on board peripherals
- Bluetooth protocols include GAP, GATT, SMP, RFCOMM, SDP, AVDT/AVCT, BLE Mesh
- BLE and BR/EDR profile APIs, libraries and sample apps
- Support for Over-The-Air (OTA) upgrade.
- Device Configurator for creating custom pin mapping.
- Bluetooth Configurator for creating BLE GATT Database.
- Documentation for APIs, datasheet, profiles and features.
Kits
----
CYW920819EVB-02:
62-FBGA package, Arduino compatible headers, 9-axis motion sensor and thermistor,
user switches and LEDs, USB connector for power, programming and USB-UART bridge.
Note: Max UART baud rate is 3M
For more information, see - http://www.cypress.com/CYW920819EVB-02
CYBT-213043-MESH
35-SMT package, PIR sensor (motion detection), Ambient Light Sensor and thermistor,
user switches and RGB LEDs, with additional 1MB External Serial Flash.
CYW20819-based dual-mode (BLE/BR/EDR) Bluetooth 5.0 with SIG MESH Qualified Module,
FCC, ISED, MIC, and CE Certified Module.
USB connector for power, programming and USB-UART bridge.
Note: Max UART baud rate is 1M. Use baud rate of 115200 for Client Control.
For more information, see - http://www.cypress.com/CYBT-213043-MESH
CYW920820EVB-02:
62-FBGA package, Arduino compatible headers, 9-axis motion sensor and thermistor,
user switches and LEDs, USB connector for power, programming and USB-UART bridge,
10.5 dBm internal power amplifier.
Note: Max UART baud rate is 3M
For more information, see - http://www.cypress.com/CYW920820EVB-02
CYW989820EVB-01:
48-WQFN package, Arduino compatible headers, 9-axis motion sensor and thermistor,
user switches and LEDs, USB connector for power, programming and USB-UART bridge,
10.5 dBm internal power amplifier.
Note: Max UART baud rate is 3M
For more information, see - https://www.cypress.com/products/automotive-wireless
CYBT-213043-EVAL
35-SMT package, Arduino compatible headers. CYW20819-based dual-mode (BLE/BR/EDR)
Bluetooth 5.0-compliant fully certified module (CYBT-213043-02).
Note: Max UART baud rate is 1M. Use baud rate of 115200 for Client Control.
For more information, see - http://www.cypress.com/CYBT-213043-EVAL
Software Tools
--------------
Following applications are installed with ModusToolbox on your computer.
BT Spy :
BTSpy is a trace viewer utility that can be used in the WICED BT platforms to
view protocol and application trace messages from the embedded device. The
utility is located in folder below. For more information, see readme.txt
in the same folder. (This utility can also be run from IDE Launches menu).
It is supported on Windows, Linux and macOS.
<Install Dir>\ModusToolbox_1.1\tools\wiced-tools-1.0\BT\BTSpy
BT/BLE Profile Client Control:
This application emulates the host MCU applications for BLE and BR/EDR profile.
It demonstrates WICED BT APIs. It application communicates with embedded apps
over the WICED HCI interface. The application is located in folder below.
See readme.txt in the same folder. (This utility can also be run from IDE Launches menu).
It is supported on Windows, Linux and macOS.
<Install Dir>\ModusToolbox_1.1\libraries\bt_sdk-1.x\components\BT-SDK\common\client_control
Note: For CYBT-213043-EVAL, use baud rate of 115200.
BLE Mesh Client Control:
Similar to the above app, this application emulates the host MCU applications
for BLE Mesh models. It can configure and provision mesh devices and create mesh
network. The application is located in folder below. (Currently for Windows OS only).
<Install Dir>\ModusToolbox_1.1\libraries\bt_sdk-1.x\components\BT-SDK\common\apps\snip\mesh\ClientControl
See readme.txt in the same folder.
Note: For CYBT-213043-MESH and CYBT-213043-EVAL, use baud rate of 115200.
Peer apps:
Application that run on Windows, iOS or Android and act as peer
BT apps to demonstrate specific profiles or features.
BT/BLE apps location -
<Install Dir>\ModusToolbox_1.1\libraries\bt_sdk-1.x\components\BT-SDK\common\peer_apps
BLE Mesh apps location -
<Install Dir>\ModusToolbox_1.1\libraries\bt_sdk-1.x\components\BT-SDK\common\apps\snip\mesh\peerapps
Device Configurator:
Use this tool to create custom pin mapping for your device. Run this tool from ModusToolbox IDE
"Configure Device" menu. It is supported on Windows, Linux and macOS.
Note: The pin mapping is based on wiced_platform.h for your board.
Bluetooth Configurator:
Use this application to create and configure BLE GATT Database for your application.
Run this tool from ModusToolbox IDE "Configure Device" menu -> Peripherals -> Bluetooth
-> External tools. It is supported on Windows, Linux and macOS.
Power Estimator:
Use this application to get an estimate of power consumed by your application, running on CYW920819EVB-02 kit.
Run this tool from ModusToolbox <Install Dir>\tools\cype-tool-1.0\cype-tool
It is supported on Windows, Linux and macOS.
Tracing
-------
To view application traces, there are 2 methods available. Note that the application
needs to configure the tracing options.
1. WICED Peripheral UART - Open this port on your computer using serial port utility
such as Tera Term or PuTTY (usually baud rate of 115200).
2. WICED HCI UART - Open this port on your computer using Client Control application
mentioned above (usually baud rate of 3M). Then run BT Spy utility mentioned above.
Application Settings
--------------------
Application settings can be changed via 'Change Application Settings...' menu (right click on
application in IDE). Options below are available for all applications. Other application
specific options might also be available and are documented in the readme.txt for those
applications.
BT_DEVICE_ADDRESS
Set BT device address for your BT device. The BT address is 6 bytes,
for example 20819A10FFEE. By default, the SDK will set random BDA for your device.
UART
Select the UART port you want the application to be downloaded. For example 'COM6'
on Windows or '/dev/ttyWICED_HCI_UART0' on Linux or '/dev/tty.usbserial-000154' on macOS.
By default, the SDK will auto detect the port.
ENABLE_DEBUG
For HW debugging, select the option '1'. See the document WICED-Hardware-Debugging.pdf
for more information. This setting configures GPIO for SWD.
CYW920819EVB-02/CYW920820EVB-02: SWD signals are shared with D4 and D5, see SW9 in schematics.
CYBT-213043-MESH/CYBT-213043-EVAL: SWD signals are routed to P12=SWDCK and P13=SWDIO. Use
expansion connectors to connect VDD, GND, SWDCK and SWDIO to your SWD Debugger probe.
CYW989820EVB-01: SWDCK (P02) is routed to the J13 DEBUG connector, but not SWDIO. Add a wire
from J10 pin 3 (PUART CTS) to J13 pin 2 to connect GPIO P10 to SWDIO.
POWER_ESTIMATOR
For power estimation, select the option "yes". See the cype-tool help for more information.
This setting enables power estimation feature of your app on CYW920819EVB-02 kit.
Downloading application to kit
------------------------------
If you have issues downloading to the kit, follow the steps below -
- Press and hold the 'Recover' button on the kit.
- Press and hold the 'Reset' button on the kit.
- Release the 'Reset' button.
- After one second, release the 'Recover' button.
After downloading the application, press the 'Reset' button on the kit.
Over The Air (OTA) Firmware Upgrade
-----------------------------------
Application that support OTA upgrade can be updated via peer OTA apps located in the folder -
<Install Dir>\ModusToolbox_1.1\libraries\bt_sdk-1.x\components\BT-SDK\common\peer_apps\ota_firmware_upgrade
See the readme.txt file located in the above folder for instructions.
To generate OTA image for the app, append command line OTA_FW_UPGRADE=1 to the build, for example
> make PLATFORM=CYW920819EVB-02 OTA_FW_UPGRADE=1
This will generate <app>.bin file in the 'build' folder.
------------------------------------------------------------------------------------