workswell wirisethernetstream sdk€¦ · workswell wirisethernetstream sdk usermanual fwversion:...
TRANSCRIPT
WORKSWELLWIRIS Ethernet Stream
SDK
USER MANUAL
FW Version: 1.1.1
Release date: 11th September, 2019
Revision : 1.1 EN
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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