Client Startup Procedure

As of version 8.6 (released in October 2008), the LumenVox Engine (both client and server) perform a series of checks when initialized. If these checks fail, it can cause the application to terminate. If your application is crashing at startup, it is likely related to one of these items.

This procedure applies to any application using our LVSpeechPort C or C++ interface. The SRE Server has its own startup procedure.

Note that folder and file verification checks (steps 5 through 9) are only performed for the first OpenPort call and are skipped on any subsequent OpenPort calls.

1. Verifies that there is a valid LVLANG directory. This is the path specified by the value of LANGDIR in lumenvox_settings.conf. If any errors are detected, a log message will be added to the API log before returning with an error to the calling application.
2. Determines the location of the ClientStartupLog.txt that will be generated by the startup check. This will be located in the folder determined by the LVLOGS value from lumenvox_settings.conf.
3. Creates the ClientStartupLog.text log file, overwriting any previous contents, allowing only the last startup to be recorded, so that this file does not grow to an unmanageable size.
4. On Windows only, if the LumenVox_Product.dub file is located in the $LVBIN folder, then a warning is added to the log to indicate that any system variables are being overridden by this.
5. The application checks to ensure that a directory called BuiltinGrammars exists inside of the directory specified by the LANGDIR setting. Any errors are logged and an error code is returned to the calling application.
6. This folder is checked to ensure it contains the following items:
   • ABNFBoolean.gram
   • ABNFCurrenty.gram
   • ABNFDate.gram
   • ABNFDigits.gram
   • ABNFNumber.gram
   • ABNFPhone.gram
   • ABNFTime.gram
7. The application checks to ensure there is an LVLANG/Dict folder, and that this directory contains at least one .model data file.
8. It checks to ensure there is an LVLANG/Grammars folder, and that the folder contains the grammar.dtd and SRGS_to_ABNF.xsl files.
9. The application checks to ensure there is a valid LVLANG/VadModels folder and that it contains the following files:
• bab.code
• baby.code
• back.code
• back1.code
• bell.code
• bird.code
• breath.code
• chan.code
• CosTable.txt
• dtmf.code
• gspeech.code
• kmusic.code
• music.code
• nonspeech.code
• phone.code
• rtp.code
• SinTable.txt
• speech.code
• throat.code