RIL (Radio Interface Layer)

欢迎使用 RIL，持续更新中...

简介

RIL — это программное обеспечение для управления беспроводными коммуникационными модулями (GSM/GPRS/CatM1/NB-IoT), разработанное специально для встраиваемых платформ. В отличие от других крупных фреймворков, таких как Android RIL и Wince RIL, RIL предназначен для применения в ограниченных ресурсами устройствах интернета вещей (однокристальный микроконтроллер + беспроводной модуль). Он предоставляет основные функции, необходимые для связи в интернете вещей, включая регистрацию в сети, управление соединениями, отправку и получение SMS, а также сокетную связь. На данный момент поддерживаются модули EC21, BG96 и HL8518, и список поддерживаемых модулей продолжает расширяться.

Основные характеристики

• Включает в себя управление регистрацией в сети, соединениями, отправкой и получением SMS и сокетной связью.
• Управление модульными драйверами осуществляется с помощью плагинов, что позволяет одному и тому же устройству поддерживать несколько модулей и динамически выбирать драйвер модуля.
• Легко адаптируется к различным RTOS-платформам путём простых изменений.
• Встроенный механизм обработки исключений обеспечивает стабильную работу модуля.
• Встроенные компоненты, такие как HTTP-загрузка файлов с функцией продолжения после прерывания, TFTP-передача и MQTT, делают его удобным в использовании.

Системные требования

Для нормальной работы RIL система должна соответствовать следующим требованиям:

• ROM-ресурсы: минимум 13,5 КБ (зависит от количества подключённых модулей и используемых компонентов).
• RAM-ресурсы: минимум 1,2 КБ (зависит от количества создаваемых сокетов).
• RTOS и стек: RIL должен работать в двух задачах, каждая из которых требует минимум 256 байт стека.
• Компилятор: поскольку RIL использует некоторые функции C99 (гибкие массивы и встроенные функции), компилятор должен поддерживать C99. Для IAR поддержка включена по умолчанию, а для Keil MDK требуется вручную добавить опцию компиляции (--c99 --gnu).

Архитектура программного обеспечения

Руководство по разработке

#include "ril.h"
//....
//Создание задачи RIL

ril_init(&adt, &cfg);     //Инициализация RIL

ril_use_device("EC21");   //Выбор типа модуля

ril_open();               //Открытие устройства

ril_netconn(true);        //Запуск сетевого подключения
//...

Более подробные инструкции можно найти здесь:

• Быстрый старт
• Демонстрация примеров
• Документация по переносу на другую ОС
• Документация по адаптации модулей

Участие и вклад

1. Fork этого репозитория.
2. Создайте ветку Feat_xxx.
3. Отправьте код.
4. Создайте Pull Request.
5. Если вы обнаружите какие-либо проблемы или серьёзные ошибки во время использования, не забудьте оставить комментарий в разделе комментариев, автор будет очень благодарен!