Open Source · MIT License

🌉 Redfire Gateway

High-performance TDM over Ethernet (TDMoE) to SIP gateway

A carrier-grade telecommunications system designed for bridging legacy TDM infrastructure with modern VoIP systems. Free, open source, and MIT licensed.

Get Started Learn More

Project Overview

🔗 Bridge Legacy & Modern

Seamlessly connect legacy TDM telecommunications infrastructure with modern SIP/VoIP networks, preserving existing investments while enabling digital transformation.

🏢 Carrier-Grade

Built for enterprise and service provider deployments with comprehensive monitoring, SNMP support, and enterprise-grade reliability features.

🔓 Open Source

Completely free and open source software with MIT licensing for maximum flexibility in commercial and non-commercial use.

Core Features

✅ Core Functionality

TDMoE Interface

Full TDM over Ethernet support with comprehensive frame processing and error handling.

SIP Protocol

SIP-I/SIP-T signaling architecture with a defined integration interface; the SIP handler and router currently ship as stubs pending an external SIP library integration.

RTP Media

RTP session and codec interfaces for G.711, G.722, G.729, Opus, AMR/AMR-WB, EVS, iLBC, Speex, and G.726; the transcoding service currently ships as a passthrough stub pending an external transcoding library integration.

Protocol Translation

TDM-to-SIP signaling mapping architecture, designed for transparent conversion once the SIP/transcoding stubs are replaced with integrated libraries.

✅ Interface Support

E1/T1 Lines

Support for both E1 (30 channels) and T1 (24 channels) with full signaling compatibility.

FreeTDM Integration

Optional FreeTDM library support for hardware TDM interface integration.

Multiple Signaling

PRI, CAS, and SS7/Sigtran protocol support for diverse telecommunications environments.

Remote Loopback

ITU-T G.703/G.704 compliant loopback testing for comprehensive diagnostics.

✅ Advanced Features

NFAS Support

Non-Facility Associated Signaling with automatic failover for high-availability deployments.

Mobile Interworking

3G/4G network integration with AMR and EVS codec support for mobile networks.

Feature Group D/B

Support for North American telephony networks with proper trunk group handling.

DTMF Handling

RFC2833, SIP INFO, and inband DTMF support for comprehensive dual-tone handling.

External Integration

Support for external SIP and transcoding libraries with comprehensive API compatibility and event-driven architecture.

B2BUA Testing

Comprehensive testing framework with SIPp integration for validation of media translation and transcoding features.

✅ Monitoring & Management

Performance Monitoring

Real-time system performance tracking with comprehensive metrics and alerting.

SNMP Support

Complete MIB implementation for enterprise network management system integration.

CLI Management

Comprehensive command-line interface for configuration and operational management.

BERT Testing

Bit Error Rate Testing with multiple patterns for comprehensive circuit validation.

Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   TDMoE/E1/T1   │    │   SIP Protocol  │    │   RTP Media     │
│   Interface     │◄──►│   Handler       │◄──►│   Handler       │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         ▲                       ▲                       ▲
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────────────────────────────────────────────────────┐
│                    Gateway Orchestrator                        │
├─────────────────────────────────────────────────────────────────┤
│  Performance Monitor │ Alarm System │ SNMP Agent │ CLI Server  │
└─────────────────────────────────────────────────────────────────┘

System Requirements

Minimum Hardware

CPU: 2+ cores, x86_64
Memory: 4GB RAM minimum
Storage: 20GB free space
Network: Gigabit Ethernet
OS: Debian 11+ or Ubuntu 20.04+

Production Recommended

CPU: 4+ cores, Intel Xeon/AMD EPYC
Memory: 16GB+ RAM
Storage: SSD, 500GB+
Network: Multiple Gigabit interfaces
Redundancy: Dual PSU, RAID storage

Quick Start

Debian Package Installation

# Download the latest .deb from GitHub Releases
# https://github.com/carrierone/redfire-gateway/releases

# Install the package
sudo dpkg -i redfire-gateway__amd64.deb

# Fix any dependency issues
sudo apt-get install -f

# Verify installation
sudo systemctl status redfire-gateway

From Source

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone and build
git clone https://github.com/carrierone/redfire-gateway.git
cd redfire-gateway
cargo build --release

# Install binaries
cargo install --path .

Configuration Example

Main Configuration (/etc/redfire-gateway/gateway.toml)

[general]
name = "Redfire Gateway"
location = "Primary Site"
contact = "ops@company.com"

[tdmoe]
interface = "eth1"  # Dedicated TDMoE interface
channels = 30       # E1: 30, T1: 24
protocol = "E1"     # E1 or T1
framing = "CRC4"    # E1: CRC4, T1: ESF
line_coding = "HDB3" # E1: HDB3, T1: B8ZS

[sip]
listen_addr = "0.0.0.0:5060"
domain = "gateway.company.com"
realm = "company"
transport = "UDP"

[timing]
enable_internal_clock = true
enable_gps = true
enable_ntp = true
gps_device = "/dev/ttyUSB0"
ntp_servers = ["pool.ntp.org", "time.google.com"]

Management & Monitoring

System Commands

# Start services
sudo systemctl start redfire-gateway

# Check status
sudo systemctl status redfire-gateway

# View logs
sudo journalctl -u redfire-gateway -f

CLI Management

# Gateway status
redfire-cli status

# Interface testing
interface-test loopback --span 1 --duration 30

# Performance monitoring
redfire-cli performance

Diagnostics

# System diagnostics
redfire-diag system

# Generate support bundle
redfire-diag support-bundle --output /tmp/gateway-support.tar.gz

# Protocol analysis
redfire-diag protocols --capture 60

⚠️ Legal and Regulatory Notice

Important Disclaimer

This software is provided "as is" with NO WARRANTY of any kind. This code has NOT been tested against various regulatory agencies for compliance with telecommunications network requirements and regulations.

Regulatory Requirements

Connecting telecommunications equipment to the public switched telephone network (PSTN) may require:

Federal Communications Commission (FCC) certification in the United States
Industry Canada (IC) certification in Canada
CE marking and compliance in the European Union
Telecommunications regulatory approval in your jurisdiction
Compliance with local telecommunications standards and regulations

Professional Services

For production deployments, regulatory compliance assistance, testing, certification support, and professional telecommunications consulting services, please get in touch.

Work in Progress

The Redfire Gateway is actively developed with ongoing improvements and new features:

🚧 Enhanced Security

Advanced security features including TLS support, certificate management, and secure authentication mechanisms.

🚧 Web Management Interface

Browser-based configuration and monitoring interface for easier management and real-time system visualization.

🚧 High Availability

Clustering support with automatic failover and load balancing for mission-critical deployments.

🚧 SIP & Transcoding Library Integration

The SIP handler and transcoding service currently ship as stubs with defined interfaces (G.711, G.722, G.729, Opus, AMR, EVS, and more); wiring in real external SIP and codec libraries is the active integration effort.

🚧 API Extensions

RESTful API for programmatic configuration, monitoring, and integration with external systems.

🚧 Performance Optimization

Continuous optimization for higher throughput, lower latency, and improved resource utilization.

Deploy Redfire Gateway

Bridge your legacy telecommunications infrastructure with modern SIP networks using proven, open source technology.

Download on GitHub Professional Services