workswell wirisethernetstream sdk€¦ · workswell wirisethernetstream sdk usermanual fwversion:...

44
WORKSWELL WIRIS Ethernet Stream SDK USER MANUAL FW Version: 1.1.1 Release date: 11 th September, 2019 Revision : 1.1 EN

Upload: others

Post on 13-Jun-2020

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

WORKSWELLWIRIS Ethernet Stream

SDK

USER MANUAL

FW Version: 1.1.1

Release date: 11th September, 2019

Revision : 1.1 EN

Page 2: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

Contents

1. User Informa on 61.1 Typographic Conven ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.2 Help and Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.3 Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61.4 Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2. Revision history 7

3. Overview 83.1 Basic Informa on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.2 Ac va ng the SDK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83.3 Example Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.4 WIRIS IP Address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93.5 Ge ng Help and Sugges ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

4. Communica on protocol descrip on 104.1 Commands - Basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4.1.1 Set commands delimiter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.1.2 Get commands delimiter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.1.3 Check connec on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.1.4 Get WIRIS serial number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.1.5 Get WIRIS ar cle number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.1.6 Get WIRIS version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.1.7 Get CPU temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.1.8 Get thermal camera temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.1.9 Get device temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.2 Commands - Ac va on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.2.1 Ac vate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124.2.2 Is ac vated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.3 Commands - Ethernet Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.3.1 Set Ethernet Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134.3.2 Get Ethernet Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

4.4 GPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.4.1 Set thermo range to high . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4.5 Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.5.1 Get range mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.5.2 Set range mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144.5.3 Get manual range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154.5.4 Set manual range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154.5.5 Get span range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154.5.6 Set span range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154.5.7 Get environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154.5.8 Get list of environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164.5.9 Set environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

1

Page 3: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4.6 WWS Thermal Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164.6.1 Get me stabiliza on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164.6.2 Set me stabiliza on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164.6.3 Get hot rejec on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174.6.4 Set hot rejec on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174.6.5 Get cold rejec on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174.6.6 Set cold rejec on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.7 Zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174.7.1 Get thermal camera zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174.7.2 Get list of thermal camera zooms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.7.3 Set thermal camera zoom index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.7.4 Get visible camera zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.7.5 Get list of visible camera zooms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184.7.6 Set visible camera zoom index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.8 Pale es of thermal video stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.8.1 Get pale e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.8.2 Get pale e list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194.8.3 Set pale e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.9 Capture and record . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.9.1 Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.9.2 Is capturing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.9.3 Recording start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.9.4 Recording finish . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204.9.5 Is recording . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

4.10 Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.10.1 Get alarm mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.10.2 Set alarm mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.10.3 Get alarm values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.10.4 Set alarm values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214.10.5 Get alarm colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.10.6 Set alarm colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

4.11 Thermal camera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.11.1 Get emissivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.11.2 Set emissivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224.11.3 Get shu er period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.11.4 Set shu er period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.11.5 Get synchronous shu er se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.11.6 Set synchronous shu er se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234.11.7 Perform thermal camera shu er . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244.11.8 Get seconds to next thermal camera shu er . . . . . . . . . . . . . . . . . . . . . . . 244.11.9 Get seconds from last thermal camera shu er . . . . . . . . . . . . . . . . . . . . . . 24

4.12 Image and video se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244.12.1 Get radiometric JPEG image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244.12.2 Get radiometric TIFF image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254.12.3 Get super-resolu on image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254.12.4 Get visible image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

2

Page 4: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4.12.5 Get radiometric video se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254.12.6 Get visible video se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254.12.7 Set radiometric JPEG image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.12.8 Set radiometric TIFF image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.12.9 Set super-resolu on image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.12.10 Set visible image se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264.12.11 Set radiometric video se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274.12.12 Set visible video se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274.12.13Get image loca on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274.12.14 Set image loca on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

4.13 Date and Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.13.1 Get date and me . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.13.2 Set date and me . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

4.14 Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.14.1 Get memory status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.14.2 Get memory size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284.14.3 Get memory free . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.14.4 Get captured images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.14.5 Get recorded thermal video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 294.14.6 Get recorded visible video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

4.15 Stream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.15.1 Get thermal camera resolu on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.15.2 Get thermal extremes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304.15.3 Get pale e values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

4.16 System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314.16.1 Default se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314.16.2 Shut down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314.16.3 Reboot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

