How georgebregman/esp32-sip-voice works
This repository implements an ESP32 SIP VoIP phone. The main user-to-result path is web, keypad, touchscreen, or wake-word interaction through call control and SIP signaling; once a call is negotiated, the audio engine encodes and sends microphone audio over RTP and plays received audio. Separate branches provide network setup, persistent settings and phonebook, and device/graphical interfaces. The README documents capabilities such as STUN, themed LVGL screens, and dynamic hardware configuration; some of those implementation links are documented rather than visible in the sampled excerpts.
Main entry points: audio_pipeline.c Audio engine · sip_client.c SIP client · ui_controller.c Web control · main.c Application bootstrap
Components 22
Network and SIP
- Wi-Fi manager
main/wifi_manager.c - SIP client
main/sip_client.c
Voice and RTP
- Audio engine
main/audio_pipeline.c - RTP and jitter buffer
main/rtp_handler.c - G.711 codec
main/g711_codec.c - G.722 codec
components/audio_pipeline/g722_codec.c - OPUS codec
components/audio_pipeline/opus_codec.c - AEC filter
components/audio_pipeline/aec_filter.c - Wake-word detector
components/audio_pipeline/wake_word.c
User interfaces
- Web control
main/ui_controller.c - LVGL screens
components/ui_lvgl/ui_lvgl.c - Application bootstrap
main/main.c
Hardware I/O
- Matrix keypad
components/board_hal/keypad.c - TFT display
components/board_hal/display_tft.c - Touch input
components/board_hal/touch_driver.c - I2S codec driver
main/codec_driver.c - Status display
main/display.c
Configuration and contacts
- Settings manager
components/config_store/config_manager.c - Phonebook
components/storage/phonebook.c
Other components
- Phone user
- SIP server
- STUN service
Connections 31
- Phone user → Web control: controls calls
- Phone user → Matrix keypad: dials with
- Phone user → LVGL screens: uses touchscreen
- Web control → SIP client: requests calls
main/ui_controller.c - Web control → Phonebook: manages contacts
main/ui_controller.c - Web control → Settings manager: saves settings
- Matrix keypad → SIP client: initiates calls
- LVGL screens → Touch input: reads input
components/ui_lvgl/ui_lvgl.c - LVGL screens → TFT display: uses display
components/ui_lvgl/ui_lvgl.c - Application bootstrap → Wi-Fi manager: initializes
- Application bootstrap → SIP client: initializes
- Application bootstrap → Web control: initializes
- Application bootstrap → LVGL screens: initializes
- Wi-Fi manager → Settings manager: loads credentials
- Wi-Fi manager → SIP client: provides connectivity
- SIP client → SIP server: signals calls
- SIP client → STUN service: discovers public endpoint
- SIP client → Audio engine: provides negotiated media
main/audio_pipeline.c - Audio engine → RTP and jitter buffer: sends and receives
main/audio_pipeline.c - Audio engine → G.711 codec: encodes and decodes
main/audio_pipeline.c - Audio engine → G.722 codec: dispatches codec
main/audio_pipeline.c - Audio engine → OPUS codec: dispatches codec
main/audio_pipeline.c - Audio engine → I2S codec driver: initializes audio hardware
main/audio_pipeline.c - Audio engine → AEC filter: uses filter
- Audio engine → Wake-word detector: feeds audio
main/audio_pipeline.c - Wake-word detector → Web control: triggers call
- Audio engine → Phone user: plays call audio
- Settings manager → TFT display: supplies hardware settings
components/board_hal/display_tft.c - Settings manager → Touch input: supplies hardware settings
components/board_hal/touch_driver.c - Settings manager → Matrix keypad: supplies pin settings
components/board_hal/keypad.c - Application bootstrap → Phonebook: initializes