|
| 1 | +.. zephyr:board:: kit_psc3m5_evk |
| 2 | +
|
| 3 | +Overview |
| 4 | +******** |
| 5 | + |
| 6 | +This is the standard evaluation board for the PSOC™ Control C3 family of MCU's. PSOC™ Control C3M5 |
| 7 | +is a high-performance and low-power 32-bit single-core Arm® Cortex® M33-based MCU. |
| 8 | +In addition to the CPU subsystem, the devices contain advanced real-time control peripherals, |
| 9 | +such as a high-performance programmable analog subsystem, comparators, advanced timers with |
| 10 | +high-resolution capability, up to six SCBs, and two CAN FDs for communication. |
| 11 | + |
| 12 | +Hardware |
| 13 | +******** |
| 14 | + |
| 15 | +For more information about the PSC3M5 SoC and KIT_PSC3M5_EVK board: |
| 16 | + |
| 17 | +- `PSOC Control C3 SoC Website`_ |
| 18 | +- `KIT_PSC3M5_EVK Board Website`_ |
| 19 | + |
| 20 | +Kit Features: |
| 21 | +============= |
| 22 | + |
| 23 | +- Onboard programmer/debugger (KitProg3) |
| 24 | +- PSC3M5FDS2AFQ1 |
| 25 | +- Type-C USB device interface |
| 26 | +- Operating voltage of 3.3 V |
| 27 | +- CAN FD interface |
| 28 | +- Headers for MIKROE's mikroBUS shields |
| 29 | +- Headers compatible with Arduino Uno R3 |
| 30 | +- Mode button and a mode LED for KitProg3 |
| 31 | +- Potentionmeter to simulate analog output |
| 32 | +- Two (40-pin) expansion headers |
| 33 | + |
| 34 | +Kit Contents: |
| 35 | +============= |
| 36 | + |
| 37 | +- EVK board |
| 38 | +- Type C to USB A cable |
| 39 | +- Quick Start Guide |
| 40 | + |
| 41 | + |
| 42 | +Supported Features |
| 43 | +================== |
| 44 | + |
| 45 | +.. zephyr:board-supported-hw:: |
| 46 | +
|
| 47 | +
|
| 48 | +Build blinking led sample |
| 49 | +************************* |
| 50 | + |
| 51 | +Here is an example for building the :zephyr:code-sample:`blinky` sample application. |
| 52 | + |
| 53 | +.. zephyr-app-commands:: |
| 54 | + :zephyr-app: samples/basic/blinky |
| 55 | + :board: kit_psc3m5_evk |
| 56 | + :goals: build |
| 57 | + |
| 58 | +Programming and Debugging |
| 59 | +************************* |
| 60 | + |
| 61 | +.. zephyr:board-supported-runners:: |
| 62 | +
|
| 63 | +The KIT_PSC3M5_EVK 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. |
| 64 | + |
| 65 | +Infineon OpenOCD Installation |
| 66 | +============================= |
| 67 | + |
| 68 | +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. |
| 69 | + |
| 70 | +.. 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``. |
| 71 | + |
| 72 | +West Commands |
| 73 | +============= |
| 74 | + |
| 75 | +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``. |
| 76 | + |
| 77 | + .. tabs:: |
| 78 | + .. group-tab:: Windows |
| 79 | + |
| 80 | + .. code-block:: shell |
| 81 | +
|
| 82 | + # Run west config once to set permanent CMake argument |
| 83 | + west config build.cmake-args -- -DOPENOCD=path/to/infineon/openocd/bin/openocd.exe |
| 84 | +
|
| 85 | + # Do a pristine build once after setting CMake argument |
| 86 | + west build -b kit_psc3m5_evk -p always samples/basic/blinky |
| 87 | +
|
| 88 | + west flash |
| 89 | + west debug |
| 90 | +
|
| 91 | + .. group-tab:: Linux |
| 92 | + |
| 93 | + .. code-block:: shell |
| 94 | +
|
| 95 | + # Run west config once to set permanent CMake argument |
| 96 | + west config build.cmake-args -- -DOPENOCD=path/to/infineon/openocd/bin/openocd |
| 97 | +
|
| 98 | + # Do a pristine build once after setting CMake argument |
| 99 | + west build -b kit_psc3m5_evk -p always samples/basic/blinky |
| 100 | +
|
| 101 | + west flash |
| 102 | + west debug |
| 103 | +
|
| 104 | +Once the gdb console starts after executing the west debug command, you may now set breakpoints and perform other standard GDB debugging on the CYW20829 CM33 core. |
| 105 | + |
| 106 | +.. _PSOC Control C3 SoC Website: |
| 107 | + https://www.infineon.com/cms/en/product/microcontroller/32-bit-psoc-arm-cortex-microcontroller/32-bit-psoc-control-arm-cortex-m33-mcu/ |
| 108 | + |
| 109 | +.. _KIT_PSC3M5_EVK Board Website: |
| 110 | + https://www.infineon.com/cms/en/product/evaluation-boards/kit_psc3m5_evk/ |
| 111 | + |
| 112 | +.. _ModusToolbox: |
| 113 | + https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolbox |
| 114 | + |
| 115 | +.. _ModusToolbox Programming Tools: |
| 116 | + https://softwaretools.infineon.com/tools/com.ifx.tb.tool.modustoolboxprogtools |
| 117 | + |
| 118 | +.. _Infineon OpenOCD: |
| 119 | + https://github.com/Infineon/openocd/releases/latest |
| 120 | + |
| 121 | +.. _KitProg3: |
| 122 | + https://github.com/Infineon/KitProg3 |
0 commit comments