5. RTSP Video Server 325.1 GStreamer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325.2 VLC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325.3 FFmpeg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

6. FTP data access 376.1 FTP connec on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376.2 Restric ons and warnings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376.3 So ware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

7. WIRIS Ethernet Stream SDK GUI Applica on 397.1 Introduc on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

7.1.1 Installa on . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397.1.2 First launch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397.1.3 Startup default se ngs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

7.2 Main Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407.3 Main menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

3

Page 5: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

7.3.1 Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407.3.2 Func ons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417.3.3 Pale es . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417.3.4 Capture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417.3.5 Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417.3.6 Advanced . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

7.4 Quick Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427.5 Inspec on Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427.6 Secondary Stream window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437.7 WIRIS Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

4

Page 6: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

1. USER INFORMATION

1 User Informa on

1.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 filenames 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

1.2 Help and Support

For technical ques ons that were not answered in this User Manual feel free to contact your dealer or visit theproduct website at www.drone-thermal-camera.com, or send an email on [email protected].

1.3 Updates

The primary aim of Workswell s.r.o. company is to supply their products in a way that meets the current needsof its users and at the same me to remove all the weaknesses that were found in their use as quickly possible.For this reason, Workswell s.r.o. regularly releases updates for all their products.

Visit h ps://www.workswell-thermal-camera.com/firmware-update/ to download the latest firmware release.The update process itself is described in a later sec on.

1.4 Firmware

Firmware is the „internal“ control program of the device. From the user’s point of view, only the official firmwarereleased by Workswell s.r.o. company can be used for update of the device.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

5

Page 7: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

2. REVISION HISTORY

2 Revision history

1.0

Ini al release

1.1

Added shu er se ngs

Added alarm color se ngs

Added Hot and Cold Rejec on for WWS

New chapter for GUI Applica on

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

6

Page 8: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

3. OVERVIEW

3 Overview

This chapter includes basic informa on about the WIRIS Ethernet SDK.

3.1 Basic Informa on

Ethernet SDK is intended to stream video from WIRIS device and to control it over Ethernet connec on. It re-places the HDMI output and RC transceiver input.

The SDK is currently compa ble with two models of WIRIS:

WIRIS PRO (WWP)

WIRIS SECURITY (WWS)

Differences between models will be noted.

Figure 3.1 – Supported devices.

The WIRIS runs a TCP/IP server for the control. It can be controlled with simple text commands. The openedserver is similar to telnet protocol and can be used with telnet terminal so ware.

The WIRIS also runs RTSP server for streaming the visible and thermal video. it can be viewed with GStreamer,FFmpeg, VLC or other so ware capable of opening RTSP streams.

Lastly, the FTP server is opened for data management.

Please note that the simultaneous usage of HDMI output, keyboard and RC controller with the Ethernet SDK isnot possible.

3.2 Ac va ng the SDK

The SDK in the WIRIS device needs to be ac vated. It is not free of charge. Please contact the sales support formore informa on.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

7

Page 9: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

3. OVERVIEW

It can be ac vated with license code using TCP/IP server command.

3.3 Example Library

We have prepared simple open-source example library for the TCP/IP communica on.

It is cross-pla orm (Linux, Windows or Mac) and uses the Boost ASIO library.

Current version of the example library can be downloaded from the Workswell website.

3.4 WIRIS IP Address

The default WIRIS IP Address is 10.0.0.230 and the default mask is 255.255.255.0.

These values can be changed in Advanced System Menu.

3.5 Ge ng Help and Sugges ons

The WIRIS Ethernet SDK was created as stable and robust as possible. S ll, if you find any bugs, inconveniencesor if you have any sugges ons for improvement, please contact us at [email protected].

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

8

Page 10: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4 Communica on protocol descrip on

This chapter contains informa on about the TCP/IP communica on protocol and commands.

The server descrip on:

Port 2240

Text-based communica on protocol

Can be connected to with telnet so ware

Each command received by the server is at least acknowledged

The commands are case sensi ve, the server responses are always in upper case

All temperatures are in degrees Celsius

The most common responses are OK in case of success and ERR in case of error. When parameters are given orreturned, they are separated by one space.

Parameter Value

Protocol TCP

Port number 2240

Table 4.1 – Protocol parameters

4.1 Commands - Basic

