Infrastructure.Telecom 1.0.4

Infrastructure.Telecom

A .NET library for integrating with Olax GSM devices (tested on Olax Ultra U80_21B44). It lets you send SMS, read messages, manage your device, and more — all through a clean, async API.

Requirements

• .NET Standard 2.1 or later
• An Olax Ultra device connected to your local network
• The device's local IP address, username, and password

Installation

dotnet add package Infrastructure.Telecom

Or via the NuGet Package Manager:

Install-Package Infrastructure.Telecom

Setup

1. Add configuration to appsettings.json

{
  "TelecomSettings": {
    "Host": "http://192.168.0.1",
    "Username": "admin",
    "Password": "your-password",
    "DeviceType": "Olax"
  }
}

Host is the base URL of your Olax device on the local network.

2. Register the service in Program.cs / Startup.cs

Using appsettings.json (recommended):

builder.Services.AddTelecomService();

Or pass configuration directly in code:

builder.Services.AddTelecomService(new BaseConfiguration
{
    Host = "http://192.168.0.1",
    Username = "admin",
    Password = "your-password"
});

Usage

Inject IOlaxTelecomService into your class:

public class MyService
{
    private readonly IOlaxTelecomService _telecom;

    public MyService(IOlaxTelecomService telecom)
    {
        _telecom = telecom;
    }
}

Send SMS

Simple way:

await _telecom.SendSMSAsync("+84901234567", "Hello from Infrastructure.Telecom!");

Using request object:

var request = new CreateSMSRequest("+84901234567", "Hello!");
await _telecom.SendSMSAsync(request);

Read Messages

// Get all messages
var all = await _telecom.GetSMSsAsync();

// Get only new (unread) messages
var newMessages = await _telecom.GetNewSMSsAsync();

// Get read messages
var oldMessages = await _telecom.GetOldSMSsAsync();

// Get sent messages
var sent = await _telecom.GetSentSMSsAsync();

Each message is a MessageDto:

By default, up to 500 messages are returned. You can pass a custom pageSize:

var messages = await _telecom.GetSMSsAsync(pageSize: 100);

Manage Messages

// Mark a message as read
await _telecom.MarkOldSMSAsync(messageId);

// Delete a specific message
await _telecom.DeleteSMSAsync(messageId);

// Delete all messages
await _telecom.DeleteAllSMSAsync();

Device Information & Control

// Get device info
DeviceDto device = await _telecom.GetDeviceAsync();
Console.WriteLine(device.PhoneNumber);
Console.WriteLine(device.NetworkType);
Console.WriteLine(device.SignalStrength);

// Check if the SMS module is ready
bool isReady = await _telecom.GetSMSReadyAsync();

// Reboot the device
await _telecom.RebootDeviceAsync();

// Turn off the device
await _telecom.TurnOffDeviceAsync();

// Reset the IP
await _telecom.ResetIPAsync();

DeviceDto key properties:

Custom Validation

By default, all SMS requests pass validation. You can add your own rules by implementing ITelecomValidator:

public class MyTelecomValidator : ITelecomValidator
{
    public Task<bool> SendSMSValidateAsync(CreateSMSRequest request)
    {
        // Example: block empty content
        bool isValid = !string.IsNullOrWhiteSpace(request.Content)
                    && !string.IsNullOrWhiteSpace(request.PhoneNumber);

        return Task.FromResult(isValid);
    }
}

Then register your validator before calling AddTelecomService:

builder.Services.AddTransient<ITelecomValidator, MyTelecomValidator>();
builder.Services.AddTelecomService();

If validation fails, a SmsRuleViolationException is thrown:

try
{
    await _telecom.SendSMSAsync(request);
}
catch (SmsRuleViolationException ex)
{
    Console.WriteLine(ex.Message); // "SMS sending failed: violates compliance rules."
}

Full Example

// Program.cs
builder.Services.AddTelecomService();

// MyController.cs
public class NotificationController : ControllerBase
{
    private readonly IOlaxTelecomService _telecom;

    public NotificationController(IOlaxTelecomService telecom)
    {
        _telecom = telecom;
    }

    [HttpPost("send")]
    public async Task<IActionResult> Send(string phone, string message)
    {
        await _telecom.SendSMSAsync(phone, message);
        return Ok("SMS sent.");
    }

    [HttpGet("inbox")]
    public async Task<IActionResult> Inbox()
    {
        var messages = await _telecom.GetNewSMSsAsync();
        return Ok(messages);
    }
}