documentation updated

Author: michpro

README.md

@@ -0,0 +1,90 @@
+# **PY32F002A ESSOP10 Minimal Board**
+
+- [**PY32F002A ESSOP10 Minimal Board**](#py32f002a-essop10-minimal-board)
+  - [**Overview**](#overview)
+    - [**Features**](#features)
+  - [**Software**](#software)
+  - [**Schematic diagram**](#schematic-diagram)
+  - [**Module visualisation**](#module-visualisation)
+  - [**Assembly**](#assembly)
+  - [**Production files**](#production-files)
+  - [**Reporting bugs**](#reporting-bugs)
+  - [**License**](#license)
+  - [**Support**](#support)
+
+---
+
+## **Overview**
+This project is a minimal development board designed for the PY32F002A microcontroller in the ESSOP10 package. It serves as a simple and compact platform for prototyping and testing applications using this low-power ARM Cortex-M0+ microcontroller. The board includes essential components to power the microcontroller, provide access to its pins, and offer basic functionality for development purposes.
+
+### **Features**
+* **PY32F002A Microcontroller**: Low-power ARM Cortex-M0+ in ESSOP10 package.
+  * **Operating voltage**: 1.7V to <span style="color:orange"><b>5.5V</b></span>
+  * **Driver current**: 8mA
+  * 32-bit ARM® Cortex® - M0+ CPU
+  * Internal 8/24 MHz RC Oscillator (HSI)
+  * Internal 32.768 KHz RC oscillator (LSI)
+  * 20 Kbytes of flash memory
+  * 3 Kbytes SRAM
+  * 1 x 12-bit ADC (Input voltage conversion range: 0 ~ VCC)
+  * Two comparators (One has full mapping to external µC pins)
+  * **Timers**:
+    * A 16bit advanced control timer (TIM1)
+    * 1 general purpose 16-bit timers (TIM16)
+    * A low-power timer (LPTIM), supports wake-up from stop mode
+    * An Independent Watchdog Timer (IWDT)
+    * A SysTick timer
+  * **Communication Interfaces**:
+    * A Serial Peripheral Interface (SPI)
+    * 1 Universal Synchronous/Asynchronous Transceivers (USARTs) with automatic baudrate detection
+    * A I²C interface , supports standard mode (100kHz), Fast mode (400 kHz), supports 7-bit addressing mode
+  * Hardware CRC-32 module
+  * Unique UID
+  * **Working temperature**: -40 to 85℃
+* **SWD Header**: For easy programming/debugging.
+* **Decoupling Capacitors**: Ensure stable power supply to the microcontroller.
+* **Indicator LED**: Connected to a microcontroller pin via a resistor for status or testing with solder jumper - configurable option to enable/disable the LED circuit.
+* **Compact Design**: Two-layer PCB optimized for minimal footprint.
+
+---
+
+## **Software**
+Arduino boards: [https://github.com/py32duino/Arduino-PY32](https://github.com/py32duino/Arduino-PY32) with recommended patch for Windows: [https://github.com/michpro/PY32Duino_windows_patch](https://github.com/michpro/PY32Duino_windows_patch)
+
+---
+
+## **Schematic diagram**
+<p align="center"><img src="./docs/schematic.png" alt="wiring diagram" width="80%"/></p>
+
+
+## **Module visualisation**
+(click on the image to see the 3D model)
+<p align="center"><a href="https://3dviewer.net/#model=https://github.com/michpro/PY32F002_ESSOP10_minimal_board/blob/master/docs/PY32F002_ESSOP10_minimal_board.wrl"><img src="./docs/PY32F002_ESSOP10_minimal_board.png" alt="I²C to 1-Wire Click" width="50%"/></a></p>
+
+## **Assembly**
+[Interactive BOM and placement](https://michpro.github.io/PY32F002_ESSOP10_minimal_board/ibom.html)
+
+## **Production files**
+Production files can be found [**here**](./production/).
+
+---
+
+## **Reporting bugs**
+
+[Create an issue on GitHub](https://github.com/michpro/PY32F002_ESSOP10_minimal_board/issues)
+
+---
+
+## **License**
+Copyright © 2025 Michal Protasowicki
+
+This project is released under CERN Open Hardware Licence Version 2 - Permissive.
+
+[![License: CERN-OHL-P-2.0](https://img.shields.io/badge/License-CERN--OHL--P--2.0-blue.svg)](./LICENSE)
+
+---
+
+## **Support**
+If You find my projects interesting and You wanted to support my work, You can give me a cup of coffee or a keg of beer :)
+
+[![PayPal Direct](https://badgen.net/badge/icon/Support%20me%20by%20PayPal?icon=kofi&label&scale=1.5&color=blue)](https://www.paypal.me/michpro)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[![ko-fi](https://badgen.net/badge/icon/Support%20me%20on%20Ko-fi?icon=kofi&label&scale=1.5&color=red)](https://ko-fi.com/F1F24CEW1)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[![Coinbase](https://badgen.net/badge/icon/Support%20me%20with%20cryptocurrencies?icon=kofi&label&scale=1.5&color=blue)](https://commerce.coinbase.com/checkout/ec299320-cbed-475d-976e-fdf37c1ac3d0)