Hereby the commands for controlling the WIRIS device follow. The basic commands can be used without theEthernet SDK ac va on.

4.1.1 Set commands delimiter

Set the delimiter for command messages. This delimiter is used for detec ng the end of a command. Defaultvalue is LINE for the ’\n’ character. It can be changed to NULL for the ’\0’ character.

The LINE is used for telnet, the NULL is be er for so ware development.

Command

• SDLM NULL

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

9

Page 11: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.1.2 Get commands delimiter

Returns the current commands delimiter.

Command

• GDLM

Answer

• LINE or NULL

4.1.3 Check connec on

Command used for checking the connec on.

Command

• HIWS

Answer

• OK

4.1.4 Get WIRIS serial number

Returns WIRIS device serial number.

Command

• GSRN

Answer

• ABC-DEF123

4.1.5 Get WIRIS ar cle number

Returns WIRIS device serial number.

Command

• GATN

Answer

• ABC-DEF123

4.1.6 Get WIRIS version

Returns WIRIS firmware version.

Command

• GFWV

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

10

Page 12: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Answer

• 1.2.3

4.1.7 Get CPU temperature

Returns WIRIS device internal temperature.

Command

• GTCU

Answer

• 32.10

4.1.8 Get thermal camera temperature

Returns WIRIS thermal camera core temperature.

Command

• GTIC

Answer

• 32.10

4.1.9 Get device temperature

Returns WIRIS internal device temperature.

Command

• GTIN

Answer

• 32.10

4.2 Commands - Ac va on

All the following commands are inaccessible unless the Ethernet SDK is ac vated for the given WIRIS camera.

The ac va on needs to be done once per device. A er the ac va on, the WIRIS saves the ac va on code anddoes not need to be ac vated again.

4.2.1 Ac vate

To ac vate the device, send the license number with following command.

Command

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

11

Page 13: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

• ACTV ACTIVATION-NUMBER-123

Answer

• OK

4.2.2 Is ac vated

Check if WIRIS is ac vated.

Command

• IACT

Answer

• TRUE or FALSE

4.3 Commands - Ethernet Mode

This command will start or stop the Ethernet Mode. In Ethernet Mode mode, WIRIS will stop streaming camerasto HDMI. The RTSP server is started.

Please note that all the following commands can be used without the Ethernet Mode, but it is highly recom-mended to exclude the combina on of Ethernet set commands and the usage of RC or keyboard.

4.3.1 Set Ethernet Mode

Sets the Ethernet Mode ON or OFF with TRUE or FALSE.

Command

• SETH TRUE

Answer

• OK

4.3.2 Get Ethernet Mode

Returns if the Ethernet Mode is ac ve.

Command

• GETH

Answer

• TRUE or FALSE

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

12

Page 14: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.4 GPS

4.4.1 Set thermo range to high

Get the current GPS coordinates as long as it is provided to the camera; it relies on external source. Returns ei-ther N/Awhen GPS is not connected, INVALIDwhen GPS data is not valid or the coordinates in following format:LATITUDE 14.4444 SLONGITUDE 57.5555 WAlLTITUDE 156.156

Command

• GGPS

Answer

• INVALID, N/A or coordinates

4.5 Range

Please refer to the WWP User Guide for more indepth explana on of these parameters.

Range se ngs is available only for WWP.

4.5.1 Get range mode

Returns the current range mode.

Command

• GRMD

Answer

• AUTOMATIC, MANUAL or SPAN

4.5.2 Set range mode

Sets the thermal range mode to AUTOMATIC, MANUAL or SPAN.

Command

• SRMD AUTOMATIC

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

13

Page 15: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.5.3 Get manual range

Returns the currently set manual thermal range minimum and maximum.

Command

• GRMM

Answer

• 20.0 40.0

4.5.4 Set manual range

Sets the thermal manual range minimum and maximum

Command

• SRMM 20.0 40.0

Answer

• OK

4.5.5 Get span range

Returns the current span range window and center.

Command

• GRWC

Answer

• 10.0 30.0

4.5.6 Set span range

Sets the manual range window and center

Command

• SRWC 10.0 30.0

Answer

• OK

4.5.7 Get environment

Returns current thermal environment (absolute temperature range) se ng.

Command

• GREN

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

14

Page 16: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Answer

• -25.0 150.0

4.5.8 Get list of environments

Returns the list of available thermal environments. Each line is one environment.

