Workswell Wiris Pro

This section describes how to set up the Workswell Wiris Pro with Skynode. Please refer to this page for wiring instructions and this page for specifics about the Pixhawk Payload Bus.

What you will need for this step

  • Skynode Enterprise (powered as described in Power Skynode)

  • Pixhawk Payload Bus (connected as described in Pixhawk Payload Bus)

  • Microhard Air Unit (optional - connected as described in Data Link Module)

  • Workswell Wiris Pro (not included in the kit)

  • RJ45 Ethernet cable (not included in the kit)

  • Monitor with HDMI input (not included in the kit)

  • HDMI cable (not included in the kit)

  • USB keyboard (not included in the kit)

Supported features

  • Full control of the payload from AMC

    • Photo triggering

      • Can be stored in external USB drive, Wiri's internal SSD or both

    • Video recording

      • Can only be stored in Wiri's internal SSD

  • Video stream directly to AMC

  • Configurable settings

    • EO or IR video stream

    • In IR mode: various colors palettes

Update your Wiris Pro to the 1.6.42 firmware version if the camera is on an older version. All previous versions are not supported by Auterion OS. Workswell fimrware can be downloaded from here by creating an account and registering the S/N from your camera. Instructions on how to see the current version and how to update can be found in the Workswell documentation.

Setup Block Diagram

The Workswell Wiris can be interfaced with Skynode via Ethernet using the RJ45 connector on the Pixhawk Payload bus. The Microhard Air Unit module connection slightly changes the first steps of the configuration.

IP Settings with Microhard Air Unit module connected

The default Microhard DHCP server will assign an IP address in the range 192.168.168.100 - 192.168.168.200 to Skynode, therefore the IP of the Workswell Wiris should be changed to an IP outside this range, such as 192.168.168.230.

IP Settings without Microhard Air Unit module connected

In this case, there is no DHCP server that will assign an IP to Skynode, therefore you need to set a static IP, such as 192.168.168.100. Then you should anyway change the IP address of the Workswell Wiris to be in the same network as Skynode, such as 192.168.168.230.

  • Login into Skynode via SSH

  • Create the file /data/override.env

  • Add the following environment variable

AP_CONFIGURE_ETHERNET_IP=192.168.168.100

  • Reboot Skynode

Configure Skynode Environment Variables

The Wiris driver supports several environment variables that can be configured to customize the camera connection and behavior. These variables should be added to /data/override.env on Skynode.

Available Environment Variables

Variable
Description
Type

PAYLOAD_MNG_CTRL_IP_WIRIS

IP address of the Wiris camera

string

PAYLOAD_MNG_CTRL_EO_BITRATE_WIRIS

Bitrate for electro-optical (visible light) video stream in kbps

integer

PAYLOAD_MNG_CTRL_IR_BITRATE_WIRIS

Bitrate for infrared video stream in kbps

integer

PAYLOAD_MNG_CTRL_FTP_USERNAME_WIRIS

FTP username for camera file access

string

PAYLOAD_MNG_CTRL_FTP_PASSWORD_WIRIS

FTP password for camera file access

string

PAYLOAD_MNG_CTRL_USB_ONLY_WIRIS

Enable USB-only mode (set to "1" to enable)

string

Basic Configuration

At minimum, you need to configure the FTP credentials for AuterionOS to communicate with the camera. The username is always wiris-pro while the password is by default your license key. If you want to change your password, follow the steps highlighted in section Configure FTP Password.

Add the following environment variables to /data/override.env and replace the password with your actual camera password:

PAYLOAD_MNG_CTRL_FTP_USERNAME_WIRIS="wiris-pro"
PAYLOAD_MNG_CTRL_FTP_PASSWORD_WIRIS="wiris-ftp-password"

Advanced Configuration Examples

Custom IP Address

If your camera uses a different IP address:

PAYLOAD_MNG_CTRL_IP_WIRIS="192.168.1.100"

Video Bitrate Configuration

To optimize video streaming quality and bandwidth usage:

# Set EO (visible light) stream to 2 Mbps
PAYLOAD_MNG_CTRL_EO_BITRATE_WIRIS="2000"

# Set IR (thermal) stream to 1.5 Mbps
PAYLOAD_MNG_CTRL_IR_BITRATE_WIRIS="1500"

USB-Only Mode

To restrict communication to USB interface only:

PAYLOAD_MNG_CTRL_USB_ONLY_WIRIS="1"

After modifying /data/override.env, reboot Skynode for the changes to take effect.

Workswell Wiris Manual Settings

First of all, to enable the Wiris SDK over Ethernet you will need to buy an SDK license from Workswell: this will result in a license key.

To insert it, you will need to connect the camera via Ethernet to your laptop and then follow these instructions. First of all, give your laptop a static IP in the same range as the default Workswell Wiris one, for example 10.0.0.1.

Then, follow these steps:

  • Open a telnet console to the camera on port 2240. On Linux this can be done with the following command

telnet 10.0.0.230 2240

  • Now you can check if the camera is already activated with the following command

IACT

  • If the previous command returns FALSE, you will need to activate it with the following command

ACTV <ACTIVATION-CODE>

Your Workswell Wiris is now ready to be configured and then connected to Skynode.

To access the camera settings, you need to connect the Workswell Wiris to a screen via HDMI and then connect a keyboard to it via USB. Turn on the camera and follow these steps to set the IP:

  • Go to Advanced

  • Go to System

  • Change the static IP from 10.0.0.230 to 192.168.168.230

Now you can connect the camera to Skynode via Ethernet on the Pixhawk Payload Bus and Skynode will automatically detect the payload and expose video and controls in AMC.

Configure FTP Password on Camera

Connect a display via HDMI to your camera and attach a usb keyboard as well.

In the left tool strip select Advanced and navigate to Ethernet SDK Protocol

Select Save New FTP Password

Enter the new password into the dialog and confirm.

PreviousGeneric USB Webcams (UVC)NextTrillium HD40-LV

Last updated