.. zephyr:board:: cy8cproto_063_ble

Overview

The PSOC 6 BLE Proto Kit (CY8CPROTO-063-BLE) is a hardware platform that enables design and debug of the Cypress PSOC 63 BLE MCU.

Hardware

For more information about the PSOC 63 BLE MCU SoC and CY8CPROTO-063-BLE board:

PSOC 63 BLE MCU SoC Website_
PSOC 63 BLE MCU Datasheet_
PSOC 63 BLE MCU Architecture Reference Manual_
PSOC 63 BLE MCU Register Reference Manual_
CY8CPROTO-063-BLE Website_
CY8CPROTO-063-BLE User Guide_
CY8CPROTO-063-BLE Schematics_

Supported Features

.. zephyr:board-supported-hw::

System Clock

The PSOC 63 BLE MCU SoC is configured to use the internal IMO+FLL as a source for the system clock. CM0+ works at 50MHz, CM4 - at 100MHz. Other sources for the system clock are provided in the SOC, depending on your system requirements.

Fetch Binary Blobs

cy8cproto_063_ble board requires fetch binary files (e.g Bluetooth controller firmware, CM0p prebuilt images, etc).

To fetch Binary Blobs:

.. code-block:: console

west blobs fetch hal_infineon

Build blinking led sample

Here is an example for building the :zephyr:code-sample:blinky sample application.

.. zephyr-app-commands:: :zephyr-app: samples/basic/blinky :board: cy8cproto_063_ble :goals: build

Programming and Debugging

.. zephyr:board-supported-runners::

The CY8CPROTO-063-BLE includes an onboard programmer/debugger (KitProg3_) to provide debugging, flash programming, and serial communication over USB. Flash and debug commands use OpenOCD and require a custom Infineon OpenOCD version, that supports KitProg3, to be installed.

Infineon OpenOCD Installation

Both the full ModusToolbox_ and the ModusToolbox Programming Tools_ packages include Infineon OpenOCD. Installing either of these packages will also install Infineon OpenOCD. If neither package is installed, a minimal installation can be done by downloading the Infineon OpenOCD_ release for your system and manually extract the files to a location of your choice.

.. note:: Linux requires device access rights to be set up for KitProg3. This is handled automatically by the ModusToolbox and ModusToolbox Programming Tools installations. When doing a minimal installation, this can be done manually by executing the script openocd/udev_rules/install_rules.sh.

West Commands

The path to the installed Infineon OpenOCD executable must be available to the west tool commands. There are multiple ways of doing this. The example below uses a permanent CMake argument to set the CMake variable OPENOCD.

.. tabs:: .. group-tab:: Windows

     .. code-block:: shell

        # Run west config once to set permanent CMake argument
        west config build.cmake-args -- -DOPENOCD=path/to/infineon/openocd/bin/openocd.exe

        # Do a pristine build once after setting CMake argument
        west build -b cy8cproto_063_ble -p always samples/basic/blinky

        west flash
        west debug

  .. group-tab:: Linux

     .. code-block:: shell

        # Run west config once to set permanent CMake argument
        west config build.cmake-args -- -DOPENOCD=path/to/infineon/openocd/bin/openocd

        # Do a pristine build once after setting CMake argument
        west build -b cy8cproto_063_ble -p always samples/basic/blinky

        west flash
        west debug

References

.. target-notes::

.. _PSOC 63 BLE MCU SoC Website: https://www.infineon.com/products/microcontroller/32-bit-psoc-arm-cortex/psoc-6-m4-mcu/psoc-63

.. _PSOC 63 BLE MCU Datasheet: 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

.. _PSOC 63 BLE MCU Architecture Reference Manual: https://documentation.infineon.com/html/psoc6/zrs1651212645947.html

.. _PSOC 63 BLE MCU Register Reference Manual: https://documentation.infineon.com/html/psoc6/bnm1651211483724.html

.. _CY8CPROTO-063-BLE Website: https://www.infineon.com/cms/en/product/evaluation-boards/cy8cproto-063-ble/

.. _CY8CPROTO-063-BLE User Guide: https://www.infineon.com/cms/en/product/evaluation-boards/cy8cproto-063-ble/#!?fileId=8ac78c8c7d0d8da4017d0f00d7eb1812

.. _CY8CPROTO-063-BLE Schematics: https://www.infineon.com/cms/en/product/evaluation-boards/cy8cproto-063-ble/#!?fileId=8ac78c8c7d0d8da4017d0f00ea3c1821

.. _ModusToolbox: https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolbox

.. _ModusToolbox Programming Tools: https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolboxprogtools

.. _Infineon OpenOCD: https://github.com/Infineon/openocd/releases/latest

.. _KitProg3: https://github.com/Infineon/KitProg3