🌉 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 GPL 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

Complete SIP implementation with SIP-I and SIP-T support for seamless interoperability.

RTP Media

Real-time Transport Protocol with comprehensive codec support and media handling.

Protocol Translation

Seamless conversion between TDM and SIP protocols with transparent signaling mapping.

✅ 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 package
wget https://releases.redfire.tel/redfire-gateway_1.0.0-1_amd64.deb

# Install the package
sudo dpkg -i redfire-gateway_1.0.0-1_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

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.

🚧 Extended Codec Support

Additional codec implementations including G.722, G.729, and modern codecs for enhanced audio quality.

🚧 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