Updated directories and readme

Readme.md

@@ -1 +1,168 @@
-Repositorio product bpdt
+````markdown
+# PSG5 Diagnostic Bluetooth Tool – STM32H5
+
+Embedded diagnostic and communication tool for PSG5 diesel injection control units, built on **STM32H5** with **Bluetooth connectivity**.
+
+This project is part of the Herlic Components diagnostic and control platform, focused on reliable communication, testing, and service workflows for professional diesel ECU environments.
+
+---
+
+## Overview
+
+This firmware implements a Bluetooth-enabled diagnostic interface designed to communicate with PSG5-based ECUs and associated workshop tools.
+
+Main goals of the project:
+
+- Reliable **Bluetooth communication interface**
+- Fast and deterministic **embedded real-time firmware**
+- Robust **diagnostic protocol handling**
+- Safe **PSG5 communication and validation**
+- Expandable architecture for future diagnostic services
+- Secure migration path toward STM32H5 platform
+
+The system is intended for professional workshop and development environments.
+
+---
+
+## Hardware Platform
+
+- **MCU:** STM32H5 series
+- **IDE:** STM32CubeIDE / STM32CubeMX
+- **Communication:** Bluetooth UART bridge
+- **Debug:** ST-Link / SWD
+- **Power:** Automotive 12V environment with regulated rails
+
+---
+
+## Project Structure
+
+```text
+bpdt-repo/
+├── Firmware/               # Application code
+├── Hardware/               # KiCad project files
+├── Docs/                   # Documentation (Protocol, Instructions, Images...)
+├── Production/             # Ready files
+
+└── README.md
+````
+
+---
+
+## Main Features
+
+* Bluetooth communication stack
+* Frame parser / packet builder
+* Session control state machine
+* Keep-alive supervision
+* ECU identification
+* EEPROM / memory read services
+* Diagnostic command execution
+* Timeout and retry handling
+* Non-blocking ISR-friendly architecture
+
+---
+
+## Development Environment
+
+Recommended tools:
+
+* **STM32CubeIDE 2.x**
+* **STM32CubeMX**
+* **Git**
+* **Gitea**
+* **ST-Link Utility / STM32CubeProgrammer**
+
+---
+
+## Build
+
+Open the project in STM32CubeIDE and build:
+
+```bash
+Project -> Build Project
+```
+
+Or from terminal if using headless tools:
+
+```bash
+make all
+```
+
+Generated binaries:
+
+* `.elf`
+* `.hex`
+* `.bin`
+
+---
+
+## Flashing
+
+Use STM32CubeProgrammer or CubeIDE:
+
+```text
+Run -> Debug
+```
+
+or
+
+```text
+Run -> Run As -> STM32 Cortex-M C/C++ Application
+```
+
+---
+
+## Current Development Status
+
+Current migration phase:
+
+* [x] Repository initialized
+* [x] STM32H5 platform selected
+* [ ] CubeMX base project
+* [ ] Bluetooth driver migration
+* [ ] Protocol migration
+* [ ] Diagnostic validation
+* [ ] Real ECU testing
+* [ ] Production release
+
+---
+
+## Version Control Workflow
+
+Typical workflow:
+
+```bash
+git pull
+git add .
+git commit -m "Describe changes"
+git push
+```
+
+---
+
+## Notes
+
+This repository may include:
+
+* firmware sources
+* CubeIDE project files
+* diagnostic protocol implementation
+* future KiCad hardware revisions
+
+Build artifacts are excluded through `.gitignore`.
+
+---
+
+## Maintainer
+
+**Herlic Components**
+Professional diesel ECU diagnostics and control electronics
+
+---
+
+## License
+
+Internal development / proprietary project
+
+```
+```