Dream Chip ATOM one SSM500 Reference Manual

Reference Manual ATOM one SSM500 Table of Contents 1 Overview.........................................................................................................................................6 1.1 Operation modes......................................................................................................................6 1.2 Trigger Mode...........................................................................................................................7 1.2.1 Production Preparation.....................................................................................................7 1.2.2 Trigger Workflows...........................................................................................................8 1.2.2.1 Link Channels...........................................................................................................8 1.2.2.2 Pull Settings..............................................................................................................8 1.3 SSM Mode...............................................................................................................................9 2 Technical Details...........................................................................................................................10 2.1 Image Processing Pipeline – Trigger Mode...........................................................................10 2.1.1 Recording System..........................................................................................................11 2.1.2 Workflow Details...........................................................................................................11 2.1.2.1 Workflow A: Independent Live and Playback Chains............................................12 2.1.2.2 Workflow B: Linked Live and Playback Chains:...................................................12 2.2 Image Processing Pipeline – SSM Mode...............................................................................13 2.2.1 Workflow Details...........................................................................................................13 3 General Usage...............................................................................................................................14 3.1 Power On/Off.........................................................................................................................14 3.2 Connectors.............................................................................................................................14 3.2.1 Power and RS485 Connector.........................................................................................14 3.2.2 AUX Connector..............................................................................................................15 3.2.3 Microphone Input...........................................................................................................16 3.2.4 RJ45 Ethernet Connector...............................................................................................16 3.2.5 SD Card Slot..................................................................................................................16 3.3 Over-Temperature Protection.................................................................................................16 3.4 Status LEDs...........................................................................................................................16 3.5 OLED Display.......................................................................................................................17 4 Firmware Update...........................................................................................................................18 4.1 Firmware Update via GUI.....................................................................................................18 4.2 Firmware Update via Web Interface......................................................................................18 4.3 Firmware Update via SD Card...............................................................................................19 5 ProVideo GUI................................................................................................................................20 6 Terminal Usage..............................................................................................................................21 6.1 Terminal.................................................................................................................................21 6.2 Terminal Settings...................................................................................................................21 6.3 General Command Format.....................................................................................................21 6.4 RS485 Addressing..................................................................................................................22 6.5 RS485 Broadcasting..............................................................................................................22 6.6 Inbuild Help...........................................................................................................................23 6.7 Command parser....................................................................................................................23 7 Settings Handling..........................................................................................................................24 7.1 Set Functions..........................................................................................................................24 7.2 Get Functions.........................................................................................................................24 7.3 auto_save ....................................................................................................................24 7.4 save_settings..........................................................................................................................25

Reference Manual ATOM one SSM500 7.5 load_settings..........................................................................................................................25 7.6 reset_settings..........................................................................................................................25 7.7 dump_settings........................................................................................................................25 7.8 copy_settings.........................................................................................................................25 7.9 link_settings ...............................................................................................................26 8 System Commands........................................................................................................................28 8.1 rs232_baud .......................................................................................................28 8.2 rs485_baud .......................................................................................................28 8.3 rs485_addr

............................................................................................................28 8.4 rs485_bc_addr

......................................................................................................29 8.5 rs485_bc_master

...................................................................................................29 8.6 rs485_term .................................................................................................................29 8.7 prompt ........................................................................................................................30 8.8 shutdown................................................................................................................................30 8.9 reboot.....................................................................................................................................30 8.10 switch_mode ...............................................................................................................30 8.11 fw_update.............................................................................................................................31 8.12 version..................................................................................................................................31 8.13 identify.................................................................................................................................31 8.14 name ............................................................................................................32 8.15 out ..........................................................................................................................32 8.16 flip .........................................................................................................................32 8.17 log_mode ...............................................................................................................33 8.18 pq_max_brightness ..................................................................................................33 8.19 slog3_master_gain ..................................................................................................34 8.20 audio_enable ............................................................................................................34 8.21 audio_gain ...............................................................................................................34 8.22 audio_micbias ..........................................................................................................35 8.23 temp ..................................................................................................................35 8.24 max_temp.............................................................................................................................35 8.25 max_temp_reset...................................................................................................................36 8.26 over_temp_count.................................................................................................................36 8.27 health....................................................................................................................................36 8.28 selftest..................................................................................................................................38 8.29 calibration_profile .......................................................................................................38 8.30 volatile ...................................................................................................................39 9 Camera Commands.......................................................................................................................40 9.1 cam_gain ...................................................................................................................40 9.2 cam_exposure ............................................................................................................40 9.3 cam_info................................................................................................................................40 10 Video Commands........................................................................................................................41 10.1 video_mode ...........................................................................................................41 10.2 fps_mode ...............................................................................................................41 10.3 phases ......................................................................................................................43 10.4 fps.........................................................................................................................................44 10.5 genlock ..................................................................................................................44 10.5.1 Status LED...................................................................................................................45

Reference Manual ATOM one SSM500 10.6 genlock_status......................................................................................................................45 10.7 genlock_lol_filter .............................................................................................46 10.8 sdi_black ................................................................................................................47 10.9 sdi_white ...............................................................................................................47 10.10 sdi_range ................................................................................................................47 10.11 post_bright ...........................................................................................................48 10.12 post_cont .............................................................................................................48 10.13 post_sat ...............................................................................................................48 10.14 post_hue ..............................................................................................................48 10.15 wb ......................................................................................................................49 10.16 awb .........................................................................................................................49 10.17 awb_speed ...........................................................................................................49 10.18 wb_preset ..................................................................................................................49 10.19 gain_red .................................................................................................................50 10.20 gain_blue ...............................................................................................................51 10.21 gain_green .............................................................................................................51 10.22 black_master ..................................................51 10.23 black_red .............................................................................................................51 10.24 black_blue ...........................................................................................................51 10.25 black_green .........................................................................................................52 10.26 flare ....................................................................52 10.27 filter_enable ...........................................................................................................52 10.28 filter_detail ...........................................................................................................52 10.29 filter_denoise ........................................................................................................52 10.30 color_conv .. ....................................................................................................53 10.31 color_cross .. ...................................................................................................53 10.32 color_cross_offset .......................................54 10.33 color_space..................................................................................................55 10.34 mcc .........................................................................................................................55 10.35 mcc_opmode ..........................................................................................................55 10.36 mcc_blink []....................................................................................55 10.37 mcc_set [] []......................................................................56 10.38 lsc ...................................................................................57 11 Defect Pixel Correction...............................................................................................................59 11.1 dpc ............................................................................................................................59 11.2 dpc_mode ...............................................................................................................59 11.3 dpc_test_mode .......................................................................................................59 11.4 dpc_level .................................................................................................59 11.5 dpc_add_pixel .......................................................................................................60 11.6 dpc_del_pixel ...............................................................................................60 11.7 dpc_save...............................................................................................................................60 11.8 dpc_load...............................................................................................................................60 11.9 dpc_auto_load......................................................................................................................61 12 Knee Function.............................................................................................................................62 12.1 knee ..........................................................................................62 13 Look-up Table Management........................................................................................................63 13.1.1 How to setup a lookup table using interpolation..........................................................63

Reference Manual ATOM one SSM500 13.1.2 How to setup a lookup table using the fast gamma function.......................................64 13.1.3 How to setup a lookup table using the fixed gamma mode.........................................64 13.2 lut_enable ...................................................................................................64 13.3 lut_mode ................................................................................................................65 13.4 lut_preset ...............................................................................................................65 13.5 lut_sample ... .....................................................................66 13.6 lut_sample_red ... ..............................................................67 13.7 lut_sample_green ... ...........................................................67 13.8 lut_sample_blue ... ............................................................67 13.9 lut_interpolate......................................................................................................................67 13.10 lut_interpolate_red.............................................................................................................67 13.11 lut_interpolate_green.........................................................................................................67 13.12 lut_interpolate_blue...........................................................................................................67 13.13 lut_reset..............................................................................................................................67 13.14 lut_reset_red.......................................................................................................................67 13.15 lut_reset_green...................................................................................................................67 13.16 lut_reset_blue.....................................................................................................................67 13.17 lut_fun_rec709 ..................................................................................................................................68 13.18 lut_fast_gamma ................................................................................................70 13.19 lut_fixed_mode ....................................................................................................70 14 Image statistic commands............................................................................................................72 14.1 stat_rgb.................................................................................................................................72 14.2 stat_hist ..................................................................................................................72 14.3 stat_exp ..................................................................................................................73 15 SDI Time code.............................................................................................................................75 15.1 timecode .................................................................................75 15.2 timecode_hold ..........................................................................................................75 16 Auto Exposure.............................................................................................................................76 16.1 aec ......................................................................................76 16.2 aec_weight ............................................................................................78 16.3 stat_ae..................................................................................................................................78 17 Slow Motion Engine....................................................................................................................80 17.1 count ........................................................................................................................81 17.2 status ................................................................................................................81 17.3 rec ....................................................................................................................82 17.4 rec_mode ...............................................................................................................82 17.5 rec_stop................................................................................................................................83 17.6 play .....................................................................................83 17.7 play_mode .............................................................................................................85 17.8 pause....................................................................................................................................86 17.9 stop.......................................................................................................................................86 17.10 stop_mode ...........................................................................................................86 17.11 pos......................................................................................................................................86 17.12 seek ..........................................................................................86 17.13 mark_in..............................................................................................................................87