Command

• GREL

4.5.9 Set environment

Sets the environment se ngs. Use just the maximum value of the range. This command can take up to 10seconds to perform.

Command

• SREN 150.0

Answer

• OK

4.6 WWS Thermal Parameters

Specific parameters for WWS thermal camera.

4.6.1 Get me stabiliza on

Returns thermal camera me stabiliza on in seconds.

Command

• GTST

Answer

• 2.4

4.6.2 Set me stabiliza on

Sets thermal camera me stabiliza on in seconds.

Command

• STST 2.4

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

15

Page 17: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.6.3 Get hot rejec on

Returns hot rejec on in percent.

Command

• GHRJ

Answer

• 2.4

4.6.4 Set hot rejec on

Sets hot rejec on in percent.

Command

• SHRJ 2.4

Answer

• OK

4.6.5 Get cold rejec on

Returns cold rejec on in percent.

Command

• GCRJ

Answer

• 2.4

4.6.6 Set cold rejec on

Sets cold rejec on in percent.

Command

• SCRJ 2.4

Answer

• OK

4.7 Zoom

4.7.1 Get thermal camera zoom

Returns thermal camera zoom ra o.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

16

Page 18: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Command

• GZTV

Answer

• 2.5

4.7.2 Get list of thermal camera zooms

Get list of all available zooms of thermal camera. Each line has index number and zoom ra o value.

Command

• GZTL

Answer

• 0 1.0

• 1 2.0

• ...

4.7.3 Set thermal camera zoom index

Sets the thermal camera zoom index number.

Thermal camera has only digital zoom, so the stream is not inflicted by the zoom value. The zoom changes thearea where maximum and minimum values are looked for.

Command

• SZTN 1

Answer

• OK

4.7.4 Get visible camera zoom

Returns visible camera zoom ra o.

Command

• GZVV

Answer

• 2.5

4.7.5 Get list of visible camera zooms

Get list of all available zooms of visible camera. Each line has index number and zoom ra o value.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

17

Page 19: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Command

• GZVL

Answer

• 0 1.0

• 1 2.0

• ...

4.7.6 Set visible camera zoom index

Sets the visible camera zoom index number.

Command

• SZVN 1

Answer

• OK

4.8 Pale es of thermal video stream

4.8.1 Get pale e

Returns current pale e name.

Command

• GPTE

Answer

• GRAY

4.8.2 Get pale e list

Returns all the available pale es. Each line is one pale e name.

Command

• GPTL

4.8.3 Set pale e

Set pale e by name.

Command

• SPTE GRAY

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

18

Page 20: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.9 Capture and record

4.9.1 Capture

Triggers the image capture. The command returns an acknowledgement right away, but the capture itself cantake up to several seconds depending on the se ngs. Returns NOT_READY in the case the capture cannot beini ated due to the last one not being finished yet.

Command

• CPTR

Answer

• OK or NOT_READY

4.9.2 Is capturing

Check if capture in progress.

Command

• ICPT

Answer

• TRUE or FALSE

4.9.3 Recording start

Start recording thermal and visible video according to se ngs.

Command

• RCRS

Answer

• OK or NOT_READY

4.9.4 Recording finish

Stops recording of thermal and visible video.

Command

• RCRF

Answer

• OK or NOT_READY

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

19

Page 21: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.9.5 Is recording

Check if recording is in progress.

Command

• IRCR

Answer

• TRUE or FALSE

4.10 Alarms

4.10.1 Get alarm mode

Returns current alarm mode.

Command

• GALM

Answer

• OFF, ABOVE, BELOW, BETWEEN, or OUTSIDE

4.10.2 Set alarm mode

Set alarm mode OFF, ABOVE, BELOW, BETWEEN, or OUTSIDE.

Command

• SALM OFF

Answer

• OK

4.10.3 Get alarm values

Get alarm thresholds; below and above.

Command

• GALV

Answer

• 20.0 40.0

4.10.4 Set alarm values

Set alarm thresholds; below and above.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

20

Page 22: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Command

• SALV 20.0 40.0

Answer

• OK

4.10.5 Get alarm colors

Get alarm colors: above, between and below. Possible colors are red, green or blue.

Command

• GALC

Answer

• RED GREEN BLUE

4.10.6 Set alarm colors

Set alarm colors: above, between and below. Possible colors are red, green or blue.

