1.. _cy8cproto_063_ble:
2
3INFINEON CY8CPROTO-063-BLE
4###########################
5
6Overview
7********
8
9The PSoC 6 BLE Proto Kit (CY8CPROTO-063-BLE) is a hardware platform that
10enables design and debug of the Cypress PSoC 63 BLE MCU.
11
12.. image:: img/cy8cproto-063-ble.jpg
13     :align: center
14     :alt: CY8CPROTO-063-BLE
15
16Hardware
17********
18
19For more information about the PSoC 63 BLE MCU SoC and CY8CPROTO-063-BLE board:
20
21- `PSoC 63 BLE MCU SoC Website`_
22- `PSoC 63 BLE MCU Datasheet`_
23- `PSoC 63 BLE MCU Architecture Reference Manual`_
24- `PSoC 63 BLE MCU Register Reference Manual`_
25- `CY8CPROTO-063-BLE Website`_
26- `CY8CPROTO-063-BLE User Guide`_
27- `CY8CPROTO-063-BLE Schematics`_
28
29Supported Features
30==================
31
32The board configuration supports the following hardware features:
33
34+-----------+------------+-----------------------+
35| Interface | Controller | Driver/Component      |
36+===========+============+=======================+
37| NVIC      | on-chip    | nested vectored       |
38|           |            | interrupt controller  |
39+-----------+------------+-----------------------+
40| SYSTICK   | on-chip    | system clock          |
41+-----------+------------+-----------------------+
42| GPIO      | on-chip    | gpio                  |
43+-----------+------------+-----------------------+
44| PINCTRL   | on-chip    | pin control           |
45+-----------+------------+-----------------------+
46| SPI       | on-chip    | spi                   |
47+-----------+------------+-----------------------+
48| UART      | on-chip    | serial port-polling;  |
49|           |            | serial port-interrupt |
50+-----------+------------+-----------------------+
51| I2C       | on-chip    | I2C                   |
52+-----------+------------+-----------------------+
53| PWM       | on-chip    | PWM                   |
54+-----------+------------+-----------------------+
55| Counter   | on-chip    | Counter               |
56+-----------+------------+-----------------------+
57| Bluetooth | on-chip    | Bluetooth             |
58+-----------+------------+-----------------------+
59
60
61The default configurations can be found in the Kconfig
62
63:zephyr_file:`boards/arm/cy8cproto_063_ble/cy8cproto_063_ble_defconfig`
64
65System Clock
66============
67
68The PSoC 63 BLE MCU SoC is configured to use the internal IMO+FLL as a source for
69the system clock. CM0+ works at 50MHz, CM4 - at 100MHz. Other sources for the
70system clock are provided in the SOC, depending on your system requirements.
71
72
73OpenOCD Installation
74====================
75
76To get the OpenOCD package, it is required that you
77
781. Download the software ModusToolbox 3.1. https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolbox
792. Once downloaded add the path to access the Scripts folder provided by ModusToolbox
80   export PATH=$PATH:/path/to/ModusToolbox/tools_3.1/openocd/scripts
813. Add the OpenOCD executable file's path to west flash/debug.
824. Flash using: west flash --openocd path/to/infineon/openocd/bin/openocd
835. Debug using: west debug --openocd path/to/infineon/openocd/bin/openocd
84
85
86Fetch Binary Blobs
87******************
88
89cy8cproto_063_ble board requires fetch binary files
90(e.g Bluetooth controller firmware, CM0p prebuilt images, etc).
91
92To fetch Binary Blobs:
93
94.. code-block:: console
95
96   west blobs fetch hal_infineon
97
98Programming and Debugging
99*************************
100
101The CY8CPROTO-063-BLE includes an onboard programmer/debugger (KitProg3) with
102mass storage programming to provide debugging, flash programming, and serial
103communication over USB. Flash and debug commands must be pointed to the Cypress
104OpenOCD you downloaded above.
105
106On Windows:
107
108.. code-block:: console
109
110   west flash --openocd path/to/infineon/openocd/bin/openocd.exe
111   west debug --openocd path/to/infineon/openocd/bin/openocd.exe
112
113On Linux:
114
115.. code-block:: console
116
117   west flash --openocd path/to/infineon/openocd/bin/openocd
118   west debug --openocd path/to/infineon/openocd/bin/openocd
119
120References
121**********
122
123.. _PSoC 63 BLE MCU SoC Website:
124    https://www.cypress.com/products/32-bit-arm-cortex-m4-psoc-6
125
126.. _PSoC 63 BLE MCU Datasheet:
127    https://www.infineon.com/dgdl/Infineon-PSoC_6_MCU_PSoC_63_with_BLE_Datasheet_Programmable_System-on-Chip_(PSoC)-DataSheet-v16_00-EN.pdf?fileId=8ac78c8c7d0d8da4017d0ee4efe46c37&utm_source=cypress&utm_medium=referral&utm_campaign=202110_globe_en_all_integration-files
128
129.. _PSoC 63 BLE MCU Architecture Reference Manual:
130    https://documentation.infineon.com/html/psoc6/zrs1651212645947.html
131
132.. _PSoC 63 BLE MCU Register Reference Manual:
133    https://documentation.infineon.com/html/psoc6/bnm1651211483724.html
134
135.. _CY8CPROTO-063-BLE Website:
136    https://www.infineon.com/cms/en/product/evaluation-boards/cy8cproto-063-ble/
137
138.. _CY8CPROTO-063-BLE User Guide:
139    https://www.infineon.com/cms/en/product/evaluation-boards/cy8cproto-063-ble/#!?fileId=8ac78c8c7d0d8da4017d0f00d7eb1812
140
141.. _CY8CPROTO-063-BLE Schematics:
142    https://www.infineon.com/cms/en/product/evaluation-boards/cy8cproto-063-ble/#!?fileId=8ac78c8c7d0d8da4017d0f00ea3c1821
143
144.. _Infineon OpenOCD:
145    https://github.com/infineon/openocd/releases/tag/release-v4.3.0
146