{"id":2378,"date":"2019-10-28T12:26:52","date_gmt":"2019-10-28T12:26:52","guid":{"rendered":"http:\/\/grauonline.de\/cms2\/?page_id=2378"},"modified":"2021-12-22T10:24:02","modified_gmt":"2021-12-22T10:24:02","slug":"quick-start-gui-usb-module-usb-pushbuttonusb-pushbox","status":"publish","type":"page","link":"https:\/\/main.grauonline.de\/de\/quick-start-gui-usb-module-usb-pushbuttonusb-pushbox\/","title":{"rendered":"Web manual: GUI for your USB module (USB pushbutton\/USB pushbox)"},"content":{"rendered":"
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

If you are familiar with programming, you probably already know how to install, connect, and\u00a0 program your pushbutton or pushbox “manually” via command lines and a serial terminal.The graphic user interface (GUI) on your mini CD or on our product page makes it easier to configure your USB module (includes both USB pushbutton and USB pushbox). Go ahead and see how the programming of your USB module via GUI works!<\/p>

Configure your USB module without any programming knowledge!<\/h1>

Before customizing your USB module, you must install and connect the GUI<\/a>. The GUI offers you two main possibilities to customize your USB module according to your purposes. The first one is to manually enter keys and key combinations into the dialogue “Key Probing and Tables”. This only works if you want the pushbutton or pushbox to simulate keys, but not full type strings, delays or other command types. The second possibility is to complete the command lines in your app by manually entering codes, strings and other commands into the interactive table in the main dialogue. This procedure works for all command types. The following sections present these two programming possibilities “step by step” and offer a variety of programming examples.<\/p>

Programming keys for your USB module via ‘Key Probing and Tables’<\/h2>

The following steps show you how to configure the example “123” via the input field in Key Probing and Tables<\/strong><\/p>

          1. Select command list 1 (the default list on button trigger) in the main dialogue.<\/li>
          2. Click on Clear command lists and start with the first command entry \u201cidx 0\u201d if you want to want to enter a new configuration. If you already programmed command lists in the GUI, you can also start at another command list.<\/li>
          3. Select the field DATA 1<\/strong><\/em> within a list entry (idx 0 \u2013 idx 7). For a new configuration, start with “idx 0”. If you already programmed entries in the command list, you can also start at another list entry.<\/li>
          4. Click on Key Probing and Tables<\/strong> <\/em>in order to define your preferred keys.The GUI opens a second dialogue. This dialogue includes an input field for keyboard shortcuts, the button Copy to main window<\/strong><\/em>, an English keyboard image, a dropdown lists to select a keyboard layout and several tables with key codes.<\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol>

            \"PBT_PBL<\/a><\/p>

                    1. Manually enter the key \u201c1\u201d into the input field.The GUI automatically displays the data codes result after all keys have been released.<\/li>
                    2. Click on Copy keys to main window<\/strong><\/em> to copy the data codes to the main dialogue at the selected position. Then return to the main dialogue by minimizing the window. An auto-release data code (\u201c0x8000\u201d) be automatically added after each entered shortcut.<\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol>

                      \"Confguring<\/a><\/p>

                              1. Repeat the steps 4 to 6 for the keys \u201c2\u201d and \u201c3\u201d.<\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol>

                                Notice:<\/strong> If you only want to press the key, but do not release it before the next command, you must set the trailing data codes number \u201c0x8000\u201d (=\u201dRELEASE ALL KEYS\u201d) as \u201c0x0 (0)\u201d (=undefined).<\/p>

                                          1. Check the concerned command list entry (“idx+value”). The interactive chart with all command lists has adapted to the new configuration and displays it.<\/li>
                                          2. Check the field Interpretation<\/strong><\/em> in order to view and verify your programmed operations.<\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol>

                                            \"Customizing<\/a><\/p>

                                                      1. Click on Save to btn mem\/test<\/strong><\/em> in order to temporarily store your USB module\u2019s new configurations for testing. The GUI saves the newly set configurations in your USB module\u2019s internal memory without flashing the module. This means that you can still correct and adapt the configurations. If you want to revert to your original configuration you may also close the application, plug-out and re-plug the USB module.<\/li>
                                                      2. Click on Show serial terminal<\/strong><\/em> or Show serial cmds<\/strong><\/em> in order to view and test your USB module\u2019s new configurations within the GUI. Show serial cmds<\/strong><\/em> is a more compact terminal view which only contains the serial commands. Via Show serial terminal<\/strong><\/em>, you can view all configurations as full strings. You can also test keys in an external text editor.<\/li>
                                                      3. Push the button(s) included in your USB module in order to verify your programming success. In the best case, the USB module now simulates the key combination “123”. Otherwise, you need to correct your configurations, save and test them again.<\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol>

                                                        \"Customizing<\/a><\/p>

                                                                1. Return to the main dialogue.<\/li>
                                                                2. Click on Save to btn flash<\/strong><\/em> if you permanently want to save the new configurations in your USB module\u2019s internal flash memory. Do not immediately flash the module if you are going to initiatiate any changes regarding the stored configurations.<\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol><\/li><\/ol>

                                                                  You have successfully customized your USB module. The configurations for the key combination \u201c123\u201d have been stored in the module\u2019s internal flash memory.<\/p>

                                                                  Entering codes and values for your USB module in the main dialogue<\/h2>

                                                                  The following instructions show you how to programme the following key and string combination: “Windows + r, 500 ms delay, programme path, Return\/Enter”. After programming, your file system is supposed to open the programme \u201cOpenOffice\u201d on the computer. All values shall be manually entered into the GUI’s selection table in the main dialogue.<\/p>

                                                                      1. Select a command list.<\/li>
                                                                      2. Start with the command list number 1 and click on Clear command lists<\/strong><\/em> if you want to want to enter a new configuration.If you already programmed command lists in the GUI, you can also start at another command list.<\/li>
                                                                      3. Select a command type for an entry in the command list (idx + value). Within the column (also: index row) idx 0<\/strong><\/em>, select the field DATA 1<\/strong><\/em> for configuration. It is always recommended to start with DATA 1<\/strong> <\/em>within an index row (left -right) and at idx 0<\/strong><\/em> (top-down) unless you already configured any index rows.\"Programming<\/a><\/li>
                                                                      4. Click on Key Probing and Tables<\/strong><\/em> in order to define the keys simulated by the field entries DATA1<\/strong><\/em>, DATA2<\/strong><\/em> and DATA3<\/strong><\/em>.The GUI opens a second dialogue. This dialogue includes an input field for keyboard shortcuts, the button Copy keys to main window<\/strong><\/em>, an English keyboard image, a dropdown list to select a keyboard layout and several tables with key codes.<\/li>
                                                                      5. Define a keyboard layout and a code table.<\/li><\/ol><\/li><\/ol><\/li><\/ol>

                                                                        \"Programming<\/a><\/p>

                                                                        Notice:<\/strong> The USB module defines HID RAW codes exclusively via their position on the keyboard. In consequence,\u00a0 they do not rely on any ASCII interpretation. ASCII codes do not include any function keys and depend on your file system’s code interpretation. For programming success, you must select the keyboard layout matching the keyboard which you want to simulate with the USB module.If you are not sure yet which keyboard you are going to simulate, you should select the codelist “HID RAW codes”.<\/p>

                                                                        1. Select your preferred \u201cPress code\u201d or \u201cPress and release code\u201d from the code list. For this example, select the \u201cPress\u201d code for the Windows key \u201cLEFT_GUI\u201d. If you select a \u201cPress code\u201d, the GUI does not automatically create a release code in the main window. You usually select press codes for parallel keystrokes.If you select a \u201cPress and release code\u201d, the GUI automatically adds a hold and release code in the main dialogue. You usually select press and release codes for key sequences.<\/li>
                                                                        2. Copy the \u201cPress code\u201d for \u201cLEFT_GUI\u201d and return to the main window. Paste it into the field DATA 1.<\/li>
                                                                        3. Now select the field DATA 2 and repeat the steps 4 to 7 with the \u201cPress code\u201d for \u201cr\u201d.<\/li>
                                                                        4. Check the field Interpretation to verify your result.<\/li>
                                                                        5. Move on to the index row idx 1<\/strong><\/em> and select the command type 5-DelayMS<\/strong><\/em> (delay in milliseconds).<\/li><\/ol>

                                                                          \"Programming<\/a><\/p>

                                                                          1. Enter the value \u201c500\u201d into the field DATA 1 and check the field Interpretation to verify your result.<\/li>
                                                                          2. Move on to the index row idx 2<\/strong><\/em>. Then select the command type 3- typeString<\/strong><\/em> in order to enter a string into the main window.<\/li>
                                                                          3. Copy your string (here: the programme path) into the input field at the bottom of the dialogue. For programme paths, you might have to add “programme name.exe (or other ending for Mac)” manually at the end of the string.<\/li>
                                                                          4. Make sure to choose the column with the correct index number (here: idx 2) and press “Return\/Enter”.<\/li><\/ol>

                                                                            \"Programming<\/a><\/p>

                                                                            1. Enter the value \u201c0x2 (2)\u201d into the field DATA 2<\/strong><\/em>. \u201c2\u201d refers to the current index number.<\/li>
                                                                            2. Move on to the index row idx 3<\/strong><\/em>. Select the command type 2- Keyboard<\/strong><\/em>. Then select the field DATA 1<\/strong><\/em>.<\/li>
                                                                            3. Click on Key Probing and Tables<\/strong><\/em>. Repeat the steps 4 to 7 with the \u201cPress and release code\u201d for \u201cReturn\/Enter\u201d.<\/li>
                                                                            4. Check the field Interpretation<\/strong><\/em> to verify your result.<\/li><\/ol>

                                                                              \"Programming<\/a><\/p>

                                                                              1. Click on Save to btn mem\/test<\/strong><\/em> in order to temporarily store your USB module\u2019s new configurations for testing. The GUI saves the newly set configurations in your USB module\u2019s internal memory without flashing the module. This means that you can still correct and adapt the configurations.<\/li>
                                                                              2. Push the button(s) included in your USB module in order to verify your programming success.
                                                                                In the best case, the USB module opens the programme \u201cOpenOffice\u201d with 500 milliseconds delay on your computer. Otherwise you need to check your configurations, correct and save them again. Your current configurations are now listed in the Form Serial Explorer (via Show serial cmds<\/strong><\/em>) and can be viewed and modified in the serial terminal.<\/li><\/ol>

                                                                                \"Programming<\/a><\/p>

                                                                                1. Return to the main dialogue.<\/li>
                                                                                2. Click on Save to btn flash<\/strong><\/em> if you permanently want to save the new configurations in your USB module\u2019s internal flash memory. Do not immediately flash the module if you are going to change the stored configurations again.<\/li><\/ol>

                                                                                  You have successfully customized your USB module. The module now directly opens the programme OpenOffice on your computer through a push.<\/p>

                                                                                  Programming examples for the USB module\u00a0 (Windows)<\/h2>

                                                                                  In the following section, you get familiar with various user scenarios which you can simulate with a USB module. All programming examples only refer to a Windows file systems, the programming settings differ for Linux and Mac users. There are two helpful tips before you sta<\/p>

                                                                                  Helpful tips for programming your USB module<\/h3>