Services

This page explains the function of each ARK-OS service.

This collection of services is referred to as ARK-OS and is installed using the ARK-OS repository. The services are installed as systemd user services and follow the XDG Base Directory Specification.

Mavlink Router

The mavlink-router service routes the MAVLink data from the Jetson USB port /dev/ttyACM0 to user defined UDP endpoints. The Jetson USB port is connected directly to the Flight Controller USB and is capable of 3Mbps.

The Jetson Micro-USB is muxed with the Flight controller USB. The Flight Controller USB connection will not work while the Micro-USB is connected.

The configuration can be edited in the ARK-UI. The default configuration is found here:

https://github.com/ARK-Electronics/ARK-OS/blob/main/platform/jetson/main.conf

---

Remote ID Transmitter

The rid-transmitter service enables compliance with Remote ID requirements as specified in ASTMF3411 by implementing the Bluetooth functionality described in ASTMF3586. It requires a network card that supports Bluetooth 5.2.

The configuration can be edited in the ARK-UI. The default configuration is found here:

https://github.com/ARK-Electronics/RemoteIDTransmitter/blob/main/config.toml

bluetooth_device = "hci0"
connection_url = "udp://:14553"
manufacturer_code = "MFR1"
serial_number = "123456789ABC"

---

Logloader

The logloader service automatically downloads the PX4 .ulg flight logs from the Flight Controller SD card after each flight. It will automatically upload the log to a locally hosted Flight Review server and optionally upload to a remotely hosted server.

The configuration can be edited in the ARK-UI. The default configuration is found here:

https://github.com/ARK-Electronics/logloader/blob/main/config.toml

connection_url = "udp://:14551"
local_server = "http://127.0.0.1:5006"
remote_server = "https://review.px4.io"
email = ""
upload_enabled = false
public_logs = false

---

Flight Review

The flight-review service is a locally hosted instance of the PX4 Flight Review web application for flight log plotting and analysis. It can be accessed at http://jetson.local/flight-review/. By default all logs downloaded by logloader will be visible on the local server.

---

DDS Agent

The dds-agent service bridges the PX4 uORB pub/sub system to ROS2 topics on the Jetson. The bridged topics are defined in PX4 Firmware and can be found here.

The dds-agent runs the micro-xrce-dds-agent on the /dev/ttyTHS1 serial port of the Jetson. This serial port is connected directly to the Flight Controller Telem2 port and is capable of 3Mbps.

The Flight Controller firmware needs to be configured by setting these parameters:

Parameter	Value	Description
UXRCE_DDS_CFG	102	TELEM 2
SER_TEL2_BAUD	3000000	3000000 8N1

For more information please see the official PX4 docs for UXRCE DDS.

---

Hotspot Updater

The hotspot-updater service configures the Jetson as a hotspot if it is unable to connect to a WiFi network after 1 minute from booting. It will create a hotspot with the name jetson-<serialnumber> with a password of password. Once connected to the hotspot you can go to http://jetson.local to connect to your local network.

---

Polaris

The polaris service provides a client interface to the Point One Polaris RTK Correction Network. This service allows you to receive network RTK corrections over the internet with an active Point One subscription. This allows you to achieve centimeter precision position hold anywhere the network is available.

The configuration can be edited in the ARK-UI. The default configuration is found here:

https://github.com/ARK-Electronics/polaris-client-mavlink/blob/main/config.toml

connection_url = "udp://:14552"
polaris_api_key = "your_api_key_goes_here"

---

RTSP Server

The rtsp-server service provides a RTSP Server for live streaming video. The server uses gstreamer and is currently only compatible with CSI cameras, for example /dev/video0. Stay tuned for future plans to support both CSI and USB cameras.

The configuration can be edited in the ARK-UI. The default configuration is found here:

https://github.com/ARK-Electronics/rtsp-server/blob/main/config.toml

[rtsp]
url = "camera1"
address = "0.0.0.0"
port = 5600

[camera]
framerate = 30
bitrate = 5000
resolution = "1920x1080"
resolution_options = ["320x240", "640x480", "1280x720", "1920x1080"]
rotation = "0"
rotation_options = ["0", "90", "180", "270"]

---

ARK UI Backend

The ark-ui-backend service is a REST API backend for the ARK-UI. It provides API endpoints for managing services, querying device information, and updating the Flight Controller firmware.

---

Jetson CAN

The jetson-can service enables the CAN interface on the Jetson.

---

System Manager

The system-manager service provides a REST API for Linux system monitoring. It exposes endpoints for querying system information such as CPU usage, memory usage, disk space, network statistics, and system health metrics.

---

Autopilot Manager

The autopilot-manager service provides a REST API for autopilot MAVLink interactions. It enables programmatic access to autopilot data and control, including reading telemetry, sending commands, and managing parameters.

---

Connection Manager

The connection-manager service provides a REST API for network connection management. It handles WiFi network scanning, connection, and configuration, as well as hotspot management and network interface control.

---

Service Manager

The service-manager service provides a REST API for systemd service management. It allows starting, stopping, enabling, and disabling systemd services, as well as querying service status and logs.