Kaya Instruments IRON SDI User manual

IRON
SDI
User Manual
May 2021
-
Rev 2.0
Sky Blue Microsystems GmbH
Geisenhausenerstr. 18
81379 Munich, Germany
[phone], [email protected]
www.skyblue.de
In Great Britain:
Zerif Technologies Ltd.
Winnington House, 2 Woodberry Grove
Finchley, London N12 0DR
[phone], [email protected]
www.zerif.co.uk
International Distributors

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F a x: ( + 9 72) - 72- 2 7 2 3 51 1
www.kayainstruments.com
Table of Contents
Table of Contents
1 Figures & Tables ................................................................................................................................................5
1.1 List of Figures............................................................................................................................................5
1.2 List of Tables .............................................................................................................................................5
2 Revision History.................................................................................................................................................6
3 Introduction ......................................................................................................................................................7
3.1 Safety Precautions ....................................................................................................................................7
3.2 Disclaimer .................................................................................................................................................8
4 Overview ...........................................................................................................................................................9
5 Supported Formats..........................................................................................................................................10
6 Quick Start Guide.............................................................................................................................................11
6.1 Camera Connection ................................................................................................................................11
6.1.1 Power and Image Streaming...........................................................................................................11
6.1.2 Advanced Control............................................................................................................................11
6.2 Troubleshooting......................................................................................................................................12
7 Image Processing Flow ....................................................................................................................................13
8 Camera Operation...........................................................................................................................................14
8.1 SDIControlPoint.......................................................................................................................................14
8.2 Terminal Usage .......................................................................................................................................14
8.2.1 Terminal..........................................................................................................................................14
8.2.2 Terminal Settings ............................................................................................................................14
8.2.3 General Command Format..............................................................................................................14
8.3 Commands..............................................................................................................................................15
8.3.1 Help Dialog......................................................................................................................................15
8.3.2 Set Functions...................................................................................................................................15
8.3.3 Get Functions..................................................................................................................................15
8.3.4 List of Commands............................................................................................................................15
8.4 RS485 Interface.......................................................................................................................................19
8.4.1 rs485_baud <baud_rate>................................................................................................................19
8.4.2 rs485_addr <address> ....................................................................................................................19
8.4.3 rs485_bc_addr <address>...............................................................................................................20
8.4.4 rs485_bc_master <address>...........................................................................................................20
8.5 Settings Handling ....................................................................................................................................21
8.5.1 save_settings <id>...........................................................................................................................21
8.5.2 load_settings <id>...........................................................................................................................21
8.5.3 default_settings <id> ......................................................................................................................21
8.5.4 reset_settings .................................................................................................................................21
8.5.5 dump_settings ................................................................................................................................21
8.6 System Commands..................................................................................................................................22
8.6.1 prompt <flag> .................................................................................................................................22
8.6.2 reboot .............................................................................................................................................22
8.6.3 fw_update.......................................................................................................................................22
8.6.4 version ............................................................................................................................................22
8.6.5 name <name string> .......................................................................................................................23
8.6.6 flip <mode>.....................................................................................................................................23
8.6.7 temp <sensor id> ............................................................................................................................23
8.7 Camera Commands.................................................................................................................................24
8.7.1 cam_gain <gain> .............................................................................................................................24
8.7.2 cam_exposure <time> ....................................................................................................................24
8.7.3 cam_info .........................................................................................................................................24
8.7.4 identify............................................................................................................................................25

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Table of Contents
8.8 Video Commands....................................................................................................................................26
8.8.1 video_mode <mode>......................................................................................................................26
8.8.2 downscale <channel=1> <downscale> <reserved=0>.....................................................................27
8.8.3 sdi_black <offset> ...........................................................................................................................28
8.8.4 sdi_white <offset> ..........................................................................................................................28
8.8.5 sdi_range <flag>..............................................................................................................................28
8.8.6 post_bright <offset> .......................................................................................................................28
8.8.7 post_cont <factor>..........................................................................................................................29
8.8.8 post_sat <factor>............................................................................................................................29
8.8.9 post_hue <offset>...........................................................................................................................29
8.8.10 wb ...................................................................................................................................................30
8.8.11 wb_threshold <threshold>..............................................................................................................30
8.8.12 awb <flag>.......................................................................................................................................30
8.8.13 wb_preset <id> ...............................................................................................................................30
8.8.14 gain_red <gain> ..............................................................................................................................30
8.8.15 gain_blue <gain>.............................................................................................................................31
8.8.16 gain_green <gain>...........................................................................................................................31
8.8.17 black_master <offset-red> <offset-green> <offset-blue>...............................................................31
8.8.18 black_red <offset> ..........................................................................................................................31
8.8.19 black_blue <offset>.........................................................................................................................32
8.8.20 black_green <offset> ......................................................................................................................32
8.8.21 flare <red level> <green level> <blue level>....................................................................................32
8.8.22 color_cross <c0> .. <c8>..................................................................................................................32
8.8.23 color_cross_offset <red_offset> <green_offset> <blue_offset> ....................................................33
8.8.24 color_conv <c0> .. <c8> ..................................................................................................................33
8.8.25 color_space <color space>..............................................................................................................34
8.8.26 stat_roi <width><height><offsetX><offsetY> .................................................................................34
8.8.27 stat_roi_info <maxWidth><maxHeight><widthStep><heightStep> ...............................................34
8.8.28 cam_roi_offset <offsetX><offsetY>.................................................................................................34
8.8.29 cam_roi_offset_info <offsetXMax><offsetYMax><offsetXStep><offsetYStep>..............................34
8.9 Defect Pixel Correction ...........................................................................................................................35
8.9.1 dpc <flag>........................................................................................................................................35
8.9.2 dpc_add_pixel <x> <y>....................................................................................................................35
8.9.3 dpc_del_pixel..................................................................................................................................36
8.9.4 dpc_save .........................................................................................................................................36
8.9.5 dpc_load .........................................................................................................................................36
8.10 Knee Function .........................................................................................................................................36
8.10.1 knee <flag> <knee_point> <knee_slope> <white_clip> ..................................................................36
8.11 Loop-up Table Management...................................................................................................................37
8.11.1 lut_enable <reserved=0> <flag> .....................................................................................................37
8.11.2 lut_mode <mode> ..........................................................................................................................38
8.11.3 lut_preset <index> ..........................................................................................................................38
8.11.4 lut_sample_master <xi_0> <yi_0> ... <xi_7> <yi_7> .......................................................................38
8.11.5 lut_sample_red <xi_0> <yi_0> ... <xi_7> <yi_7> .............................................................................39
8.11.6 lut_sample_green <xi_0> <yi_0> ... <xi_7> <yi_7> .........................................................................39
8.11.7 lut_sample_blue <xi_0> <yi_0> ... <xi_7> <yi_7>............................................................................39
8.11.8 lut_interpolate................................................................................................................................39
8.11.9 lut_interpolate_red.........................................................................................................................39
8.11.10 lut_interpolate_green.................................................................................................................39
8.11.11 lut_interpolate_blue ...................................................................................................................39
8.11.12 lut_reset_master.........................................................................................................................39
8.11.13 lut_reset_red ..............................................................................................................................40

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Table of Contents
8.11.14 lut_reset_green ..........................................................................................................................40
8.11.15 lut_reset_blue.............................................................................................................................40
8.11.16 lut_fun_rec709 <threshold> <linear-contrast> <linear-brightness> <contrast> <gamma>
<brightness> ...................................................................................................................................................40
8.11.17 lut_fast_gamma <gamma> .........................................................................................................42
8.11.18 lut_fixed_mode <mode>.............................................................................................................42
8.12 Image statistic commands ......................................................................................................................42
8.12.1 stat_rgb...........................................................................................................................................42
8.13 Auto Exposure.........................................................................................................................................43
8.13.1 aec <enable> <setPoint> <speed> <clmTolerance> <activeGain> <activeExposure> <activeApt>
<maxExposure> <maxGain> <reserved>.........................................................................................................43
8.14 Genlock ...................................................................................................................................................45
8.14.1 genlock <mode>..............................................................................................................................45
8.14.2 genlock_status ................................................................................................................................45
8.14.3 genlock_lol_filter <time_ms>..........................................................................................................45
8.14.4 genlock_offset <v_offset>...............................................................................................................46
8.14.5 genlock_offset_info <v_offset_phase>...........................................................................................46
8.15 SDI Time Code.........................................................................................................................................46
8.15.1 timecode <hour> <minute> <second>............................................................................................46
8.15.2 timecode_hold <flag> .....................................................................................................................46
9 Hardware Reference........................................................................................................................................47
9.1 Status LED ...............................................................................................................................................47
9.2 Micro BNC Connector .............................................................................................................................47
10 Appendix 1: Firmware Update.........................................................................................................................48

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 5 | Appendix No. 1
1Figures & Tables
1.1 List of Figures
Figure 1 –Camera connections diagram.................................................................................................................11
Figure 2 –Image Processing Flow ...........................................................................................................................13
Figure 3 –Downscale example................................................................................................................................27
Figure 4 –ROI position in relation to the origin......................................................................................................34
Figure 5 –Defect pixel correction position .............................................................................................................35
Figure 6 –Pushing the Micro-BNC connector into place ........................................................................................47
Figure 7 –Twisting the connector and securing it in position.................................................................................47
Figure 8 –Serial communication example ..............................................................................................................48
Figure 9 –Firmware terminal initiation...................................................................................................................48
Figure 10 –Firmware update fail ............................................................................................................................49
Figure 11 –Firmware update process.....................................................................................................................49
Figure 12 –Firmware update succession................................................................................................................49
1.2 List of Tables
Table 1 –Revision History.........................................................................................................................................6
Table 2 –Supported SDI parameters ......................................................................................................................10
Table 3 –List of commands.....................................................................................................................................18
Table 4 –Connector indicator lamp states .............................................................................................................47

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 6 | Appendix No. 1
2Revision History
Table 1 –Revision History
Ver
Date
Notes
1.0
12.01.2020
Initial release
1.1
20.05.2020
Added the Subsampling mode
1.2
31.1.2020
Added section no. 6: Quick Startup Guide
Added section no. 7: Image Processing Flow.
Added appendix no. 1: firmware update.
Section no. 8: updated new commands and re-ordered them.
1.3
28.02.2021
Section no. 8: added subsection 8.13 –“Genlock”
2.0
02.05.2021
Added Region of Interest support
Added RS485 interface support and Multi-Camera Mode
Added video output time-code control support
Added extended auto-exposure features configurations

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 7 | Appendix No. 1
3Introduction
3.1 Safety Precautions
With your Iron camera in hand, please take the time to read through the precautions listed below in order to
prevent preventable and unnecessary injuries and damage to you, other personnel or property. Read these safety
instructions carefully prior to your first use of the product, as these precautions contain safety instructions that
must be observed. After reading through this manual, be sure to follow it to prevent misuse of product.
Caution! Read Carefully and do not disregard these instructions.
In the event of a failure, disconnect the power supply
Disconnect the power supply immediately and contact our sales personnel for repair. Continuing to use the product in
this state may result in a fire or electric shock.
If an unpleasant smell or smoking occurs, disconnect the power supply.
Disconnect the power supply immediately! Continuing to use the product in this state may result in a fire or electric
shock. After verifying that no smoking is observed, contact our sales personnel for repair.
Do not disassemble, repair or modify the product.
This may result in a fire or electric shock due to a circuit shortage or heat generation. Contact our sales personnel prior
to inspection, modification or repair.
Do not place the product on unstable surfaces.
Otherwise, it may drop or fall, resulting in injury to persons or the camera.
Do not use the product if dropped or damaged.
Otherwise, a fire or electric shock may occur.
Do not touch the product with metallic objects.
Otherwise, a fire or electric shock may occur.
Do not place the product in dusty or humid environments, nor where water may splash.
Otherwise, a fire or electric shock may occur.
Do not wet the product or touch it with wet hands.
Otherwise, the product may fail or it may cause a fire, smoking or electric shock.
Do not touch the gold-plated sections of the connectors on the product.
Otherwise, the surface of the connector may be contaminated by sweat or skin-oil, resulting in contact failure of a
connector, malfunction, fire or electric shock due to static electricity discharge.
Do not use or place the product in the following locations.
Unventilated areas such as closets or bookshelves.
Near oils, smoke or steam.
Next to heat sources.
A closed (and not running) car where the temperature becomes high.
Static electricity replete locations
Near water or chemicals.
Otherwise, a fire, electric shock, accident or deformation may occur due to a short circuit or heat generation.
Do not place heavy objects on the product.
Otherwise, the product may be damaged.
Be sure to discharge static electricity from body before touching any sensitive electronic components.
The electronic circuits in your computer and the circuits on the Iron camera and the Predator II board are sensitive to
static electricity and surges. Improper handling may seriously damage the circuits. In addition, do not let your clothing
come in contact with the circuit boards or components. Otherwise, the product may be damaged.

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 8 | Appendix No. 1
3.2 Disclaimer
This product should only be used for image capturing and processing. KAYA Instruments will assume no
responsibility for any damage that may ensue by the use of the camera for any purpose other than intended, as
previously stated. Without detracting from what was previously written, please be advised that the company will
take no responsibility for any damages caused by:
Earthquake, thunder strike, natural disasters, fire caused by use beyond our control, wilful and/or accidental
misuse and/or use under other abnormal and/or unreasonable conditions.
Secondary damages caused by the use of this product or its unusable state (business interruption or others).
Use of this product in any manner that contradicts this manual or malfunctions that may occur due to
connection to other devices. Damage to this product that is out of our control or failure due to modification
Accidents and/or third parties that may be involved.
Additionally, KAYA Instruments assumes no responsibility or liability for:
Erasure or corruption of data caused by the use of this product.
Any consequences or other abnormalities following the use of this product
Repairs to this product are carried out by replacing it on a chargeable basis and not by repairing the faulty device.
Non-chargeable replacement is offered for initial failure, as long as it is reported no later than two weeks post-
delivery of the product.

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 9 | Appendix No. 1
4Overview
This user manual provides a detailed overview of KAYAS’s IRON SDI cameras operation. All cameras are suited for
a wide variety of applications such low light surveillance, special effects, sports broadcasting, etc.
With our customers’ convenience in mind we had made sure that connecting and streaming can be easily achieved
in few easy steps and require little configurations. Control of the camera as well as advanced configurations are
made easy using the SDIControlPoint software and terminal, enabling enhanced streaming and image processing
of the cameras’ outputs. Hardware reference is covered in chapter 9, Hardware Reference.
It is important to note that some parameters might vary slightly compared to this document or may be absent
entirely, subject to the active firmware capabilities: a firmware upgrade might be needed to support complete
functionality set. Please feel free to contact our support team at [e-mail] with any
questions that may arise.

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 10 | Appendix No. 1
5Supported Formats
Iron SDI camera support multiple standard video formats including HD-SDI, 3G-SDI, 6G-SDI and 12G-SDI,
depending on the camera’s sensor resolution. Changing format can be done dynamically, using serial interface, or
format configuration can be saved and loaded on startup.
Table no. 2 describes the supported formats:
Table 2 –Supported SDI parameters
Mode
IIRON
SDI 25
IRON SDI
305
Video Standard
Resolutions supported
Frame rates supported (fps)
HD-SDI
V
V
ST 292 (ST 274)
1080i 10-bit 4:2:2
50, 59.94, 60
1080p 10-bit 4:2:2/RAW
23.98, 24, 25, 29.97, 30
ST 292 (ST 2048-2)
2K 10-bit 4:2:2
23.98, 24, 25, 29.97, 30
3G-SDI
ST 425-1 (ST 274)
1080p 10-bit 4:2:2/RAW
50, 59.94, 60
ST 425-1 (ST 2048-2)
2K 10-bit 4:2:2
47.95, 48, 50, 59.94, 60
6G-SDI
X
ST 2081-10 M1, (ST 2036-1)
UHD 10-bit 4:2:2
23.98, 24, 25, 29.97, 30
ST 2081-10 M1, (ST 2048-1)
4K 10-bit 4:2:2
23.98, 24, 25, 29.97, 30
12G-SDI
ST 2082-10 M1, ST 425-5 (ST 2036-1)
UHD 10-bit 4:2:2
50, 59.94, 60
ST 2082-10 M1, ST 425-5 (ST 2048-1)
4K 10-bit 4:2:2
47.95, 48, 50, 59.94, 60

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 11 | Appendix No. 1
6Quick Start Guide
6.1 Camera Connection
KAYA’s Iron SDI cameras are easy to set up and operate. The camera needs to be connected to a power source,
using the supplied cable, and to an SDI capture card or monitor. Under normal circumstances the camera will start
streaming to an SDI input as soon as it is powered.
Advanced camera settings can be configured using the provided serial command line interface. The camera can
also be controlled using KAYA’s SDIControlPoint application. For more details, see section 8, Camera Operation.
Computer With
SDIControlPoint
KAYA
SDI Camera
SDI Input
Coaxial Cable
RS232 Serial Cable
Power Cable
12V Power
Adapter
Figure 1 –Camera connections diagram
6.1.1 Power and Image Streaming
1. Connect the camera to an SDI Input using a coaxial cable
2. Connect the camera to a 7-18V power source.
3. Video should start streaming to the SDI capture card or monitor.
6.1.2 Advanced Control
1. Connect the camera’s GPIO to a serial RS232 port (cable provided).
2. Connect to the camera’s command user interface via a standard serial terminal (see section 8.2, Terminal
Usage) or KAYA’s SDIControlPoint application.
3. To chance the video mode use the video_mode command (see section 8.8.1, video_mode).
4. To save the current settings use the save_settings command (see section 8.5.1, save_settings).

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 12 | Appendix No. 1
6.2 Troubleshooting
1. Make sure that the camera is connected to a 7-18V power source.
2. Make sure that all components are properly connected (camera, cables and capture card). See Figure 1
and section 9.2 Micro BNC Connector.
3. Make sure that the coaxial cable supports the proper output stream bandwidth:
3G SDI for 2k video streaming.
12G SDI for 4k video streaming.
4. Check to see whether the LED on the back of the camera is blinking green. The issue may be resolved by
power cycling the camera (turning power off and back on). More LED indicators are described in section
no. 9.1 (Status LED).
5. Make sure the SDI input (SDI capture card or monitor) supports the output video format of the camera –
contact the SDI input’s manufacturer for support and additional information. To change the camera’s
output video mode, see section 8.8.1, video_mode <mode>.

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 13 | Appendix No. 1
7Image Processing Flow
Figure 2 describes the image processing flow in KAYA’s SDI cameras, from a raw image acquired by the sensor and
to an SDI-standard compatible output. All commands implemented in the processing pipe are described in chapter
no. 8, “Camera Operation”.
Debayer Color
Correction
Matrix LUTSensor Gain/Offset
Y=(X-b)*aSDI
color_cross
color_cross_offset
black_master
color_conv
color_space
sdi_black
sdi_white
sdi_range
post_bright
post_cont
post_sat
post_hue
cam_gain
cam_exposure
cam_info
cam_roi_offset
flip
awb
wb_preset
RGB->YCbCr
gain_red
gain_green
gain_blue
black_red
black_green
black_blue
Defect Pixel
Correction
dpc
dpc_add_pixel
dpc_del_pixel
dpc_save
dpc_load
video_mo
de
downscale
aec stat_roi
lut_enable
lut_mode
lut_preset
lut_sample_master
lut_sample_red
lut_sample_green
lut_sample_blue
lut_interpolate
lut_interpolate_red
lut_interpolate_green
lut_interpolate_blue
lut_reset_master
lut_reset_red
lut_reset_green
lut_reset_blue
lut_fun_rec709
lut_fast_gamma
lut_fixed_mode
knee
Linear
Bayer
Domain
flare
Figure 2 –Image Processing Flow

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 14 | Appendix No. 1
8Camera Operation
8.1 SDIControlPoint
KAYA Instruments provides a free, open-source camera control software (named: SDIControlPoint). A
downloadable file as well as the software’s user manual (KAYA SDIControlPoint Manual.pdf) are available at the
following address for your convenience: cloud.kayainstruments.com/s/SDI
8.2 Terminal Usage
8.2.1 Terminal
The Iron SDI can be controlled via a simple terminal connection. All commands consist of ASCI characters.
8.2.2 Terminal Settings
The terminal interfaces are either RS232 or RS485 and are connected via the GPIO connector. The default interface
settings are:
115200 baud
8 bit data
no parity
1 stop bit
no flow control
The camera accepts commands in text form and responds in text messages. Every command is confirmed by either
an "OK" or a "FAIL" to indicate whether it had been successfully implemented or not, respectably; errors have to
be handled by the user or a host software which is used to control the device. Depending on the prompt setting
one may receive a "=>" prompt after start up. Commands can then be sent to control the device or receive
information.
8.2.3 General Command Format
If the prompt command is enabled the firmware will send its prompt ("=> ") when awaiting commands. Every
command line is accepted as a single text line, terminated by either CR or LF. The command consists of a command
string, possibly followed by one or more parameters separated by a single space. Depending of the command the
parameters can come in one of these formats:
Signed decimal : -323, 422
Hexadecimal: 0x35ff34aa
String : any_string
The command will be executed and may produce some text output in a single line or more, followed by a single
status line consisting of either "OK" or "FAIL". In case of failure an error code may be added in the same line, e.g.
"FAIL 3".The lines sent by the firmware are terminated with both CR and LF. Most commands do have parameters.
The parameters depend on the given command.

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 15 | Appendix No. 1
8.3 Commands
8.3.1 Help Dialog
Typing help will give a full list of supported commands. It is possible to get a detailed help for each command by
typing "help <cmd>".
Example:
help video_mode<Enter>
video_mode <video mode> - set video mode
8.3.2 Set Functions
Running a command with its required matching parameters will change the settings.
Example:
Command: video_mode 5
Response: OK (returned)
8.3.3 Get Functions
Any setting can be checked by running a function without parameters. The output of the get function represents
a valid command followed by parameters. This string can be parsed by external applications to extract the current
settings out of the system.
Example:
Command: video_mode
Response: video_mode 5 (returned)
OK (returned)
8.3.4 List of Commands
#
Command
Parameters
Description
1
help
Gives a full list of supported commands
2
rs485_baud
<baud_rate>
Sets the baud rate of the serial communication
3
rs485_addr
<address>
Sets the unique device serial address
4
rs485_bc_addr
<address>
Sets the serial broadcast address
5
rs485_bc_master
<address>
Sets master device for command acknowledge of broadcast commands
6
save_settings
<id>
Saves the current settings into camera non-volatile memory
7
load_settings
<id>
load saved settings on demand
8
default_settings
<id>
Select the default settings set applied on startup
9
reset_settings
Resets the system into factory default run
10
dump_settings
dumps current settings configured on the device
11
prompt
<flag>
Set prompt mode of the command output

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 16 | Appendix No. 1
12
reboot
Preforms a system reboot
13
fw_update
Set the system into firmware update mode
14
version
Dumps a detailed version information about the system
15
name
<name string>
Sets the device name
16
flip
<mode>
Sets the image flip or rotation mode
17
temp
<sensor id>
Sets the image flip or rotation mode
18
cam_gain
<gain>
Set the analog gain for the sensor
19
cam_exposure
<time>
Sets the exposure time/shutter width
20
cam_info
Reports the min / max gain and exposure
21
identify
display device connection details
22
video_mode
<mode>
Sets the output video mode
23
downscale
<channel=1>
<downscale>
<reserved=0>
The downscale command is used to output Full HD or 2K resolution from UHD or
4K downscaled source image
24
sdi_black
<offset>
Sets the black level for SDI in legal range mode
25
sdi_white
<offset>
Sets the white level for SDI in legal range mode
26
sdi_range
<flag>
Sets the SDI output range type
27
post_bright
<offset>
Sets post processing brightness
28
post_cont
<factor>
Sets post processing contrast
29
post_sat
<factor>
Sets post processing color saturation
30
post_hue
<offset>
Sets post processing color hue offset angle
31
wb
Triggers single shot white-balance
32
wb_threshold
<threshold>
Sets wb maximum calculation threshold
33
awb
<flag>
Enable continuous white balance adjustment.
34
wb_preset
<id>
Sets calibrated white balance presets
35
gain_red
<gain>
Sets gain factor for red component for selected output channel
36
gain_blue
<gain>
Sets gain factor for blue component for selected output channel
37
gain_green
<gain>
Sets gain factor for green component for selected output channel
38
black_master
<offset-red>
<offset-green>
<offset-blue>
Sets the black-level offset for red, green and blue-components for selected
output channel
39
black_red
<offset>
Sets offset for red component for selected output channel as black level setting
40
black_blue
<offset>
Sets offset for blue component for selected output channel as black level setting
41
black_green
<offset>
Sets offset for green component for selected output channel as black level setting
42
flare
<red level>
<green level>
<blue level>
Sets flare compensation level (= Defogging)
43
color_cross
<c0> .. <c8>
Sets the color cross talk matrix
44
color_cross_offset
<red_offset>
<green_offset>
<blue_offset>
Sets the color cross talk offset
45
color_conv
<c0> .. <c8>
Sets the color conversion matrix
46
color_space
<color space>
Change the color space matrix
47
stat_roi
<width>
<height>
<offsetX>
<offsetY>
Set the ROI where auto compensation calculations are made
48
stat_roi_info
<maxWidth>
<maxHeight>
<widthStep>
<heightStep>
Gets the auto compensation max ROI coordinates
49
cam_roi_offset
<offsetX>
<offsetY>
Moves the absolute image ROI position across the sensor. Default position in
center

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 17 | Appendix No. 1
50
cam_roi_offset_info
<offsetXMax>
<offsetYMax>
<offsetXStep>
<offsetYStep>
Gets the maximum camera roi offset
51
dpc
<flag>
Enable deflect pixel correction
52
dpc_add_pixel
<x> <y>
Adds a pixel coordinate to defect pixel table or dumps the whole table
53
dpc_del_pixel
Deletes all pixel coordinates from the defect pixel table
54
dpc_save
Saves defect pixel table to persistent memory
55
dpc_load
Loads defect pixel table from persistent memory
56
knee
<flag>
<knee_point>
<knee_slope>
<white_clip>
Knee function for highlight control
57
lut_enable
<reserved=0>
<flag>
Enables the function for look up table
58
lut_mode
<mode>
Selects the LUT operational mode
59
lut_preset
<index>
Selects the preset storage for the current LUT interpolator
60
lut_sample_master
<xi_0><yi_0> ...
<xi_7> <yi_7>
Defines the sample points in a lookup table for all colors
61
lut_sample_red
<xi_0><yi_0> ...
<xi_7> <yi_7>
Same as lut_sample, but only for the red component
62
lut_sample_green
<xi_0><yi_0> ...
<xi_7> <yi_7>
Same as lut_sample, but only for the green component
63
lut_sample_blue
<xi_0><yi_0> ...
<xi_7> <yi_7>
Same as lut_sample, but only for the blue component
64
lut_interpolate
Interpolates all look up tables based on the given sample point
65
lut_interpolate_red
Interpolates the red look up table based on the given sample points
66
lut_interpolate_green
Interpolates the green look up table based on the given sample points
67
lut_interpolate_blue
Interpolates the blue look up table based on the given sample points
68
lut_reset_master
Clears all color channels look up sample points
69
lut_reset_red
Clears all red look up sample points
70
lut_reset_green
Clears all green look up sample points
71
lut_reset_blue
Clears all blue look up sample points
72
lut_fun_rec709
<threshold>
<linear-
contrast>
<linear-
brightness>
<contrast>
<gamma>
<brightness>
Sets new LUT sample points according to REC.709 for selected LUT preset
73
lut_fast_gamma
<gamma>
The fast gamma function uses the same formula as the lut_fun_rec709 command,
but the user only has to specify the desired gamma value.
74
lut_fixed_mode
<mode>
The fixed gamma mode contains three presets which are shown in the table
below
75
stat_rgb
Dumps the average image value for each color channel (RGB)
76
aec
<enable>
<setPoint>
<speed>
<clmTolerance>
<activeGain>
<activeExposure>
<activeApt>
<maxExposure>
<maxGain>
Auto Exposure and Gain are used to control the picture brightness by adjusting
Exposure and Gain values automatically in order to reach desired luminance level
77
genlock
<mode>
The genlock mechanism is used to synchronize multiple cameras video signals
78
genlock_status
Used to check the current genlock status

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 18 | Appendix No. 1
79
genlock_lol_filter
<time_ms>
Can be configured to prevent glitches in the unstable genlock signals
80
genlock_offset
<v_offset>
The vertical position offset that is added to the reference sync signal
81
genlock_offset_info
<v_offset_phase>
The vertical position offset that is added to the reference sync signal
82
timecode
<hour>
<minute>
<second>
Sets SDI time code which is embedded into the SDI signal
83
timecode_hold
<flag>
This command can be used to hold the timecode on the SDI output
Table 3 –List of commands

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 19 | Appendix No. 1
8.4 RS485 Interface
An RS485 Bus allows for multiple Iron SDI systems to be used simultaneously with a single RS485 Master controller;
please note that an RS485 to RS232 adapter must be used.
Commands can also be sent to a group of cameras at once as long as they are connected to the same RS485 bus.
To accommodate for this, each camera has a personal address and a broadcast address which can be set via the
rs485_addr and rs485_bc_addr commands, respectively. The former is used for individual control while the latter
is used to communicate commands to a group.
Master and slave communication is commenced in the following command format for both individual and group
communication: <address> <command> <parameter>.
8.4.1 rs485_baud <baud_rate>
Sets the baud rate for the RS485 terminal interface. Possible baud rates are:
#
Baud Rate
1
9600
2
14400
3
19200
4
57600
5
115200 (defualt)
Remarks:
1. It is advised to leave the baud rate at 115200 (default) for faster device response.
2. Setting RS485 baud rate will also change the RS232 interface baud rate.
8.4.2 rs485_addr <address>
Sets the address for the RS485 interface. It is impossible to set the device’s address to be the same as the broadcast
address, an attempt to do so will return “FAIL”.
Value
Default
Minimal
Maximal
Device Address
1
0
99
Remarks:
1. Make sure, that each address is unique on your RS485 bus system. Address conflicts can be checked and
resolved at any time via RS232 console, or by removing devices from the bus until the contention is solved.
2. Address 100 is reserved as a fail-safe address: all devices will always replay to commands sent over this address,
as if it was their current device address. This can be used to identify or change the device address if it has been
lost.

2 0 H a M e s i la S t . , N e s h er 3 6 8 8 52 0 , I s r a el
P O B 2 5 0 0 4 , H a i f a 3 1 2 5 0 0 1 , I s r a e l
T el : (+ 9 7 2) - 72- 2 7 2 3 5 00 F ax : ( + 9 7 2) - 72- 2 72 3 5 1 1
www.kayainstruments.com
Page no. 20 | Appendix No. 1
8.4.3 rs485_bc_addr <address>
Sets the broadcast address for the RS485 interface. It is impossible to set the broadcasting address to be the same
as the device’s address, an attempt to do so will return “FAIL”.
Value
Default
Minimal
Maximal
Broadcast Address
0
0
99
To change the broadcast address of an already existing broadcast group, simply send an rs_485_bc_addr command
over the broadcast channel
Example 1:
// change the broadcast address of all connected cameras to 8
rs485_bc_addr 8
Example 2:
// change the broadcast address of all connected cameras associated
// with existing broadcast group 8 to new broadcast address 9
8 rs485_bc_addr 9
8.4.4 rs485_bc_master <address>
This command enables the broadcast master mode on a camera with a given device address. If the command is
transmitted as a get command (without an argument) it will reply with a flag (0 or 1) rather than the broadcast
master address. The flag indicates whether this camera currently is the broadcast master or not (0 for no and 1
for yes).
Value
Default
Minimal
Maximal
Device Address of the Broadcast Master
Broadcast Master Disabled
0
99
Remarks:
1. Sending an address value of “-1” will disable the broadcast master mode.
Example 1:
// Disable broadcast master mode on all cameras in the group with the “0” broadcast address.
0 rs485_bc_master -1
Example 2:
// Sends a command to all cameras in the group (with the “0” broadcast address) and sets the camera
with a “1”
// device address as the broadcast master, whilst disabling “broadcast master” on all other cameras.
0 rs485_bc_master 1