boards: wbz450_curiosity: add docs and openocd support

Added the index.rst and openocd.cfg file support for wbz450_curiosity

Signed-off-by: Dinesh Arasu <[email protected]>

Author: DineshArasu-Microchip

boards/microchip/wbz/wbz450_curiosity/doc/img/wbz450_curiosity.jpg

@@ -0,0 +1,309 @@
+.. zephyr:board:: wbz450_curiosity
+
+Overview
+*********
+
+The **WBZ450 Curiosity Board** is a development and evaluation platform for Microchip’s WBZ450 Bluetooth® Low Energy and Zigbee RF Module, based on the **PIC32CX-BZ2 family** of MCUs.
+
+The board offers an integrated development environment with on-board debugging, flexible power options, and expansion capabilities through the mikroBUS™ socket. It is ideal for rapid prototyping, testing, and demonstrating wireless applications supporting BLE 5.2 and Zigbee protocols.
+
+WBZ450 supports the following drivers:
+
+* UART  
+* Flash  
+* GPIO  
+* Pin Control  
+* Entropy  
+* DMA  
+* RTC  
+* I2C  
+* SPI  
+* PWM  
+* Clock Control  
+* Reset  
+
+Hardware
+********
+
+* **WBZ450PE Module** – Integrated multi-protocol (BLE 5.2 + Zigbee) RF module.
+* **On-board Debugger/Programmer (PKOB4)** – Provides programming and debugging interface.
+* **mikroBUS™ Socket (J4)** – Enables expansion with Click boards™ for rapid hardware prototyping.
+* **Power Supply** – Supports USB or Li-Po battery-based power input.
+* **Switches and LEDs** – Dedicated user and reset switches, RGB LED, and status indicators.
+* **USB Connectivity** – Micro-B USB connector (J7) for programming, UART, and power input.
+* **Other Peripherals** – Includes a temperature sensor (MCP9700A), 32.768 kHz secondary oscillator, and power measurement header.
+
+
+**Design Files:**  
+`WBZ450 Curiosity Board Hardware Design Documentation <https://ww1.microchip.com/downloads/aemDocuments/documents/WSG/ProductDocuments/BoardDesignFiles/WBZ450+Curiosity+Board+Design+Documentation-R2.zip>`_
+
+Supported Features
+==================
+
+.. zephyr:board-supported-hw::
+
+For complete list of `WBZ450 Curiosity Board User’s Guide <https://ww1.microchip.com/downloads/aemDocuments/documents/WSG/ProductDocuments/UserGuides/WBZ450-Curiosity-Board-User-Guide-DS50003639.pdf>`_
+
+
+Connections and IOs
+===================
+
+User LED (D5)
+-------------
+
+- One blue **user LED** is available on the WBZ450 Curiosity Board. 
+  - Connected to GPIO pin **PB7**.
+  - Drive **PB7 LOW** → LED turns **ON**.
+  - Drive **PB7 HIGH** → LED turns **OFF**.
+
+
+Push Buttons
+------------
+
+The WBZ450 Curiosity Board includes two push switches:
+
+- **Reset Switch (SW1)**: Connected to **MCLR**. Pulls high in idle; pressing drives low to reset the module.  
+- **User Switch (SW2)**: Connected to **PB4**. Pulls high in idle; pressing drives low to generate a user-defined input.
+
+**Switches Description**
+
+.. list-table::
+   :header-rows: 1
+   :widths: 25 25 50
+
+   * - Switch Name
+     - Pin on WBZ450 Curiosity Board
+     - Description
+   * - Reset (SW1)
+     - MCLR
+     - Reset switch connected to the MCLR pin
+   * - User Button (SW2)
+     - PB4
+     - Configurable user switch for custom application input
+
+
+mikroBUS™ Socket (J4)
+---------------------
+
+The **mikroBUS™ socket** on the WBZ450 Curiosity Board supports hardware expansion using Click boards™. It provides:
+
+- **Communication Interfaces:** SPI, UART, and I²C  
+- **Power Lines:** 3.3 V/GND and 5 V/GND  
+- **Additional Signals:** PWM, RST, INT, and AN  
+
+**mikroBUS™ Socket Pinout**
+
+.. list-table::
+   :header-rows: 1
+   :widths: 10 15 30 45
+
+   * - Pin #
+     - Pin Name
+     - Pin on WBZ450 Curiosity Board
+     - Description
+   * - 1
+     - AN
+     - PB6_AN
+     - ADC analog input
+   * - 2
+     - RST
+     - PB2
+     - General purpose I/O pin
+   * - 3
+     - CS
+     - PB13_SERCOM0_PAD3
+     - Chip select for SPI or general purpose I/O
+   * - 4
+     - SCK
+     - PB11_SERCOM0_PAD1
+     - SPI clock
+   * - 5
+     - MISO
+     - PB10_SERCOM0_PAD2
+     - SPI host input / client output
+   * - 6
+     - MOSI
+     - PB12_SERCOM0_PAD0
+     - SPI host output / client input
+   * - 7
+     - +3.3V
+     - +3.3V
+     - 3.3 V power supply
+   * - 8
+     - GND
+     - GND
+     - Ground
+   * - 9
+     - PWM
+     - PB0
+     - PWM output / general I/O
+   * - 10
+     - INT
+     - PB1
+     - Interrupt input / general I/O
+   * - 11
+     - TX
+     - PA1_SERCOM1_PAD0
+     - UART TX
+   * - 12
+     - RX
+     - PA0_SERCOM1_PAD1
+     - UART RX
+   * - 13
+     - SCL
+     - PA3_SERCOM1_PAD1
+     - I²C clock
+   * - 14
+     - SDA
+     - PA2_SERCOM1_PAD0
+     - I²C data
+   * - 15
+     - +5V
+     - +5V
+     - 5 V power supply
+   * - 16
+     - GND
+     - GND
+     - Ground
+
+
+For detailed schematics, pin assignments, and signal descriptions, see the  
+`WBZ450 Curiosity Board User’s Guide <https://ww1.microchip.com/downloads/aemDocuments/documents/WSG/ProductDocuments/UserGuides/WBZ450-Curiosity-Board-User-Guide-DS50003639.pdf>`_
+
+
+Programming and Debugging
+*************************
+
+This section describes how to flash and debug applications on the Microchip Wireless WBZ450 Curiosity board using Zephyr.
+
+**Supported Debuggers**
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 20 20 20 20
+
+   * - 
+     - Flash
+     - Debug
+     - Debug Server
+     - Debug Tool
+   * - Segger
+     - ✓
+     - ✓
+     - ✓
+     - J-Link
+   * - OpenOCD
+     - ✓
+     - ✓
+     - ✓
+     - PKOB4, PICkit Basic
+
+Flashing
+========
+
+Follow the steps below to build and flash your application:
+
+1. Open a terminal and change to the Zephyr workspace directory:
+
+   .. code-block:: console
+
+      cd zephyr
+
+2. Build the application using the following command:
+
+   .. code-block:: console
+
+      west build -p always -b wbz450_curiosity .\samples\basic\blinky\
+
+3. After a successful build, connect the WBZ450 device to your machine.
+
+4. Flash the device using the `west flash` command:
+
+   .. code-block:: console
+
+      west flash
+
+5. Ensure the flash process completes successfully. You should see confirmation messages in the terminal.
+
+Debugging
+=========
+
+To debug the WBZ450 application using Visual Studio Code:
+
+1. Ensure the application is built for the WBZ450 board.
+2. Install the `cortex-debug` extension in Visual Studio Code.
+3. Open the workspace and click the **Run and Debug** icon on the left sidebar.
+4. If `launch.json` and `tasks.json` files are already present, VS Code will automatically start the debug session.
+5. If prompted to create a new `launch.json`, select the **Cortex Debug** debugger option.
+6. Replace the contents of `launch.json` with:
+
+   .. code-block:: json
+
+      {
+        "version": "2.0.0",
+        "configurations": [
+          {
+            "name": "Debug WBZ450",
+            "type": "cortex-debug",
+            "request": "attach",
+            "servertype": "openocd",
+            "cwd": "C:\\developers\\zephyr\\",
+            "executable": "<path to zephyr project>/build/zephyr/zephyr.elf",
+            "device": "WBZ450",
+            "configFiles": [
+              "interface/cmsis-dap.cfg",
+              "target/wbz450.cfg"
+            ],
+            "gdbPath": "<path to zephyr sdk>/arm-zephyr-eabi/bin/arm-zephyr-eabigdb.exe",
+            "preLaunchTask": "flash_wbz450_hex",
+            "postRestartCommands": [
+              "symbol-file <path to zephyr project>/build/zephyr/zephyr.elf",
+              "monitor reset halt",
+              "break main"
+            ],
+            "showDevDebugOutput": "none"
+          }
+        ]
+      }
+
+7. Create `tasks.json` inside `.vscode` with:
+
+   .. code-block:: json
+
+      {
+        "version": "2.0.0",
+        "tasks": [
+          {
+            "label": "flash_wbz450_hex",
+            "type": "shell",
+            "command": "openocd",
+            "args": [
+              "-f", "interface/cmsis-dap.cfg",
+              "-f", "target/wbz450.cfg",
+              "-c", "init",
+              "-c", "reset halt",
+              "-c", "program <path to zephyr project>/build/zephyr/zephyr.hex reset exit"
+            ],
+            "problemMatcher": [],
+            "group": {
+              "kind": "build",
+              "isDefault": true
+            }
+          }
+        ]
+      }
+
+8. Connect the WBZ450 Curiosity board.
+9. Click the **Run and Debug** icon again and select the WBZ450 debug option.
+10. Confirm that the debugger hits the breakpoint in `main.c`. Press **Continue** to proceed.
+
+References
+==========
+
+- `WBZ450 Curiosity Board Product Page <https://www.microchip.com/en-us/development-tool/EV22L65A>`_
+- `WBZ450 Curiosity Board User’s Guide <https://ww1.microchip.com/downloads/aemDocuments/documents/WSG/ProductDocuments/UserGuides/WBZ450-Curiosity-Board-User-Guide-DS50003639.pdf>`_
+- `Hardware Design Files <https://ww1.microchip.com/downloads/aemDocuments/documents/WSG/ProductDocuments/BoardDesignFiles/WBZ450+Curiosity+Board+Design+Documentation-R2.zip>`_
+- `PIC32CX-BZ2 and WBZ45 Family Data Sheet <https://ww1.microchip.com/downloads/aemDocuments/documents/WSG/ProductDocuments/DataSheets/PIC32CX-BZ2-and-WBZ45-Family-Data-Sheet-DS70005504.pdf>`_
+- `mikroBUS Click Boards <https://www.mikroe.com/click>`_
+- `Microchip Support Portal <http://support.microchip.com/>`_
+- `Microchip Direct <https://www.microchipdirect.com/?srsltid=AfmBOop0KWt1byQZUafcD8wwzrgQX_iuCJLi6AmzTIzhI6Ez-D2IZr_M>`_

boards/microchip/wbz/wbz450_curiosity/doc/index.rst

@@ -0,0 +1,25 @@
+# Copyright (c) 2025 Microchip Technologies Inc
+# SPDX-License-Identifier: Apache-2.0
+source [find interface/cmsis-dap.cfg]
+transport select swd
+
+# chip name
+set CHIPNAME wbz450
+set ENDIAN little
+set CPUTAPID 0x04D8810B
+
+source [find target/wbz450.cfg]
+
+# reset_config none
+cortex_m reset_config sysresetreq
+
+$_TARGETNAME configure -event gdb-attach {
+	echo "Debugger attaching: halting execution"
+	reset halt
+	gdb_breakpoint_override hard
+}
+
+$_TARGETNAME configure -event gdb-detach {
+	echo "Debugger detaching: resuming execution"
+	resume
+}