neilphan98/hearth-sip-endpoint repository overview

⁠HEARTH SIP Endpoint

SIP intercom/phone (SIPp) with real signaling and two-way G.711 RTP media.

Real-device analogue: An IP intercom / VoIP desk phone (2N/Fanvil/Grandstream-class).

Protocol / ports: SIP (UDP 5060) + RTP media.

⁠What it does / how it works

Real SIPp. SIP_MODE=uas answers calls and echoes RTP (two-way audio on the wire); SIP_MODE=uac places calls to SIP_TARGET and plays a real G.711 pcap, so calls carry genuine bidirectional media.

⁠Functions

• SIP UAS (answer) / UAC (call)
• Real RTP media (G.711)
• Door-intercom or desk-phone role

⁠How to use

UAS: just start it. UAC: set SIP_TARGET=<uas-ip> and optionally SIP_RATE/SIP_CALL_LIMIT. Watch with tshark -i ethX -Y sip.

⁠Use in GNS3

• Import the matching .gns3a (File > Import appliance), or docker pull neilphan98/hearth-sip-endpoint:1.1.
• Drag onto your topology, wire to a switch/hub, start. Console: telnet.
• Adapters: 1. Category: guest.

IPv4 device: leave MQQ1_IP empty to auto-assign a unique IP (zero-config), or set a fixed address. Zone via HEARTH_OCTET (5 corp / 6 ot / 8 security).

⁠Default environment (per node)

MQQ1_IP=192.168.8.30
MQQ1_PREFIX=24
MQQ1_GW=192.168.8.1
MQQ1_IP6=fd11:1111:1111:6::1e
MQQ1_IP6_PREFIX=64
MQQ1_GW6=fd11:1111:1111:6::1
SIP_MODE=uas

Current release: 1.1 (docker pull neilphan98/hearth-sip-endpoint:1.1)

Part of the HEARTH Tower commercial-building IoT/OT security testbed. Image tags are immutable per release (1.0, 1.1, ...), so updating the device list never changes nodes you already placed. See the HEARTH bundle for all devices + guides.