Home

DecaTone Documentation Wiki

Welcome to the official DecaTone v1.2.2 documentation wiki. DecaTone is an open-source private telephone switch and VoIP hardware system designed to revive vintage rotary telephones by replacing their internal electromechanical central-office circuitry with an ESP32-S3 microcontroller and linking them to a self-hosted cloud switchboard.

---

📖 Wiki Navigation

1. Hardware Wiring and Pinouts
   • Hosyond ESP32-S3 pin mappings, hook switch detection, rotary pulse decoding, MAX98357A I2S DAC, MAX4466 mic ADC, and IRF640N resonant AC bell ringer circuit.
2. Firmware Flashing and Setup
   • Initial flashing via PlatformIO / esptool, captive portal provisioning (DecaTone-Setup-XXXX), custom firmware override binary specs, and scheduled OTA updates.
3. Backend and Docker Deployment
   • Docker Compose installation (tylerhats/decatone:1.2.2), container immutability, 100% full-program .tar.gz backups, custom branding, and Home Assistant MQTT.
4. Phone Numbering, Routing and Dial Codes
   • Extension allocation, service lines (111, 119, 300, 411, 711, 069, 078, 079, 0), speed dial (1–9), in-call commands (2, 3+ext, 8), and privacy policies.
5. Audio Normalization and Bell Ringer Tuning
   • Inbound audio leveler (-18 dBFS), outbound mic AGC, carbon mic warmth DSP, 20Hz resonance sweep calibration, and cadence patterns.
6. User and Admin Operations Guide
   • Multi-phone accounts, party-line auto-join, voicemail handset playback (0), emergency DND breakthrough, SMTP email, and admin fleet inspector.
7. Troubleshooting and FAQ
   • Gotchas, rotary governor PPS & break ratio tuning, bell ringer tuning, and network diagnostic tools.

---

🚀 Quick Technical Summary

• Target Microcontroller: Hosyond ESP32-S3-WROOM-1 (Dual-Core 240MHz Xtensa LX7, 8MB Octal PSRAM, 16MB Flash).
• Backend Architecture: Node.js 22, TypeScript, SQLite3 (WAL mode), WebSocket VoIP switchboard engine.
• Frontend Architecture: React 18, Vite, Lucide Icons, Pure CSS Design System, WebPhone softphone with 3D rotary visualizer.
• Official Docker Images: tylerhats/decatone:1.2.2 and tylerhats/decatone:latest.