Skip to content

Connecting

KH Control connects to a MAVLink source over a network link. The connection is shared across all actions and can be configured the Connection tab of any action.

Connection settings

Four connection types are supported. Once the settings are entered, press Connect or Disconnect to open or close a connection. If the connection fails to open double check the settings have been entered correctly and the remote side is active.

TypeDescription
WebSocketConnects to a WebSocket server.
TCPConnects to a TCP server.
UDPListens for incoming UDP packets on a given port.
UDP ClientSends UDP packets to a address and port.
Address

The IP address or hostname of the MAVLink source. Not required for UDP, which listens for incoming connections.

Port

The port number of the connection.

Signing key

If your MAVLink setup uses packet signing, enter the signing key here. Leave blank to disable signing. More information on signing can be found in the MAVLink Guide.

Connection action

The Connection action provides dedicated connect and disconnect buttons on the Stream Deck. This is useful for quickly switching connections, without having to open the action settings. The action will feedback if its connection is active.

Connect: global settings

Connects using the settings configured in the Connection tab. Use this for a simple connect button.

StateDisplayDescription
Not connectedKH Control is not connected.
ConnectedKH Control is connected using the global settings.

Connect: custom settings

Connects using connection details configured on the action itself. This allows different buttons to connect to different MAVLink sources. The Display text field labels the button so it is easy to identify on the Stream Deck. The settings are the same as the those for the global connection. Custom text can be added to give a more memorable name to the connection.

StateDisplayDescription
Not connectedKH Control is not connected.
ConnectedKH Control is connected to the custom connection.

TIP

Use multiple Connection actions with custom settings to switch quickly between vehicles or ground station configurations.

Alert

If a connection action shows an alert after being pressed, check that the connection settings are correct and that the remote endpoint is active.

StateDisplay
Alert - check connection

Disconnect

Closes the current connection.

StateDisplay
Disconnect

Common connections

Listed below are some common connection types that might be useful.

DescriptionTypeAddressPort
Mission Planner WebSocket. This is always active for easy connection via Mission Planner.WebSocket127.0.0.15762
Common TCP, SITLTCP127.0.0.15760
Common UDP, MAVProxy, HerelinkUDP14550