Radiator
SDK - набор разработчика (28/04/2001 - 182 kB) -
проверка плагина, пример плагина с исходниками, описание использования прямого доступа
к порту с комментариями
Плагины должны находиться в поддиректории Радиатора Plugins (например c:\Program
Files\Radiator\Plugins).
Если плагину необходимы какие-нибудь файлы, то они должны находиться там же. Если плагину необходимо сохранять свою конфигурацию, ПРЕДПОЧТИТЕЛЬНО ИСПОЛЬЗОВАТЬ
файл plugins.ini в поддиректории Plugins.
Пункты должны быть сохранены в файле plugins.ini в следующей форме: [имя модуля] ;например [sf16fmi] для плагина sf16fmi.dll
параметр=значение ;например Port=$384
Как разработать свой собственный драйвер (плагин) для Радиатора:
Оригинальная идея принадлежит хорошо известному MikeCrash.
Он создал свою собственную программу (AFM radio), которая была разработана для карт на базе BT878,
но также могла работать с плагинами для других плат.
Через некоторое время, мы создали первое предложение нового интерфейса плагинов,
который включил большее количество функций и возможностей.
Интерфейс плагинов Радиатора строго основан на приведенном здесь стандарте.
Интерфейс:
Здесь приведен список функций и процедур, которые экспортирует плагин Радиатора.
Фраза Радиатор пока не использует.
означает, что хотя пока Радиатор не использует эти функции, они
планируется к реализации в следующих версиях.
Требуется во всех плагинах
Описание
функция GetModuleName: PChar;
stdcall;
Экспортирует имя модуля. Не должна быть пустой, чтобы Радиатор смог распознать плагин.
функция GetModuleInfo: Cardinal;
stdcall;
Возвращает информацию о возможностях плагина. Результатом будет
постоянная "поддержки модуля" ORed:
например FM_TUNE or FM_MUTEUNMUTE
тоже самое, что и FM_TUNE + FM_MUTEUNMUTE
Результатом будет 1 + 4 = 5.
функция HWInit: Boolean; stdcall;
Инициализация "железа".
функция HWDeInit: Boolean; stdcall;
Деинициализация "железа".
Не обязательны
Описания
функция GetModuleComment: PChar;
stdcall;
Описание, копирайт и т.д.
процедура TuneFreq (Freq: LongInt);
stdcall;
Matches FM_TUNE. Частота
в кГц (88.2 МГц -> 88200 кГц).
процедура TuneFreqMuted (Freq: LongInt);
stdcall;
Matches FM_TUNEMUTED.
Частота в кГц (88.2 МГц -> 88200 кГц).
функция ScanStation (DirectionUp:Boolean; FreqToSearchFrom: LongInt): LongInt;
stdcall; Радиатор использует начиная с версии 1.6.1.0.
Matches FM_SCANSTATION.
Параметры:
направление (вверх по диапазону - True или вниз по диапазону - False) и текущая частота, откуда начинать искать.
Возвращает новую частоту.
функция GetVolume: Word; stdcall; Радиатор пока не использует.
Функции, используемые для прямого доступа к порту:
Прямой доступ к порту осуществляется с помощью dlportio.dll, который
устанавливается вместе с Радиатором. НЕ ИСПОЛЬЗУЙТЕ НИ ВАШИ СОБСТВЕННЫЕ ДРАЙВЕРЫ,
НИ ПРЯМЫЕ АССЕМБЛЕРНЫЕ КОМАНДЫ ПОРТА - ЭТО НЕНУЖНО И ЛИШНЕЕ.
Доступ к порту с помощью команд ассемблера не работает под NT.
Путь установки плагинов по умолчанию - ПУТЬ_РАДИАТОРА+ПУТЬ_ПЛАГИНОВ (например
в c:\Program Files\Radiator\Plugins) Dlportio.dll всегда находится в директории ПУТЬ_РАДИАТОРА, где к нему
можно обращаться.
функция GetPortByte(Address : Word) : Byte; процедура SetPortByte(Address : Word; Data : Byte); функция GetPortWord(Address : Word) : Word; процедура SetPortWord(Address : Word; Data : Word); функция GetPortDWord(Address : Word) : Longword; процедура SetPortDWord(Address : Word; Data : Longword); функция OpenDriver: Boolean; процедура CloseDriver;
Поддержка сканирования - параметры:
направление (вверх по диапазону - True или вниз по диапазону - False) и текущая частота, откуда начинать искать.
Возвращает новую частоту.
Сделано в Республике Чехия. c 1999 - 2001 Miroslav Flesko
Любые комментарии и советы: [email protected]
Главный сайт на flesko.cz / Зеркало на
FortuneCity
Последнее обновление: 26/02/02 14:48
