init

HIL_doc.md

@@ -0,0 +1,22 @@
+
+# HIL Test Environment: ESP32 Device Mapping
+
+This document defines the persistent hardware mapping for the ASF-SH Debugger environment. 
+Devices are mapped via **udev rules** to ensure `/dev/` paths remain constant regardless of plug order.
+
+## Setup 1: Debugging & Programming
+| Device Name | Friendly Symlink | Environment Variable | Hardware ID / Serial |
+| :--- | :--- | :--- | :--- |
+| **EPROG Debugger** | `/dev/eprog_debugger` | `$EPROG` | FTDI Dual RS232 (Port 0) |
+| **ESP32-S3 Target** | `/dev/esp32_s3_debug` | `$ESP_DEBUG` | Serial: `123456` |
+
+## Setup 2: I2C & Sensor Emulation
+| Device Name | Friendly Symlink | Environment Variable | Hardware ID / Serial |
+| :--- | :--- | :--- | :--- |
+| **ESP Sensor Test** | `/dev/esp_sensor_test` | `$ESP_SENSOR` | ID: `1a86:7523` |
+| **I2C Emulator** | `/dev/i2c_emulator` | `$I2C_EMULATOR` | CP2102 Serial: `0001` |
+
+## Usage in Scripts
+Always use the environment variables in your automation scripts to ensure compatibility:
+- **Flash Sensor:** `idf.py flash -p $ESP_SENSOR`
+- **Monitor Emulator:** `idf.py monitor -p $I2C_EMULATOR`