Commit iniziale con alcuni documenti e i datasheet

docs/HUBAudio_Bus_and_Pin_Assignment.md

@@ -0,0 +1,588 @@
+# HubAudio
+# Bus Architecture and Preliminary Pin Assignment
+
+**Document:** Hardware Interface Definition  
+**Revision:** 0.1  
+**Status:** Preliminary Design  
+**Controller:** ESP32-S3
+
+
+---
+
+# 1. Purpose
+
+This document defines the preliminary hardware interfaces between the ESP32-S3 system controller and all HubAudio modules.
+
+The purpose is to establish:
+
+- bus ownership
+- GPIO allocation
+- peripheral assignment
+- boot-safe pins
+- expansion possibilities
+
+
+This document must be reviewed before PCB routing.
+
+
+---
+
+# 2. Design Rules
+
+
+The following rules apply:
+
+
+## Rule 1
+
+The ESP32-S3 controls configuration only.
+
+
+Audio data does not pass through the MCU.
+
+
+---
+
+## Rule 2
+
+All audio sources connect directly to ADAU1467.
+
+
+
+SOURCE
+
+|
+
+I2S
+
+|
+
+ADAU1467
+
+
+
+---
+
+## Rule 3
+
+Every external module must be identifiable.
+
+
+Identification:
+
+
+24AA025E48T-I/OT
+
+
+
+---
+
+# 3. ESP32-S3 Peripheral Allocation
+
+
+## 3.1 Overview
+
+
+| Function | Interface |
+|-|-|
+| Radio control | SPI |
+| DSP control | I2C |
+| Module EEPROM | I2C |
+| Bluetooth control | UART |
+| Debug | USB/JTAG |
+| Expansion | Reserved GPIO |
+
+
+---
+
+# 4. Proposed GPIO Map
+
+
+## 4.1 I2C Bus
+
+
+Shared bus:
+
+
+| Signal | ESP32-S3 GPIO | Devices |
+|-|-|-|
+| SDA | GPIO8 | EEPROM, ADAU1467 |
+| SCL | GPIO9 | EEPROM, ADAU1467 |
+
+
+Notes:
+
+- keep traces short
+- external pull-ups required
+- address conflicts must be checked
+
+
+---
+
+# 4.2 SPI Bus
+
+
+Used for radio and memories.
+
+
+| Signal | ESP32-S3 GPIO | Function |
+|-|-|-|
+| SCLK | GPIO12 | SPI Clock |
+| MOSI | GPIO11 | SPI Data |
+| MISO | GPIO13 | SPI Data |
+| CS_RADIO | GPIO10 | Si4684 |
+| CS_FLASH | GPIO14 | External memories |
+
+
+---
+
+# 4.3 UART Bus
+
+
+Bluetooth modules:
+
+
+## BT RX
+
+
+| Signal | GPIO |
+|-|-|
+| TX ESP32 | GPIO17 |
+| RX ESP32 | GPIO18 |
+
+
+## BT1035 TX
+
+
+Second UART:
+
+
+| Signal | GPIO |
+|-|-|
+| TX ESP32 | GPIO43 |
+| RX ESP32 | GPIO44 |
+
+
+Notes:
+
+ESP32-S3 provides multiple UART peripherals.
+
+
+---
+
+# 4.4 Module Control GPIO
+
+
+| Signal | GPIO | Function |
+|-|-|-|
+| RADIO_RESET | GPIO4 | Si4684 reset |
+| DSP_RESET | GPIO5 | ADAU1467 reset |
+| BT_RX_RESET | GPIO6 | BT receiver reset |
+| BT_TX_RESET | GPIO7 | BT1035 reset |
+
+
+---
+
+# 5. Si4684 Interface
+
+
+## Control
+
+
+SPI:
+
+
+
+ESP32-S3
+
+SCLK
+|
+Si4684 CLK
+
+MOSI
+|
+Si4684 SDIO
+
+CS
+|
+Si4684 CS
+
+
+
+Control:
+
+
+
+GPIO4
+
+|
+
+RESET
+
+
+
+Interrupt:
+
+
+
+Si4684 IRQ
+
+|
+
+ESP32 GPIO
+
+
+
+---
+
+# 6. ADAU1467 Interface
+
+
+## Control Interface
+
+
+Preferred:
+
+
+I2C
+
+
+
+ESP32-S3
+
+SDA
+
+SCL
+
+|
+
+ADAU1467
+
+
+
+Used for:
+
+
+- volume
+- routing
+- DSP parameters
+
+
+---
+
+# 7. Bluetooth TX Interface
+
+
+Device:
+
+FSC-BT1035
+
+
+## Control
+
+
+UART:
+
+
+
+ESP32-S3
+
+TX
+
+|
+
+BT1035 RX
+
+ESP32-S3
+
+RX
+
+|
+
+BT1035 TX
+
+
+
+---
+
+## Audio
+
+
+I2S:
+
+
+
+ADAU1467
+
+  |
+
+  |
+
+BT1035
+
+BCLK
+
+LRCLK
+
+DATA
+
+
+
+The clock direction must be verified.
+
+
+Preferred:
+
+
+ADAU1467 master.
+
+
+---
+
+# 8. Bluetooth RX Interface
+
+
+Device:
+
+FSC-BT1026 or equivalent.
+
+
+## Control
+
+
+UART:
+
+
+
+ESP32-S3
+
+|
+
+BT RX Module
+
+
+
+---
+
+## Audio
+
+
+
+BT RX
+
+|
+
+I2S OUT
+
+|
+
+ADAU1467 INPUT
+
+
+
+---
+
+# 9. I2S Architecture
+
+
+## Important Design Decision
+
+
+Multiple I2S sources are not connected together.
+
+
+Wrong:
+
+
+
+Si4684
+|
+|
+BT RX
+|
++------ I2S ------ ADAU1467
+
+
+
+Correct:
+
+
+
+Si4684
+
+I2S Port 0
+
+    |
+
+    |
+
+ADAU1467
+
+BT RX
+
+I2S Port 1
+
+    |
+
+    |
+
+ADAU1467
+
+
+
+The ADAU1467 internal serial ports perform routing.
+
+
+---
+
+# 10. Proposed ADAU1467 Serial Port Allocation
+
+
+| DSP Port | Device | Direction |
+|-|-|-|
+| Serial Input 0 | Si4684 | RX |
+| Serial Input 1 | BT RX | RX |
+| Serial Output 0 | DAC | TX |
+| Serial Output 1 | BT1035 | TX |
+
+
+---
+
+# 11. EEPROM Bus
+
+
+All modules include:
+
+
+
+24AA025E48T
+
+
+
+Example:
+
+
+| Module | Address |
+|-|-|
+| Main Board | 0x50 |
+| Radio | 0x51 |
+| Bluetooth | 0x52 |
+| DSP | 0x53 |
+
+
+Address selection must be verified.
+
+
+---
+
+# 12. Reserved Expansion Interface
+
+
+Future modules:
+
+
+Possible:
+
+- external DAC
+- amplifier module
+- display
+- sensors
+- remote control
+
+
+Reserved:
+
+
+SPI
+
+I2C
+
+UART
+
+I2S
+
+GPIO
+
+Power
+
+
+
+---
+
+# 13. Boot Safety Review
+
+
+ESP32-S3 boot pins must be checked.
+
+
+Before PCB release:
+
+
+Verify:
+
+- GPIO assignment
+- strapping pins
+- pull-up/pull-down resistors
+
+
+No external device must force an incorrect boot state.
+
+
+---
+
+# 14. Recommended Connector Between Modules
+
+
+For removable modules:
+
+
+Example:
+
+
+
+MODULE HEADER
+
+1 3.3V
+2 GND
+3 SDA
+4 SCL
+5 UART TX
+6 UART RX
+7 RESET
+8 IRQ
+9 I2S BCLK
+10 I2S LRCLK
+11 I2S DATA
+12 RESERVED
+
+
+
+---
+
+# 15. Final Review Before Schematic
+
+
+Before drawing schematic:
+
+
+Check:
+
+
+[ ] ESP32-S3 GPIO availability
+
+[ ] Boot strap conflicts
+
+[ ] I2S clock ownership
+
+[ ] Module power consumption
+
+[ ] RF placement
+
+[ ] EEPROM addressing
+
+[ ] Firmware update paths
+
+
+---
+
+# END

