Topics

Language breakdown

No language data available.

▸ Files click to expand

README

Telon GSM-SIP Gateway

About

📱 The Telon GSM-SIP Gateway is an Android application that acts as a bidirectional bridge between GSM telephony and SIP (Session Initiation Protocol). It enables seamless integration of local GSM calls with SIP-based telephony systems, allowing users to make and receive calls through SIP infrastructure while using GSM hardware.

How It Works

Core Architecture

The application consists of two main endpoints that work together to bridge GSM and SIP communications:

Telephony Endpoint (react-native-tele): Handles GSM/telephony operations
SIP Endpoint (react-native-sip2): Manages SIP protocol communications

Call Flow

Incoming SIP → Outgoing GSM

SIP call is received by the SIP endpoint
Application extracts the destination number from SIP call
Initiates outgoing GSM call using the telephony endpoint
Bridges audio between SIP and GSM calls
Handles call state synchronization (ringing, connected, terminated)

Incoming GSM → Outgoing SIP

GSM call is received by the telephony endpoint
Application automatically rejects incoming GSM calls (for security)
Only outgoing GSM calls initiated by SIP are processed

Device-Specific Configuration

The application automatically configures itself based on the device ID:

| Device ID | SIP Account | GSM Configuration | |-----------|-------------|-------------------| | sp7731cea | 50015 | ReplaceDialer: true, Permissions: true | | Impress_City | 50014 | ReplaceDialer: false, Permissions: false | | Impress_Tor | 50017 | ReplaceDialer: true, Permissions: true | | QCReferencePhone | 50019 | ReplaceDialer: true, Permissions: true, fas: false | | MSM8937 | 50018 | ReplaceDialer: true, Permissions: true, fas: false | | Default | 50016 | ReplaceDialer: false, Permissions: false |

SIP Configuration

Server: 192.168.88.254
Transport: UDP
Registration Timeout: 3600 seconds
Network: Supports WiFi, 3G, Edge, GPRS, and roaming

Special Test Numbers

50014-50019: Test calls with fast answer
3333: Test call with destination "900"
4444: Test call with audio session activation

Features

🔄 Bidirectional Gateway: Routes calls between GSM and SIP networks
📱 Device Auto-Configuration: Automatically detects and configures based on device ID
🔒 Security: Rejects incoming GSM calls to prevent unauthorized access
📊 Real-time Logging: Comprehensive logging for monitoring and debugging
⚙️ Magisk Integration: System-level permissions for telephony operations
🎵 Audio Bridging: Seamless audio routing between GSM and SIP calls

Technical Requirements

Prerequisites

📱 Android device running version 8.0 (Oreo) or higher
🔧 Root access (for Magisk module installation)
📡 GSM SIM card with active service
🌐 Network connectivity for SIP registration

System Permissions

The application requires elevated permissions through Magisk:

android.permission.READ_LOGS
android.permission.CAPTUREAUDIOOUTPUT
android.permission.READPRECISEPHONE_STATE
android.permission.MODIFYPHONESTATE

Installation

Pre-installation Setup

Clone the required repositories to a common folder:

# Clone the main repository
git clone https://github.com/telon-org/telon-gsm-sip-gateway.git
Clone the required libraries to the same directory level
git clone https://github.com/telon-org/react-native-tele.git
git clone https://github.com/telon-org/react-native-sip2.git
git clone https://github.com/telon-org/react-native-replace-dialer.git

Your directory structure should look like this:

common-folder/ ├── telon-gsm-sip-gateway/ ├── react-native-tele/ ├── react-native-sip2/ └── react-native-replace-dialer/

Build and Installation

Install Magisk Module: Flash the magisk/gateway.zip module
Build Application: Use GitHub Actions or run yarn android
Install APK: Install the generated APK on your device

Usage

Initial Setup

🚀 Launch the Telon GSM-SIP Gateway app
📱 Grant necessary permissions when prompted
🔧 The app will automatically configure based on your device ID
📊 Monitor the gateway log for connection status

Operation

The application runs in the background
SIP calls are automatically routed to GSM
All call states are synchronized between networks
Real-time logs show call progress and any issues

Troubleshooting

Common Issues

SIP Registration Failed: Check network connectivity and server configuration
Audio Issues: Verify device audio permissions and hardware compatibility
Call Routing Problems: Check device ID configuration and SIP account settings

Debug Information

View real-time logs in the application console
Check Magisk module installation status
Verify system permissions are properly granted

Development

Dependencies

react-native-tele: GSM/telephony operations
react-native-sip2: SIP protocol handling
react-native-replace-dialer: Default dialer replacement
react-native-device-info: Device identification

Building from Source

cd telon-gateway-app
yarn install
yarn android

Contributing

🤝 We welcome contributions! Here's how you can help:

🍴 Fork the repository
🌱 Create a feature branch: git checkout -b feature-name
💾 Commit your changes: git commit -m "Add feature description"
🔼 Push the branch: git push origin feature-name
📝 Create a pull request

License

📜 This project is licensed under the ISC License.

Support

💌 For support or inquiries, please visit telon.org or contact us at support@telon.org.

Acknowledgments

🙏 Special thanks to the contributors and the open-source community for making this project possible.

🔗 More in this category