Reference Manual ATOM one SSM500 17.14 mark_out .................................................................................................................88 17.15 mark_pos............................................................................................................................88 17.16 free .................................................................................................................88 18 Lens Drive Unit...........................................................................................................................90 18.1 lens_setup

..............................................90 18.2 lens_active .........................................................................................................91 18.3 lens_invert ................................................91 18.4 lens_stop ..................................................................................................................92 18.5 lens_info...............................................................................................................................92 18.6 focus_pos ...........................................................................................................92 18.7 fine_focus .............................................................................................................92 18.8 focus_setup .......................................................................93 18.9 zoom_pos ...........................................................................................................93 18.10 zoom_setup ....................................................................93 18.11 iris_pos .............................................................................................................93 18.12 iris_setup ........................................................................94 18.13 iris_apt .............................................................................................................94 18.14 iris_table ... ......................................................................94 18.15 filter_pos ..........................................................................................................95 18.16 filter_setup ......................................................................95

Reference Manual ATOM one SSM500 1 Overview This manual describes the usage of the ATOM one SSM500 (Super Slow Motion) camera system. Here is a quick navigation through the document: • Chapter 1: Overview Describes the functionality of the SSM500, especially the two different operational modes, “Trigger” and “SSM”. Please read this chapter as a quick start guide on how to work with the camera. • Chapter 2: Technical Details This chapter describes the internals of the SSM500 in detail and is of special interest for system integrators. • Chapter 3: General Usage Gives information on how to connect the camera and describes the functionality of the OLED display and the status LEDs. • Chapter 4: Firmware Update Describes the different ways that are available to perform a firmware update. • Chapter 5: ProVideo GUI: Short introduction into the ProVideo GUI which can be used to control the camera. • Chapter 6 : Terminal Usage Specifies the terminal interface of the camera and the way the camera processes commands. • Chapter 7 and following: Camera API These chapters describe the commands that can be processed by the camera grouped by subject areas. 1.1 Operation modes The ATOM one SSM500 supports two operation modes: • Trigger Mode: This mode uses the internal storage space to record and playback slow motion video with up to 500 frames per second. This version can be used stand alone. • SSM Mode (Super Slow Motion 4x): This mode does not use the internal storage but streams with 240 FPS via four HD SDI (4x 1080p60) outputs This version is intended to be used with external storage / video server solutions (like EVS). The operation mode can be switched with the switch_mode command, which requires a reboot. Details can be read in chapter 8.10.

Reference Manual ATOM one SSM500 1.2 Trigger Mode In this mode the ATOM one SSM500 works as a stand alone camera with internal recording. It can record up to 500 frames per second with a memory depth of 30.000 frames. This will give you a recording time of 1 minute at 500 FPS. By lowering the frame rate the recording time can be extended accordingly. It is possible to split the 30.000 frames in up to 4 smaller buffers on demand. The recording frame rate is independent of the video output format. The slow motion ratio is defined by: Slow Motion Ratio = Recording Frame Rate / Output Frame Rate Examples: Record 500 FPS / 1080p50 = 10x Record 500 FPS / 1080p25 = 20x In addition to that, the playback speed can be slowed down to further increase the ratio. In trigger mode the camera has 2 independent output channels: • Live ◦ Always shows the live stream ◦ The live frame rate is independent of the recording frame rate ◦ Is shown on SDI outputs 1 & 2 • Playback ◦ Can show the recorded slow motion video. ◦ The slow motion factor is recording FPS / play back FPS ◦ Optional it can show the live image if no playback is running (auto live) ◦ Is shown on SDI outputs 3 & 4 SDI 5 is always showing a live image. This can be used by the camera operator as a local monitor. Both output groups have independent image processing pipelines for best flexibility for color grading and post processing. Refer to chapter 1.2.2 for workflows details. Technical details on the Trigger mode can be found in chapter 2.1. 1.2.1 Production Preparation For any production the camera needs some settings to meet the project requirements. The following order is recommended: 1. Define lens system / lens control (motors, RCP, etc.)

Reference Manual ATOM one SSM500 2. Select the video output format, e.g. 1080i50 3. Select the recording frame rate / slow motion ratio, e.g. 300 FPS = 6x 4. Select number of buffers e.g. 3 x 10.000 frames (~33 seconds @ 300 FPS per buffer) 5. Select the color profile on the live channel e.g. 6500K (playback will follow automatically) 6. Setup white balance or use auto white balance 7. Start recording on a buffer 1.2.2 Trigger Workflows Since the SSM500 Trigger does have multiple independent image processing pipelines, the color workflow is different to other cameras. This chapter defines recommended workflows for best results. Trigger mode supports independent color grading for the live and playback channel. Depending of the need for the production, 2 different workflow can be defined: • Link Channels (live = playback) • Pull Settings (live → playback) Important: Both work flows have in common, that the selection of the color temperature / white balance is defined from the live channel. This means that any recording does include white balance from live settings at recording time. Optionally the white balance can be modified/fine-tuned during playback if needed. 1.2.2.1 Link Channels In the first workflow, both live and playback image processing are always in sync. The operator must control only the live output, the playback output will follow automatically. The command “link_settings 1” links both channels, see chapter 7.9 for details. Advantages • Very easy to use • Record and play do always have the same look • Low workload for the operator Disadvantages • It is not possible to “tweak” the playback without changing the live image • Risk: During playback, changes of live channel will show up directly “on air” 1.2.2.2 Pull Settings In the second workflow, both live and playback image processing is independent. The image engineer can control live and playback settings as wanted. In many cases one

Reference Manual ATOM one SSM500 image engineer is controlling the live image, while a 2nd engineer is controlling the playback image. On demand the playback operator can “pull” the settings from the current live image by running a copy_settings command, see chapter 7.8 for details. This command applies all settings from the live channel to the playback channel. Advantages • Full control over live and playback look • Changes only get applied on demand, when the image engineer decides to do so (lower risk of having wrong settings “on air”) Disadvantages • Higher workload for the operator (ideally two image engineers) • Risk: Operator must make sure that settings get pulled, otherwise playback can have wrong look 1.3 SSM Mode In this mode the ATOM one SSM500 does not use its internal storage. The camera is steaming in super slow motion speed with up to 240 FPS. The slow motion ratio is changed by adjusting the number of active phases. There are 4 different phase settings possible: • 1 Phase: SDI 1 → 1x • 2 Phases: SDI 1, SDI 2 → 2x • 3 Phases: SDI 1, SDI 2, SDI 3 → 3x • 4 phases: SDI 1, SDI 2, SDI 3, SDI 4 → 4x SDI 5 is always showing a copy of phase 1. This can be used for the camera operator as a local monitor. The frame rate is defined by the video output frame rate and the number of selected phases. FPS = Output FPS * Number of Phases Examples: Video Mode 1080p50 on 3 Phases: FPS = 3 * 50 = 150 FPS Video Mode 1080p60 on 4 Phases: FPS = 4 * 60 = 240 FPS From the image processing perspective, this camera is operated like any “normal” camera. The image processors of all outputs are configured with the same settings, so no special workflows are required.

Reference Manual ATOM one SSM500 2 Technical Details 2.1 Image Processing Pipeline – Trigger Mode The following graphic gives an overview of the image processing pipeline in the ATOM one SSM500 in Trigger mode: The camera has two independent video processing chains. In the following chapters they are called “live” and “playback”. Each chain features an image processor that can be setup independent to match your video production needs. The output video is send to three SDI outputs for the live chain (SDI 1, 2 and 5) and two for the playback chain (SDI 3 and 4). Usually SDI 1 to 4 will be connected to the production equipment while the 5th SDI output is used as a monitor output for he camera operator. The live and playback chain have independent video processors which can be configured with different settings. To switch between the configuration of the live and playback chain the out command is used. In front of the two chains is a common module for global image processing tasks, this includes the white balance and the defect pixel correction. Also the sensor settings like gain and exposure time will be common for both chains. The live chain directly plays back the video coming from the image sensor, it has a delay of 1 frame. The playback chain reads data from the video storage system. The storage system is persistent, that means as long as you do not change the video format, the recording frame rate or the amount of recording buffers (see video_mode, fps_mode and count commands) you will be able to play back the recorded video even after a power cycle. For more details on the handling of the recording engine please see chapter 17. The playback chain can be configured to show a live image, if no playback is running (see stop_mode command). In that case the image coming from the live video image

Reference Manual ATOM one SSM500 processor will be shown on all channels and the playback video image processor is being bypassed (see the orange arrows in the above diagram). Please note the following differences and dependencies between the live and playback chain: • The white balance settings (R/G/B gains) of the live chain are applied in the “Global Image Processing” module, that means its’ settings also impact the playback chain as they influence the data before it is being recorded. Changing the R/G/B gains of the live chain after the recording was stopped will not effect the playback. • The white balance settings in the playback chain can be used to fine tune the white balance during playback. By default they are set to neutral so that the playback chain has the same look as the live chain. • The defect pixel correction happens in the “Global Image Processing” module and always effects both chains. • When being executed on the playback chain, the wb_preset command will set the white balance gains back to neutral, but it will apply the color correction matrix and offsets associated with that preset (see wb_preset command). 2.1.1 Recording System The recording system of the SSM500 consists of two high speed solid state drives (SSDs). These drives have a limited lifetime, that means they can only be rewritten certain times before failing. To ensure longevity of the SSM500 system, high endurance drives intended for professional use have been selected. These drives have a write endurance of at least 2400 hours or 100 days of continuous recording at 500 frames per second. For an average recording time of 3 hours per day, 7 days a week that translates into a lifetime of over 2 years. You can monitor the state of the SSDs using the health command. If this command reports any errors, or the video output shows image artifacts, please run a self test of the recording system using the selftest command. Afterwards contact the Dream Chip technical support so that the drives can be checked and replaced. For more details please see the health and selftest command descriptions in chapter 8. 2.1.2 Workflow Details This chapter is intended as a guideline on how to use the ATOM one SSM500 in a production environment. Note on Color Calibration and the White Balance: To simplify the workflow the camera stores the currently configured white balance preset of (see wb_preset command) and the currently configured white balance gains (see gain_red / gain_green / gain_blue commands) of the live chain in the recording meta data, when a recording is started with the rec command. When the recording is played back with the play command these settings are restored automatically. Caution: If the preset is changed during the recording these changes will not be updated in the meta data, you have to select the correct preset before starting the recording.

Reference Manual ATOM one SSM500 Since the global white balance is done before storing the video data (see chapter 2.1), the recorded video data is already white balanced. Therefore the white balance gains of the playback chain will internally be set to x1 when playback is started. This ensures that the playback has the same look as the original live video. To show the correct white balance gains that were used during recording, the camera stores the white balance R/G/B gains when the recording is started and will display those when the buffer is being played back (although internally a gain of x1 is used). You can change the white balance of the live chain during the recording, or use the AWB and those changes do have an immediate effect on the recording, but they will not be stored in the buffer meta data. That means when playback is started, the camera will report the initial values of the R/G/B gains. Any updates made later will not be reflected in the values reported by the gain_red / gain_green / gain_blue commands. If you are not satisfied with the white balance or color calibration during playback, you can select a different preset using the wb_preset command or change the white balance gains (gain_red / gain_green / gain_blue commands) while the playback is running. These settings are only temporary and will be reset to the values stored in the buffer meta data if you stop/restart playback or play back a different buffer. 2.1.2.1 Workflow A: Independent Live and Playback Chains As described in chapter 2.1 the live and playback chains feature their own image processor. By default these are configured in a split configuration, that means they can configured independently. The image engineer can use this to perform all changes on the live chain (by setting the out command to 1). His changes will not effect the playback output which might be on air at the same time. Once the setup is complete and the playback output is not on air anymore the copy_settings command is used to copy all settings form the live to the playback chain to apply the new look for the next playout. If corrections have to be made to the playback output without wanting to change the live output the playback chain is selected by setting the out command to 2. Please note that there is no command to copy settings from the playback to the live chain. 2.1.2.2 Workflow B: Linked Live and Playback Chains: If the above workflow is not desired or to complicated, both chains can be linked by using the link_settings command. If link_settings is enabled both chains will be configured at the same time, regardless of the current setting of the out command. One important exception are the gain_red / gain_green / gain_blue commands used to setup the white balance: Since the global white balance is done before the recording, the recorded image data is already white balanced. Therefore changing the white balance of the live chain will not change the white balance of a recording that is currently being played back, even when both chains are linked. If you want to fine-tune the white balance of an existing recording, you have to switch to the playback chain using the out command before sending the gain_red / gain_green / gain_blue commands.

Reference Manual ATOM one SSM500 For a full list of the commands that will be executed on both chains in linked mode see the description of the link_settings command. Linking the chains will always result in an implicit call of copy_settings, so that the chains are initially in sync. From here on you can setup both chains simultaneously, just remember that any setting will directly be seen in the playback output. 2.2 Image Processing Pipeline – SSM Mode The following graphic shows the image processing pipeline of the ATOM one SSM500 in SSM Mode: In contrast to the Trigger Mode the SSM Mode does not have a recording pipeline as recording is done by an external solution (e.g. EVS). The SDI outputs 1 to 4 contain the multiplexed slow motion video with up to 60 fps per output (240 fps sensor frame rate) and will usually be connected to the storage system. The 5th SDI output is a copy of SDI 1 and serves as a monitor output for the camera operator. It is possible to change the number of active phases to reduce the amount of SDI outputs used (and thus reduce the slow motion factor). For more details see the phases command. 2.2.1 Workflow Details Since the ATOM one SSM500 in SSM Mode has only one video processor and no internal recording it behaves like any other ATOM one camera and you can use your usual workflow.

Reference Manual ATOM one SSM500 3 General Usage For regular operation the camera only needs a power supply. For controlling the camera a RS485 connection is required. This can be done with the optional RS485 USB converter. Connect the USB connector to your PC and let the operation system install the required drivers. You can then use the ProVideo GUI software to control the camera (see chapter 5). Alternatively you can use a third party hardware controller to control the camera. 3.1 Power On/Off After connecting the power cable, the camera will turn on automatically and the Sys LED begins to blink green. The boot process takes about 20 seconds and is being visualized in the OLED display. During boot the fan will spin at maximum speed. If the camera has been turned on and the power is interrupted, the camera will turn on again automatically once power is supplied again. To power down the camera press the power button for ~3 seconds or use the shutdown command. During power down the fan will spin at maximum speed. The camera will then enter standby mode. In standby mode the Sys LED glows yellow. To turn the camera on again, press the power button for ~3 seconds, or cut the power for at least 5 seconds before reconnecting it. Note: It is recommended to shut down the camera with the power button or shutdown command at the end of a production to ensure no corrupt image data is stored. 3.2 Connectors The ATOM one SSM500 has two 6 pin Hirose HR10 connectors. 1. Main: Male HR10 6 pin 2. AUX: Female HR10 6 pin Additionally a 3.5mm jack for audio input is available. 3.2.1 Power and RS485 Connector Dream Chip Technologies offers an optional Power / Control cable. For power and control, a Hirose male HR10A-10R-10PB connector is used. The following table shows required plugs. Female HR10A-10P-10S(73) Signal Power XLR 4-pin male 6-wire AWG 26 Power cable RS485 ITT Female M-XL-3-11L 6-wire AWG 26 RS422 cable

Reference Manual ATOM one SSM500 6 + 7 + 10 Power in (25W power) Pin 4 orange yellow green 2 + 3 + 9 GND Pin 1 black brown red 3 (see note) brown 1 RS422_RX_A 1 (see note) orange 8 RS422_RX_B 2 (see note) black 4 RS422_TX_A 1 (see note) green 5 RS422_TX_B 2 (see note) yellow Note: The RS422 RX and TX are bonded in the Mini XLR connector for RS485. For RS422 operation, remove the connector to split RX from TX. 3.2.2 AUX Connector The AUX connector is a Hirose female HR10A-7R-6SB pin connector which can be used for lens control or local control via UART. The following table shows the required plug. Male Pin HR10A-7P-6P(73) Signal 1 Power pass through 2 GND 3 Uart TX 3.3V 4 Uart RX 3.3V 5 Lens I2C SCL 6 Lens I2C SDA

Reference Manual ATOM one SSM500 3.2.3 Microphone Input The microphone connector is a standard 3.5 mm stereo jack. It supports 2.5 V phantom power for electret microphones (see audio_micbias command for details). The audio will be inserted into all SDI signals. 3.2.4 RJ45 Ethernet Connector The network connector is reserved for future applications like control via IP. At the moment it can only be used for firmware updates (see chapter 4.2). 3.2.5 SD Card Slot The ATOM one SSM500 has a SD card slot on the right side. This slot is used for firmware updates. Details can be found in chapter 4.3. 3.3 Over-Temperature Protection The ATOM one SSM500 has a compact design which includes an efficient air cooling solution. Still the device will get warm during heavy load. To protect the device the camera will switch to a low power state when the internal CPU temperature reaches 90°C. This stops all record and playback and powers down the image processor. To recover from this state the device temperature has to fall below 70°C 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. If the low power state does not cool down the camera and the temperature reaches 100°C the device will shut down completely. You can only recover from this state by turning the device on again via the power button. Note: During normal operation the camera should never reach the 90°C limit. If your device reaches this limit repeatedly, please check the operating conditions (e.g. ambient temperature, other devices generating heat nearby, access to fresh air for cooling). 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 90°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. 3.4 Status LEDs The device has two status LEDs. The right LED labeled “Sys” shows the general status of the system: Value Status Note Green flashing Booting The operating system is booting

Reference Manual ATOM one SSM500 Solid Blue Running System is running normally Yellow flashing Shutdown Device is shutting down Solid Red Reboot Device is rebooting Red flashing Reboot delay Device is waiting before performing reboot (short, temporary power off) Solid Yellow Standby Device is powered down, but power is still attached The left LED labeled “Cam” shows the status of the image processing system. The image processor is started after the operating system has finished booting (see above). Value Status Note Solid Purple Powered Down Image processing core is powered down (will be shown during boot or shutdown) Yellow flashing Busy Device is processing a command or loading settings Red flashing Genlock Error Device was unable to lock to genlock signal Toggle between Yellow and Red Over Temperature The device reached it’s maximum temperature of 90°C and is in a low power state to cool down Blue flashing Ready Device is up and waiting for commands 3.5 OLED Display The ATOM one SSM500 has a build in OLED display which shows additional status information. This includes the current firmware version and the IP address. The OLED display will show the following screens, each screen is shown for 3 seconds before switching to the next screen: • Main Screen: Shows the operational mode (“TRIG” for the Trigger Mode and “SSM” for the SSM Mode), the firmware version and the IP address. • Genlock Screen: Shows the Genlock status. See chapter 10.6 for details. • Record Screen: Only displayed if a recording is running, shows the buffer which is currently used for recording (Trigger Mode only). • Playback Screen: Only displayed if playback is running, shows the buffer which is currently used for playback (Trigger Mode only). • Phases Screen: Shows the number of active phases (SSM Mode only).

Reference Manual ATOM one SSM500 4 Firmware Update The firmware can be updated via network or SD card. Make sure, that the power supply of the camera and the computer for the update are in a stable state. A firmware update will reset all camera settings to their default values. You can download the latest updated from our GitLab repository: https://gitlab.com/dreamchip/provideo-downloads 4.1 Firmware Update via GUI A firmware update via the GUI is not possible at the moment. But the GUI can be used to reboot the camera into update mode. To do this open the info tab of the GUI and under “System Operations” click on “Reboot to Update Mode”. The reboot will take about 40 seconds, you can then perform the firmware update procedure as described in chapter 4.2. 4.2 Firmware Update via Web Interface The ATOM one SSM500 has an integrated web server that provides a software update web page. To start the web server the device has to be in Update Mode. This can be done by sending the fw_update command or using the GUI as described in chapter 4.1 above. The reboot to Update Mode takes about 40 seconds. Afterwards the firmware update web page will be accessible on the IP address that is displayed in the devices OLED display. By default the device will try to get an IP address via DHCP, it will display “Waiting for DHCP” during this time. If no DHCP server is available in the network, the device will fall back to the address 192.168.1.200 after ~20 seconds. To access the web page connect the ATOM one SSM500 to the same network as your PC over its’ Ethernet port. Then simply enter the IP address in the web browser of your choice. In the web interface you can upload the desired firmware update, the web interface will show you the progress. As soon as the update is finished use the “Reboot” button in the top right corner of the web page to switch back to the newly installed firmware. Summary: 1. Connect device to your local network 2. Send device into update mode (with fw_update command or GUI) 3. Read device IP address from OLED screen 4. Access update web server from web browser 5. Upload firmware, wait for update to completely 6. Click Reboot, wait for application to load Caution: If the update fails or you do not perform any update (e.g. you click “Reboot” without installing an update) the device will stay in Update Mode. To leave the Update Mode an update has to be installed successfully.

Reference Manual ATOM one SSM500 4.3 Firmware Update via SD Card Alternatively an update via SD card can be performed: 1. Format SD card with FAT32 format (vFat is not supported!) 2. Copy firmware update file to SD card Caution: The file name must be “SSM500.swu”, otherwise the update will not be performed! 3. Insert SD card into cameras’ SD card slot 4. Power on or reboot device 5. During boot the device will automatically detect the update on the SD card and boot into Update Mode 6. The update will be installed automatically, during the installation an according info message will be shown on the OLED screen 7. When the update was installed successfully, the device will shut down automatically 8. Once the device is powered down, remove the SD card 9. Power on the device, the new firmware will boot

Reference Manual ATOM one SSM500 5 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 SSM500 6 Terminal Usage 6.1 Terminal The ATOM one SSM500 can be controlled by a terminal connection. All commands consist of ASCI characters. 6.2 Terminal Settings For flexible configuration the ATOM one SSM500 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 SSM500 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. 6.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

Reference Manual ATOM one SSM500 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 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. 6.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. 6.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,

Reference Manual ATOM one SSM500 representative for all cameras, reply to commands as usual, while all other cameras are silent. 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. 6.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 SSM500 7 Settings Handling 7.1 Set Functions To change any settings run the matching command with its required parameters. Example: video_mode 5 OK 7.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) 7.3 auto_save Controls auto save. Flag Function 0 (reset) Auto save OFF 1 Auto save ON With this flag any settings change will instantly be saved into the permanent storage. Please note that saving settings can take a while and saving settings after each command makes camera operation slower. Therefore auto save is turned off by default. Use the save_settings command below to save your settings as needed. Example: auto_save 0 Note: In Trigger mode the settings which are needed for correct video playback will always get saved automatically, those are the video mode (10.1), the frame-rate (10.2) and the buffer count (17.1).

Reference Manual ATOM one SSM500 7.4 save_settings ATOM one has a build in storage for settings. It is automatically loaded on start up. 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 7.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. 7.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. 7.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. 7.8 copy_settings Note: This command is only available in the ATOM one SSM500 Trigger mode. This command copies the settings from the live to the playback chain. The recommendation is to setup the desired image parameters on the live chain and then copy those settings to the playback chain before recording is started. The copied settings include all settings of the image processors, except for the settings of the white balance. The settings of the white balance will be stored in each recording buffer individualy and is loaded automatically on each playback. If you always want to configure both chains simultaneously, use the link_settings command below. For more information about the image processing pipeline and the workflow see chapters 2.1 and 2.1.2.

Reference Manual ATOM one SSM500 7.9 link_settings Note: This command is only available in the ATOM one SSM500 Trigger mode. By default the live and playback chain can be configured independently (split mode). By enabling link_settings you can configure the settings of both chains simultaneously, regardless of the current setting of the out command and without having to call the copy_settings command. Flag Function 0 (reset) Settings of Live and Playback chain are not linked (split mode) 1 Settings of Live and Playback chain are linked (linked mode) When enabled the following commands will be executed for both chains: • System Commands (chapter 8): ◦ pq_max_brightness ◦ log_mode • Video Commands (chapter 10): ◦ wb_preset (for the playback chain, it does not apply the R/G/B gains of the preset, but set them to x1) ◦ black_red, black_green, black_blue ◦ flare ◦ filter_enable, filter_detail, filter_denoise ◦ color_conv, sdi_range, sdi_white, sdi_black color_cross, color_cross_offset ◦ post_cont, post_bright, post_sat, post_hue ◦ black_master ◦ mcc, mcc_opmode, mcc_set, mcc_blink • Knee Function (chapter 12): ◦ knee • Look-up Table Management (chapter 13): ◦ lut_preset, lut_enable ◦ lut_sample, lut_sample_red, lut_sample_green, lut_sample_blue, lut_sample_master ◦ lut_interpolate, lut_interpolate_red, lut_interpolate_green, lut_interpolate_blue ◦ lut_reset, lut_reset_red, lut_reset_green, lut_reset_blue, lut_reset_master ◦ lut_fun_rec709, lut_fast_gamma, lut_mode, lut_fixed_mode

Reference Manual ATOM one SSM500 Note: When link_settings is switched from disabled to enabled, all settings will be copied from the live to the playback chain automatically (like calling the copy_settings command), so that the chains are initially in sync. For more information about the image processing pipeline and the workflow see chapters 2.1 and 2.1.2.

Reference Manual ATOM one SSM500 8 System Commands 8.1 rs232_baud Sets the baud rate for the RS232 terminal interface. Please note that the ProVideo GUI only supports baudrates of 115200 and 57600 baud to provide a smooth and responsive user experience. baud_rate 9600 14400 19200 57600 115200 (default) 8.2 rs485_baud Sets the baud rate for the RS485 terminal interface. Please note that the ProVideo GUI only supports baudrates of 115200 and 57600 baud to provide a smooth and responsive user experience. baud_rate 9600 14400 19200 57600 115200 (default) 8.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.

Reference Manual ATOM one SSM500 8.4 rs485_bc_addr

Sets the broadcast address for the RS485 interface. It can not be set to the current value 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. 8.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 8.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 SSM500 8.7 prompt Set prompt mode. Flag Function 0 (reset) No prompt 1 '=>' prompt 8.8 shutdown Powers off the system. Shutdown takes about 20 seconds. Please always shut down the device before disconnecting the power supply, otherwise recorded image data might be lost. If you have unsaved changes to the settings make sure to save them before doing a shutdown. After shutdown the camera goes into standby mode which is indicated by a yellow glowing Sys LED, to leave start the camera again, disconnect power for at least 5 seconds or press the power button for ~3 seconds (also see chapter 3.1). 8.9 reboot Does a system reboot (warm start). A full reboot takes about 40 seconds. If you have unsaved changes to the settings make sure to save them before doing a reboot. 8.10 switch_mode This command can be used two switch between the two operating modes (Trigger or SSM) of the SSM500 (see chapter 1.1 for details on the modes). The mode is selected with the id parameter: id Operational Mode 0 (factory default) Trigger Mode 1 SSM Mode Caution: Switching between the modes requires a reboot, the reboot will be performed automatically when you send the switch_mode command, so make sure to finish your work and stop any running recordings before doing so. Each mode stores its’ individual camera settings which will be restored when you switch back to it. The only exception is the DPC table which is identical for both modes, so you do not have to run the calibration for each mode separately (see chapter 11.9 for details).

Reference Manual ATOM one SSM500 8.11 fw_update Set the system into firmware update mode. The reboot to update mode takes about 40 seconds. For more information on how to perform a firmware update please see chapter 4. If you have unsaved changes to the settings make sure to save them before doing a firmware update. 8.12 version Dumps a detailed version information about the system with system ID and firmware version. The output looks like this: platform : caterham_hs device name : ATOM one SSM500 system-id : 80:1f:12:55:e8:91 hw revision : 503 system validity: DEVELOPER feature mask HW: 0 feature mask SW: ffffffff resolution mask: 0-7ff-0 loader version : 0 (0) sw-release-id : v0.4.2 sw-release-date: Thu Feb 27 21:30:54 2020 +0100 sw-build-date : 2020-02-28 14:21:48 8.13 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 that the bus does not get corrupted. Each device will report the following parameters: • Platform ID: This will be caterham for ATOM one SSM500 cameras (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 6.4 and 6.5

Reference Manual ATOM one SSM500 • Device Name: Name which can be set by the user, see chapter 8.14 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: caterham 1 0 0 ATOM one SSM500 - Goal OK id: caterham 55 0 0 ATOM one SSM500 – Middle Line OK 8.14 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 SSM500 Is not changed through reset Up to 5 words with 32 characters in total 8.15 out The ATOM one SSM500 provides 2 pairs of outputs. The first pair shows the live image of the camera while the second pair is the slow motion video output. The out command selects the chain (live or playback) which is being configured by following commands. Value Reset Minimal Maximal Index 1 1 2 For more information about the image processing pipeline see chapter 2.1. 8.16 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)

Reference Manual ATOM one SSM500 1 Vertical flip 2 Horizontal flip 3 Rotated by 180° 8.17 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 8.18). 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 8.19). 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 13. 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 settings will be restored. 8.18 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.

Reference Manual ATOM one SSM500 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 8.19 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 8.20 audio_enable Enables the A/D converter and embeds the stereo audio signal in all SDI output signals. Audio Enable Function 0 (reset) Audio is disabled 1 Audio is embedded in the SDI signals 8.21 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. Value Floating Point 4.12 Fixed Point Hex 4.12 Fixed Point Decimal Resulting Gain in dB Minimum 0.0 0x0 0 -12 dB Reset 1.0 0x1000 4096 0 dB Maximum 1000.0 0x3E8000 4096000 60 dB

Reference Manual ATOM one SSM500 Examples: To set a gain of 2.0 or 6 dB (double the volume) use: audio_gain 8192 or: audio_gain 0x2000 To set a gain of 0.5 or -6 dB (half the volume) use either: audio_gain 2048 or audio_gain 0x800 Note: To be compatible with the API of other ATOM one cameras gains below 0.25 (down to 0.0) are allowed, but internally all values below 0.25 or -12 dB will be clipped to -12 dB. 8.22 audio_micbias Enables the 2.5V microphone phantom/bias voltage on the audio port. By default the mic bias is enabled which should be fine if an electret microphone is used. If you intend to use the port as a line-in port, disable the bias voltage. Mic Bias Enable Function 0 Mic Bias is disabled 1 (reset) 2.5V Mic Bias is enabled 8.23 temp Dumps camera temperature values in degree centigrade. Temperature Sensor ID Function 0 CPU temperature (with 0.1°C accuracy) The output has the format temp , see the following examples: temp 0 temp 0 50.3 CPU OK 8.24 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 90°C. Example: max_temp max_temp 61 70 90 OK

Reference Manual ATOM one SSM500 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. 8.25 max_temp_reset Resets the logged maximum CPU temperature value to the current temperature. Example: max_temp_reset OK 8.26 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 > 90°C). It is persistent and can not be reset by the user. Example: over_temp_count over_temp_count 3 OK 8.27 health Note: This command is only available in the ATOM one SSM500 in Trigger Mode. Dumps the health state of the two SSDs which are used for video recording. This command can be run at any time. The output has the following format: SSD: H (), T //, L The fields have the following meaning: Value Meaning Description ID of the SSD 0 or 1 Bitmask that contains the device health status When everything is fine this value is “0”. In case of a detected failure the bits of this value describe different states: • Bit 3: Device is failing, replace it immediately. • Bit 4: Prefail was detected, device can fail within the next hours, replace it as soon as possible.

Reference Manual ATOM one SSM500 • Bit 5: Prefail warning, prefail was detected at some point in the past but is not detected now. Perform a test of the drive using the selftest command. • Bit 6: Error Log warning, the error log contains warnings. Perform a test of the drive using the selftest command. • Bit 7: Test Log warning, the test log contains warnings. Perform a test of the drive using the selftest command. Content of the error_code as readable text Describes the above mentioned errors as user readable text: • Nothing set: OK • Bit 3: FAILING • Bit 4: PREFAIL (if Bit 3 and Bit 4 are set only FAILING will be reported) • Bit 5: WARN_PREFAIL • Bit 6: WARN_ERR_LOG • Bit 7: WARN_TEST_LOG Minimum Temperature Reports the coldest temperature the device has logged in °C Current Temperature Reports the current SSD temperature in °C Maximum Temperature Reports the hottest temperature the device as logged in °C Remaining Lifetime Reports the remaining lifetime of the SSD in %. A value of 100% means the SSD is unused, a value of 0% means the device has reached its guaranteed operational limit. To avoid downtime we advise a replacement of the SSDs as soon as the Lifetime reaches 1%. Please note that the SSDs will still continue to work when the lifetime drops to 0%, but the risk of device failure is highly increased. Example output: SSD0: H 0(OK), T 21/36/57, L 100

Reference Manual ATOM one SSM500 SSD1: H 0(OK), T 21/38/59, L 100 Note: If you have any doubt about the health of your device please contact the Dream Chip technical support. 8.28 selftest Note: This command is only available in the ATOM one SSM500 in Trigger Mode. This command performs a short SMART self test of the SSDs and reports the result. The test will run for approximately two minutes. During the test no recording or playback must be running, if recording or playback are still running the command will fail. To stop recording and playback see the rec_stop and stop commands in chapter 17. The output of this command has the following format: SSD: () The fields have the following meaning: Value Meaning Description ID of the SSD 0 or 1 Test result in user readable format If the test did not find any issues the result is “PASS”, else “FAIL” is reported. In case one ore both devices did not pass the test please contact the Dream Chip technical support. Test result as an error code The error code is 0 if the device passed the test. In case of an error please report the error code to the Dream Chip technical support. Example output: SSD0: PASS (0) SSD1: PASS (0) 8.29 calibration_profile The ATOM one SSM500 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 Profile that matches the original IR-cut filter that was shipped with the first batch of ATOM one SSM500 cameras.

Reference Manual ATOM one SSM500 1 Profile for the newer, improved IR-cut filter that was shipped with later batches of ATOM one SSM 500 cameras. 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. If you have a camera with an older model filter and buy a filter upgrade from Dream Chip you should change the calibration profile for best color reproduction. If you are unsure about this setting, contact the Dream Chip technical support. 8.30 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 SSM500 9 Camera Commands The camera commands control the exposure (gain and time) of the camera. 9.1 cam_gain Sets analog and digital gain for the sensor. Value Reset Minimal Maximal gain Automatic 1000 100000 Minimum: 1000 = 1x = 0dB = 80 ISO Maximum: 100000 = 100x = 40dB = 8000 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 SSM500 it will report a value of 80. Examples: Gain 1000 → ISO = 1000 / 1000 * 80 = 80 Gain 40000 → ISO = 40000 / 1000 * 80 = 3200 Gain 100000 → ISO = 100000 / 1000 * 80 = 8000 You can read out the gain at any time, also when the auto exposure control is enabled. 9.2 cam_exposure Sets the exposure time/shutter width in microseconds. Value Reset Minimal Maximal time Automatic 5 Depends on video mode 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. 9.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 sensor in 500 fps mode: cam_info 1000 100000 5 2000 80

Reference Manual ATOM one SSM500 10 Video Commands 10.1 video_mode Set the output video mode of both chains. Caution: In Trigger Mode changing the video mode invalidates all recording buffers, the data will be lost! Note: Since the video mode is essential to play back recorded buffers, it will get saved automatically in Trigger Mode, even if save_settings is not called by the user. Mode ID Resolution Frame Rate 4 1920x1080 30 5 1920x1080 25 6 1920x1080 24 7 1920x1080 23.98 8 1920x1080 29.97 9 1920x1080 50 10 1920x1080 60 11 1920x1080 60i 12 1920x1080 50i 13 1920x1080 59.94i 14 1920x1080 59.94p 10.2 fps_mode Note: This command is only available in the ATOM one SSM500 in Trigger Mode. For the SSM Mode see the phases command instead. Set the video mode of the image sensor (capture frame-rate). The camera will automatically use the fractional equivalent of the selected frame-rate if a fraction video mode is selected (see video_mode command above). Caution: Changing the frame rate of the sensor invalidates all recording buffers, the data will be lost! Note: Since the fps mode is essential to play back recorded buffers, it will get saved automatically, even if save_settings is not called by the user.

Reference Manual ATOM one SSM500 Mode ID Resolution Frame Rate 0 1920x1080 24 1 1920x1080 25 2 1920x1080 30 3 1920x1080 48 4 1920x1080 50 5 1920x1080 60 6 1920x1080 72 7 1920x1080 75 8 1920x1080 90 9 1920x1080 96 10 1920x1080 100 11 1920x1080 120 12 1920x1080 125 13 1920x1080 144 14 1920x1080 150 15 1920x1080 168 16 1920x1080 175 17 1920x1080 180 18 1920x1080 192 19 1920x1080 200 20 1920x1080 210 21 1920x1080 216 22 1920x1080 225 23 1920x1080 240 24 1920x1080 250

Reference Manual ATOM one SSM500 Mode ID Resolution Frame Rate 25 1920x1080 270 26 1920x1080 288 27 1920x1080 300 28 1920x1080 336 29 1920x1080 350 30 1920x1080 360 31 1920x1080 384 32 1920x1080 400 33 1920x1080 420 34 1920x1080 432 35 1920x1080 450 36 1920x1080 480 37 1920x1080 500 10.3 phases Note: This command is only available in the ATOM one SSM500 in SSM Mode. For the Trigger Mode see the fps_mode command instead. Set the amount of active phases (SDI outputs): Value Reset Minimal Maximal num 4 1 4 This also changes the sensor (capture) frame-rate. The sensor frame-rate will always be set to num_phases * output_fps. The output frame-rate depends on the currently selected video mode (see video_mode command). Example calculations for video mode 1080p50: • num_phases = 1, output_fps = 50 → sensor_fps = 1 x 50 = 50 • num_phases = 2, output_fps = 50 → sensor_fps = 2 x 50 = 100 • num_phases = 3, output_fps = 50 → sensor_fps = 3 x 50 = 150 • num_phases = 4, output_fps = 50 → sensor_fps = 5 x 50 = 200

Reference Manual ATOM one SSM500 10.4 fps The fps command can be used to conveniently get the current sensor and display frame- rate. Example output: fps 500 50 With these values the current slow motion factor can be calculated (for the SSM500 you also have to take account the playback speed, see the play command for details). Example: 500 / 50 = 10x 10.5 genlock Controls genlock interface. The camera is able to lock the main SDI outputs lock with a precision of +/- 1 Pixel to the reference signal. In Trigger mode the main outputs are SDI 1 (live) and SDI 3 (slow- motion), in SSM mode SDI 1, 2, 3 and 4 are the main outputs. The other outputs are also phase locked but have a delay of a few pixels compared to the main outputs. Important: Locking to PAL/NTSC Black Burst signals is supported, but it causes high jitter on the SDI outputs. Also the lock will only have a precision of +/- 20 pixels. Flag Mode Comment 0 Disable Genlock off 1 Input / Slave In this mode the system will genlock to an external 1080i or 1080p tri-level sync or PAL/NTSC Black Burst signal. 720P tri- level sync signals are not supported. For best results use a tri-level sync signal that matches the current video mode. The device will automatically perform crosslocking if the supplied reference signal does not match the current video mode. Crosslock is only supported between modes that have the same frame-rate, for an example you can have the camera run in 1080p50 mode and use a 1080p50 or 1080i50 tri-level sync signal or a PAL Black Burst signal. In case a lock is not possible (unknown format, missing sync signal, reference does not compatible with video mode) 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 no image output for a few seconds until the lock was established. As long as genlock is enabled, any video_mode, fps_mode or phases command will try to genlock to the reference signal. If fine-tuning is needed, the vertical and horizontal offsets can

Reference Manual ATOM one SSM500 be programmed with the genlock_offset command. The current genlock status can be checked with the genlock_status command. This will also show whether crosslocking is enabled. 2 Output / Master In this mode the genlock connector will become an output with 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. 10.5.1 Status LED The Status LED shows the status of the genlock. Value Status Note Yellow Wait for lock May take up to 10 seconds Red Fail to lock, or 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 Defaut state of system 10.6 genlock_status Use this command to query the current genlock status, additionally the status is also shown on the OLED screen. The following values can be returned: Value Status Comment 0 OK Genlock is disabled (no lock required) or Genlock is enabled and the lock was successful. 1 Crosslock Genlock is enabled and the lock was successful, but crosslock was enabled because the supplied sync signal does not match the video mode. This is not an error, just an information. If you do not want to use crosslocking make sure that the supplied sync signal matches the video mode.

Reference Manual ATOM one SSM500 2 No Reference Genlock is enabled, but locking did fail because no reference signal was detected. Make sure the reference signal is connected, the sync generator is powered and the cable is not damaged. 3 Unsupported Reference Genlock is enabled, but locking did fail because the detected reference signal is not supported. Please use a different reference Signal. All 1080i and 1080p tri-level sync and PAL/NTSC Black Burst reference signals are supported. 720p tri-level sync signals are not supported. 4 Reference Mismatch Genlock is enabled, but locking did fail because the detected reference signal is not compatible with the output video mode. Locking is only possible to reference signals, that have the same frame-rate as the output video mode, for an example in 1080p50 mode the camera can lock to 1080i50 and 1080p50 tri-level sync signals. 5 No Lock Genlock is enabled but the device could not lock on the supplied reference signal. Maybe the signal quality is bad, has high jitter, or the cable is damaged. 6 Genlock PLL Failure Genlock is enabled but an error occurred when configuring the Genlock PLL. This should not happen during normal operation, please contact the Dream Chip Technical Support. 7 Video PLL Failure Genlock is enabled, but an error occurred when configuring the Video PLL. This should not happen during normal operation, please contact the Dream Chip Technical Support. 10.7 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 lost for the time specified by this command, it will be accepted as a valid loss-of-link.

Reference Manual ATOM one SSM500 Usually the timeout value should be kept at its’ default, if you experience 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 10.8 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 10.9 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 10.10 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 SSM500 10.11 post_bright Set post processing brightness. Y_out = Y + offset Neutral value is 0. Value Reset Minimal Maximal offset 0 -128 127 10.12 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 10.13 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 10.14 post_hue Set post processing color hue offset angle.

Reference Manual ATOM one SSM500 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 10.15 wb Lets the white balance run for the given amount of frames. The frames parameter is optional, if not specified the white balance will run for 200 frames. Value Default Minimal Maximal frames (optional) 200 1 1000 10.16 awb Enables continuous auto white balance. Switching from disabled to enable will first reset the white balance gains to the calibrated defaults specified by the white balance preset (see wb_preset command below). This is done to make sure that the AWB has a valid starting point and converges fast. Flag Function 0 (reset) disable 1 enable 10.17 awb_speed Sets the control speed of the continuous auto white balance. Value Reset Minimal Maximal speed 0 0 (slow) 2 (fast) 10.18 wb_preset Set calibrated white balance presets (gains, color-cross matrices and offsets). List of calibrated presets:

Reference Manual ATOM one SSM500 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 Notes for Trigger mode: The function of the wb_preset commands depends on the currently selected output chain (Live or Playback). To select the desired chain use the out command. Live (out = 1): If the Live chain is selected, this command will configure the R/G/B gains of the global white balance module, this means it effects the Live chain as well as any recording that will be started after the change was made. It is recommended to not change the preset while a recording is running! Playback (out = 2): If the Playback chain is selected, this command will reset the R/G/B gains to values that were setup when the recording was started, so that the look of the Playback chain matches the original settings. You can then use the gain_red, gain_green and gain_blue commands (see below) to fine-tune the Playback output. 10.19 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

Reference Manual ATOM one SSM500 Notes for Trigger Mode: While a recording is running any changes to the R/G/B gains of the Live chain (out = 1) will also effect the recorded video. When playback is started the R/G/B gains of the Playback chain are set to the values that where setup during the beginning of the recording to restore the original look. You can then change the gains of the Playback chain (out = 2) to perform fine-tuning during playback. These changes will be reverted when you play back a different buffer. 10.20 gain_blue Equivalent to gain_red. 10.21 gain_green Equivalent to gain_red. 10.22 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 10.23 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 10.24 black_blue Equivalent to black_red.

Reference Manual ATOM one SSM500 10.25 black_green Equivalent to black_red. 10.26 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 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 10.27 filter_enable Enable function for the filter functions. Flag Function 0 disable 1 (reset) enable 10.28 filter_detail Set the detail enhance level. Value Reset Minimal Maximal level 0 0 65 10.29 filter_denoise Set the denoise level. Value Reset Minimal Maximal level 0 0 65

Reference Manual ATOM one SSM500 10.30 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 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 10.31 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:

Reference Manual ATOM one SSM500 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 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 10.32 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

Reference Manual ATOM one SSM500 10.33 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 10.31) 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 10.30) 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 1 Rec.2020 UHD / HDR 10.34 mcc Multimatrix color correction control. Flag Function 0 disable 1 (reset) enable 10.35 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 10.36 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.

Reference Manual ATOM one SSM500 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. 10.37 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. Value Minimal Maximal Comment 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

Reference Manual ATOM one SSM500 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 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 10.38 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

Reference Manual ATOM one SSM500 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 note 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 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 SSM500 11 Defect Pixel Correction 11.1 dpc Enables / Disables deflect pixel correction Flag Function 0 No correction 1 (reset) Correction enabled 11.2 dpc_mode Sets defect pixel correction mode. Mode Function 0 Table based 1 Auto-detection 2 (reset) Table based + Auto-detection 11.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 11.4 dpc_level Sets detection mode on defect pixel correction. Level Function 0 (reset) Few defects 1 ... 2 ...

Reference Manual ATOM one SSM500 3 Cluster defects 4 ... 5 Big cluster defects 11.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 11.6 dpc_del_pixel Deletes a pixel coordinate given by index from the defect pixel table. If no index is given, the complete table will be deleted. # delete pixel coordinate 0 from table => dpc_del_pixel 0 OK # dump table => dpc_add_pixel dpc_add_pixel 200 200 OK 11.7 dpc_save Saves defect pixel table to persistent memory. 11.8 dpc_load Loads defect pixel table from persistent memory.

Reference Manual ATOM one SSM500 11.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 SSM500 12 Knee Function 12.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 SSM500 13 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. Both SDI outputs of each chain (live and playback) use the same lookup table, but you can have different lookup tables for the live and playback chain. 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. 13.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. Select Chain to configure: out 1 for Live, out 2 for Playback Chain 2. Disable LUT: lut_enable 0 0 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 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 SSM500 1. Select Chain to configure: out 1 for Live, out 2 for Playback Chain 2. Disable LUT: lut_enable 0 0 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 Switch Presets: For preset LUT setup the following steps are required. Presets are user sets to be loaded. 1. Select Chain to configure: out 1 for Live, out 2 for Playback Chain 2. Disable LUT: lut_enable 0 0 3. Select preset storage: lut_preset 0 4. Calculate LUT: lut_interpolate 5. Enable LUT again: lut_enable 0 1 13.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 Chain to configure: out 1 for Live, out 2 for Playback Chain 2. Make sure LUT is enabled: lut_enable 0 1 3. Setup gamma value: lut_fast_gamma <...> 13.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 Chain to configure: out 1 for Live, out 2 for Playback Chain 2. Make sure LUT is enabled: lut_enable 0 1 3. Setup fixed gamma curve: lut_fixed_mode <...> 13.2 lut_enable Enable function for look up table. Index Function 0 Is fixed to 0 for the ATOM one SSM500

Reference Manual ATOM one SSM500 Flag Function 0 Disable (linear) 1 (reset) Enable Examples: # enable LUT => lut_enable 0 1 OK # dump current LUT states => lut_enable lut_enable 0 1 OK 13.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. 13.4 lut_preset Selects the preset storage for the current LUT interpolator. Value Reset Minimal Maximal index 0 0 4 The ATOM one can internally handle 5 presets. Any preset can be modified by the customer.

Reference Manual ATOM one SSM500 Index Factory preset 0 REC709 1 Linear 2 Linear 3 Linear 4 Linear Example: => lut_preset 0 OK 13.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 => lut_sample_red lut_sample_red 0 0 65535 65535 OK # overrule start and end point

Reference Manual ATOM one SSM500 lut_sample_red 0 1000 65535 64000 OK # start curve interpolation => lut_interpolate OK 13.6 lut_sample_red ... Same as lut_sample, but only for red component. 13.7 lut_sample_green ... Same as lut_sample, but only for red component. 13.8 lut_sample_blue ... Same as lut_sample, but only for red component. 13.9 lut_interpolate Interpolates all look up tables based on the given sample points. 13.10 lut_interpolate_red Interpolates the red look up table based on the given sample points. 13.11 lut_interpolate_green Interpolates the red look up table based on the given sample points. 13.12 lut_interpolate_blue Interpolates the red look up table based on the given sample points. 13.13 lut_reset Clears all look up sample points. 13.14 lut_reset_red Clears all red look up sample points. 13.15 lut_reset_green Clears all green look up sample points. 13.16 lut_reset_blue Clears all blue look up sample points.

Reference Manual ATOM one SSM500 13.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 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...

Reference Manual ATOM one SSM500 To avoid a discontinuity in the gamma-function select the brightness (offset) for the non- 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

Reference Manual ATOM one SSM500 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 13.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. 13.19 lut_fixed_mode The fixed gamma mode allows to choose between three fixed gamma tables which are 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.

Reference Manual ATOM one SSM500 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 8.17 for details.

Reference Manual ATOM one SSM500 14 Image statistic commands 14.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) 14.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 SSM500 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. ... ... ... 14.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 SSM500 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 SSM500 15 SDI Time code 15.1 timecode The SDI signal has an embedded time code. Since ATOM one 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 15.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 SSM500 16 Auto Exposure 16.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 18). 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 16.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 SSM500 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 16.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 SSM500 16.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 16.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. 16.3 stat_ae Dump auto exposure statistics Example:

Reference Manual ATOM one SSM500 # Get stat_ae information 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 SSM500 17 Slow Motion Engine The command described in this chapter control the slow motion video recording and playback capabilities of the ATOM one SSM500 in Trigger Mode, they are not available when the SSM Mode is used. Key features: The ATOM one SSM500 can record 300000 frames which equals 60s at 500fps which can be equally split into up to 4 buffers. It is possible to record into one buffer while displaying video from another buffer. You can seamlessly switch recording from one buffer to another free buffer without dropping any frames. General workflow: • Select into how many recording buffers you want to partition the storage space using the count command. • Select whether you want to record in “loop” or “once” mode using the rec_mode command. • List buffer status using the status command. • Pick a buffer that is “free” and start recording into it using the rec command. • Once the scene is recorded either switch recording to the next buffer using the rec command or stop the recording using the rec_stop command. • Start playback of the recorded buffer using the play command. • Use the seek / pause and play commands to find the first frame of the scene you want to play back. • Use the mark_in command to mark this frame as the first frame of the scene. • Use the seek / pause and play commands to find the last frame of the scene you want to show. • Mark that frame using the mark_out command. • Use the mark_pos command to check the “in” and “out” frame positions, jump to the “in” frame using the seek command. • Start playback of the selected scene using the play command, use the play_mode command to select if it shall be played in loop mode or only once. • During playback you can check the progress using the pos command which prints the currently displayed frame. • When you are done with the playback send the stop command. The playback output will then switch into the mode you have specified with the stop_mode command (can be either live video or one of two test patterns). • If you run out of free buffers use the free command to clear old buffers that you do not need anymore.

Reference Manual ATOM one SSM500 For a detailed description of the commands please read the following chapters. 17.1 count Change how the recording time is split into buffers. The ATOM SSM500 provides a recording buffer of 300000 frames which equals a recording time of 60s at 500 fps. These frames can be split into 1, 2, 3 or 4 buffers of equal size (see table below). After changing the buffer count it is highly recommended to save the settings (see 7.4), otherwise your recorded image data might not be restored after reboot if the buffer count loaded from the settings does not match the recording data. Caution: Changing the buffer count will automatically delete all recorded data! Note: Since the buffer count is essential to play back recorded buffers, it will get saved automatically, even if save_settings is not called by the user. Note: It is possible to use only one buffer but in this case you are not able to record and playback at the same time. Parameter Minimal Maximal Comment count 1 4 Change amount of recording buffers to specified number. 17.2 status Print the status of all recording buffers (if no id or 0 given) or a specific buffer specified by the buffer_id parameter. Parameter Minimal Maximal Comment buffer_id 0 Depends on buffer count (see count command) Prints status of all buffers (if buffer_id = 0) or specified buffer. The status has the following format: B: / Where: • is the ID of the buffer starting from 1 up to the amount of buffers specified with the count command. • is the amount of frames that have been recorded in the buffer. • is the total amount of frames that the buffer can hold. The behaviour for the case that reaches is specified with the rec_mode command. • is the current buffer status, it can be either:

Reference Manual ATOM one SSM500 ◦ free: The buffer is free and does not contain any data, is 0. Only free buffers can be used to start a new recording using the rec command. To free a buffer use the free command. ◦ used: The buffer contains recorded data, it can be selected for playback using the play command. ◦ record: The buffer is currently being used for recording, stop the recording using the rec_stop command or switch recording to another buffer using the rec command. ◦ play: The buffer is currently being played back, you can seek inside the buffer using the seek command, change the playback speed with the play command, mark buffers with the mark_in and mark_out commands or pause playback with the pause command. To check the current position in the buffer use the pos and mark_pos commands. To stop playback use the stop command, the buffer will then switch its status to “used”. ◦ pause: The buffer is selected for playback but was paused with the pause command. Commence playback using the play command, or perform any of the other operations that are also possible on a buffer in the “play” state. Example output: 1 status B1: 2432 / 7500 play B2: 3220 / 7500 record B3: 0 / 7500 free B4: 0 / 7500 free 17.3 rec Starts recording into a given, or the next free buffer. Use the status command to see a list of all available buffers. When a recording is already running when this command is send, the recording is stopped and switched to the new buffer immediately. No frames are lost when such a switch is performed. When being called without parameters this command returns the ID of the buffer which is currently being used for recording, or 0 if no recording is running. Parameter Minimal Maximal Comment buffer_id 0 Depends on buffer count (see count command) Starts recording into next free buffer (if buffer_id = 0) or specified buffer. 17.4 rec_mode Set the recording mode.

Reference Manual ATOM one SSM500 By default the camera records in loop mode, that means it write into a continuous ring buffer. Once the buffer is filled old data is being overwritten, so that the newest data is always inside the buffer. Alternatively one shot recording (mode “once”) can be used. In this mode the recording is stopped automatically once the buffer is filled. This can be used if you want to record a fixed time and do not want to loose data from the start of the recording. Notes: • To check if the end of the buffer was reached in “once” mode, use the rec command. It will report buffer index 0, if the recording stopped. • The record mode can only be changed if no recording is currently running. • When the recording is started the currently configured white balance preset and the R/G/B white balance gains are stored in the video meta data. These settings is automatically restored when the buffer is being played back using the play command (also see wb_preset and gain_red command description). Parameter Value Function Comment Mode 0 Loop Ringbuffer: When reaching the end of the buffer jump to start of the buffer and overwrite oldest data. 1 Once One Shot: When reaching the end of the buffer stop recording automatically. 17.5 rec_stop Stops the current recording and switches the playback output into the mode which is selected by the stop_mode command below. If you want to stop the recording and immediately start recording into the next buffer use the rec command instead. 17.6 play Start playback of a previously recorded buffer. Playback can be started forward or backward and with different speeds. If no speed is given speed 10 (x1) will be used. If a frame index is given, playback will start from the given frame. If no index is given and the buffer which shall be played is currently in “used” state, playback will start at the frame that was marked with the mark_in command. If the buffer is in “paused” state, and no frame is given, playback will continue from the current position (see pos command). When being called without parameters this command returns the ID of the buffer which is currently being played, or 0 if no playback is running. If playback is paused or was stopped the playback speed will be reported as 0. The frame number will not be reported by the play command, use the pos command instead to read the current frame index. Note: Starting playback of a buffer will restore the white balance preset and the R/G/B gains that were selected when the recording of the buffer was started (also see wb_preset

Reference Manual ATOM one SSM500 and gain_red command description). Any subsequent play command with the same buffer_id will not restore these settings, that means you can change the wb_preset and R/G/B gains while playback is running. Stopping the playback with the stop command or calling the play command with a different buffer_id will reset the settings to the stored values again. Parameter Minimal Maximal Comment buffer_id 1 Depends on buffer count (see count command) Buffer which shall be played back, playback starts at mark_in position. speed (optional) -1000 1000 Playback speed. Divide by 10 to get the playback factor (see examples below). If no speed is specified a factor of x1 (speed = 10) is used. frame (optional) 0 Depends on amount of frames in buffer Frame where playback is started. If not specified or 0, playback will start from the “mark_in” frame (if buffer is “used”) or the current frame (if buffer is “paused”). Otherwise it will start at the given frame. If the given frame is bigger than the amount of frames in the buffer, playback will start from the last frame in loop mode, or jump to the last frame and pause there in once mode.

Reference Manual ATOM one SSM500 Playback speed examples: Speed Function -1000 Play backward wit x100 speed -100 Play backward with x10 speed -50 Play backward with x5 speed -10 Play backward with x1 speed -5 Play backward with x1/2 speed 0 Equal to calling the pause command, show still image. 5 play forward with x1/2 speed 10 play forward with x1 speed 50 play forward with x5 speed 100 play forward with x10 speed 1000 play forward with x100 speed Command Examples: Start Playback with speed x1 from buffer 1 at mark_in position: play 1 Start Playback from buffer 2 with speed x5 at frame 2000: play 2 50 2000 Start Playback from buffer 1 at the last frame (with max 15000 frames per buffer) and pause there: play_mode 1 play 1 0 15000 17.7 play_mode Set the playback mode. By default playback is done in loop mode, that means when the end of the currently marked segment (see mark_out command) is reached it automatically starts from the beginning of the segment (see mark_in command). Alternatively the “once” mode can be used to automatically stop the playback at the end of the segment that was marked with the mark_out command, the last frame will then be repeated as a still frame.

Reference Manual ATOM one SSM500 Note: To check if the end of the buffer was reached in “once” mode, use the play command. If playback stopped, it will report a speed of 0. Parameter Value Function Comment Mode 0 Loop When reaching the mark_out position jump to the mark_in position and continue playback. 1 Once When reaching the mark_out position stop playback and repeat the last frame. 17.8 pause Pause the current playback. The current frame will be repeated to produce a still frame. 17.9 stop Stop playback from current buffer. Depending on the stop mode (see stop_mode command below) the playback output will then switch to live playback or a test pattern. 17.10 stop_mode The stop mode defines the behavior of the camera when playback is stopped (see stop command above). When stop is set the camera can either output the live image or two kinds of test pattern (black image or color bars). Parameter Value Function Comment Mode 0 Live Show live image when stop is called. 1 Black Show black image when stop is called. 2 Color Bars Show test image (color bars) when stop is called. 17.11 pos Print the frame position in the current playback buffer. This command can be queried during playback to show the playback progress. If no buffer is currently being played, the returned position will be 0. To see the current range of frames being played back use the status and mark_pos commands. 17.12 seek Seek to another frame in the current buffer. Depending on the given mode a relative jump counted from the current position is done or an absolute jump inside the buffer is performed. The parameter is optional. If it is set to 0 or not specified the seek is executed and “OK” is returned upon completion. If it is set to 1 after the seek was performed the new

Reference Manual ATOM one SSM500 position in the buffer is returned and afterwards “OK” is printed. See examples below for details. It is possible to seek in front of the positions that are marked as “in” and “out” with the mark_in and mark_out commands below. This command has no get function and will fail if called without parameters. Parameter Value Function Comment mode 0 Relative Jump frames relative to the current position. Negative number seeks backward, positive number forward. 1 Absolute Jump to absolute postion in the buffer, must be a valid frame in the buffer, negative positions are not allowed. ret_pos (optional) 0 Normal Mode If 0 or not specified, the seek command will work in normal mode and just print “OK” upon completion. 1 Return new Position If 1, the seek command will print the new position in the format “pos X”, before printing “OK”. Examples: Seek 200 frames forward: seek 0 200 OK Seek 10 frames backward: seek 0 -10 OK Seek to absolute frame position 3000: seek 1 3000 OK Seek 200 frames forward and print new absolute position: seek 0 200 1 pos 1300 OK 17.13 mark_in Mark the given frame or the current frame (pos not specified or 0) as the start frame of the segment you want to play out. Also see play_mode command. Can only be set while playback is running (playback has been started with the play command).

Reference Manual ATOM one SSM500 If the mark_in position is placed behind the mark_out position, mark_out is moved to the end of the buffer automatically. Parameter Minimal Maximal Comment pos 0 Depends on amount of frames in the buffer, see status command This argument is optional. If it is not specified or set to 0 the current frame will be marked, otherwise the frame with the given position will be marked. 17.14 mark_out Mark the given frame or the current frame (pos not specified or 0) as the end frame of the segment you want to play out. Also see play_mode command. Can only be set while playback is running (playback has been started with the play command). If the mark_out position is moved in front of the mark_in position, mark_in is moved to start of the buffer automatically. Parameter Minimal Maximal Comment pos 0 Depends on amount of frames in the buffer, see status command This argument is optional. If it is not specified or set to 0 the current frame will be marked, otherwise the frame with the given position will be marked. 17.15 mark_pos Print the current start and end positions which where set with the mark_in and mark_out commands. By default playback will loop between those two markers (see play_mode command). If no buffer is selected for playback, this command will return 0 for both mark_in and mark_out positions. Example output: 1 mark_pos mark_pos 2347 2356 17.16 free Free a buffer. This deletes the content of the buffer so that it can be reused for a new recording. “free” can be called on any buffer at any time. If a recording is currently running into that buffer it will be stopped and the playback output is switched to the mode specified with the stop_mode command. Caution: Calling free on a buffer will delete all data in that buffer, it can not be recovered!

Reference Manual ATOM one SSM500 If the free command is called without any parameter (without specifying a buffer_id) or with the buffer_id set to 0, all buffers will be cleared. Parameter Minimal Maximal Comment buffer_id (optional) 0 Depends on buffer count (see count command) Frees (deletes content!) of specified buffer or all buffers if buffer_id = 0 or not specified

Reference Manual ATOM one SSM500 18 Lens Drive Unit The following commands control the external lens drive unit (if attached). 18.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 SSM500 [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 18.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 18.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 7.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 18.3 lens_invert This command can be used to invert the movement of the motors.

Reference Manual ATOM one SSM500 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 18.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. 18.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 18.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 18.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 SSM500 0 0...100 1 0...1000 18.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 18.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 18.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 18.6. 18.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 18.8. 18.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 18.6.

Reference Manual ATOM one SSM500 Note: The iris position can only by changed if the iris is currently not controlled by the auto exposure (costApt set to 0, see aec command in chapter 16.1). 18.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 18.8. 18.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 18.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 18.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 18.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 SSM500 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 18.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 18.6. 18.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 18.8.