boards: weact: blackpill_h523ce: Added index.rst file

Author: filipembedded

boards/weact/blackpill_h523ce/blackpill_h523ce.dts

@@ -45,18 +45,6 @@
     };
 };
 
-/*
-&timers4 {
-	status = "okay";
-
-	pwm4: pwm {
-		status = "okay";
-				pinctrl-0 = <&tim4_ch1_pb6 &tim4_ch2_pb7>;
-		pinctrl-names = "default";
-	};
-};
-*/
-
 &timers3 {
 	status = "okay";
 	st,prescaler = <1000>;
@@ -75,14 +63,12 @@
 	current-speed = <115200>;
 };
 
-/*
 &i2c1 {
-	pinctrl-0 = <&i2c1_scl_pb8 &i2c1_sda_pb9>;
+	pinctrl-0 = <&i2c1_scl_pb6 &i2c1_sda_pb7>;
 	pinctrl-names = "default";
 	status = "okay";
 	clock-frequency = <I2C_BITRATE_FAST>;
 };
-*/
 
 &spi1 {
 	pinctrl-0 = <&spi1_sck_pa5 &spi1_nss_pa4
@@ -91,13 +77,11 @@
 	status = "okay";
 };
 
-/*
 &rtc {
 	clocks = <&rcc STM32_CLOCK_BUS_APB3 0x00200000>,
 		 <&rcc STM32_SRC_LSE RTC_SEL(1)>;
 	status = "okay";
 };
-*/
 
 zephyr_udc0: &usb {
 	pinctrl-0 = <&usb_dm_pa11 &usb_dp_pa12>;

boards/weact/blackpill_h523ce/doc/index.rst

@@ -0,0 +1,106 @@
+.. zephyr:board:: blackpill_h523ce
+
+Overview
+********
+The WeAct STM32H523CE Core Board is a low cost and bare-bone development
+board made in famous "blackpill" package. It features STM32H523CE, high
+performance microcontroller based on a Arm Cortex M33 processor. 
+ 
+Hardware
+********
+
+The STM32H523CE based Black Pill board provides the following harware 
+components:
+
+- STM32H523CE in 48 pin package
+- ARM 32-bit Cortex -M33 CPU with FPU
+- 250 MHz max CPU frequency
+- VDD from 1.7 V to 3.6 V
+- 512 kB Flash
+- 274 kB SRAM
+- TIM 
+- ADC 
+- USART 
+- I2C 
+- SPI 
+- USBFS 
+- FDCAN
+- RTC
+
+Supported Features
+==================
+
+.. zephyr:board-supported-hw::
+
+Connections and IOs
+===================
+
+Default Zephyr Peripheral Mapping:
+----------------------------------
+
+- UART_1 TX/RX : PA9/PA10
+- I2C1 SCL/SDA : PB6/PB7
+- SPI1 CS/SCK/MISO/MOSI : PA4/PA5/PA6/PA7 (Routed to footprint for external flash)
+- PWM_3_CH3 : PB0
+- PWM_3_CH4 : PB1
+- ADC_1 : PA1
+- USER_PB : PA0
+- USER_LED : PC13
+
+Programming and Debugging
+*************************
+
+.. zephyr:board-supported-runners::
+
+There are 2 main entry points for flashing STM32H5X SoCs, one using the ROM
+bootloader, and another by using the SWD debug port (which requires additional
+hardware). Flashing using the ROM bootloader requires a special activation
+pattern, which can be triggered by using the BOOT0 pin.
+
+Flashing
+========
+
+Installing dfu-util
+-------------------
+
+It is recommended to use at least v0.8 of `dfu-util`_. The package available in
+debian/ubuntu can be quite old, so you might have to build dfu-util from source.
+
+There is also a Windows version which works, but you may have to install the
+right USB drivers with a tool like `Zadig`_.
+
+Flashing an Application
+-----------------------
+
+Connect a USB-C cable and the board should power ON. Force the board into DFU mode
+by keeping the BOOT0 switch pressed while pressing and releasing the NRST switch.
+
+The dfu-util runner is supported on this board and so a sample can be built and
+tested easily.
+
+.. zephyr-app-commands::
+   :zephyr-app: samples/basic/blinky
+   :board: blackpill_f523ce
+   :goals: build flash
+
+
+Debugging
+=========
+
+The board can be debugged by installing the included 100 mil (0.1 inch) header,
+and attaching an SWD debugger to the 3V3 (3.3V), GND, SCK, and DIO
+pins on that header.
+
+References
+**********
+
+.. target-notes::
+
+.. _WeAct Github:
+https://github.com/WeActStudio/WeActStudio.STM32H523CoreBoard/tree/master
+
+.. _STM32F523CE website:
+https://www.st.com/en/microcontrollers-microprocessors/stm32h523ce.html
+
+.. _STM32F523CE reference manual:
+https://www.st.com/en/microcontrollers-microprocessors/stm32h523ce.html#