Описание

Текущая версия: 1.1.5662

Проект Omni-Rig.NET является первой кроссплатформенной реализацией всем известной программы Omni-Rig Александра (Alex Shovkoplyas, VE3NEA). Программа Omni-Rig.NET написана на языке C# и предназначена для внедрения в различные ваши проекты возможность управлять радиолюбительскими трансиверами. Список поддерживаемых трансиверов полностью соответствует текущему списку Omni-Rig. Файлы описания команд управления (INI-файлы) использованы без каких либо изменений от программы Omni-Rig.

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

Omni-Rig.NET работает на операционных системах Windows и Linux (включая MacOS). На операционной системе MacOS проект не тестировался.

Минимальная версия Windows: Windows XP. Обязательное наличие .NET Framework 4.0.
На операционных системах Linux/MacOS должен быть установлен полный пакет Mono.

Архитектура

Проект Omni-Rig.NET построен по принципу клиент-сервер. Для обмена данными между клиентом (клиентами) и сервером используется технология Microsoft WCF. Omni-Rig.NET позволяет управлять одновременно двумя трансиверами как локально (при расположении клиента и сервера на одном компьютере), так и удалённо по сети (сервер располагается на компьютере подключенном к управляемому трансиверу и сети (Internet, местной, домашней и т.д.). Число клиентов может быть больше одного и они могут располагаться как на одном компьютере, так и на нескольких компьютерах объединённых в сеть. Структурная схема Omni-Rig.NET приведена ниже.

Внимание! Так как графический интерфейс пользователя (GUI) для операционной системы Windows написан на Windows Forms, а для операционных систем Linux - на GTK#, то при написании программ под Linux с использованием сборки-клиента OmniRig.Client.dll следует использовать только GTK#.

Установка сервера на Windows

Скачайте инсталляционный пакет Omni-Rig.NET.Server.exe.
Запустите его и следуйте указаниям мастера установки. На завершающем этапе после нажатия кнопки Финиш откроется окно, с сообщением об успешной установке сервера и номером версии сервера. Это означает, что путь к серверу был успешно сохранён в системе.

Путь к исполняемому файлу сервера, на примере Windows 7, храниться по пути: "C:\Users\Имя пользователя\AppData\Roaming\RS - Design\OmniRig.NET" в файле server.config. В этом же файле храняться остальные настройки сервера (сетевой протокол, номер порта).

В меню Программы вашего компьютера будет создан пункт RS Design -> Omni-Rig.NET. Зайдите в него и запустите программу Server Configurator. Программа Server Configurator позволяет изменять настройки сервера, а также запускать, останавливать или перезапускать сервер на локальном компьютере. Кроме того есть возможность удалить все файлы конфигурации в случае возникновения неполадок. Вы можете просматривать журнал ошибок. В этом журнале фиксируются все непредвиденные программные ошибки во время работы сервера.

Выберите требуемый сетевой протокол обмена данными и номер сетевого порта.

Протокол Named Pipes следует выбирать только в том случае, если не предполагается удалённое (по сети) управление трансивером. Протокол Named Pipes отсутствует на системах Linux. Если флажок Autostart Server установлен, то сервер будет запускаться автоматически во время загрузки операционной системы.

Нажмите Save, чтобы сохранить конфигурацию. Если при этом сервер был запущен, то его следует перезапустить.

Установка сервера на Linux

Для операционных систем Linux инсталлятор сервера Omni-Rig.NET не предусмотрен. Поэтому просто скачайте файл архива Omni-Rig.NET.Server.UNIX.zip и распакуйте его содержимое в любую папку Linux (например, в домашнюю папку). 
Запустите файл сервера OmniRig.Server.exe. В случае удачного сохранения пути к серверу появиться такое же окно, что в случае с установкой на Windows. Закройте его.
Запустите программу ServerConfiguratorUNIX.exe и с её помощью отредактируйте при необходимости настройки сервера.
Нажмите Save configuration, чтобы сохранить конфигурацию. Если при этом сервер был запущен, то его следует перезапустить.


 

Использование клиента в приложениях

1. Скачайте архивный файл OmniRig.Client.zip.
2. Распакуйте содержимое архива в любую подходящую папку или папку вашего проекта.
3. В вашем проекте добавьте ссылки на сборки: OmniRig.Client.dll; OmniRig.Interfaces.dll.
4. В нужных файлах проекта директивой using добавьте пространства имён: OmniRig.Client; OmniRig.Interfaces;

Распространение

Ввиду того, что сервер Omni-Rig.NET может присутствовать на компьютере пользователя только в единственном экземпляре, он должен распространяться только в виде инсталляционного пакета. При распространении клиента вы должны поставлять следующие сборки: