Install wb-config tool

Summary

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.

wb-config main menu v1.0.0

Installation & Running

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:

curl -sL https://gitlab.com/wingbits/config/-/raw/master/wb-config/install.sh | sudo bash

Once run, you should see output on the screen stating it has been downloaded and how to run it:

sudo wb-config

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.

Features

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).

Getting around in the tool

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.

Issues

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.