background image

 

 

AudioNav EF 

                        

Config Utility & API    

 

 

The content of this communication and/or document, including but not limited to images,   specifications, designs, concepts and information is 
confidential  and  is  not  to  be  used  for  any  purpose  or  disclosed  to  a  third  party  without  the  express  and  written  consent of 
Keymat Technology Ltd., Copyright 2018.    All rights reserved.  

 
1400 Series AudioNav EF - Config Utility & API  Rev  1.2                        

www.storm-interface.com

        

 

           Page 3 of 37 

 

 

Installing the Configuration Utility 

To install the Configuration Utility download from 

www.storm-interface.com/downloads

, double click on the 

downloaded .exe file and the Setup Wizard will launch  

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Click on “Next”   

 

 

Select “I Agree” and Click on “Next”  

 

 

 

 

 

 

 

 

 

 

 

Select if you would like to install for just you or  
everyone and select location if you do not want   

 

Click on “Next” to confirm. 

 to install at default location. Then click on “Next” 

 

Содержание AudioNav EF

Страница 1: ...ten consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 1 of 37 Windows Utility System Requirements 2 Installation 3 Using the Utility 5 API for controlling the Keypad from the Host Computer 16 List of Messages Device Communications Message Format 17 Message Definitions Details 18 Host API Library for A...

Страница 2: ...es AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 2 of 37 System Requirements The utility requires NET framework to be installed on the PC and will communicate over the same USB connection but via the HID HID data pipe channel no special drivers are required Compatibility Windows 10 Windows 8 Windows 7 Windows Vista Windows XP Only if you install NET framework The utility can ...

Страница 3: ...18 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 3 of 37 Installing the Configuration Utility To install the Configuration Utility download from www storm interface com downloads double click on the downloaded exe file and the Setup Wizard will launch Click on Next Select I Agree and Click on Next Select if you would like to install for just yo...

Страница 4: ... Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 4 of 37 The Disk Cost shows available space at your chosen folder The program requires 10MB of space Click on Close for successful installation A shortcut will be installed on your desktop Double click this to start the Utility and the following screen will appear If an AudioNav ...

Страница 5: ...press and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 5 of 37 The following functions are available and will be described on the following pages Select a Code table Create a customised code table Change the LED brightness Test the AudioNav EF Update the Firmware Reset the AudioNav EF to ...

Страница 6: ...bles Once a table has been selected then the keypad will hold that configuration unless it is disconnected Once the keypad has been disconnected that configuration will be lost unless you save the configuration in memory by clicking on Save Changes FACTORY DEFAULT CODE TABLE ALTERNATE CODE TABLE CUSTOMISED CODE TABLE Function Hex USB Description Hex USB Description Set initially to the factory def...

Страница 7: ...express and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 7 of 37 Create a Custom Code Table First select Customise Table Note that Multimedia Control Codes Vol Up Down are not available in Customised Table Please note JACK IN OUT and Horizontal Vertical codes can also be customised Click ...

Страница 8: ...played from memory on the keypad Attached to each key is another button NONE this shows the modifier for each key To customize a key click on the key and Key Code combo box will appear with Select Code The button colour will change to Orange Now press on the down arrow on the combo box This will display all the codes that can be selected These codes are the ones defined by USB org Once code is sel...

Страница 9: ...lity API Rev 1 2 www storm interface com Page 9 of 37 Adding a modifier Now if you wanted a E uppercase then you need to add a SHIFT modifier for that key Click on the modifier button for that key The background colour for modifier button will change to orange and modifier combo box will appear Select down arrow key on modifier combo box and the following selection will be available NONE L SHT Lef...

Страница 10: ...Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 10 of 37 The R SHT modifier is now displayed on the button and background colour changed to grey Now if you click on Apply and if successfully transferred then pressing down on keypad will display E uppercase If you did not want the current setting then click on Reset then all buttons will revert to original coding and then...

Страница 11: ... party without the express and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 11 of 37 LED Brightness This will set the brightness of the LEDs The selection is from 0 to 9 LEDs in Audio Nav EF can be configured differently when the jack is in or out In addition there are 3 separate lighting...

Страница 12: ...isclosed to a third party without the express and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 12 of 37 Test the AudioNav This will test all the functions illumination dimming levels Key test Jack in out H V Switch Audio test First test the audio make sure it is set as the default audio d...

Страница 13: ...on is confidential and is not to be used for any purpose or disclosed to a third party without the express and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 13 of 37 Now press each key on keypad each key will light up on screen Press close when finished ...

