RadioTrack
II plugin (07/09/2001 - 5 kB) - plugin created with possibility to
switch mono/stereo by Josef
Kucera (www
page) Supported card: AimsLab RadioTrack II
Plugins should be stored in Radiator's subdirectory Plugins (for example c:\Program
Files\Radiator\Plugins).
If there are any file(s) that plugin needs they should be stored there also. If plugin needs to save its configuration PREFERABLY USE
plugins.ini file in Plugins subdirectory.
Items should be stored in plugins.ini file in the following form: [name of the module] ;for example [sf16fmi] for sf16fmi.dll plugin
entry=value ;for example Port=$384
How to develop own driver (plugin) for Radiator:
The idea originally came from well-known MikeCrash.
He made his own application (AFM radio) which was designed for BT878 based cards
but his application could accept plugins for other cards as well.
Some time after we created the first proposal of the new plugins interface
which included more functions and possibilities.
The Radiator plugins interface is strongly based on our given standard.
Interface:
Here is the list of functions and procedures which the Radiator plugin
exports.
The sentence Radiator does not use it yet.
means that although Radiator does not take benefit from these functions, it is
planned to do so in next versions.
Required in all plugins
Description
function GetModuleName: PChar;
stdcall;
Exported name of the module. Must not be empty for Radiator to recognize the plugin.
function GetModuleInfo: Cardinal;
stdcall;
Gives info of plugin possibilities. The result
are ORed "module supports" constants:
eg. FM_TUNE or FM_MUTEUNMUTE
which is the same as FM_TUNE + FM_MUTEUNMUTE
Result would be 1 + 4 = 5.
function HWInit: Boolean; stdcall;
Initializes hardware.
function HWDeInit: Boolean; stdcall;
Deinitializes hardware.
Optional
Description
function GetModuleComment: PChar;
stdcall;
Description, copyright etc.
procedure TuneFreq (Freq: LongInt);
stdcall;
Matches FM_TUNE. Frequency
is given in kHz (88.2 MHz -> 88200 kHz).
procedure TuneFreqMuted (Freq: LongInt);
stdcall;
Matches FM_TUNEMUTED.
Frequency is given in kHz (88.2 MHz -> 88200 kHz).
function ScanStation (DirectionUp:Boolean; FreqToSearchFrom: LongInt): LongInt;
stdcall; Radiator uses it since 1.6.1.0.
Matches FM_SCANSTATION.
Parameters are
direction (up to high range - True or down to low range - False) and current frequency to search from.
Returns new frequency.
function GetVolume: Word; stdcall; Radiator does not use it yet.
Direct access to port is performed by dlportio.dll shipped and installed with Radiator.
DO NOT USE YOUR OWN DRIVERS NOR DIRECT ASM PORT DIRECTIVES - IT WOULD BE UNNECESSARY AND
REDUNDANT. Port access by asm directives does not work on NT based systems.
Default path where the plugins are installed is RADIATOR_PATH+PLUGINS_PATH (for
example in c:\Program Files\Radiator\Plugins) Dlportio.dll is always in RADIATOR_PATH directory, where it can be
accessed.
function GetPortByte(Address : Word) : Byte; procedure SetPortByte(Address : Word; Data : Byte); function GetPortWord(Address : Word) : Word; procedure SetPortWord(Address : Word; Data : Word); function GetPortDWord(Address : Word) : Longword; procedure SetPortDWord(Address : Word; Data : Longword); function OpenDriver: Boolean; procedure CloseDriver;
Supports scanning - parameters are
direction (up to high range - True or down to low range - False) and current frequency to search from.
Return is new frequency.
There is sample sf16fmi plugin included in the developer pack together with
its source code in Delphi (Object Pascal) so you can get inspiration from there.
How to make the plugin available for other users of
Radiator:
