WORKSWELL WIRIS PRO User manual

WORKSWELL
WIRIS PRO
USER MANUAL
FW Version: 1.3.8
Release date: 15th December, 2020
Version: 201215 EN

Contents
1. Legal Disclaimer 4
1.1 Copyright .............................................. 4
2. Warning and Cauons 5
2.1 Warnings .............................................. 5
2.2 Nocaons............................................. 5
3. Help and FAQ 6
3.1 GeneralInstrucons......................................... 6
4. User Informaon 7
4.1 TypographicConvenons...................................... 7
4.2 HelpandSupport .......................................... 7
4.3 Updates............................................... 7
4.4 Firmware .............................................. 7
5. Revision History 8
6. Introducon 10
7. System Assembly 11
7.1 GeneralDescripon......................................... 11
7.2 HDMIMicroVideoOutput ..................................... 12
7.3 RCReceiver ............................................. 12
7.4 USBKeyboard............................................ 13
7.5 USBOn‐The‐Go ........................................... 14
7.6 SDCard ............................................... 14
7.7 PowerSupply ............................................ 15
7.8 TurningtheSystemOFF....................................... 15
7.9 FocusingtheInfraredCamera.................................... 16
7.10MounngtheSystem........................................ 17
7.11InputInterfaces........................................... 18
8. Digital Inputs 19
8.1 S.BUSInput ............................................. 19
8.1.1 S.BUS through Amimon Connex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
8.1.2 S.BUS through DJI Lightbridge 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
8.2 TriggerSignal ............................................ 22
9. GPS and MAVLink 23
9.1 GPS ................................................. 24
9.2 MAVLink............................................... 25
10. DJI Drones and CAN Bus 27
10.1SystemConnecon ......................................... 27
1

10.2SystemControl ........................................... 27
11. Digital Output 29
12. System Appearance 30
12.1Layouts ............................................... 33
12.1.1 Inspecon.......................................... 33
12.1.2 Security........................................... 33
12.1.3 Fullscreen.......................................... 34
12.1.4 PiPFusion.......................................... 35
13. Main Menu (Sengs) 36
13.1GeneralDescripon......................................... 36
13.2Range ................................................ 37
13.3Funcons .............................................. 39
13.4Capture ............................................... 40
13.5Palee................................................ 41
13.6Measure............................................... 42
13.7Advanced .............................................. 44
13.7.1 ThermalCamera ...................................... 45
13.7.2 VisibleCamera ....................................... 46
13.7.3 Layout............................................ 48
13.7.4 Images&Video....................................... 50
13.7.5 Alarms ........................................... 51
13.7.6 CommunicaonInterface.................................. 52
13.7.7 Memory........................................... 53
13.7.8 System ........................................... 54
13.7.9 Info ............................................. 55
14. Images and Video 56
14.1Images................................................ 56
14.1.1 RadiometricJPEG...................................... 56
14.1.2 RadiometricTIFF ...................................... 56
14.1.3 ScreenshotJPEG ...................................... 57
14.1.4 IRSuper‐ResoluonJPEG.................................. 57
14.1.5 VisibleJPEG......................................... 58
14.2Video ................................................ 58
14.2.1 Thermal Radiometric Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
14.2.2 Thermal Nonradiometric Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
14.2.3 Visible............................................ 58
15. Data Transfer and Memory Manipulaon 59
15.1ApplicaonMenu.......................................... 59
15.1.1 FormangMemory .................................... 61
15.2MassStorage(USBOTG) ...................................... 62
16. Firmware Update 63
2

16.1FirmwareUpdateProcess...................................... 63
17. Workswell CorePlayer 64
17.1GeneralDescripon......................................... 64
18. Environmental Condions 65
18.1EnvironmentalCondions...................................... 65
19. Infrared Camera Behavior 66
19.1InfraredCameraWarm‐Up ..................................... 66
19.2 Non‐Uniformity Correcon (NUC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
19.3CameraCalibraon ......................................... 67
20. Maintanance 68
20.1 Cleaning the WIRIS Head and Cables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
20.2CleaningtheInfraredLens ..................................... 69
21. Troubleshoong 70
21.1TurningON ............................................. 70
21.2Resetbuon............................................. 70
21.3SafeMode.............................................. 71
21.4ResettoFactoryDefault....................................... 72
21.5RemoteControl........................................... 72
21.6SystemUpdate ........................................... 72
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
3

1. LEGAL DISCLAIMER
1 Legal Disclaimer
All products (soware, hardware or rmware) manufactured by Workswell s.r.o. are warranted against defecve
materials and workmanship for a period of twelve (12) months, provided such products have been under normal
storage and use in accordance with herein instrucons.
The warranty extends only to the original purchaser and is not transferable. It is not applicable to any product
which has been subjected to misuse, neglect, accident or abnormal condions of operaon.
In the case of a defect in a product covered by this warranty the product must not be further used in order to
prevent addional damage. The purchaser shall promptly report any defect to Workswell s.r.o. or its authorized
distributor or this warranty will not apply.
Workswell s.r.o. will, at its opon, repair or replace any such defecve product free of charge if, upon inspecon,
it proves to be defecve in material or workmanship and provided that it is returned to Workswell within the
said twelve‐month period.
Nobody but Workswell s.r.o. is allowed to open or modify such product.
Workswell s.r.o. has no other obligaon or liability for defects than those set forth above. No other warranty
is expressed or implied. Workswell s.r.o. shall not be liable for any direct, indirect, special, incidental or conse‐
quenal loss or damage, whether based on contract, tort or any other legal theory.
1.1 Copyright
© Workswell s.r.o. All rights reserved worldwide. No parts of the soware including source code may be re‐
produced, transmied, transcribed or translated into any language or computer language in any form or by any
means, electronic, magnec, opcal, manual or otherwise, without the prior wrien permission of Workswell
s.r.o.
Names and marks appearing on the products herein are either registered trademarks or trademarks of Workswell
s.r.o. All other trademarks, trade names or company names referenced herein are used for idencaon only
and are the property of their respecve owners.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
4

2. WARNING AND CAUTIONS
2 Warning and Cauons
2.1 Warnings
Before using the product, please read the whole User Manual. Before power‐up the camera or drone, please
check that there is no visible damage or malfuncon, cables are connected properly and verify the polarity is
correct.
If there are any visible signs of damage or other defect on the device, or you are not sure with the connecon,
then on no account should it be installed or put into operaon.
Any interference and non‐cered service operaons into the product leads to an automac loss of warranty.
2.2 Nocaons
Do not use or store the device in conict with the storage and operang condions laid down in this manual
(only for hardware).
Do not point the infrared camera (with or without the lens cover) at strong energy sources, for example,
devices that cause laser radiaon, or the sun. This can have an unwanted eect on the accuracy of the
camera. It can also cause damage to the detector in the camera.
Plug the camera to its own power source. Do not plug the camera into the same power source as drone’s
motors.
Use original accessories only.
Do not plug any power to the GPS/Mavlink power pin.
Do not use the Workswell WIRIS Pro system in temperatures higher than +50◦C (+122◦F). High tempera‐
tures can cause damage to the camera.
Do not use the Workswell WIRIS Pro system in temperatures lower than ‐10◦C (+5◦F). Low temperatures
can cause damage to the camera.
Do not use the Workswell WIRIS Pro in environmental condions that make condensaon possible (make
sure the air is non‐condensing)
Do not apply solvents or equivalent liquids to the cameras, the cables, or other items. Damage to the items
can occur. For cleaning refer to chapter 20.
Be careful when you clean the infrared lens. The lens has an an‐reecve coang which is easily damaged.
Do not use too much force to clean the infrared lens. This can cause damage to the an‐reecve coang.
The encapsulaon rang is only applicable when all the openings on the all components of the system are
sealed with their correct covers, hatches, or caps.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
5

3. HELP AND FAQ
3 Help and FAQ
3.1 General Instrucons
While looking for a soluon of any technical problem we recommend following these steps:
try to nd an answer by searching this User Manual
contact your dealer
log in and send an email on support.workswell.eu
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
6

4. USER INFORMATION
4 User Informaon
4.1 Typographic Convenons
Following typographic convenons are used in this User Manual:
UPPER CASE is used for the names of keys, buons and menu items
COURIER is used for lenames and paths
Italic is used for important informaon and document names
bold is used for the links to other secons, for funcon names or Internet sites
4.2 Help and Support
For technical quesons that were not answered in this User Manual feel free to contact your dealer or visit the
product website at www.drone‐thermal‐camera.com, or log in and send an email on support.workswell.eu.
4.3 Updates
The primary aim of Workswell s.r.o. company is to supply their products in a way that meets the current needs of
its users and at the same me to remove all the weaknesses that were found in their use as quickly as possible.
For this reason, Workswell s.r.o. regularly releases updates for all their products.
Visit hps://www.workswell‐thermal‐camera.com/rmware‐update/ to download the latest rmware release.
The update process itself is described in a later secon.
4.4 Firmware
Firmware is the „internal“ control program of the device. From the user’s point of view, only the ocial rmware
released by Workswell s.r.o. company can be used for update of the device.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
7

5. REVISION HISTORY
5 Revision History
0.1.0
inial dra
0.9.9
preliminary release version
1.0.0
TIFF calculaon formula repaired.
1.1.0
Added and adjusted for slight changes in FW v.1.1.0 funcon interface
Added deeper insight into the Super‐Resoluon funconality
Correcons
1.2.0
Updated with current interface images.
Added Geofencing funcon.
1.2.1
Added new keyboard control possibilies
Changed trigger behaviour
1.3.0
Added a menon about digital outputs.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
8

5. REVISION HISTORY
1.3.1
Added informaon forbidding formang of the SSD via USB OTG.
1.3.2
Added warning about formang of the SSD via USB OTG into chapter USB On‐The‐Go.
201215
Added new support contact and version numbering.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
9

6. INTRODUCTION
6 Introducon
Workswell WIRIS Pro is the thermal imaging system for unmanned aerial vehicles (UAVs, drones). It is a lightweight
all‐in‐one system equipped with a thermal imaging camera and a visible spectrum camera. The purpose of the
whole system is the simple capture, transfer, storage and processing of radiometric (temperature) data directly
from an unmanned aerial vehicle (drone) and display of the data on the screen of the UAV remote controller in
real me. The system also oers a variety of measurement funcons, colour palees or alarm (security) modes,
which can be combined with a visible spectrum camera.
Figure 6.1: Workswell WIRIS Pro connected to a standard FPV monitor (monitor not included)
Workswell WIRIS Pro is designed in a way which allows control of all of its funcons during the ight. The system
has digital inputs, which are fully compable with standard RC receivers that support S.BUS. Two channels serve
as navigaon buons in the menu, the rest are shortcuts for the selected funcons (image capturing, video
recording, palee switching, zoom and others).
The system oers a digital video output. Both visible and thermal spectrum images can be displayed on the
screen at the same me.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
10

7. SYSTEM ASSEMBLY
7 System Assembly
7.1 General Descripon
Follow these steps to prepare the system:
1) Connect the system to a wire‐
less video link or a display using
HDMI micro cable (included).
2) Connect the system to a stan‐
dard RC receiver using S.BUS. Use
channels 1 and 2 to control the
main funcons. System can also
be controlled via USB keyboard.
3) Connect the power supply
using power supply cable (in‐
cluded). Red wire is +9 to +36
VDC, black wire is GND.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
11

7. SYSTEM ASSEMBLY
7.2 HDMI Micro Video Output
The Workswell WIRIS system is equipped with a standard HDMI micro video output. It can be connected to any
wireless video link or a display with HDMI input that supports WIRIS Pro resoluon.
The default WIRIS Pro resoluon 1280x720 (also called HD or 720p). It is recommended to use a display with
16:9 aspect rao.
Figure 7.3: Connex wireless video link and DJI Lightbridge (not included)
The system can be connected to a wireless video link or a display using supplied lightweight HDMI cable.
7.3 RC Receiver
For interfacing with standard RC receivers, WIRIS Pro is equipped with a S.BUS input. The S.BUS input, commu‐
nicang control of mulple servo inputs, allows user to control the system remotely during the ight.
The rst two virtual channels on the S.BUS funcon as primary direconal controls within the menus and allow
for complete control over the device. The addional channels allow binding of funcon shortcuts which provide
quick, customizable access to various funcons; capture trigger, mode change and so forth.
It is recommended to use a joysck for navigaon in system menu. If connected as recommended, then the
behavior of the joysck is as shown on the following image.
Digital Input Funcon
1 Up/Down
2 OK/Cancel
3‐4 Oponal (shorcuts)
More informaon about digital inputs can be found in secon 8 Digital IO Ports.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
12

7. SYSTEM ASSEMBLY
7.4 USB Keyboard
Besides the digital inputs, the Workswell WIRIS Pro system can be controlled also via standard USB keyboard.
Once the keyboard is connected, it can be used for navigaon in system menu, for image capturing, video record‐
ing, mode switching, zoom or seng numerical values.
Figure 7.4: Connecng a generic USB keyboard.
Warning: Do NOT connect WIRIS Pro to any other powered device (such as PC) through the full size USB
port on the rear of WIRIS Pro. As the rear USB port is powered, connecon to another powered USB port
can lead to permanent damage to either device. Only unpowered devices (USB Keyboards and USB Flash
Storage drives) are to be connected into the rear USB A port of WIRIS Pro.
The following table shows the behavior of connected keyboard.
Key Funcon
Up Up
Down Down
Right OK/Menu
Le Cancel
Enter OK/Menu
Escape Cancel
F5 Camera switch
F6 Image capture
F7 Video record
+ Zoom in
‐ Zoom out
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
13

7. SYSTEM ASSEMBLY
7.5 USB On‐The‐Go
The Workswell WIRIS Pro’s internal SSD memory can be accessed directly using an USB On‐The‐Go connecon
between with any system capable of correctly accessing the standard USB mass storage such as a PC with MS
Windows or GNU/Linux.
To connect to the internal memory, use a standard USB Micro B connector cable and plug it into the connector
in the side of WIRIS Pro.
If communicaon is successfully established, most modern operang systems will automacally report presence
of a mass storage device and allow access to the data.
Figure 7.5: Connecng WIRIS Pro using USB On‐The‐Go
Warning: Do NOT connect WIRIS Pro to any other powered device (such as PC) through the full size USB
port on the rear of WIRIS Pro ‐ only the side Micro USB port can be used for mass storage access. As the
rear USB port is powered, connecon to another powered USB port can lead to permanent damage to
either device.
Warning: Do NOT format the SSD of the camera as a device connected to the PC via USB OTG! Formang
the SSD in this manner will void the warranty and the camera will need to be sent for repair. Use only the
rmware GUI of the camera to format the SSD, while the camera is not connected to any other device.
7.6 SD Card
The Workswell WIRIS Pro can be oponally ed with a MicroSD memory card as a storage medium. Most
generic MicroSD cards should be compable. Video recordings cannot be saved directly to the MicroSD card and
have to be recorded only to internal storage (but can be moved over to the MicroSD o‐line within the device
itself).
To install the MicroSD card simply insert it into the MicroSD slot on le side of the device. Be mindful of the
SDCard orientaon; contacts should be facing upwards.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
14

