C.4 Creating New Major Modes from Old
Ones
Developers can add custom algorithms to RVP by building on its concept of major modes
and output data types. Each major mode defines all the methods required to compute each
output data type from raw (I,Q) data.
Allowing users to define their own major modes provides all hooks required for full
customization. You can code your own custom algorithms by making incremental changes
to one of the Vaisala models, or you can start from scratch and build something unique.
The best way to create a custom major mode is usually to start with the code for an existing
one and incrementally modify it to include the new features.
The FFT mode, for example, is
defined in the files rvp9main/open/mt_fft.c and
rvpxproc/open/ct_fft.c, each containing boilerplate top-level definitions.
1. To start creating your new major mode, copy the prototype code to separately named
files in the rvp9main/site and rvp9proc/site areas, and then make the desired
changes.
There are 4 major mode slots reserved for custom user applications.
2. Define the names of your new modes using Setup > RVP > Optional Data Parameters.
Names can be up to 15 characters long, and the text you choose automatically appears
in utility menus such as Ascope, IRIS.
3. To invoke your new code, modify one of the lines of rvp9main/site/mt_user.c
and rvpxproc/site/ct_user.c.
These simple
files are shipped in deactivated form as follows:
/* ------------------------------
The available user modes are shipped in an unused state. By doing nothing
in their INIT routines, these modes are effectively disabled
(all function pointers remain NULL).
*/
void mtInitMajorMode_user1( void ) {}
void mtInitMajorMode_user2( void ) {}
void mtInitMajorMode_user3( void ) {}
void mtInitMajorMode_user4( void ) {}
4. During execution, call your custom initialization routines from one of the
predefined
user stubs:
void mtInitMajorMode_user1( void ) {initMajorMode_myCustomMode() ; }
RVP900 User Guide M211322EN-J
382
To Next Page
Loading...