Command

• SALC RED GREEN BLUE

Answer

• OK

4.11 Thermal camera

Thermal camera se ngs are currently supported only for WWP.

4.11.1 Get emissivity

Returns current thermal camera emissivity.

Command

• GTEM

Answer

• 0.95

4.11.2 Set emissivity

Set thermal camera emissivity from 0.5 to 1.0.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

21

Page 23: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Command

• STEM 0.95

Answer

• 0.95

4.11.3 Get shu er period

Get thermal camera shu er period in seconds.

Command

• GTCP

Answer

• 120

4.11.4 Set shu er period

Set thermal camera shu er period in seconds 120-1800.

Command

• STCP 120

Answer

• OK

4.11.5 Get synchronous shu er se ngs

Returns the current synchronous shu er se ngs.

Command

• GTSC

Answer

• TRUE or FALSE

4.11.6 Set synchronous shu er se ngs

Set the synchronous shu er op on on or off, TRUE or FALSE.

Command

• STSC TRUE

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

22

Page 24: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.11.7 Perform thermal camera shu er

Performs the thermal camera shu er immediately.

Command

• DTSR

Answer

• OK

4.11.8 Get seconds to next thermal camera shu er

Returns the number of seconds to next shu er or ”N/A” if asynchronous.

Command

• GTSN

Answer

• 123 or N/A

4.11.9 Get seconds from last thermal camera shu er

Returns the number of seconds from last thermal camera shu er.

Command

• GTSL

Answer

• 123

4.12 Image and video se ngs

WWS does not support the super-resolu on and TIFF images. WWS captures and records the thermal image andvideo instead of the radiometric image and video.

4.12.1 Get radiometric JPEG image se ngs

Returns whether the image should be captured, TRUE or FALSE.

Command

• GIRJ

Answer

• TRUE or FALSE

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

23

Page 25: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.12.2 Get radiometric TIFF image se ngs

Returns whether the image should be captured, TRUE or FALSE.

Command

• GIRT

Answer

• TRUE or FALSE

4.12.3 Get super-resolu on image se ngs

Returns whether the image should be captured, TRUE or FALSE.

Command

• GISR

Answer

• TRUE or FALSE

4.12.4 Get visible image se ngs

Returns whether the image should be captured, TRUE or FALSE.

Command

• GIVI

Answer

• TRUE or FALSE

4.12.5 Get radiometric video se ngs

Returns whether the video should be recorded, TRUE or FALSE.

Command

• GVTH

Answer

• TRUE or FALSE

4.12.6 Get visible video se ngs

Returns whether the video should be recorded, TRUE or FALSE.

Command

• GVVI

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

24

Page 26: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Answer

• TRUE or FALSE

4.12.7 Set radiometric JPEG image se ngs

Sets whether the image should be captured, TRUE or FALSE.

Command

• SIRJ TRUE

Answer

• OK

4.12.8 Set radiometric TIFF image se ngs

Sets whether the image should be captured, TRUE or FALSE.

Command

• SIRT TRUE

Answer

• OK

4.12.9 Set super-resolu on image se ngs

Returns whether the image should be captured, TRUE or FALSE.

Command

• SISR TRUE

Answer

• OK

4.12.10 Set visible image se ngs

Sets whether the image should be captured, TRUE or FALSE.

Command

• SIVI TRUE

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

25

Page 27: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.12.11 Set radiometric video se ngs

Sets whether the video should be recorded, TRUE or FALSE.

Command

• SVTH TRUE

Answer

• OK

4.12.12 Set visible video se ngs

Sets whether the video should be recorded, TRUE or FALSE.

Command

• SVVI TRUE

Answer

• OK

4.12.13 Get image loca on

Return the current image loca on se ngs.

Command

• GILC

Answer

• SSD, SD_CARD or FLASH_DRIVE

4.12.14 Set image loca on

Set the current image loca on se ngs. This will change the memory where the images are captured, SSD,SD_CARD or FLASH_DRIVE.

Command

• SILC SSD

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

26

Page 28: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.13 Date and Time

4.13.1 Get date and me

Return the current date and me in strict format yyyy/MM/dd-hh:mm:ss.

Command

• GDTI

Answer

• 2019/06/21-10:44:51

4.13.2 Set date and me

Set the date and me in strict format yyyy/MM/dd-hh:mm:ss.

Command

• SDTI 2019/06/21-10:44:51

Answer

• OK

4.14 Memory

Thera are three types of memory: SSD, SD_CARD or FLASH_DRIVE.

The following commands returns the status of each memory on one line like:SSD SOME_STATUSSD_CARD SOME_STATUSFLASH_DRIVE SOME_STATUS

4.14.1 Get memory status

Return the current memory status, each line one memory type.

Command

• GMST

Answer

• READY, CONNECTED or N/A

4.14.2 Get memory size

Return the current memory size in bytes, each line one memory type.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

27

Page 29: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

Command

• GMSI

Answer

• SSD 123456789

4.14.3 Get memory free

Return the current free memory in percent, each line one memory type.

Command

• GMFR

Answer

• SSD 88.88

4.14.4 Get captured images

Return the current captured images, each line one memory type.

Command

• GMCP

Answer

• SSD 1234

4.14.5 Get recorded thermal video

Return the recorded radiometric video in seconds.

Command

• GTRC

Answer

• 1234

4.14.6 Get recorded visible video

Return the recorded visible video in seconds.

Command

• GVRC

Answer

• 1234

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

28

Page 30: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.15 Stream

4.15.1 Get thermal camera resolu on

Return the resolu on of thermal camera - width and height.

Command

• GTRE

Answer

• 640 512

4.15.2 Get thermal extremes

Return the current thermal camera extremes. The extreme consists out of coordinates X and Y and the extremevalue in degrees Celsius. Each extreme takes one line like:MAXIMUM X Y VALUEMINIMUM 300 100 10.000CENTER 320 256 25.555

WWS returns only the posi ons of extremes, without the values.

Command

• GTEX

4.15.3 Get pale e values

Returns current pale e values used for crea ng the thermal image from gray image.

The pale e consists out of 256x3 values. Each line is RGB pixel represented by three values from 0 to 255.

The top most value is the ho est color, the bo om values is the coldest color. Here is short example of answer:0 0 02 0 24 0 4...

Command

• GPLV

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

29

Page 31: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

4. COMMUNICATION PROTOCOL DESCRIPTION

4.16 System

4.16.1 Default se ngs

Set the default se ngs, can take up to 10 seconds. This command will exit the Ethernet Mode.

Command

• SDST

Answer

• OK

4.16.2 Shut down

Shuts the WIRIS down.

Command

• SHDW

Answer

• OK

4.16.3 Reboot

Reboot the WIRIS.

Command

• REBT

Answer

• OK

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

30

Page 32: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

5. RTSP VIDEO SERVER

5 RTSP Video Server

This chapter contains informa on about the RTSP server and video streams.

When the Ethernet Mode is ac vated, the RTSP server is opened on standard port. The address is:

Thermal stream

• rtsp://10.0.0.230:8554/thermal

Visible stream

• rtsp://10.0.0.230:8554/visible

The IP address may differ according to the se ngs.

The sever uses RTP protocol for media stream delivery. Currently only the stream can be opened, no othercommands are available.

The video streams are H264 encoded. The resolu on of visible stream is always HD (1280x720) with 20Hz.

The resolu on of thermal stream depends on the model:

WWP

• 640x512, 30Hz or 8.5Hz

WWS

• 800x600, 25Hz or 8.3Hz

Following so ware was tested to be working with the RTSP streams. The so ware is free and cross-pla orm.

5.1 GStreamer

The best result with lowest delay can be achieved using GStreamer.

h ps://gstreamer.freedesktop.org/

The command for launching the video stream is:

gst-launch-1.0 rtspsrc location=rtsp://10.0.0.230:8554/visible latency=100 ! rtph264depay! avdec_h264 ! autovideosink

5.2 VLC

The streams can be opened using VLC media player.

h ps://www.videolan.org/vlc/index.cs.html

The command for launching the video stream is:

vlc --network-caching 250 --clock-jitter=0 rtsp://10.0.0.230:8554/visible

The network caching parameter sets the video delay. Too low value may cause instability.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

31

Page 33: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

5. RTSP VIDEO SERVER

Figure 5.1 – Windows console with the GStreamer command.

Figure 5.2 – Windows GStreamer video stream.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

32

Page 34: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

5. RTSP VIDEO SERVER

Figure 5.3 – Windows console with the VLC command.

Figure 5.4 – Windows VLC video stream.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

33

