A
Building custom lexicons
A.1
Lexicon build procedure
A pre-built version of the lex_make utility for Windows systems is provided
as part of the firmware update kit. The source code is provided and should
compile and run on any system with a modern C compiler and runtime
library.
Note: Normally you will use the pre-built lex_make utility. The source
code is provided in case you do not have a Windows system
available. Instructions for compiling the utility are outside the
scope of this document; refer to your operating system or compiler
documentation for more information.
The lex_make utility reads a configuration file and creates a custom
firmware image based on the supplied configuration. Here is a sample
config file named
lex_basic.cfg
:
rptr-nex_3.6.blob
RPTR-NEX_V36_LEX-BASIC.bin
BASIC
words/flw_dirty.txt
words/slw_dirty.txt
words/flw_basic.txt
words/slw_basic.txt
The first line contains the filename of the actual GPS repeater code "blob".
The second line is the name of the firmware file to create. The third line is
the display name of the lexicon which will be displayed on the clock when
the GPS repeater powers up or is paired to the clock. The following lines,
which can be as few as one or as many as you’d like, list the filenames
of lexicons to be incorporated into the firmware. This example includes
both the 4- and 6-letter "dirty" lexicons as well as the 4- and 6-letter basic
lexicons. Additional lexicons can be found in the "words" subdirectory and
example config files which use them are also provided.
The lexicons are stored in a special compressed format in order to increase
the number of words which will fit in the repeater. The lex_make utility
attempts to verify that the created firmware image will be small enough
to fit in the repeater, however it does not guarantee that this is the case.
If you add a very large number of words, you may exceed the storage
capacity of the GPS repeater.
The following example shows the procedure to create firmware with the
BASIC lexicon:
C:\tmp>dir/s
Volume in drive C has no label.
Volume Serial Number is 7A06-DFCD
Directory of C:\tmp
A–1