Страница 14: ...formation is confidential and is not to be used for any purpose or disclosed to a third party without the express and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 14 of 37 Update the Firmware Press YES BROWSE for the file press UPGRADE and CLOSE ...

Страница 15: ...dioNav EF Config Utility API Rev 1 2 www storm interface com Page 15 of 37 Reset the AudioNav EF to Factory Defaults Clicking on Factory Default will reset the keypad to factory settings Code Table Default LED brightness 9 Reset the AudioNav from a saved Configuration You can load the saved settings onto another AudioNav This is useful for example you have set up a customised table and you wish to...

Страница 16: ...ost to AudioNav is on the following pages ID Name Description 01 Device Status Request Output the firmware version selected parameters 02 LED Brightness Adjust led brightness 03 Reserved Reserved for future use 04 Reserved Reserved for future use 05 Load New code table Load new code table 06 Reserved Reserved for future use 07 Keypad Type Select layout table 08 Reserved Reserved 09 Write to defaul...

Страница 17: ...ontrol byte ACK 0x06 A retransmission should be initiated if an NAK 0x15 is received or if no acknowledge is received at all Message Formats A Alpha character A Z and a z C Control character one byte in length H Hexadecimal characters 0 9 A F N Numeric character 0 9 S Special characters entire character set 0x00 0xFF ASCII Message Format Message Field Type Length Description 1 STX C 1 Control char...

Страница 18: ...ion and all currently selected parameters 02 LED Brightness Host To AUDIONAV keypad adjust led brightness default 0 03 Reserved RESERVED 04 Reserved RESERVED 05 Load New code table Host To AUDIONAV keypad Load new code table 06 Reserved RESERVED 07 Keypad Table Host To AUDIONAV keypad Select layout table 0 Default Table 1 Alternate Table 2 Customised 08 Reserved Reserved 09 Write to default Host T...

Страница 19: ...s Response Keypad sends this message to Host in response to the Device Status message Data Field Type Length Description ec Error Code SH 2 Lb LED Brightness SN 1 Value 0 9 Kt Keypad Table SN 1 0 Default Table 1 Alternate Table 2 Customised Table Js Jack status SN 1 0 Jack IN 1 Jack Out Hs Horizontal Verticle SN 1 0 Vertical 1 Horizontal Kc Keycode SH 20 Customised keycode for each key fw Firmware...

Страница 20: ...d Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 20 of 37 LED Brightness Command 02 Host sends this message to control brightness of LEDs Data Field Type Length Description 1 LED brightness SN 1 0 9 LED Brightness Command Response Data Field Type Length Description ec Error Code H 2 Host Device AudioNav 02 lb 02 ec Note LED bright...

Страница 21: ...ble Command Response Data Field Type Length Description ec Error Code H 2 Host Device AudioNav 05 lt 20 scan codes 05 ec Note Length is always 20 Format of table is as follows modifier for key 1 code for Key 1 modifier for key 2 Code for Key 2 etc The code table is specified in the user manual together with the modifier code For example to program the following for 4 way Key 1 A Key 2 a Key 3 9 Ke...

Страница 22: ...terface com Page 22 of 37 Keypad Table Command 07 Host sends this message to set keypad type Data Field Type Length Description 1 Keypad Type SN 1 0 Default Table 1 Alternate Table 2 Customised Table Keypad Command Response Data Field Type Length Description ec Error Code H 2 Host Device AudioNav 07 bp 07 ec Reserved 08 Write Config Data To Flash command 09 Host sends this command to request the A...

Страница 23: ...nfig Utility API Rev 1 2 www storm interface com Page 23 of 37 Reset To Factory Default command 10 Host sends this command to request the AUDIONAV to reset parameters back to factory default This command has no data associated with it Reset To Factory Default Response Data Field Type Length Description ec Error Code H 2 Host Device AUDIONAV 10 10 ec Reserved 11 Enable BSL Command 12 Host sends thi...

Страница 24: ... written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 24 of 37 Set Serial Number command 14 Host sends this command to set the serial number of the device in format YYQQXXXXXXXX Data Field Type Length Description 1 Serial Number ANS 12 YYQQXXXXXXXX Set Serial Number command Response Data Field Ty...

Страница 25: ...keypad Keyboard Report HID Keyboard Report Format BIT7 BIT6 BIT5 BIT4 BIT3 BIT2 BIT1 BIT0 Byte0 Right GUI Right Alt Right Sft Right Ctrl Left GUI Left Alt Left Shift Left Ctrl Byte1 Reserved Key_array 0 Key_array 1 Key_array 2 Key_array 3 Key_array 4 Key_array 5 Byte2 Byte3 Byte4 Byte5 Byte6 Byte7 For example if user has configured for Default Table If the user now presses the top key which is and...