Page 35: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

5. RTSP VIDEO SERVER

Figure 5.5 – Windows console with the FFmpeg command.

5.3 FFmpeg

The FFmpeg libraries can be also used for the video stream.

h ps://ffmpeg.org/

The command for launching the video stream is:

ffplay -fflags nobuffer -flags low_delay -framedrop -strict experimental -rtsp_transporttcp -sync ext -i "rtsp://10.0.0.230:8554/visible"

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

34

Page 36: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

5. RTSP VIDEO SERVER

Figure 5.6 – Windows FFmpeg video stream.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

35

Page 37: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

6. FTP DATA ACCESS

6 FTP data access

This chapter contains informa on about the FTP server and WIRIS data access.

6.1 FTP connec on

There is a standard FTP server running on the WIRIS device. You can access it with the WIRIS IP address andfollowing login:

User: wiris

Without password

You have full access to the saved data. You can download, rename and delete the files.

You can also connect as anonymous user, but anonymous user does not have the write access.

6.2 Restric ons and warnings

Since the full access is given, it should be use with cau on. These are the restric ons:

Do not delete or alter the current folder in use!

If these restric ons are broken, it can cause the WIRIS to crash and reboot.

6.3 So ware

The server can be accessedwithweb browser (Firefox, Chrome, Opera, ...). For details please refer to the supportof the browser.

We recommend using the Filezilla so ware.

h ps://filezilla-project.org/.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

36

Page 38: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

6. FTP DATA ACCESS

Figure 6.1 – Connec ng to FTP server with Filezilla.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

37

Page 39: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

7. WIRIS ETHERNET STREAM SDK GUI APPLICATION

7 WIRIS Ethernet Stream SDK GUI Applica on

This chapter contains informa on about WIRIS Ethernet Stream SDK GUI applica on, which was developed todemonstrate possible usage of this SDK.

7.1 Introduc on

7.1.1 Installa on

The app can be downloaded directly fromWorkswell website.

WIRIS Ethernet Stream SDK GUI is fully open source, therefore you can access all source files, which can serve asan example for developing your own applica on. You can find them on GitHub:

h ps://github.com/So wareWorkswell/EthernetStreamSDKGUI

Note that the most important part of this project is ”ControllerCore” class (with its dependencies like Threadclasses and NetworkClient class), which demonstrates basic usage of SDK, other files are pla orm dependentand may not be so interes ng

7.1.2 First launch

On first startup applica on requires you to:

Fill in your WIRIS IP address

Fill in your ac va on code

A er filling IP adress and clicking OK, applica on will try to contact your WIRIS device, this step can fail if yourdevice is unreachable or yourWiris Firmware is too obsolete and is not supported by the applica on.(Applica onwill always show you the cause) When connected to WIRIS via HDMI, IP address and mask can be changed inAdvanced - System se ngs

When successfully connected, applica onmay ask you to fill in your ac va on code (but only if it has never beenac vated in the past)

Figure 7.1 – WIRIS Ethernet Stream SDK GUI - Connec on Window

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

38

Page 40: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

7. WIRIS ETHERNET STREAM SDK GUI APPLICATION

A er comple ng these ini al steps you should be able to see main applica on window.

7.1.3 Startup default se ngs

Most se ngs are read fromWIRIS during startup, except some of se ngs which applica on set to default values:

Image storage is set to SSD

Alarm mode is set to OFF

Zooms are both set to 1

All measure se ngs are set to OFF

7.2 Main Window

WIRIS Ethernet Stream SDK GUI visuals are strongly inspired by na ve look of WIRIS HDMI output - user shouldbe familiar with most of included features - reading chapter 11 in WIRIS PRO User Manual before con nuing isrecommended:

h ps://www.workswell-thermal-camera.com/documents/

This brief manual includes mainly parts of the applica on, that differ from na ve WIRIS output.

The main window is divided into 4 main parts:

Main streamwindow - in the center, displays thermal streambydefault, you can also find currently selectedpale e on its right side together with current range mode indicator on its very top

Secondary stream window - in the right upper corner, displays visible stream by default

Main menu - le side of the main window, keeps all items that are included in na ve WIRIS

Quick menu - at the very bo om(replaces original Status bar), is used for some of frequently accessedfeatures

Inspec on panel - on the right, below secondary stream window, includes status bar and some extra in-forma on

7.3 Main menu

Main menu appearance is iden cal with na ve WIRIS Main menu but each item contents can slightly differ.

7.3.1 Range

Range contents are iden cal, however they are slightly differently styled, you can now use radio bu on at thetop to toggle between AUTOMATIC, MANUAL and SPAN ranges and there is also new radio bu on for changingeviroments.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

39

Page 41: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

7. WIRIS ETHERNET STREAM SDK GUI APPLICATION

Figure 7.2 – WIRIS Ethernet Stream SDK GUI - Main Window

7.3.2 Func ons

This sec on now includes both thermal and visible zoom andMain Camera toggle. However there are no se ngsfor Image opacity, Layout and Lock Zoom.

7.3.3 Pale es

This sec on is iden cal.

7.3.4 Capture

You can find both Capture and Record bu on here with ability to set periodic capture and check whether it hasbeen started, Image Correc on (Shu er) was moved to quick menu.

7.3.5 Measure

Extremes se ngs are iden cal. Alarms func onality stayed the same but is now interpreted graphically by aslider.

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

40

Page 42: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

7. WIRIS ETHERNET STREAM SDK GUI APPLICATION

7.3.6 Advanced

A couple of submenus from this item has been removed. Only following submenus can be found here:

Thermal Camera - Emissivity and shu er period can be found here

Images and Video - This submenu is iden cal except Image Screenshot JPEG op on

Alarms - You can set alarm colors here

Memory - You can find status of all storage devices here

System - This submenu is iden cal, however Language and Units op on cannot be changed

Info - This submenu is iden cal

7.4 Quick Menu

Quick Menu consist of several ac ons that are likely to be used frequently:

Capture - ini ates capturing according to Image and Video se ngs (Advanced/Images and Video sub-menu), it can also ini ate periodic capture(if set in Capture menu)

Record - ini ates recording according to Image and Vid se ngs (Advanced/Images and Video submenu)

Shu er - performs the thermal camera shu er immediately

Range - toggles range to manual mode and allows user to quickly adjust range

Pause - pauses or con nues the main camera stream - can be used to lower bandwidth requirements

7.5 Inspec on Panel

Standard Status bar can be found, there are also some addi onal features:

WIRIS Type - Pro/Security

WIRIS IP Address

CPU temperature

IR Core temperature

WIRIS Firmware version

WIRIS Serial Number

Latency

Current alarm mode info

Connec on state

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

41

Page 43: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

7. WIRIS ETHERNET STREAM SDK GUI APPLICATION

Figure 7.3 – WIRIS Ethernet Stream SDK GUI - Secondary StreamWindow

7.6 Secondary Stream window

This window is used to display either visible or thermal stream, you can find following bu ons here:

Switch stream windows - is used to switch stream windows quickly

Pause stream - pauses or con nues the secondary camera stream - can be used to lower bandwidth re-quirements

Separate window - opens new resizable window with secondary stream

7.7 WIRIS Security

If you are usingWIRIS Security device which doesn’t provide the same SDK interface asWIRIS Pro, the applica onlacks of these following features:

Range in Main menu cannot be accessed

In Measure, Show temperatures op on is disabled and alarms cannot be set

In Advanced - Thermal Camera and Alarms submenus are hidden, in Memory - radiometric se ngs havebeen removed

Inspec on panel lacks of Alarm and Environment info

Quick menu - NUC and Man. range have been removed

Main stream window - pale e values are hidden

E-mail and [email protected]

Mobile:+420 725 877 063

ID:Reg. No.: 29048575VAT No.: CZ29048575

HeadquartersU Albrechtova vrchu 12155 00, Prague 13Czech Republic

Revision 1.1 EN, 11th Sept, 2019All pictures are only for illustra on.Real values may vary.

42

Page 44: WORKSWELL WIRISEthernetStream SDK€¦ · WORKSWELL WIRISEthernetStream SDK USERMANUAL FWVersion: 1.1.1 Releasedate: 11thSeptember,2019 Revision:1.1EN

Contacts

Sales DepartmentMobile: +420 725 955 464

E-mail: [email protected]

HeadquartersWorkswell s.r.o.

U Albrechtova vrchu 12

155 00, Prague 13

Czech Republic

Partners WorldwideVisit our partner list online

Company contact details

Mobile: +420 725 877 063

E-mail: [email protected]

Web: www.workswell.eu