- опис Проект Omni-Rig.NET є першою кроссплатформенной реалізацією всім відомої програми Omni-Rig...
- архітектура
- Установка сервера на Windows
- Установка сервера на Linux
- Використання клієнта в додатках
- поширення
опис
Проект 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, щоб зберегти конфігурацію. Якщо при цьому сервер був запущений, то його слід перезапустити. 
Використання клієнта в додатках
- Скачайте архівний файл OmniRig.Client.zip .
- Розпакуйте вміст архіву в будь-яку відповідну папку або папку вашого проекту.
- У вашому проекті додайте посилання на збірки: OmniRig.Client.dll; OmniRig.Interfaces.dll.
- У потрібних файлах проекту директиви using додайте простору імен: OmniRig.Client; OmniRig.Interfaces;
поширення
З огляду на те, що сервер Omni-Rig.NET може бути присутнім на комп'ютері користувача тільки в єдиному екземплярі, він повинен поширюватися тільки у вигляді інсталяційного пакета. При поширенні клієнта ви повинні постачати такі збірки:
Windows Linux OmniRig.Client.dll OmniRig.Client.dll OmniRig.Interfaces.dll OmniRig.Interfaces.dll OmniRig.Client.WinGUI.dll OmniRig.Client.UnixGUI.dll
OmniRig.WinProcess.dll OmniRig.UnixProcess.dll