Страница 26: ...e API for the host application developers HIDAPI This is a third party library which allows an application to interface with USB HID Compliant devices on Windows Linux and Mac OS X While it can be used to communicate with standard HID devices like keyboards mice and Joysticks it is most useful with custom Vendor Defined HID devices This allows for host software to scan for the device using its VID...

Страница 27: ...d party without the express and written consent of Keymat Technology Ltd Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 27 of 37 The API makes the following functions available to developers Page All Message Types 28 GetDeviceStatus 30 InitialiseStormUSBDevice 29 LoadCodeTable 32 ResetToFactoryDefault 35 SetKeypadTable 33 SetLedLe...

Страница 28: ...ww storm interface com Page 28 of 37 All Message Types This is referenced in below functions enum REQUEST_TYPE message types DEVICE_STATUS 1 Device status message LED_BRIGHTNESS set led brightness RESERVED_1 MID_RESERVED_6 RESERVED_2 MID_RESERVED_6 LOAD_NEW_TABLE load new key code table RESERVED_3 MID_RESERVED_6 KEYPAD_TYPE set keypad type 0 default table 1 alternate 2 customise RESERVED_4 MID_RES...

Страница 29: ...roduct PID and Manufacturer VID This are assigned to Keymat Vendor ID 0x2047 Product ID 0x09D0 On successful finding the Audio Nav the manufacturer_local will be filled with Storm Interface and product_local will be filled with AUDIO NAV If not successful both of the strings will be filled with none Parameters storm_vid Vendor ID product_pid Product ID manufacturer vendors name will be stored prod...

Страница 30: ...igned char led_brightness unsigned char keypad_table unsigned char jack_status unsigned char HV_status unsigned char keyCode 20 currently keytable in use std string version std string serialNumber DEVICE_INFO _deviceInfo DEVICE_INFO sturcture that will be filled by the function timeToWait maximum time to wait for command to complete Return Value True for success False for failure brief GetDeviceSt...

Страница 31: ...vel can be set with values 0 to 9 Parameters Int ledLevel timeToWait maximum time to wait for command to complete Return Value 0 for success brief SetLedLevel This function sets led brightness level from 0 to 9 where 0 is off and 9 is on param ledLevel used to set led level param _timeToWait is the time in milliseconds to wait for the data to be retrieved return 0 on success negative error code on...

Страница 32: ...cluding modifier For each key the values must be modifier USB key code timeToWait maximum time to wait for command to complete Return Value 0 for success brief LoadCodeTable This function loads a new code table to customise table in AudioNav param KeyCodePtr Point to new code table param keyCodeLen length of keycode Must be 20 param _timeToWait is the time in milliseconds to wait for the data to b...

Страница 33: ... alternate 2 customise Parameters Int KeypadTable 0 default 1 alternate 2 customise timeToWait maximum time to wait for command to complete Return Value 0 for success brief SetKeypadTable This function sets which table is currently used param KeyCodeTable 0 default 1 alternate 2 customise param _timeToWait is the time in milliseconds to wait for the data to be retrieved return 0 on success negativ...

Страница 34: ...unction commnds the AudioNav to commit current values to flash Parameters timeToWait maximum time to wait for command to complete Return Value 0 for success brief WriteDefaultToFlash This function writes changed values to Flash param None param _timeToWait is the time in milliseconds to wait for the data to be retrieved return 0 on success negative error code on failure Possible error codes are DE...

Страница 35: ...n commnds the AudioNav to reset the Audio Nav to factory default Parameters timeToWait maximum time to wait for command to complete Return Value 0 for success brief ResetToFactoryDefault This function reset AudioNav to factory default param None param _timeToWait is the time in milliseconds to wait for the data to be retrieved return 0 on success negative error code on failure Possible error codes...

Страница 36: ...AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 36 of 37 Workspace Click on AudioNavApi microsoft visual studio solution and the workspace will be launched The workspace has 5 projects AudioNavApi This is the API as described above Hidapi This is freeware api for low level communication with USB device TestApi This shows how the AudioNavApi is used using c Wrapper This wrapper ...

Страница 37: ...d Copyright 2018 All rights reserved 1400 Series AudioNav EF Config Utility API Rev 1 2 www storm interface com Page 37 of 37 Change History Instructions for Date Version Details Config Utility API 13 Sep 19 1 0 First release split out from AudioNav tech manual 14 Dec 20 1 1 API added 06 Jan 21 1 2 Utility update Configuration Utility Date Version Details 14 Jun 19 1 0 First Release 06 Jan 21 2 0 ...

Отзывы: