Dream Chip ATOM one 4K mini Reference Manual

Reference Manual ATOM one 4K mini Table of Contents 1 Overview.........................................................................................................................................5 2 General Operation...........................................................................................................................6 2.1 Connectors...............................................................................................................................6 2.1.1 Power and RS485 Connector...........................................................................................6 2.1.2 AUX Connector................................................................................................................6 2.2 Over-Temperature Protection...................................................................................................7 2.3 Status LED...............................................................................................................................8 3 Firmware Update.............................................................................................................................9 3.1 Firmware Update via GUI.......................................................................................................9 3.2 Firmware Update via Script.....................................................................................................9 3.2.1 Preparation for Update.....................................................................................................9 3.2.2 Update of Firmware.........................................................................................................9 4 ProVideo GUI................................................................................................................................11 5 Terminal Usage..............................................................................................................................12 5.1 Terminal.................................................................................................................................12 5.2 Terminal Settings...................................................................................................................12 5.3 General Command Format.....................................................................................................12 5.4 RS485 Addressing..................................................................................................................13 5.5 RS485 Broadcasting..............................................................................................................13 5.6 Inbuild Help...........................................................................................................................14 5.7 Command Parser....................................................................................................................14 6 Settings Handling..........................................................................................................................15 6.1 Set Functions..........................................................................................................................15 6.2 Get Functions.........................................................................................................................15 6.3 auto_save ....................................................................................................................15 6.4 save_settings..........................................................................................................................15 6.5 load_settings..........................................................................................................................16 6.6 reset_settings..........................................................................................................................16 6.7 dump_settings........................................................................................................................16 7 System Commands........................................................................................................................17 7.1 rs232_baud .......................................................................................................17 7.2 rs485_baud .......................................................................................................17 7.3 rs485_addr

............................................................................................................17 7.4 rs485_bc_addr

......................................................................................................17 7.5 rs485_bc_master

...................................................................................................18 7.6 rs485_term .................................................................................................................18 7.7 prompt ........................................................................................................................19 7.8 reboot.....................................................................................................................................19 7.9 fw_update...............................................................................................................................19 7.10 version..................................................................................................................................19 7.11 identify.................................................................................................................................19 7.12 name ............................................................................................................20 7.13 out ..........................................................................................................................20 7.14 sdi2 ........................................................................................................................21 7.15 flip .........................................................................................................................22

Reference Manual ATOM one 4K mini 7.16 log_mode ...............................................................................................................22 7.17 pq_max_brightness ..................................................................................................23 7.18 slog3_master_gain ..................................................................................................23 7.19 audio_enable ............................................................................................................23 7.20 audio_gain ...............................................................................................................23 7.21 temp ..................................................................................................................24 7.22 max_temp.............................................................................................................................24 7.23 max_temp_reset...................................................................................................................25 7.24 over_temp_count.................................................................................................................25 7.25 fan_speed.............................................................................................................................25 7.26 fan_target ................................................................................................................25 7.27 calibration_profile .......................................................................................................26 7.28 volatile ...................................................................................................................26 8 Camera Commands.......................................................................................................................27 8.1 cam_gain ...................................................................................................................27 8.2 cam_exposure ............................................................................................................27 8.3 cam_info................................................................................................................................28 9 Video Commands..........................................................................................................................29 9.1 video_mode .............................................................................................................29 9.2 downscale ...................................................................30 9.3 genlock ....................................................................................................................31 9.3.1 Status LED.....................................................................................................................32 9.4 genlock_crosslock .................................................................................32 9.5 genlock_offset ...................................................................................34 9.6 genlock_term .........................................................................................................34 9.7 genlock_status........................................................................................................................34 9.8 genlock_lol_filter ...............................................................................................34 9.9 sdi_black ..................................................................................................................35 9.10 sdi_white ...............................................................................................................35 9.11 sdi_range ..................................................................................................................35 9.12 post_bright .............................................................................................................36 9.13 post_cont ...............................................................................................................36 9.14 post_sat .................................................................................................................36 9.15 post_hue ................................................................................................................36 9.16 wb.........................................................................................................................................37 9.17 awb ...........................................................................................................................37 9.18 awb_speed .............................................................................................................37 9.19 wb_preset ....................................................................................................................37 9.20 gain_red ...................................................................................................................38 9.21 gain_blue .................................................................................................................38 9.22 gain_green ...............................................................................................................39 9.23 black_master ....................................................39 9.24 black_red ...............................................................................................................39 9.25 black_blue .............................................................................................................39 9.26 black_green ...........................................................................................................39 9.27 flare ......................................................................39 9.28 filter_enable .............................................................................................................40

Reference Manual ATOM one 4K mini 9.29 filter_detail .............................................................................................................40 9.30 filter_denoise ..........................................................................................................40 9.31 color_conv .. ......................................................................................................40 9.32 color_cross .. .....................................................................................................41 9.33 color_cross_offset .........................................42 9.34 color_space....................................................................................................42 9.35 mcc ...........................................................................................................................43 9.36 mcc_opmode ............................................................................................................43 9.37 mcc_blink []......................................................................................43 9.38 mcc_set [] []........................................................................43 9.39 lsc .....................................................................................46 10 Defect Pixel Correction...............................................................................................................48 10.1 dpc ............................................................................................................................48 10.2 dpc_mode ..............................................................................................................48 10.3 dpc_test_mode .......................................................................................................48 10.4 dpc_level .................................................................................................48 10.5 dpc_add_pixel .......................................................................................................49 10.6 dpc_del_pixel.......................................................................................................................49 10.7 dpc_save...............................................................................................................................49 10.8 dpc_load...............................................................................................................................49 10.9 dpc_auto_load......................................................................................................................49 11 Knee Function..............................................................................................................................50 11.1 knee ..........................................................................................50 12 Look-up Table Management........................................................................................................51 12.1.1 How to setup a lookup table using interpolation..........................................................51 12.1.2 How to setup a lookup table using the fast gamma function.......................................52 12.1.3 How to setup a lookup table using the fixed gamma mode.........................................52 12.2 lut_enable ...................................................................................................52 12.3 lut_mode ................................................................................................................53 12.4 lut_preset ...............................................................................................................53 12.5 lut_sample ... .....................................................................54 12.6 lut_sample_red ... ..............................................................55 12.7 lut_sample_green ... ...........................................................55 12.8 lut_sample_blue ... ............................................................55 12.9 lut_interpolate......................................................................................................................55 12.10 lut_interpolate_red.............................................................................................................55 12.11 lut_interpolate_green.........................................................................................................55 12.12 lut_interpolate_blue...........................................................................................................55 12.13 lut_reset..............................................................................................................................55 12.14 lut_reset_red.......................................................................................................................55 12.15 lut_reset_green...................................................................................................................55 12.16 lut_reset_blue.....................................................................................................................56 12.17 lut_fun_rec709 ..................................................................................................................................56 12.18 lut_fast_gamma ................................................................................................58 12.19 lut_fixed_mode ....................................................................................................58 13 Image statistic commands............................................................................................................60

Reference Manual ATOM one 4K mini 13.1 stat_rgb.................................................................................................................................60 13.2 stat_hist ..................................................................................................................60 13.3 stat_exp ..................................................................................................................61 14 SDI Time code.............................................................................................................................63 14.1 timecode .................................................................................63 14.2 timecode_hold ..........................................................................................................63 15 Auto Exposure.............................................................................................................................64 15.1 aec ......................................................................................64 15.2 aec_weight ............................................................................................66 15.3 stat_ae..................................................................................................................................66 16 Lens Drive Unit...........................................................................................................................68 16.1 lens_setup

..............................................68 16.2 lens_active .........................................................................................................69 16.3 lens_invert ................................................69 16.4 lens_stop ..................................................................................................................70 16.5 lens_info...............................................................................................................................70 16.6 focus_pos ...........................................................................................................70 16.7 fine_focus .............................................................................................................70 16.8 focus_setup .......................................................................71 16.9 zoom_pos ...........................................................................................................71 16.10 zoom_setup ....................................................................71 16.11 iris_pos .............................................................................................................71 16.12 iris_setup ........................................................................72 16.13 iris_apt .............................................................................................................72 16.14 iris_table ... ......................................................................72 16.15 filter_pos ..........................................................................................................73 16.16 filter_setup ......................................................................73

Reference Manual ATOM one 4K mini 1 Overview This manual describes the usage of the ATOM one 4K mini camera system. The general operation of the device is described in chapter 2. Information on firmware updates is found in chapter 3. We provide an open-source, free of charge GUI application which gives easy access to most camera functions, for more details on the GUI see chapter 4. Chapter 5 and 6 describe how to connect with the device and how the settings on the device are handled using terminal commands. For details on the camera functions, please refer to the API chapters of this manual which start with chapter 7.

Reference Manual ATOM one 4K mini 2 General Operation For regular operation the camera needs only a power supply. For controlling and updating the camera a RS485 connection is required. This can be done with the given RS485 USB converter. Connect the USB connector to your PC and let the operation system install the required drivers. For RS485 an address is required to access the camera. The default address is “1”. After powering up the camera the camera will boot. The boot process takes ~3 seconds. 2.1 Connectors The ATOM one 4K has two 6 pin Hirose HR10 connectors. 1. Power: Male HR10 6 pin 2. AUX: Female HR10 6 pin 2.1.1 Power and RS485 Connector The power connector is male and will mate with a female hirose HR10A-7P-6S(73) . Note: The pin order of HR10A of male and female is counted in different directions. The following table shows the numbering and cable colors of used Dream Chip adapters. Female HR10A-7P-6S(73) Signal Cable 6 wire Cable 4 wire USB RS485 6 Power in 6-36 Volt Red Red - 5 GND Brown Brown Black (gnd) 4 RS485_TX_P Black Looped to pin 1 3 RS485_TX_N Green Looped to pin 2 2 RS485_RX_N Yellow Black Yellow (D-) 1 RS485_RX_P Orange Orange Orange (D+) 2.1.2 AUX Connector The axillary connector is female and will mate with a male hirose HR10A-7P-6P(73). Note: The pin order of HR10A of male and female is counted in different directions.

Reference Manual ATOM one 4K mini This connector has a 3,3V Uart interface to control the camera. The interface behaves like the RS485, but must be use for peer to peer conections. No adressing like on RS485 is required. The I2C interface is reserved for future use like lense control or other extentions. The following table shows the numbering and cable colors of used Dream Chip adapters. Pin HR10A-7P- 6P(73) Signal Kabel 6 polig USB RS232 TTL 1 Power out bypassed from power connector pin 6. Red - 2 GND Brown Black (gnd) 3 Uart TX Black Yellow (RX) 4 Uart RX Green Orange (TX) 5 Iris SCL Yellow 6 Iris SDA Orange 2.2 Over-Temperature Protection The ATOM one mini has a very compact design which does not allow for active cooling. Thus the device will get hot under operation. To protect the device the camera will go into a safe operational mode when the internal CPU temperature reaches 70°C, this will be indicated by toggling the status LED between orange and red. The camera will stay in this state until the CPU temperature drops below 50°C, it will then reboot automatically and resume operation. Alternatively you can power-cycle the device, but keep in mind that as long as you did not improve the cooling the camera will probably reach the temperature limit again after a short time. To keep track of the current cpu temperature use the temp command. The camera also logs the maximum CPU temperature which can be read out using the max_temp command. You can reset the logged maximum temperature using the max_temp_reset command. Every time the camera reaches the 80°C temperature limit, an over temperature counter will be incremented. You can read the counter value by using the over_temp_count command. This counter value is persistent and can not be reset by the user.

Reference Manual ATOM one 4K mini 2.3 Status LED The Status LED shows the status of the device. Value Status Note Purple blinking Booting Device is booting Yellow blinking Busy Device is processing a command or loading settings Red blinking (fast) Genlock Error Device was unable to lock to genlock signal Red blinking (slow) Bootloader Device is in bootloader mode and can be updated or update is running Toggle between Yellow and Red Over Temperature The device reached it’s maximum temperature of 80°C and is in safe mode. Power cycle device or wait until temperature drops below 50°C to resume operation. Blue blinking Ready Running, OK status

Reference Manual ATOM one 4K mini 3 Firmware Update Firmware can only be updated via a serial connection. Make sure, that the power supply of the camera and the computer for the update are in a stable state. You can download the latest updated from our GitLab repository: https://gitlab.com/dreamchip/provideo-downloads 3.1 Firmware Update via GUI You can use the ProVideo GUI (see chapter 4) to update your cameras’ firmware. This is generally a lot easier, but in some cases (e.g. incompatible GUI and firmware) not possible. To perform the update simply connect your camera with the included RS485 USB adapter to your PC, start the ProVideo GUI, go to the Update Tab, choose the Firmware file and start the update. 3.2 Firmware Update via Script The update requires a manual adaption of the update script. 3.2.1 Preparation for Update Open the folder with the firmware update on your PC. You need to know your COM port of your USB RS485 interface. This can be done by checking your “Devices and Printers” in your Windows system. You also need to know your RS485 ID of your ATOM one camera. The default is 1. Now you must edit the update_firmware.bat file and edit the to your settings. The header of the files looks like this: @echo off REM SET YOUR COM PORT TO YOUR RS485 USB COM PORT set COM_PORT=COM156 REM SET THE RS485_ID to your ATOM on Camera ID. Default is 1 set RS485_ID=1 Save your changes. 3.2.2 Update of Firmware Make sure your update_firmware.bat reflects the correct COM port and RS485_ID as shown in the previous chapter. Connect the RS485 USB adapter to your PC and to the ATOM one camera. Power up the camera and wait until its fully started. This takes ~3 seconds until the LED on the backside is blinking blue. Now start the update_firmware.bat file.

Reference Manual ATOM one 4K mini After 2 seconds the camera will go into update mode. When this happens the camera will no longer send an image and the LED on the backside starts blinking red. After 5 more seconds the firmware update starts. This process takes about ~10 minutes. After the firmware update is done, power cycle the camera.

Reference Manual ATOM one 4K mini 4 ProVideo GUI Dream Chip provides a free of charge and open source control software (ProVideo GUI) for its camera devices. You should have received a copy of the software with your camera purchase. If not, or you want to check for an updated version please visit our GitLab download page: https://gitlab.com/dreamchip/provideo-downloads If you want to develop your own control software, feel free to check out our software repository: https://gitlab.com/dreamchip/provideo-gui A user manual for the GUI is part of the GUI download package.

Reference Manual ATOM one 4K mini 5 Terminal Usage 5.1 Terminal ATOM one 4K mini can be controlled by a simple terminal connection. All commands consist of ASCI characters. 5.2 Terminal Settings For flexible configuration ATOM one 4K mini provides 2 terminal interfaces: 1. RS485 on the Power connector cable 2. RS232 TTL which is connected on the AUX connector. The default interface setting is: • 115200 baud (adjustable) • 8 bit data • no parity • 1 stop bit • no flow control The ATOM one 4k mini accepts commands in text form and answers with text messages. Every command is confirmed by "OK" or "FAIL". Errors have to be handled by the user or host software which is used to control the device. Depending on the prompt setting you get a prompt "=>" after start up. Now you can send commands to control the device or get status information. Check the next chapters to get detailed information about available commands and options. 5.3 General Command Format When the firmware is ready to accept commands, it sends its prompt ("=> ") if enabled with the prompt command. Every command line is accepted as a single text line, terminated by either CR or LF. The command consists of a command string, followed by none or more parameters, separated by a single space. The parameters can have different formats, depending of the command. Supported formats are: • Signed decimal : -323, 422 • Hexadecimal: 0x35ff34aa • String : any_string The command will be executed and may produce some text output on one or more lines . Finally the status will be sent as a single line containing either "OK" or "FAIL". In case of

Reference Manual ATOM one 4K mini 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 are depending of the given command. IMPORTANT: Any command is subject of change. We will try not to change existing commands, but any command may change in the future. Details will be announced in release notes of upcoming software versions. 5.4 RS485 Addressing On a RS485 Bus multiple ATOM one systems can be used with one RS485 Master controller. To communicate with a slave, the following command format is defined for RS485:

Where address is the RS485 address of the given ATOM one device. Example command with address 1: 1 video_mode 5 The RS485 address can be set with the rs485_addr command, valid addresses range from 0 to 99. The Address 100 is reserved as a fail-safe address. All devices will always reply to commands send on address 100, as if it was their device address. This can be used to recover or change the device address if it is lost and no other communication is possible with the device. If you want to find out which devices are currently attached to the RS485 bus, you can send the identify command over the fail-safe address 100, which will have all devices report back. See the identify command description for more details. 5.5 RS485 Broadcasting To send commands to multiple cameras, which are connected to the same RS485 bus at once, they can be grouped in broadcast groups. Therefore each camera gets a second address, the broadcast address. The broadcast address is set with the rs485_bc_addr command, it can not be identical with the normal RS485 address, the default is “0”. Once all cameras in the group are setup with the correct broadcast address, the same command format like for normal RS485 communication is used:

Where address now is the broadcast address. By default the cameras do not reply to broadcast commands with the usual “OK” or “FAIL” messages, otherwise the RS485 bus would be full with replies from the different devices. To still be able to implement a handshake with a controller software during broadcast mode it is possible to select one camera as the broadcast master. This camera will, representative for all cameras, reply to commands as usual, while all other cameras are silent.

Reference Manual ATOM one 4K mini To set the broadcast master, use the command rs485_bc_master. Note that this command may be send to an individual camera, or over the broadcast channel. Sending it over the broadcast channel ensures, that only one master is active in the system. Reminder: All of this is only valid for communication over the broadcast address, communication over the device address is unaffected and works as usual. Also see the descriptions of the rs485_bc_addr and rs485_bc_master commands for more details. 5.6 Inbuild Help Type help to get a full list of supported commands. It is possible to get a detailed help for each command by typing "help ". Example to get help for the video_mode command: help video_mode video_mode

Reference Manual ATOM one 4K mini 6 Settings Handling 6.1 Set Functions To change any settings run the matching command with its required parameters. Example: video_mode 5 OK 6.2 Get Functions Any setting can be checked by running the function without parameters or followed by a question mark. 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: video_mode video_mode 5 (returned) video_mode ? video_mode 5 (returned) 6.3 auto_save Controls auto save. Flag Function 0 Auto save OFF 1 (reset) Auto save ON With this flag any settings change will instantly saved into the current settings bank for startup. By turning this off, tests on the camera settings will not change / destroy internal saved settings. In case auto save is OFF the save_settings command must be used to store the current setup. Example: auto_save 0 6.4 save_settings ATOM one 4K has a build in storage for settings. It is automatically loaded on start up.

Reference Manual ATOM one 4K mini The save_settings command saves the current settings into the start up configuration. This function is only required in case auto_save is OFF. Example: save_settings 6.5 load_settings At any time, the saved start up configuration can be loaded with load_settings. This function is useful to try new settings. To discard the tried settings, simply run load_settings to restore the known good configuration. 6.6 reset_settings To reset the system into factory default run reset_settings. You must run save_settings to make the factory default the start up configuration. Please note that all RS485 and RS232 settings, including the baudrate and device address, and the device name are not reset by calling reset_settings. This is done so that the communication to the device is not interrupted. 6.7 dump_settings This command dumps all settings which are stored on the device in alphabetical order. This can for an example be used by a hardware controller to quickly get all settings from the device. Please note that some commands like dpc_auto_load or lut_interpolate have no settings that can be dumped and this do not show up when you call dump_settings.

Reference Manual ATOM one 4K mini 7 System Commands 7.1 rs232_baud Sets the baud rate for the RS232 terminal interface. Supported Baud rates are 9600, 14400, 19200, 57600, 115200. baud_rate 9600 14400 19200 57600 115200 (default) 7.2 rs485_baud Sets the baud rate for the RS485 terminal interface. baud_rate 9600 14400 19200 57600 115200 (default) 7.3 rs485_addr

Sets the address for the RS485 interface. It can not be set to the current value of the broadcast address, an attempt to do so will return “FAIL”. Value Default Minimal Maximal Device Address 0 0 99 Note: Make sure, that each address is unique on your RS485 bus system. If you have an address conflict, it can be checked and changed any time via RS232 console, or by removing devices from the bus until the contention is solved. The address 100 is reserved as a fail-safe address. All devices will always replay to commands send 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. 7.4 rs485_bc_addr

Sets the broadcast address for the RS485 interface. It can not be set to the current value

Reference Manual ATOM one 4K mini of the device 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 a rs_485_bc_addr command over the broadcast channel. 7.5 rs485_bc_master

This command enables the broadcast master mode on the camera with the given device address. If the command is transmitted as a get command (without an argument) it will not reply with the broadcast master address, but with a flag (0 or 1) that indicates whether this camera currently is the broadcast master or not. Transmitting a negative address will always disable the broadcast master mode. Value Default Minimal Maximal Device Address of the Broadcast Master Broadcast Master Disabled 0 99 The functionality is explained in the following example: Two cameras are connected to the same RS485 bus. Camera 1 has the device address 1 and broadcast address 0, camera two has device address 2 and broadcast address 0. To enable broadcast master mode on camera 1 and disable it on camera 2 send the following command using the broadcast channel: 0 rs485_bc_master 1 Where 0 is the broadcast address of both cameras and 1 is the device address of the new broadcast master. You will not receive an “OK” message for this command, but all following commands that are send over the broadcast channel will be answered by camera 1. Note: If the commands are not transmitted over the broadcast channel, it might happen that multiple broadcast masters exist in the system. To disable broadcast master mode on all cameras in the broadcast group send: 0 rs485_bc_master -1 7.6 rs485_term Enables or disables the internal termination of the RS485 interface. Flag Function 0 Disable Termination 1 (default) Enable Termination

Reference Manual ATOM one 4K mini 7.7 prompt Set prompt mode. Flag Function 0 (reset) No prompt 1 '=>' prompt 7.8 reboot Does a system reboot (warm start). A full reboot takes depending of configuration and camera about 30 seconds. 7.9 fw_update Set the system into USB firmware update mode. This mode is usually controlled by the Windows update software. 7.10 version Dumps a detailed version information about the system with system ID and firmware version. The output looks like this: platform: condor4k_mini_16 device name: ATOM one 4K mini system-id: 003F001E-30324703-37313437-FFFFFFFF hw revision: 00001602 system validity: LICENSED feature mask HW: 0019A01C feature mask SW: FFFFFFFF resolution mask: 00000000-00000000-000FFFFF loader version: 1328 (2) sw-release-id: V1.1.2 sw-release-date: 2017-06-15 15:38:45 +0200 (Do, 15 Jun 2017) sw-build-date: 2017-06-15 15:38:55 7.11 identify Dumps essential system information including the platform, RS485 configuration and the device name. This command can be used to identify all devices which are connected to one RS485 bus by sending it to device address 100 (the fail-safe device address). Each device will wait until it is its turn before sending its ID string. The higher the RS485 address of the device, the longer the device will wait before posting its stats, this ensures

Reference Manual ATOM one 4K mini that the bus does not get corrupted. Each device will report the following parameters: • Platform ID: This will be condor4k_mini_07, condor4k_mini_11 or condor4k_mini_16 for ATOM one 4K mini cameras, depending on the sensor size (this is identical to the platform which is reported by the version command) • RS485 ID, RS485 Broadcast Address and RS485 Broadcast Master as described in chapters 5.4 and 5.5 • Device Name: Name which can be set by the user, see chapter 7.12 for more details (this is identical to the name which is reported by the version command) Example output with two devices attached to one bus: 100 identify id: condor4k_mini_11 1 0 0 ATOM one 4K - Left OK id: condor4k_mini_16 55 0 0 ATOM one 4K - Front OK 7.12 name The device name, which is shown in the output of the version command and in the GUI can be changed using a hidden command, which is not shown in the output of the help command. The name can consist of a maximum of 5 words which, in total, have a length of 32 characters, including spaces. If the name shall be changed persistently, make sure to execute the save command after changing the name. The name will not be reset by the reset command, but it might be reset after a firmware update. Name String Default Reset Possible Values Name of the device which is shown in version and GUI ATOM one 4K Is not changed through reset Up to 5 words with 32 characters in total 7.13 out The ATOM one 4K provides 2 separate SDI outputs. This can be used for display gamma mapping like REC709 or for special work flows like HLG or PQ. Value Reset Minimal Maximal Index 1 1 2

Reference Manual ATOM one 4K mini The following image presents the SDI output flow: The out command selects the SDI output to be configured. The following table shows the effected commands: command out=1 out=2 colorconv CSM-1 CSM-2 sdi_range CSM-1 CSM-2 sdi_white CSM-1 CSM-2 sdi_black CSM-1 CSM-2 lut_preset LUT-1 LUT-2 lut_reset LUT-1 LUT-2 lut_interpolate LUT-1 LUT-2 lut_sample LUT-1 LUT-2 7.14 sdi2 The SDI-2 output can be configured to support alternative modes. Mode Function 0 (reset) Same signal as SDI-1 (mirrored) 1 Use of a separate LUT for SDI-2: With this setting the camera can provide different gamma curves for the two outputs. 2 DCT RAW12: Y = upper 6 bits of sensor input (MSB aligned) U/V = lower 6 bits of sensor input (MSB aligned) 3 DCT RAW10: Y = upper 10 bits of sensor input (uses SDI extended values from 4...1019. Raw is clipped to match this range) U/V = 0x200 = 512 (to generate a gray scale image)

Reference Manual ATOM one 4K mini 7.15 flip Sets the camera flipping or rotation mode. Caution: After changing the flip mode you will have to recalibrate your defect pixel correction table! Mode Function 0 (reset) Normal (no flip) 1 Vertical flip 2 Horizontal flip 3 Rotated by 180° 7.16 log_mode Use this command to switch the device into LOG mode. In this mode the camera will use a fixed gamma curve on both outputs (depending on the used mode, see table below). When leaving LOG mode (setting it to “0”) the previously defined settings for the gamma curve will be restored automatically. Mode Function 0 (reset) Off: The user can define the gamma curve. 1 HLG: A Hybrid LOG gamma curve is used and the gain is internally adjusted to correctly expose the image. This will limit your gain range (the minimum gain is doubled). 2 PQ: A PQ gamma curve is used. The user has to setup the maximum brightness of the attached display using the “pq_max_brightness” command (see chapter 7.17). 3 S-Log3: A S-Log3 gamma curve is used. The user can setup the gain of the curve using the “slog3_master_gain” command (see chapter 7.18). When using a LOG gamma curve more details in bright image areas are preserved, but the image will have a “flat” look. Post processing is needed to generate a naturally looking image. Depending on the LOG mode, there are some points to consider: • When LOG mode is active, you can not manually adjust the gamma curve. For more details on gamma curve and lookup-table management see chapter 12. Once you disable LOG mode, the previous gamma settings are restored. • Some workflows use the the extended SDI range in PQ mode to increase the amount of available code values. To switch to extended SDI range use the sdi_range command. • The S-Log3 standard requires extended SDI range to be used, therefore the SDI range is fixed to extended in this mode and can not be changed by the user. If you switch to a different LOG mode or disable LOG mode the previous SDI range

Reference Manual ATOM one 4K mini settings will be restored. 7.17 pq_max_brightness This command is used to adjust the brightness of the output signal in PQ LOG mode (see log_mode command above for more details). The maximum brightness can be set from 100 to 10000 cd/m2. When set to 10000 cd/m2 the image will contain all highlights (use the full SDI code range) but the image will look over exposed on most displays since they can not reproduce this brightness. At the default setting of 1000 cd/m2 most displays should show the image correctly (which means without clipping). Important: Check the maximum brightness and white clip settings of your PQ compatible display and setup the maximum brightness of the PQ curve accordingly, otherwise you will not reproduce the image correctly! Value Reset Minimal Maximal max 1000 100 10000 7.18 slog3_master_gain This command is used to adjust the gain of the output signal in S-Log3 LOG mode (see log_mode command above for more details). The master gain can be set from -6 to 12 dB and works similarly to the master gain feature of Sony broadcast cameras. When set to 10 dB the image will contain all highlights (the curve will use the full SDI code range) but most workflows use a gain of 0 dB or -3 dB. Important: Make sure to use a value that matches your post processing workflow! Value Reset Minimal Maximal gain 0 -6 12 7.19 audio_enable Enables the internal microphone and embeds the audio signal in the SDI output signal. Audio Enable Function 0 (reset) Audio is disabled 1 Audio is embedded in the SDI signal 7.20 audio_gain Change the volume of the audio stream which is embedded in the SDI output signal. The gain is given as a 4.12 fixed point number. The default is a gain of 1.0. To increase the volume set a gain greater than 1.0, to decrease it, set a gain below 1.0. To convert float to 4.12 fixed point multiply with 4096. Divide by 4096 to convert 4.12 fixed point to float.

Reference Manual ATOM one 4K mini Value Floating Point 4.12 Fixed Point Hex 4.12 Fixed Point Decimal Minimum 0.0 0x0 0 Reset 1.0 0x1000 4096 Maximum 15.99 0xFFFF 65535 Examples: To set a gain of 2.0 (double the volume) use: audio_gain 8192 or: audio_gain 0x2000 To set a gain of 0.5 (half the volume) use either: audio_gain 2048 or audio_gain 0x800 7.21 temp Dumps camera temperature values in degree centigrade. Temperature Sensor ID Function 0 System temperature (with 0.1°C accuracy) 1 CPU temperature (with 0.1°C accuracy) The output has the format temp , see the following examples: temp 0 temp 0 43.3 System OK temp 1 temp 1 61.7 CPU OK 7.22 max_temp Dumps the maximum logged temperature and the maximum allowed temperature (shut- down temperature) of the camera. This command can be used to evaluate how close the device gets to it’s maximum internal temperature of 80°C. Example: max_temp max_temp 54 65 80 OK

Reference Manual ATOM one 4K mini The first value is the maximum temperature that has been logged since the last time the user has run the max_temp_reset command (see below). The second value is the overall maximum temperature, it can not be reset by the user. The third value is the shutdown temperature, the device will go into a safe mode when it is reached and the over temperature counter will be incremented. 7.23 max_temp_reset Resets the logged maximum CPU temperature value to the current temperature. Example: max_temp_reset OK 7.24 over_temp_count Dumps the over temperature counter. This counter is incremented every time the device goes into safe mode to avoid over temperature (CPU temperature > 80°C). It is persistent and can not be reset by the user. Example: over_temp_count over_temp_count 3 OK 7.25 fan_speed Dumps the current speed of the cooling fan in %. The fan speed is automatically controlled, depending on the current system temperature. To change the cooling characteristic use the fan_target command (see below). Example: fan_speed fan_speed 42 OK 7.26 fan_target The fan_target command sets the target system temperature. The device will automatically adjust the fan speed so that the system temperature reaches the desired target temperature. After changing the target temperature, the fan controller will need a few minutes to adjust to the new target. If the target temperature is too low and can not be reached, the fan will keep running at 100%. Value Reset Minimal Maximal temp 55 30 75

Reference Manual ATOM one 4K mini Example: fan_target 60 OK 7.27 calibration_profile The ATOM one 4K mini can be shipped with two different IR-cut filters. Depending on the filter a different calibration profile has to be selected, which can be done with this command. Profile ID Description 0 Original color profile of the ATOM one 4Kmini. Use this profile if you want the look of the ATOM one 4K mini cameras like they where shipped until the end of 2020. 1 Optimized Profile that matches the original IR-cut filter that was shipped with ATOM one 4K mini cameras until the end of 2020. Use this profile if your camera has the old IR cut filter but you want improved color reproduction. 2 Profile for the newer, improved IR-cut filter that was shipped with ATOM one 4K mini cameras from Q1 2021. When being shipped each camera is already configured with the correct calibration profile, and the setting will survive a firmware update. This means usually you do not have to setup the profile yourself. You only have to touch this setting in two cases: • You have an older camera and want to use the improved calibration data with the original filter: Switch to profile 1. • You have an older camera and have upgraded to the new filter: Switch to profile 2 If you are unsure about this setting, contact the Dream Chip technical support. 7.28 volatile This command is intended to be used by system integrators. It can be used to set a 32 Bit unsigned variable to any value. The variable will keep its value until a reboot is performed, then it is reset to 0. This can for an example be used to detect if the camera has performed a reboot by setting it to a non-0 value after boot. Parameter Value after Boot Minimal Maximal value 0 0 4294967295

Reference Manual ATOM one 4K mini 8 Camera Commands ATOM one 4K mini supports different camera models. Some of the following function may not be available depending of the given camera module. 8.1 cam_gain Sets analog gain for the sensor. Value Reset Minimal Maximal gain 1000 1000 Mini 7: 106666 Mini 11: 142222 Mini 16: 111304 Mini 7: Minimum: 1000 = 1x = 0dB = 30 ISO Maximum: 106666 = 107x = 40.6bB = 3200 ISO Mini 11: Minimum: 1000 = 1x = 0dB = 45 ISO Maximum: 142222 =142x = 43bB = 6400 ISO Mini 16: Minimum: 1000 = 1x = 0dB = 115 ISO Maximum: 111304 = 111x = 40.9bB = 12800 ISO To calculate the ISO value from the analog gain you have to divide it by 1000 and then multiply it with the ISO at gain 1. To read out the ISO at gain 1 you can use the cam_info command (see below). For the ATOM one 4K mini it will report the following values: 30 (Mini 7), 45 (Mini 11), 115 (Mini 16). Examples for Mini 11: Gain 1000 → ISO = 1000 / 1000 * 45 = 45 Gain 71111 → ISO = 71111 / 1000 * 45 = 3200 Gain 142222 → ISO = 142222 / 1000 * 45 = 6400 You can read out the gain at any time, also when the auto exposure control is enabled. 8.2 cam_exposure Sets the exposure time/shutter width in microseconds. If you change the video mode and the current shutter time is bigger than the maximum possible shutter time for the new video mode, the shutter time will be clipped accordingly. You can read out the exposure at any time, also when the auto exposure control is enabled.

Reference Manual ATOM one 4K mini 8.3 cam_info This command reports the min / max gain and exposure and the ISO value of the camera at gain 1 (1000) in the following order: minimum gain, maximum gain, minimum exposure, maximum exposure, minimum ISO Example output for an ATOM one mini 11: cam_info 1000 142222 75 33333 45

Reference Manual ATOM one 4K mini 9 Video Commands 9.1 video_mode Set the output video mode of both output channels. Please note that the 4k mini version 7 only supports UHD resolutions (ID 25 to 34). If you want to output Full HD or 2K resolutions, please see the downscale command in section 9.2. Mode ID Resolution Frame Rate 25 3840x2160 (UHD) 30 26 3840x2160 (UHD) 25 27 3840x2160 (UHD) 24 28 3840x2160 (UHD) 23.98 29 3840x2160 (UHD) 29.97 30 3840x2160 (UHD) 50 31 3840x2160 (UHD) 60 32 3840x2160 (UHD) 59.94 33 3840x2160 (UHD) 48 34 3840x2160 (UHD) 47.96 35 4096x2160 (4K) 30 36 4096x2160 (4K) 25 37 4096x2160 (4K) 24 38 4096x2160 (4K) 23.98 39 4096x2160 (4K) 29.97 40 4096x2160 (4K) 50 41 4096x2160 (4K) 60 42 4096x2160 (4K) 59.94 43 4096x2160 (4K) 48 44 4096x2160 (4K) 47.96

Reference Manual ATOM one 4K mini 9.2 downscale Using the downscale command you can output Full HD or 2K resolution instead of UHD or 4K. Additionally it is possible to output interlaced video instead of progressive formats. The downscaler can be enabled individually for each of the two SDI outputs. The interlace flag is optional, it can only be enabled if downscale is also enabled. You can not enable the downscaler on the second SDI output if it is Examples: # Enable downscaler on first SDI output: 1 downscale 1 1 0 # Enable downscaler and interlacer on second SDI output: 1 downscale 2 1 1 Please not that the downscale and interlace flags are only applied if the current video mode allows it. The following table lists all valid combinations of video modes and downscale / interlace flags: Video Mode ID Mode Downscale Interlace 25 UHD p30 Full HD p30 - 26 UHD p25 Full HD p25 - 27 UHD p24 Full HD p24 - 28 UHD p23 Full HD p23 - 29 UHD p29 Full HD p29 - 30 UHD p50 Full HD p50 Full HD i50 31 UHD p60 Full HD p60 Full HD i50 32 UHD p59 Full HD p59 Full HD i59 33 UHD p48 - - 34 UHD p47 - - 35 4K p30 2K p30 - 36 4K p25 2K p25 - 37 4K p24 2K p24 - 38 4K p23 2K p23 -

Reference Manual ATOM one 4K mini 39 4K p29 2K p29 - 40 4K p50 2K p50 - 41 4K p60 2K p60 - 42 4K p59 2K p59 - 43 4K p48 2K p48 - 44 4K p47 2K p47 - 9.3 genlock Controls genlock interface. Since there currently is no standard for 4K or UHD genlock signals, the ATOM one 4K mini will lock to the usual 2K or Full HD tri-level sync signals. Just make sure that the framerate matches the framerate of the video mode. Note: The required tri-level sync signals always depends on the video mode, regardless of the current downscale setting! Example: When the camera is configured in UHD p50 mode, you have to supply a Full HD p50 tri-level sync signal, even if the downscaler and interlacer are enabled and the camera is outputting 1080i50. If you want to lock to another frequency, e.g. i50, use the genlock_crosslock command. Flag Mode Comment 0 Disable Genlock off 1 Input / Slave In this mode the system will genlock to the external tri-level sync signal. Make sure that the current video mode is compatible to the tri- level sync signal. In case a lock is not possible (unmatched formats, missing sync signal) the system will report a “Error: gen-lock error” after ~10 seconds and will start without genlock. As soon as a valid sync signal is detected the device will try to lock to it. This will cause image flickering for a few frames until the lock was established. As long as genlock is enabled, any video_mode change will try to genlock to the reference signal. The vertical and horizontal position can be programmed with genlock_offset, crosslocking can be enabled using genlock_crosslock. 2 Output / Master In this mode the genlock connector will become an output with

Reference Manual ATOM one 4K mini a tri- level sync signal. The output mode depends on the current video mode and can be changed at any time. Note: The genlock output does not have a strong driver strength. It is made for testing purposes only. It works good for short cables and can be used to simply connecting two cameras. We recommend to use external tri-level syn signals for genlock purposes. 9.3.1 Status LED The Status LED shows the status of the genlock. Value Status Note Orange Wait for lock May take up to 10 seconds Red Fail to lock, of lock lost The camera will re-lock as soon as the input signal is valid. Locking can also be triggered by changing the video mode or genlock settings. Blue Locked Default state of system 9.4 genlock_crosslock In the default operational mode the camera locks to a tri-level sync signal that matches the cameras current video mode. Using the crosslock option the camera can also lock to other input signals. This is valid for both video channels. Note: It is generally possible for the camera to crosslock on a tri-level sync signal of any of the supported video modes, but keep in mind that locking to frequencies that are not equal or half the output frequency will result in an undefined behavior, that means it is not deterministic where the lock will take place. The parameter controls the crosslock mode: enable Parameter Mode Comment 0 Disable Crosslocking is disabled, camera will lock to a genlock signal that matches the current video mode. 1 PAL The camera will crosslock to a PAL Black & Burst signal. 2 NTSC The camera will crosslock to a NTSC signal. 3 Other HD Mode The camera will crosslock to genlock signal that matches a different video mode. The other mode has to be specified using the vmode parameter.

Reference Manual ATOM one 4K mini The parameter only has to be specified, if is set to 3 (see above table). It can be set to any of the video modes which are supported by the camera (see the video_mode command for more details). Although the 4K standard does not define any interlaced video modes, it is also possible to crosslock to interlaced tri-level sync signals, see the following table for all available modes: vmode Parameter Required Tri-Levl Sync Signal 25 1080p30 / 1080i60 26 1080p25 / 1080i50 27 1080p24 28 1080p23.98 29 1080p29.07 / 1080i59.94 30 1080p50 31 1080p60 32 1080p59.94 33 1080p48 34 1080p47.96 35 2Kp30 36 2Kp25 37 2Kp24 38 2Kp23.98 39 2Kp29.97 40 2Kp50 41 2Kp60 42 2Kp59.94 43 2Kp48 44 2Kp47.96

Reference Manual ATOM one 4K mini 9.5 genlock_offset The vertical and horizontal position offset which are added to the reference sync signal can be adjusted. This can be needed when different cameras are used, or genlock crosslocking is enabled. This is valid for both video channels. Both offsets can be set in the following range: -4095 <= offset <= 4095 If only the parameter is given the will automatically be set to 0. Note on genlock offsets with genlock crosslock and usage of the interlacer: When using crosslock or the interlacer one line or pixel offset may not match one line or pixel in the output timing because the reference timing does not match the output timing in those cases. 9.6 genlock_term Controls the 75R termination of the genlock in/output. Please note, that the termination is only active, when the camera is in Genlock Slave Mode (see chapter 9.3). In Master mode this setting has no effect and the termination will always be disabled. Enable Function 0 Termination off 1 Termination on (reset) 9.7 genlock_status Use this command to query the current genlock status. The following values can be returned: Status Comment 0 Genlock is disabled (no lock required) or Genlock is enabled and the lock was successful 1 Genock is enabled and the lock was not successful. This means that the reference input signal does not match the current video or crosslock mode. 9.8 genlock_lol_filter When the genlock sync signal source is disconnected or has a malfunction (loose connection, bad cable) there can be glitches in the genlock signal. This causes the camera to detect a loss-of-link immediately followed by a valid link again. In this case the camera will initiate a resync, although it is not necessary, since the device can run without a valid sync signal for a few milliseconds without getting de-synchronized. To avoid this, a glitch filter has been implemented. Only when the genlock signal has been

Reference Manual ATOM one 4K mini lost for the time specified by this command it will be accepted as a valid loss-of-link. Usually the timeout value should be kept at its default, if you see problems with your genlock signal, e.g. the camera resyncs often, you may increase the glitch filter timeout. Value Reset Minimal Maximal time_ms 200 0 5000 9.9 sdi_black Sets the black level for SDI in legal range mode (see sdi_range). An offset value of 0 will result in SDI black value of 64 (SMTP conform). When changing this value the black level on the SDI interface can be set different than 64 (not SMTP conform). This value changes the SDI range limiter and will stretch die output values to adapt to the new range. Value Reset Minimal Maximal offset 0 -60 +60 9.10 sdi_white Sets the white level for SDI in legal range mode (see sdi_range). An offset value of 0 will result in an SDI white value of 940 (SMTP conform). When changing this value the white level on the SDI interface can be set different than 940 (not SMTP conform). This value changes the SDI range limiter and will stretch die output values to adapt to the new range. Value Reset Minimal Maximal offset 0 -80 +79 9.11 sdi_range Sets the SDI output range type. Flag Mode Digital Code Range Note 0 Legal Y ranges from 64 + sdi_black offset Y ranges from 940 + sdi_white offset U/V range from 64 to 960 Used for broadcast and monitors with defined black and white levels. 1 Extende d Y/U/V range from 4 to 1019 Used for recoding with maximum dynamic.

Reference Manual ATOM one 4K mini 9.12 post_bright Set post processing brightness. Y_out = Y + offset Neutral value is 0. Value Reset Minimal Maximal offset 0 -128 127 9.13 post_cont Set post processing contrast. Y_out = Y * factor / 128 Neutral value is 128. Value Reset Minimal Maximal factor 128 0 255 Example Pseudo Code: float contrast = 1.23f; float c = contrast * 128.0f; // c = 157.44 int value = (int) round( c ); // value = 157 # post_cont 157 9.14 post_sat Set post processing color saturation. Cb,r_out = Cb,r * factor / 128 Neutral value is 128. Value Reset Minimal Maximal value 128 0 255 Example Pseudo Code: float saturation = 1.23f; float s = saturation * 128.0f; // s = 157.44 int value = (int) round( s ); // value = 157 # post_sat 157 9.15 post_hue Set post processing color hue offset angle.

Reference Manual ATOM one 4K mini Cb’ = Cb * cos (offset * 90 / 128) + Cr * sin (offset * 90 / 128) Cr’ = -Cb * sin (offset * 90 / 128) + Cr * cos (offset * 90 / 128) Neutral value is 0. Value Reset Minimal Maximal value 0 -128 (-90 degree) 127 (+89 degree) Example Pseudo Code: float hue = 22.1f; // hue = 22.1° float h = hue * 128.0f / 90.0f; // h = 31.43111... int value = (int) round( h ); // value = 31 # post_hue 31 9.16 wb Triggers single shot white-balance. 9.17 awb Enables continuous auto white balance. Flag Function 0 (reset) disable 1 enable 9.18 awb_speed Sets the control speed of the continuous auto white balance. Value Reset Minimal Maximal speed 0 0 (slow) 2 (fast) 9.19 wb_preset Set calibrated white balance presets (gains and color-cross matrices). The available presets depend on the selected calibration profile (see chapter 7.27). List of calibrated presets for calibration profile 0: ID Illumination Color Temperature 0 Horizon 2200K 1 Candle Light (A) 2700K 2 Fluorescent (TL84) 3700K

Reference Manual ATOM one 4K mini 3 Fluorescent (CWF) 4000K 4 Daylight Sunny (D50) 5000K 5 Daylight Shadow (D62) 6200K 6 Daylight Cloudy (D65) 6500K List of calibrated presets for calibration profiles 1 and 2: ID Illumination Color Temperature 0 Tungsten 2800 2800K 1 Tungsten 3200 3200K 2 Fluorescent TL84 4200K 3 Flash 5000K 4 Daylight D55 5500K 5 Daylight D60 6000K 6 Daylight D65 6500K 7 Shady 7500K 8 Cloudy 8500K 9 Blue Sky 10000K 9.20 gain_red Set gain factor for red component for selected output channel. This function is for basic color correction or white balance. red_out = red * gain / 256 Value Reset Minimal Maximal gain 256 0 4095 Example Pseudo Code: float gain = 1.23f; float gain_scaled = gain * 256.0f; // factor = 314.88 int value = (int) round( gain_scaled ); // value = 315 # gain_red 315 9.21 gain_blue Equivalent to gain_red.

Reference Manual ATOM one 4K mini 9.22 gain_green Equivalent to gain_red. 9.23 black_master Set the black-level offset for red, green and blue-components for selected output channel. The processing is done in linear RGB domain (pre gamma). red_out = (red_in – offset-red) *4095 / (4095 – offset-red) Value Reset Minimal Maximal offset 0 -2047 2048 Examples: set black-level for all components to 100 # black_master 100 set black-level for red to 10, for green to 20 and blue to 30 # black_master 10 20 30 9.24 black_red Set offset for red component for selected output channel as black level setting. The processing is done in the linear BAYER domain (pre debayering). The offset is defined as singed value. A value of zero is treated as neutral. red_out = red - offset Value Reset Minimal Maximal offset 0 -4096 4095 9.25 black_blue Equivalent to black_red. 9.26 black_green Equivalent to black_red. 9.27 flare Set flare compensation level (= Defogging). The processing is done in the linear BAYER domain (pre debayering). The level is defined as unsigned value. A value of zero is treated as neutral (disable flare). redout=4095*(red in−l ev el *−red ) 4095−l ev el *−red

Reference Manual ATOM one 4K mini Value Reset Minimal Maximal offset 0 0 65535 Example Pseudo Code: float lvl_percent = 0.1f; // 10% compensation float lvl = lvl_percent*65536.0f; // lvl = 6553.6 int value = (int) round( lvl ); // value = 6554 => flare 6554 6554 6554 To set same compensation level for all components use: => flare 6554 9.28 filter_enable Enable function for the filter functions. Flag Function 0 disable 1 (reset) enable 9.29 filter_detail Set the detail enhance level. Value Reset Minimal Maximal level 0 0 65 9.30 filter_denoise Set the denoise level. Value Reset Minimal Maximal level 0 0 65 9.31 color_conv .. Sets the color conversion matrix. The following formula is used for the conversion. Y = (c0 *r + c1*g + c2 *b) / 4096 + 64 Cb = (c3 *r + c4*g + c5 *b) / 4096 + 512 Cr = (c6 *r + c7*g + c8 *b) / 4096 + 512 Value Reset Minimal Maximal C0 871 -8192 8191

Reference Manual ATOM one 4K mini C1 2929 -8192 8191 C2 296 -8192 8191 C3 -469 -8192 8191 C4 -1579 -8192 8191 C5 2048 -8192 8191 C6 2048 -8192 8191 C7 -1860 -8192 8191 C8 -188 -8192 8191 Example Pseudo Code: float coeff7 = -0.454152908f; float coeff7_scaled = coeff7*4096.0f; // factor = -1860.210... int value = (int) round( coeff7_scaled ); // value = -1860 # color_conv 871 2929 296 -469 -1579 2048 2048 -1860 -188 9.32 color_cross .. Sets the color cross talk matrix. The Cross-Talk block in ISP is meant for correction of cross talk effects and color space shifts inside the camera sensor. The cross talk compensation unit performs a regular RGB to R’G’B’ color space conversion, to compensate the cross talk between color components of the image sensor. Also corrections of the color space and saturation can be done by appropriate matrix coefficients. Therefore this block offers the ability to correct each pixel value with a matrix operation which looks like this: R’ = (R x c0 + G x c1 + B x c2) / 4096 G’ = (R x c3 + G x c4 + B x c5) / 4096 B’ = (R x c6 + G x c7 + B x c8) / 4096 Value Reset Minimal Maximal C0 4096 -32768 32767 C1 0 -32768 32767 C2 0 -32768 32767 C3 0 -32768 32767

Reference Manual ATOM one 4K mini C4 4096 -32768 32767 C5 0 -32768 32767 C6 0 -32768 32767 C7 0 -32768 32767 C8 4096 -32768 32767 Example Pseudo Code: float coeff7 = 1.123f; float coeff7_scaled = coeff7*4096.0f; // factor = 4599.808 int value = (int) round( coeff7_scaled ); // value = 4600 # color_cross 4096 0 0 0 4096 0 0 4600 4096 9.33 color_cross_offset Sets the color cross talk offset in the FPGA. In addition to the matrix multiplication an offset can be added to the pixel values for R, G and B separately. This offset is applied after the matrix multiplication. The offset values are two’s complement integer numbers with a range of -2048 (0x800) to 2047 (0x7FF). 0 is represented as 0x000. Value Reset Minimal Maximal red_offset 0 -2048 2047 green_offset 0 -2048 2047 blue_offset 0 -2048 2047 9.34 color_space Configures the image pipeline for the selected color space. This is a high-level command which will change both the color cross talk an color conversion matrix. If you are using a custom color cross talk matrix (see chapter 9.32) it will be automatically converted when switching the color space, but due do rounding errors in the conversion each switch will result in a more altered color cross table. The color conversion matrix (see chapter 9.31) will always be set to the default for the selected color space, this means any changes the user has made will be overwritten when the color space is changed. Value Color Space Usually used for 0 (reset) Rec.709 HD / SDR

Reference Manual ATOM one 4K mini 1 Rec.2020 UHD / HDR 9.35 mcc Multimatrix color correction control. Flag Function 0 disable 1 (reset) enable 9.36 mcc_opmode Sets the number of color angles/segments for the multi matrix. The segment 0 is at the top of the color circle with the color red. Please refer to the GUI as reference. Flag Function 0 12 1 16 2 (reset) 24 3 32 9.37 mcc_blink [] This function lets the select multi matrix color range blink with a given period time. This can be used to check if the selected colors are correct. Value Minimal Maximal Comment mask 0 0xFFFFFFFF Each bit of the mask represents the blink mode of one phase of the MCC. Setting it to 1 enables blinking for this phase. period_ms 0 0xFFFFFFFF Sets the period time of the blinking. The blink mode will be toggled each period_ms / 2 ms. This parameter is optional, if left empty, a period time of 1s will be used. 9.38 mcc_set [] [] Sets parameters for multimatrix color correction. The number of angles are depending of the mcc_opmode. This table shows 24 angles in detail compared with to a sony camera with 24 angles. For any segment the saturation and the hue can be set.

Reference Manual ATOM one 4K mini segment 0 23 Index of color segment. Each Segment has 15 degree in color space. This table shows the mapping of index compared to Sony names and angles. Segment = Angle = Color 17 = 0° BLUE 18 = 15° B+ 19 = 30° B++ 20 = 45° MG- 21 = 60° MG 22 = 75° MG 23 = 90° MG + 24 = 105° R- 01 = 120° R 02 = 135° R+ 03 = 150° R/YL 04 = 165° YL- 05 = 180° YL 06 = 195° YL+ 07 = 210° YL/G 08 = 225° G- 09 = 240° G 10 = 255° G 11 = 270° G+ 12 = 285° CY- 13 = 300° CY 14 = 315° CY+ 15 = 330° CY/B 16 = 345° B- Saturation 0 0.0 65535 3.999938965 See notes below Hue -32768 -180 degree 32768 179.99450 degree See notes below With no parameter it dumps all 24 segments. => mcc_set mcc_set 0 16384 0 mcc_set 1 16384 0 mcc_set 2 16384 0 mcc_set 3 16384 0 mcc_set 4 16384 0 … OK

Reference Manual ATOM one 4K mini You can dump one segment by specifying one segment only. => mcc_set 3 mcc_set 3 16384 0 OK Examples of setting hue and saturation of a color phase: float saturation = 1.23f; // saturation of 1.23 float s = saturation * 4096.0f; // s = 5038.08 int value = (int) round( s ); // value = 5038 float hue = 1.1f; // hue rotation by =+1.1° float h = hue * 16384 / 90; // h = 200.2489 int value = (int) round( h ); // value = 200 float hue = -4.3f; // hue rotation=-4.3° float h = hue * 16384 / 90; // h = -782.7911 int value = (int) round( h ); // value = -783 9.39 lsc Due to the physical properties of the lenses used in optical imaging a reduction of the luminescence occurs from the middle of the image sensor to its borders. This is commonly known as vignetting. This effect can be separated into natural and artificial vignetting, both can be corrected using the Lens Shading Correction module. Please note that this is an advanced feature that requires the right measurement equipment to be setup correctly (see setup instructions at the end of this chapter). The lens shading correction uses a correction function to increase the gain in the outer image areas. The parameter k configures the natural vignetting compensation (cos4 compensation), a higher value will result in a higher compensation. The parameters offset and slope configure the artificial vignetting compensation. If the value for offset is increased, the radius where the compensation starts will be increased (moved to the image border). The higher the slope, the stronger is the compensation. The values k and slope range from 0.0 to 2.0, the offset from 0.0 to 1.0. Please not that all values have to be passed as fixed point numbers in Q2.30 format, that means a value of 0.67 equals: 0.67 * 2^30 = 719407022 Value Minimal Maximal Default Comment Enable 0 1 0 Enables or disables the lens shading

Reference Manual ATOM one 4K mini correction module K 0.0 (0) 2.0 (2147483648) 0 Corrects natural vignetting, has to be given in Q2.30 fixed point format Offset 0.0 (0) 1.0 (1073741824) 0 Corrects artificial vignetting, has to be given in Q2.30 fixed point format Slope 0.0 (0) 2.0 (2147483648) 0 Corrects artificial vignetting, has to be given in Q2.30 fixed point format To setup the lens shading correction, follow these steps: 1. Point the camera at a homogeneous light source. 2. Connect the camera to a wave monitor and select a line in the middle of the image, you should see a decrease in luminescence towards the edges of the image. 3. Enable lens shading correction, start with the parameters K, Offset and Slope set to 0. 4. Now turn up the K factor, this should correct the lens shading in the middle area of the image, the edges will probably still be not ideally illuminated. Make sure to not overcompensate, this will create a wavelike appearance of the luminescence on the monitor. 5. Set the Offset to 0.5 and set to slope to a high value like 1.5, you should now clearly see where the compensation starts. Now adjust the slope until you hit the point where the luminescence starts decreasing. Finally decrease the slope until the result is not overcompensated anymore. 6. Make fine adjustments until you are satisfied with the result. Please note that, depending on the optical lens used, the aperture and focal length have influence on the lens shading, so you should use your default setup for configuring the compensation. Also it might be helpful to turn of the auto exposure during the setup.

Reference Manual ATOM one 4K mini 10 Defect Pixel Correction 10.1 dpc Enables / Disables deflect pixel correction Flag Function 0 No correction 1 (reset) Correction enabled 10.2 dpc_mode Sets defect pixel correction mode. Mode Function 0 Table based 1 Auto-detection 2 (reset) Table based + Auto-detection 10.3 dpc_test_mode Sets defect pixel test mode. By default the test mode is disabled. There are two test modes available: Calibration and Validation. In Calibration mode the camera will output a black and white image with maximum gain, which is ideal to detect defect pixels. In Validation mode the camera will output a black image with white pixels at those positions where the defect pixel correction is currently correcting pixels. You can then switch between table based or automatic detection (see dpc_mode command) to validate either functionality. Mode Function 0 (reset) Disabled 1 Calibration 2 Validation 10.4 dpc_level Sets detection mode on defect pixel correction. Level Function 0 (reset) Few defects 1 ... 2 ...

Reference Manual ATOM one 4K mini 3 Cluster defects 4 ... 5 Big cluster defects 10.5 dpc_add_pixel Add a pixel coordinate to bad pixel table or dumps the whole table. Valid values for the x and y coordinates range from 0 to resolution - 1. # add pixel coordinate 200 200 into table => dpc_add_pixel 200 200 OK # add pixel coordinate 100 100 into table => dpc_add_pixel 100 100 OK # dump table => dpc_add_pixel dpc_add_pixel 100 100 dpc_add_pixel 200 200 OK 10.6 dpc_del_pixel Deletes all pixel coordinates from the defect pixel table. 10.7 dpc_save Saves defect pixel table to persistent memory. 10.8 dpc_load Loads defect pixel table from persistent memory. 10.9 dpc_auto_load Automatically detects defect pixels and stores them in the non-persistent memory. Use dpc_add_pixel to dump the automatically filled table and dpc_save to save it persistently. To detect the pixels the device uses the same logic, that is also used for the automatic defect pixel detection. That means you can vary the amount of pixels detected by adjusting the dpc_level to the desired value. To check which pixels are currently being detected, set dpc_mode to auto-detection and dpc_test_mode to validation mode.

Reference Manual ATOM one 4K mini 11 Knee Function 11.1 knee The knee function can be used for highlight control. It is defined by the knee point in % of the display brightness (brightness after gamma was applied) and the knee slope in °. The form of the knee function is shown below. Up to the knee point (marked with “k”) the Input values will be directly mapped to the output values, that means the transfer function is linear with a slope of 1. After the knee point we use a root function to get a soft knee behavior (blue curve). The slope of the root function is defined by the angle α. The knee point can be set from 0% to 100%, usually values from 60% to 100% will be used. Using a value of 100% is identical to disabling the knee function since the linear function will be used for the whole input range. The slope can be set from 0° to 90°. A slope of 0° means all highlights which lie above the knee point will be clipped to the value k, a slope of 90° means that all highlights above the knee point will be boosted to the maximum value. A value of 45° is the default, it is equal to having the knee function disabled since the root function will then be identical to the linear function. Usually values from 20° to 40° will be used. Value Reset Minimal Maximal flag (enable) 0 (off) 0 1 knee_point [%] 85 0 100 knee_slope [°] 45 (neutral) 0 90 # enable knee at 85% with a slope of 30° => knee 1 85 30 OK

Reference Manual ATOM one 4K mini 12 Look-up Table Management The lookup table has a bit depth of 16 Bit (both input and output values). There are four ways to setup the lookup table: 1. The LUTs are fully programmable with 24 sample points. All intermediate values are calculated with a spline interpolator. 2. The LUTs can be programmed by specifying a set of parameters which will be used to calculate a gamma curve like it is specified in the REC.709 standard. This will then automatically compute the 24 sample points needed for method 1 and start the spline interpolator. 3. The LUTs can be fast configured by specifying only the desired gamma value of the REC.709 gamma function. 4. The LUTs can be configured with a fixed configuration of three presets which include the default REC.709 gamma curve and two HDR gamma curves: PQ and HLG. Method 1 and 2 are intended for offline calibration of the camera. Method 3 is intended for usage during device operation. Method 4 can be used if the gamma table is not changed during production. For method 1 and 2 the user can store 5 independent presets with 24 sample points each. The default is the standard REC.709 curve, but the presets can be changed by the user. For method 3 and 4 presets are not available. It is possible to use one LUT for both SDI outputs, or use two separate LUTs for the SDI-1 and SDI-2 output. Please refer to sdi2 command for details. The LUT's can be configured for each color component separately (Red, Green, Blue) when using method 1. Method 2 and 3 will setup all components identically. 12.1.1 How to setup a lookup table using interpolation When using interpolation switch to lut mode 0: lut_mode 0 Method 1: For manual LUT setup the following steps are required. 1. Disable LUT: lut_enable 0 0 for LUT-1, lut_enable 1 0 for LUT-2 2. Select LUT to configure: out 1 for LUT-1, out 2 for LUT-2 3. Select preset storage: lut_preset 0 4. Clear current LUT configuration: lut_reset 5. Add your sample points: lut_sample 100 200 200 400 500 2000 <...> 6. Calculate LUT curve: lut_interpolate 7. Enable LUT again: lut_enable 0 1 for LUT-1, lut_enable 1 1 for LUT-2 Method 2: For functional LUT setup the following steps are required. The functional LUT will calculate sample points based on a function.

Reference Manual ATOM one 4K mini 1. Disable LUT: lut_enable 0 0 for LUT-1, lut_enable 1 0 for LUT-2 2. Select LUT to configure: out 1 for LUT-1, out 2 for LUT-2 3. Select preset storage: lut_preset 0 4. Set your sample points (includes clear): lut_fun_rec709 <...> 5. Calculate LUT curve: lut_interpolate 6. Enable LUT again: lut_enable 0 1 for LUT-1, lut_enable 1 1 for LUT-2 Switch Presets: For preset LUT setup the following steps are required. Presets are user sets to be loaded. 1. Disable LUT: lut_enable 0 0 for LUT-1, lut_enable 1 0 for LUT-2 2. Select LUT to configure: out 1 for LUT-1, out 2 for LUT-2 3. Select preset storage: lut_preset 0 4. Calculate LUT: lut_interpolate 5. Enable LUT again: lut_enable 0 1 for LUT-1, lut_enable 1 1 for LUT-2 12.1.2 How to setup a lookup table using the fast gamma function When using fast gamma setup switch to lut mode 1: lut_mode 1 Method 3: The fast gamma lut setup will calculate the lut using a function by specifying only the desired gamma value: 1. Select LUT to configure: out 1 for LUT-1, out 2 for LUT-2 2. Make sure LUT is enabled: lut_enable 0 1 for LUT-1, lut_enable 1 1 for LUT-2 3. Setup gamma value: lut_fast_gamma <...> 12.1.3 How to setup a lookup table using the fixed gamma mode When using the fixed gamma mode switch to lut mode 2: lut_mode 2 Method 4: The fixed gamma lut setup will calculate the lut by using different gamma functions: 1. Select LUT to configure: out 1 for LUT-1, out 2 for LUT-2 2. Make sure LUT is enabled: lut_enable 0 1 for LUT-1, lut_enable 1 1 for LUT-2 3. Setup fixed gamma curve: lut_fixed_mode <...> 12.2 lut_enable Enable function for look up table. Index Function 0 LUT-1 on SDI-1 1 LUT-2 on SDI-2

Reference Manual ATOM one 4K mini Flag Function 0 Disable (linear) 1 (reset) Enable Examples: # enable LUT of SDI-2 => lut_enable 1 1 OK # dump current LUT states => lut_enable lut_enable 0 1 lut_enable 1 1 OK # dump current status of LUT on SDI-2 => lut_enable 1 lut_enable 1 1 OK 12.3 lut_mode Selects the LUT operational mode. Value Reset Minimal Maximal Mode 0 0 2 There are three operational modes available: Mode Description 0 Table based using interpolation. The user has to specify a table with a maximum of 24 values. Intended for offline calibration. 1 Fast gamma mode where the user only specifies the desired gamma value. Can be used for gamma changes during runtime. 2 Fixed gamma mode where the user selects one of three fixed gamma tables. 12.4 lut_preset Selects the preset storage for the current LUT interpolator. Value Reset Minimal Maximal

Reference Manual ATOM one 4K mini index 0 0 4 The ATOM one can internally handle 5 presets. Any preset can be modified by the customer. Index Factory preset 0 REC709 1 Linear 2 Linear 3 Linear 4 Linear Example: => lut_preset 0 OK 12.5 lut_sample ... Defines the sample points in a lookup table. The x-value is the input value, the y-value is output. Value Minimal Maximal Comment xi_n 0 65535 16 bit input value yi_n 0 65535 16 bit output value Sets the up to 8 sample points of 24 for the look up definition for all colors. For setting more than 8 points, the function can be called multiple times. In case a x-position is set twice, the previous value is overwritten. When more than 24 points are defined, an error message is dumped. If the gamma curve is set with this function, save_settings will start the system with this values on boot up. Note: To read back the current sample points you must use the lut_sample_ Command. lut_sample will not return sample data. Examples: # reset sample points and add start/end point => lut_reset OK # dump sample points

Reference Manual ATOM one 4K mini => lut_sample_red lut_sample_red 0 0 65535 65535 OK # overrule start and end point lut_sample_red 0 1000 65535 64000 OK # start curve interpolation => lut_interpolate OK 12.6 lut_sample_red ... Same as lut_sample, but only for red component. 12.7 lut_sample_green ... Same as lut_sample, but only for red component. 12.8 lut_sample_blue ... Same as lut_sample, but only for red component. 12.9 lut_interpolate Interpolates all look up tables based on the given sample points. 12.10 lut_interpolate_red Interpolates the red look up table based on the given sample points. 12.11 lut_interpolate_green Interpolates the red look up table based on the given sample points. 12.12 lut_interpolate_blue Interpolates the red look up table based on the given sample points. 12.13 lut_reset Clears all look up sample points. 12.14 lut_reset_red Clears all red look up sample points. 12.15 lut_reset_green Clears all green look up sample points.

Reference Manual ATOM one 4K mini 12.16 lut_reset_blue Clears all blue look up sample points. 12.17 lut_fun_rec709 Sets sample points according to REC.709 for the current LUT. Existing sample points will be cleared before run. Sets the gamma curve for all 3 colors. If the gamma curve is set with this function, save_settings will start the system with this values on boot up. Value Minimal Maximal REC.709 Threshold 0 1000 18 Contrast (linear) 0 10000 4500 Brightness (linear) -1000 1000 0 Contrast (non-linear) 0 10000 1099 Gamma (non-linear) 0 1000 450 Brightness (non- linear) -1000 1000 -99

Reference Manual ATOM one 4K mini Note: The values are normalized to a range from 0.0 to 1.0 and multiplied by a scaling coefficient of 1000. The following image shows the normalized REC.709 gamma curve and it's transition from linear to non-linear (power function) part. The linear part ranges from 0 to <0.018 and is computed by the following formula: V out=4.5∗V in The maximum value in this range is: V out,min= lim V in→0.018 (4.5∗V in)=4.5∗0.018=0.081 The non-linear part ranges from 0.018 to 1 and is computed by the following formula: V out=1.099∗V in 0.45−0.099 The minimum value in this range is: V out,min=1.099∗0.018 0.45−0.099=0.081... To avoid a discontinuity in the gamma-function select the brightness (offset) for the non-

Reference Manual ATOM one 4K mini linear part by the following formula: V out, linear max≈V out, non-linear min Brightnessnon-linear≈(Contrast linear∗threshold+Brightnesslinear)−Contrastnon-inear∗threshold Gamma Example Pseudo Code to setup a REC.709 gamma curve: float threshold = 0.018; float linear_contrast = 4.5f; float linear_brightness = 0.0f; float gamma = 0.45f; float contras = 1.099f; float brightness = -0.099f; int t = (int) round( threshold * 1000.0f ); // t = 18 int lc = (int) round( linear_contrast * 1000.0f ); // lc = 4500 int lb = (int) round( linear_brightness * 1000.0f ); // lb = 0 int c = (int) round( contrast * 1000.0f ); // c = 1099 int g = (int) round( linear_contrast * 1000.0f ); // g = 450 int b = (int) round( brightness * 1000.0f ); // b = -99 Example curve for REC.709: => lut_gamma 18 4500 0 1099 450 -99 OK 12.18 lut_fast_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. All other values are fixed or computed as needed. Value Minimal Maximal REC.709 Gamma 1100 3000 2222 Note: The value is normalized to a range from 0.0 to 1.0 and multiplied by a scaling coefficient of 1000. Setting a value of 2222 will result in the default REC.709 gamma curve. 12.19 lut_fixed_mode The fixed gamma mode allows to choose between three fixed gamma tables which are

Reference Manual ATOM one 4K mini shown in the table below. Mode Description 0 (default) REC.709 gamma curve. 1 PQ gamma curve specified in ITU-R BT.2100 which can be used for HDR content. This will use the PQ curve with a maximum brightness of 10000 cd/m2 which results in the full SDI code range being used. If you need other values, use the log_mode and pq_max_brightness command instead. 2 HLG gamma curve specified in ITU-R BT.2100 which can be used for HDR content. 3 S-Log3 gamma curve specified by Sony which can be used for HDR content. This will use the S-Log3 curve with a master gain of 10 dB which results in the full SDI code range being used. If you need other values use the log_mode and slog3_master_gain commands instead. Note: Instead of using the lut_fixed_mode command, consider using the log_mode which adds an internal gain adjustment for the HLG curve, a maximum brightness setting for the PQ curve and a master gain setting for the S-Log3 curve. See chapter 7.16 for details.

Reference Manual ATOM one 4K mini 13 Image statistic commands 13.1 stat_rgb Dumps the RGB mean values. Example: stat_rgb stat_rgb 1040 896 1200 Output description: • Average Red = 1040 (12 bit) • Average Green = 896 (12 bit) • Average Blue = 1200 (12 bit) 13.2 stat_hist Set histogram statistics mode. Mode Histogram statistic 0 disable 1 RGB combined histogram 2 R histogram 3 G histogram 4 B histogram Y Y (luminance) histogram Note: The histogram is measured in 16 intensity intervals. The interval width is 2^12/16. The first interval ranges from intensity level 0 to 255, the 2nd interval from 256 to 511, the 3rd interval from 512 to 767 and so on. Example: # enable RGB combined histogram stat_hist 1 OK # show histogram statistic stat_hist # system dumps stat_hist 1 134120 160777 70308 40823 31308 21310 33414 50317 48382 30265 23750 17518 9922 3485 2658 7213 Output description:

Reference Manual ATOM one 4K mini Parameter Value Description mode 1 RGB combined histogram Interval-0 134120 Interval-0 contains 134120 pixel. Interval-1 160777 Interval 1 contains 160777 pixel. Interval-2 70308 Interval 2 contains 70308 pixel. Interval-3 40823 Interval 3 contains 40823 pixel. ... ... ... 13.3 stat_exp Set exposure statistics mode. Mode Exposure statistic 0 disable 1 Y - Luminance average (12 bit) Note: The exposure statistic is measured in 5x5 (25) sub-windows which results into 25 mean luminance/exposure values. The width of a sub-window is resolution width divided by 5. The height of a sub window is resolution height divided by 5. Following table shows the numbering of the statistic values: Y0 Y1 Y2 Y3 Y4 Y5 Y6 Y7 Y8 Y9 Y10 Y11 Y12 Y13 Y14 Y15 Y16 Y17 Y18 Y19 Y20 Y21 Y22 Y23 Y24 Example: # enable luminance statistics stat_exp 1 OK # show exposure statistic stat_exp # system dumps stat_exp 1 3872 3872 3872 3872 3888 3872 3872 3872 3872 3888 3872 3872 3872 3888 3888 3872 3888 3888 3872 3888 3872 3888 3888 3872 3888 Output description:

Reference Manual ATOM one 4K mini Parameter Value Description mode 1 Exposure statistic enabled sub-window 0 3872 Sub window 0 (upper left corner) has a mean luminance of 3872. sub-window 1 3872 Sub window 1 has a mean luminance of 3872. ... … ... sub-window 24 3888 Sub window 24 (lower right corner) has a mean luminance of 3888

Reference Manual ATOM one 4K mini 14 SDI Time code 14.1 timecode The SDI signal has an embedded time code. Since ATOM one 4K has no real time clock, the time code can be set manually. Sets SDI time code. Example: # get current time code timecode # system dumps: timecode 0 57 24 OK # set sdi time code to 2h 10m 53s timecode 2 10 53 # system acknowledges: OK 14.2 timecode_hold This command can be used to hold the timecode on the SDI output. This can be used to trigger recording in an external flash recorder. Note that the timecode will continue to run in the camera, this means as soon as hold is released the SDI timecode will jump to the current value. Flag Timecode Hold 0 Normal operation, SDI timecode is running 1 Hold, SDI timecode is unchanged until hold is released

Reference Manual ATOM one 4K mini 15 Auto Exposure 15.1 aec Configures auto exposure control. The auto exposure is fully controllable by the user. Depending of the application the user can decide how the exposure control should work. The target luminance is set by the setPoint, this will determine how bright the image looks. A higher setPoint results in a brighter exposed image. By default the auto exposure does not use the full available gain range. Use the maxGain parameter to change the maximum sensor gain which is used by the algorithm. Please note, that high maximum gain values can make the auto exposure control unstable. If the lighting conditions allow it, the exposure control will avoid flicker effects caused by artificial (indoor) lights by only using shutter times which are multiples of a given flicker frequency taf. For countries with power frequencies of 50 Hz (e.g. Europe) you should use a taf value of 10000 µs, in countries with a 60 Hz power frequency (e.g. USA), use a value of 8333 µs. The speed determines how fast the exposure control reacts to luminescence changes. A higher value means a slow reaction to changes. The sensitivity determines how big a luminescence change has to be before the auto exposure control reacts to it. A higher value means a bigger change in luminescence is needed. By settings a “cost” factors for gain, exposure or aperture the user can set priorities how the exposure should work. The parameter with the lowest costs is most preferred by the auto exposure control, the parameter with the highest costs will be kept as low as possible. Setting a cost factor to 0 will remote this parameter out of the automatic loop. The user must set this factor to fixed value. Check the examples below to get an idea how it works. Aperture control (auto iris) is only available on some OEM devices, or if an external lens drive unit is attached (see chapter 16). To enable it set costApt to a non-zero value. To use a customized aec algorithm set the “useCustomWeights” flag. For more information on how to setup the custom weighting, see chapter 15.2. Function call: aec Parameter Description Remarks enable 0: disable, 1: enable aec setPoint Target luminance Range 256...3000, Default 1000 speed Control speed Range 3…30, Default: 10

Reference Manual ATOM one 4K mini clmTolerance Sensitivity (threshold) Range 10...500. Default: 50 costGain Cost factor analog gain Range 0, 250...8000. Default: 8000 costTint Cost factor exposure Range 0, 250...8000. Default: 250 costApt Cost factor aperture Range 0, 250...8000. Default: 0 (disabled) taf Anti Flicker period in [µs] Range 5000...20000, Default: 10000 Following values are usually used: 10000 for 50 Hz (e.g. for EU countries) 8333 for 60 Hz (e.g. for USA) maxGain Maximum sensor gain which is used by the auto exposure control See the cam_gain command for the valid range, by default a value of 12800 is set which equals a gain of 1600 ISO useCustomWeights 0: disabled, 1: enabled By default the AEC uses an optimized algorithm to determine the needed exposure which also takes into account back light lighting conditions. If you want to use a more simple but customizable algorithm, enable this option. See chapter 15.2 for more details on how to setup the custom weights. Examples: # disable aec completely aec 0 # enable aec with luminance 2500, don't touch the other parameters aec 1 2500 # enable aec with luminance 2500, 60 Hz anti flicker period # and other parameters set to default values aec 1 2500 10 50 8000 250 0 8333 # no iris, gain fixed only shutter control aec 1 1000 10 50 0 1000 cam_gain 1000 # no iris, exposure fixed only gain control aec 1 1000 10 50 1000 0 cam_exposure 5000 # limit gain to 15000, other parameters at default aec 1 1000 10 50 8000 250 0 10000 15000

Reference Manual ATOM one 4K mini 15.2 aec_weight By default the AEC uses an optimized algorithm to determine the needed exposure which also takes into account back light lighting conditions. This algorithm should work fine for most use cases, but some might require manually tweaking the auto exposure. To do this use the aec command and set the “useCustomWeights” flag (see chapter 15.1 for more details). Value Minimal Maximal Description index 1 25 Index of the field which weight shall be changed weight 1 25 Weight of the field at the given index In custom mode the auto exposure uses a 5x5 grid which is equally split across the image. In each field of the grid the average brightness is measured. For each field a weight can be specified, which determines how strong the average brightness of this field is taken into account by the auto exposure algorithm. The following table shows the index of each field of the grid: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 By default all fields are weighted equally (with a factor of 1). If, for an example, the top- right corner of the image is the most important part of the currently filmed scene, but it is over- or underexposed with the default setting, a solution is to increase the weight of the fields 4,5, 9 and 10 to a higher value, e.g. 5: aec_weight 4 5 aec_weight 5 5 aec_weight 9 5 aec_weight 10 5 This will take the average brightness of those fields more into account, leading to this parts being correctly exposed, at the cost that the rest of the image will not be perfectly exposed. 15.3 stat_ae Dump auto exposure statistics Example: # Get stat_ae information

Reference Manual ATOM one 4K mini stat_ae Parameter Description z Backlight factor x 1000 lumaDeviation Control deviation semSetPoint Modified target value meanLuma Mean luminance meanLumaObject Mean luminance of object region meanHistogram Mean luminance determined by histogram clmHistogramSize Histogram bin count sumHistogram Sum of histogram values maxExposure Maximum abstract exposure value newExposure New calculated abstract exposure value targetExposure New calculated abstract exposure value after low pass filter realExposure Actual abstract exposure value gain Analog gain tint Exposure time aperture Aperture factor

Reference Manual ATOM one 4K mini 16 Lens Drive Unit The following commands control the external lens drive unit (if attached). 16.1 lens_setup

The lens_setup command configures the camera to find the connected motor controller. The main idea is that there is a lens drive unit connected to the camera, that has a number of motors. To determine which motor moves the iris, or the focus, the “Nr” parameters point to the motor that moves the according function. This approach is used to make the lens drive unit as flexible as possible. Parameter Description address I2c address of the motor controller, ranges from 0x20 (32) to 0x2F (47). chipID the built-in chip id of the motor controller. This is used to determine the correct device on the i2c bus, ranges from 0 to 255 (check motor driver manual). lensFeatures This parameter shows which motor in the motor controller is active. [bit0] = 1: Motor 1 is active [bit1] = 1: Motor 2 is active [bit2] = 1: Motor 3 is active [bit3] = 1: Motor 4 is active The parameter is the resulting decimal number. focusNr Determines which motor moves the focus. Range: [0…3]. If the motor controller has no focus movement, use the number of a unused motor. zoomNr Determines which motor moves the zoom. Range: [0…3]. If the motor controller has no zoom movement, use the number of a unused motor. irisNr Determines which motor moves the iris. Range: [0…3]. If the motor controller has no iris movement, use the number of a unused motor. filterNr Determines which motor moves the filter. Range: [0…3]. If the motor controller has no focus movement, use the number of a unused motor. focusFeatures Determines the features of the motor: [bit0] = 1: position control (mandatory if motor active) [bit1] = 1: speed control [bit2] = 1: step mode control

Reference Manual ATOM one 4K mini [bit3] = 1: torque control focusFeatures Determines the features of the motor: [bit0] = 1: position control (mandatory if motor active) [bit1] = 1: speed control [bit2] = 1: step mode control [bit3] = 1: torque control zoomFeatures Determines the features of the motor: [bit0] = 1: position control (mandatory if motor active) [bit1] = 1: speed control [bit2] = 1: step mode control [bit3] = 1: torque control irisFeatures Determines the features of the motor: [bit0] = 1: position control (mandatory if motor active) [bit1] = 1: speed control [bit2] = 1: step mode control [bit3] = 1: torque control filterFeatures Determines the features of the motor: [bit0] = 1: position control (mandatory if motor active) [bit1] = 1: speed control [bit2] = 1: step mode control [bit3] = 1: torque control 16.2 lens_active This command can be used to activate the lens drive unit. To do so call it with the activate parameter set to “1”. Any other value for the activate parameter will return an error. The camera searches for a lens drive unit at the AUX connector. For this search the settings of chapter 16.1 are used. If the camera was not able to find the lens, it returns a failure. Example: lens_active 1 Note: Sometimes the activate command returns with an error, even if the lens driver is correctly configured. In this case, save the settings in the camera (see 6.4) and power- cycle the camera. This command can also be used to determine the current status of the lens drive unit: Return Value Description 0 No lens drive unit connected / lens drive unit not active 1 Lens drive unit is active 16.3 lens_invert This command can be used to invert the movement of the motors.

Reference Manual ATOM one 4K mini InvFilter/Iris/Zoom/Focus Motor behavior 0 Motor moves normal 1 Motor moves inverted Example: # invert the iris movement lens_invert 0 1 0 0 16.4 lens_stop This command can be used to stop all motors as fast as possible, if the parameter is set to 1. This command can be used for a emergency stop. 16.5 lens_info This command dumps information about the lens driver, it has no parameters. Example: lens_info 1 0 1 0 28 160 The six values have the following meaning: Value Number Description Example (see above) 1 Focus Motor available 1: Focus Motor is available 2 Zoom Motor available 0: Zoom Motor is not available 3 Iris Motor available 1: Iris Motor is available 4 Filter Motor available 0: Filter Motor is not available 5 Maximum Aperture (divide by 10 to get F-Stop value) 28: Maximum Aperture in F-Stops is F2.8 6 Minimum Aperture(divide by 10 to get F-Stop value) 160: Minimum Aperture in F-Stops is F16.0 16.6 focus_pos This command can be used to drive the focus to a new position, or to determine the current position. Parameter Description Remarks position Current focus position Range 0...100 16.7 fine_focus This command can be used to increase the focus position range from 100 to 1000. enable Focus position range

Reference Manual ATOM one 4K mini 0 0...100 1 0...1000 16.8 focus_setup This command can be used to control the focus motor speed, step mode and torque. If a motor does not support one or more of this features, the value is set to zero. To determine, if a motor support a setting, see chapter 16.1. Parameter Description Remarks speed Focus motor speed Range [%]: 0...100 stepMode Focus motor step Mode, determines if the stepper motor is driven in full, half, or micro step mode Range [%]: 0...100 This Parameter is only usable, if the lens drive unit uses stepper motors and if it can control the step mode. For the detailed information, reference to the connected lens drive unit manual. torque Focus motor torque Range [%]: 0...100 The torque parameter can be used by the lens drive unit, to define a maximum torque during, the motor operation, or to define an abstract turn off parameter for a collision detection. For detailed information refer to the manual of the lens drive unit. Example: # set the focus speed to 82 and the torque to 50. Setting of the step mode is not supported by the lens drive unit: focus_setup 82 0 50 16.9 zoom_pos This command can be used to determine and set the current zoom position. The command works like the focus position command described in chapter 16.6. 16.10 zoom_setup This command can be used to control the zoom motor speed, step mode and torque. The command works like the focus settings command described in chapter 16.8. 16.11 iris_pos This command can be used to determine and set the current iris position. The command works like the focus position command in chapter 16.6. Note: The iris position can only by changed if the iris is currently not controlled by the auto

Reference Manual ATOM one 4K mini exposure (costApt set to 0, see aec command in chapter Error: Reference source not found). 16.12 iris_setup This command can be used to control the iris motor speed, step mode and torque. The command works like the focus settings command in chapter 16.8. 16.13 iris_apt This command can be used to set the iris to a aperture position, or to determine the current iris aperture. This command works only reliable if, the aperture/ position table (see chapter 16.14) filled in correctly. Parameter Description Remarks aperture Iris aperture The Range is defined by the min. aperture and max. aperture in the aperture/ position table. The F-Stop value is multiplied with a factor of 10, to avoid aperture values with rational numbers. Example: # set the iris aperture to F-Stop 5.6: iris_apt 56 # set the iris aperture to F-Stop 16: iris_apt 160 # set the iris aperture to F-Stop 4.3: iris_apt 43 16.14 iris_table ... This command can be used to set the aperture/position table. This table is used to determine the correct position of the iris in F-stops, if the user sends a iris_apt (see chapter 16.13) command. The camera uses the given points of the table and uses a linear interpolation between the given points. Up to 9 aperture/position pairs can be given, at least one pair has to be specified otherwise the command will fail. Unspecified pairs will be set to 0 which disables this table entry. Parameter Description Remarks apt0...8 Iris aperture value The F-Stop value is multiplied with a factor of 10, to avoid aperture values with rational numbers.

Reference Manual ATOM one 4K mini pos0...8 Iris aperture position value Range 0...100. The table has to be transmitted sorted from the highest to the lowest aperture value. All unused (not active) points in the table should be omitted, or set to zero. Example: # Transmit the following table to the camera: F-Stop 16 11 8 5.6 4 2.8 2 1.4 0 Position 90 84 79 72 62 49 29 0 0 Active Active Active Active Active Active Active Active Active Not Active iris_table 160 90 110 84 56 72 40 62 28 49 20 29 14 0 0 0 16.15 filter_pos This command can be used to determine and set the current filter position. The command works like the focus position command described in chapter 16.6. 16.16 filter_setup This command can be used to control the filter motor speed, step mode and torque. The command works like the focus settings command described in chapter 16.8.