7. SYSTEM ASSEMBLY
Figure 7.6: MicroSD memory card inseron.
The MicroSD card should be recognized by the device even if inserted with the system already running. The
MicroSD card should only be removed with the device either unpowered, or aer the SD card is manually un‐
mounted in the Memory menu.
7.7 Power Supply
The Workswell WIRIS Pro system can be powered through a +9 to +36 VDC connector on the back panel. The
back panel DC connector is compable with a 5.5 mm/OD (outer diameter) and 2.5 mm/ID (inner diameter) plug,
where the inner contact is +9 to +36 VDC and the shell is GND.
Figure 7.7: Inner power pinout, form of the common cable.
The standard package contains appropriate 5.5x2.5mm coaxial connector with a cable (length of 80 cm).
Warning: Failure to follow these instrucons could damage the system
7.8 Turning the System OFF
To turn the system o, simply unplug the power supply.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
15

7. SYSTEM ASSEMBLY
7.9 Focusing the Infrared Camera
The infrared camera has adjustable focus. The focus can be set using the focus tool. Note that the depicted focus
tool is not part of standard accessories and is sold separately.
Warning: The WIRIS Pro camera is focused to innity during manufacturing and in most cases should
never need adjustments. Considering the delicate nature of the opcs it is beer to not aempt removal
of protecve glass or adjustment of the focus lens unless absolutely necessary.
Figure 7.8: Two funcons of the new focus tool; rst, removing the protecve glass, then focusing the lens.
Figure 7.9: Short distance ‐ rotate the lens counter‐clockwise. Long distance ‐ rotate the lens clockwise
In order to focus for short distance gently rotate the lens counter‐clockwise. During this movement, the lens
extends from the camera body.
Warning: Trying to rotate the lens too far much may cause the lens to fall out.
In order to focus on long distance (or innity) gently rotate the lens clockwise. During this movement, the lens
retracts to the camera body. Rotang the lens too far in this direcon can adjust beyond the intended focus
range. Innity focus is recommended for most of the applicaons.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
16

7. SYSTEM ASSEMBLY
7.10 Mounng the System
The Workswell WIRIS Pro system can be mounted to a drone using the 1/4‐20 UNC thread (one on boom or
one on back side).
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
17

7. SYSTEM ASSEMBLY
7.11 Input Interfaces
The device’s input ports are all interfaced through one shared connector in the rear, with a cable split to an SBUS,
CAN, GPS and Trigger connectors.
Figure 7.10: The shared input cable.
Figure 7.11: The input cable pinout descripon.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
18

8. DIGITAL INPUTS
8 Digital Inputs
8.1 S.BUS Input
The S.BUS input port can be used. It is a standard used for Futaba RC controllers. Only the rst version of S.BUS
is supported.
Mechanically, a common servo‐wire like 3 pin jumper cable connector is used for S.BUS.
Figure 8.1: S.BUS pinout ‐ 3 pin servo cable.
Pin Descripon
1 GND
2 VCC 5V out
3 S.BUS in
Warning: The +5V wire on the S.BUS input is intended for powering otherwise unpowered transceivers
and converters from WIRIS Pro. If your transceiver or convertor is powered otherwise, do NOT connect
the +5V wires and leave them unconnected instead, only connecng the GND and S.BUS pins. If the +5V
wires are connected, damage of either device might occur.
S.BUS allows transmission of many servo‐like channel PWM signals through a simple three pin connecon. The
device is compable with S.BUS enabled receivers and converters such as the Futaba SBE‐1 PWM‐S.BUS con‐
verter.
E‐mail and Web
[e-mail]
www.workswell.eu
Mobile:
[phone]
ID:
Reg. No.: 29048575
VAT No.: CZ29048575
Headquarters
U Albrechtova vrchu 12
155 00, Prague 13
Czech Republic
Version: 201215 EN, 15th Dec, 2020
All pictures are only for illustraon.
Real values may vary.
19