docs/HUBAudio_Power_Management_Architecture.md

@@ -0,0 +1,519 @@
+# HubAudio
+# Power Management Architecture
+
+**Document:** Power Management Design Specification  
+**Revision:** 0.1  
+**Status:** Design Phase  
+
+---
+
+# 1. Overview
+
+The HubAudio platform requires a sophisticated power management architecture.
+
+The system combines:
+
+- ESP32-S3 high performance MCU with WiFi
+- ADAU1467 professional audio DSP
+- Si4684 FM/DAB receiver
+- Bluetooth audio transmitter
+- Bluetooth audio receiver
+- battery operation
+- remote monitoring capability
+
+
+The power system is therefore not considered a simple voltage regulator stage, but a complete energy management subsystem.
+
+---
+
+# 2. Design Philosophy
+
+The selected architecture follows these principles:
+
+- single intelligent PMIC
+- integrated battery management
+- multiple independent power rails
+- I2C monitoring
+- controlled power sequencing
+- ability to disable unused subsystems
+- separated digital and audio power domains
+
+
+---
+
+# 3. Selected Main PMIC
+
+## Texas Instruments TPS65217CRSLR
+
+
+The TPS65217 is selected as the main power management IC.
+
+
+Reasons for selection:
+
+
+- integrated Li-Ion battery charger
+- power path management
+- multiple switching regulators
+- LDO outputs
+- I2C configuration
+- programmable sequencing
+- fault monitoring
+
+
+Although originally designed for embedded processor systems, its architecture is suitable for HubAudio due to the need for multiple controlled power domains.
+
+
+---
+
+# 4. Power Tree
+
+
+Proposed architecture:
+
+
+             USB-C / External Power
+
+                     |
+
+                     |
+
+             TPS65217CRSLR
+
+                     |
+
+    +----------------+----------------+
+
+    |                |                |
+
+ DCDC1             DCDC2            DCDC3
+
+    |                |                |
+
+3.3V_DIGITAL 3.3V_AUDIO 5V
+
+    |                |
+
+    |                |
+
+ESP32-S3 Audio/RF domain
+
+                |
+
+          Ferrite filtering
+
+
+                |
+
+    +-----------+-----------+
+
+    |           |           |
+
+ADAU1467    Si4684      Bluetooth
+
+
+---
+
+# 5. Power Domains
+
+
+## 5.1 Digital Domain
+
+
+Voltage:
+
+3.3V_DIGITAL
+
+
+Consumers:
+
+
+- ESP32-S3
+- EEPROM
+- logic peripherals
+- communication interfaces
+
+
+Requirements:
+
+
+- high transient capability
+- low impedance supply
+
+
+Main concern:
+
+ESP32-S3 WiFi current peaks.
+
+
+---
+
+# 5.2 Audio / RF Domain
+
+
+Voltage:
+
+3.3V_AUDIO
+
+
+Consumers:
+
+
+- ADAU1467
+- Si4684
+- BT1035
+- Bluetooth RX module
+
+
+This rail must be isolated from digital noise.
+
+
+Recommended:
+
+
+
+3.3V_AUDIO
+
+  |
+
+ferrite bead
+
+  |
+
+audio devices
+
+
+
+---
+
+# 5.3 5V Domain
+
+
+Possible consumers:
+
+
+- DAC
+- amplifier
+- future peripherals
+
+
+This rail is kept independent from sensitive audio electronics.
+
+
+---
+
+# 6. Battery Management
+
+
+The TPS65217 provides:
+
+
+- Li-Ion charging
+- battery monitoring
+- power path control
+- protection mechanisms
+
+
+Battery:
+
+
+
+Single cell Li-Ion
+
+3.7V nominal
+
+4.2V charged
+
+
+
+---
+
+# 7. Power Monitoring
+
+
+## 7.1 Decision
+
+
+The TPS65217 already provides battery management.
+
+An additional current monitor is not required for system operation.
+
+
+However, HubAudio benefits from detailed subsystem monitoring.
+
+
+A dedicated I2C power monitor is therefore added for the audio domain.
+
+
+---
+
+# 8. Selected Current Monitor
+
+
+## Texas Instruments INA226
+
+
+The INA226 is selected as the default power monitoring device.
+
+
+Purpose:
+
+
+Measure the audio subsystem consumption.
+
+
+Monitored rail:
+
+
+
+TPS65217
+
+|
+
+3.3V_AUDIO
+
+|
+
+INA226
+
+|
+
+ADAU1467
+Si4684
+Bluetooth
+
+
+
+---
+
+# 9. INA226 Functions
+
+
+The INA226 provides:
+
+
+- bus voltage measurement
+- shunt voltage measurement
+- current measurement
+- power calculation
+- I2C communication
+
+
+The ESP32-S3 can periodically read:
+
+
+
+Voltage
+
+Current
+
+Power
+
+
+
+Example:
+
+
+```json
+{
+ "audio_voltage":3.30,
+ "audio_current":180,
+ "audio_power":0.59
+}
+
+10. INA228 Evaluation
+
+The INA228 has been evaluated as an alternative.
+
+Advantages:
+
+higher resolution ADC
+higher precision
+energy accumulation
+advanced power analysis
+
+Typical application:
+
+laboratory measurements
+industrial systems
+precision battery analysis
+
+For HubAudio:
+
+Not selected as default.
+
+Reason:
+
+The additional precision is not necessary because:
+
+battery management is already handled by TPS65217
+audio subsystem consumption does not require laboratory accuracy
+11. Future Compatibility
+
+The PCB should allow optional replacement:
+
+INA226 footprint compatible with INA228 evaluation.
+
+Possible versions:
+
+Standard
+TPS65217
++
+INA226
+
+Engineering / Pro Version
+TPS65217
++
+INA228
+
+12. I2C Monitoring Bus
+
+The power monitoring devices share the system I2C bus.
+
+Example:
+
+ESP32-S3
+
+
+ |
+
+I2C
+
+
+ +---- EEPROM
+
+ |
+
+ +---- ADAU1467
+
+ |
+
+ +---- INA226
+
+ |
+
+ +---- TPS65217
+
+
+13. Power Sequencing
+
+Startup sequence:
+
+Battery connected
+
+
+ |
+
+TPS65217 initialization
+
+
+ |
+
+3.3V_DIGITAL enabled
+
+
+ |
+
+ESP32-S3 boot
+
+
+ |
+
+Module detection
+
+
+ |
+
+Enable audio domain
+
+
+ |
+
+Initialize DSP
+
+
+ |
+
+Enable RF modules
+
+
+14. Controlled Shutdown
+
+The ESP32-S3 can disable:
+
+Bluetooth TX
+Bluetooth RX
+Si4684
+ADAU1467
+
+Example:
+
+Standby:
+
+
+ESP32-S3 ON
+
+WiFi ON
+
+Audio OFF
+
+Radio OFF
+
+Bluetooth OFF
+
+
+15. PCB Layout Requirements
+
+Critical:
+
+Switching regulators
+
+Keep away from:
+
+ADAU1467
+DAC
+RF sections
+Audio supply
+
+Use:
+
+short traces
+filtering
+dedicated return paths
+Decoupling
+
+Every IC requires local decoupling.
+
+Additional filtering is required for:
+
+DSP supply
+RF supply
+16. Final Decision
+
+The HubAudio power architecture is:
+
+TPS65217CRSLR
+
++
+
+Separate audio power domain
+
++
+
+INA226 monitoring
+
++
+
+Optional INA228 upgrade
+
+
+
+This provides:
+
+professional power management
+battery operation
+remote diagnostics
+future scalability
+END DOCUMENT
+
+---