Install wb-config tool
Last updated
Last updated
Wingbits has created a menu driven general configuration tool for BYOD adsb stations, with specific features focused on the Wingbits project and maintaining your station. Our goal is to take all the commands people run more frequently and provide a single interface, so there is less typing and command reference lookups. The same holds true with regards to support-related features, where we can streamline the entire process from after opening a ticket to getting resolution for your issue, by having you leverage the tool.
As of Sept 10, 2024: wb-config is automatically installed/updated during daily software sync of the station at 6pm localtime. You will not need to install with the below command, unless you setup your station today and need wb-config before 6pm your local time.
To install the latest version of wb-config, run the following on your device through an ssh session:
Once run, you should see output on the screen stating it has been downloaded and how to run it:
For best results, run on a PC or Mac using an ssh client (termius/putty/cmd/terminal) and maximize the window. Smaller screens may work but limit the amount of visible data for logs and similar output. Mobile SSH clients may or may not properly display menus.
This tool can be used for configuration tasks such as:
Set/update location
Change SDR gain for readsb
Update the station ID
Quallity of life (QOL) options - such as dark/light mode for graphs1090, add/remove route info from tar1090, and enable/disable heatmap data for tar1090
Or other operations/support tasks such as:
Restarting services (vector/readsb/tar1090)
Restarting or shutting down the device itself
Running the Wingbits debug script
View/upload logs from services or installation (upload requires installation of netcat, which can be done via the tool as well in the same menu).
This tool is based on an infrastructure that provides a TUI (text-based user inferface) within terminal based system. Basically, that means you get a text based menuing system that looks like it is from an 80s or 90s movie. Because that does not allow for mouse input, everything is controlled by keyboard. Don't worry, you will get used it it pretty quick as there are only a few controls.
| Keyboard Key | Usage |
|---|---|
Up Arrow | Move up menu item, up a selection list, or scroll up on long output line by line. |
Down Arrow | Move down menu item, down a selection list, or scroll down on long output line by line |
PDUP / PGDN | Faster scrolling (by page) either up or down on long output. |
SPACEBAR | Select current item in a selection window with multiple options (such as a listing of gain values) |
TAB | Cycle focus between menus and buttons (yes/no, ok/back, or between the menu and those options). Typically followed by hitting ENTER or SPACE to select/confirm. |
ENTER | Select highlighted menu itme (like left mouse clicking in windows on the focused item). |
ESC | Back out of the current menu/screen. If on the main menu, exit to shell. |
Sometimes SPACEBAR and ENTER can be used interchangeably based on the screen and context... just to add more spice to your journey.
Please post in discord if you have any feedback, issues, or suggestions related to the tool.
Current known issues:
Log-related output windows are not sizing dynamically based on terminal size - if you have a lot of screen real estate, it should be wider and show more lines.
When running longer commands (uploading all recent logs), the delay before showing the next screen can be quite long (which presents as you seeing the shell during that time). This happens between every screen when an action is chosen, but might be confusing when first encountered on an action that takes more than a second.
