background image

70 of 95

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 <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 <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/m

 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.

Summary of Contents for ATOM one SSM500

Page 1: ...ow 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 Car...

Page 2: ...n 31 8 13 identify 31 8 14 name name string 32 8 15 out index 32 8 16 flip mode 32 8 17 log_mode mode 33 8 18 pq_max_brightness max 33 8 19 slog3_master_gain gain 34 8 20 audio_enable flag 34 8 21 aud...

Page 3: ...n level blue level 52 10 27 filter_enable flag 52 10 28 filter_detail level 52 10 29 filter_denoise level 52 10 30 color_conv c0 c8 53 10 31 color_cross c0 c8 53 10 32 color_cross_offset red_offset gr...

Page 4: ..._reset_blue 67 13 17 lut_fun_rec709 threshold linear contrast linear brightness contrast gamma brightness 68 13 18 lut_fast_gamma gamma 70 13 19 lut_fixed_mode mode 70 14 Image statistic commands 72 1...

Page 5: ...ctivate 91 18 3 lens_invert invFilter invIris invZoom invFocus 91 18 4 lens_stop stop 92 18 5 lens_info 92 18 6 focus_pos position 92 18 7 fine_focus enable 92 18 8 focus_setup speed stepMode torque 9...

Page 6: ...rm 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...

Page 7: ...crease 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...

Page 8: ...k 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...

Page 9: ...k 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...

Page 10: ...nt 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...

Page 11: ...rtain 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...

Page 12: ...ed 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 enginee...

Page 13: ...trast 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...

Page 14: ...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 s...

Page 15: ...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 fema...

Page 16: ...ong 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 10...

Page 17: ...low 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...

Page 18: ...0 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 wil...

Page 19: ...erformed 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...

Page 20: ...ed 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 t...

Page 21: ...L 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 de...

Page 22: ...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...

Page 23: ...s485_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 cmd...

Page 24: ...ple video_mode video_mode 5 returned video_mode video_mode 5 returned 7 3 auto_save flag Controls auto save Flag Function 0 reset Auto save OFF 1 Auto save ON With this flag any settings change will i...

Page 25: ...pted 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 th...

Page 26: ...ed 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 bl...

Page 27: ...m 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...

Page 28: ...e baud_rate 9600 14400 19200 57600 115200 default 8 3 rs485_addr address 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 wi...

Page 29: ...ress 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 an...

Page 30: ...ull 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 id This command can be used two switch between the two opera...

Page 31: ...lease 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 devi...

Page 32: ...e 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 th...

Page 33: ...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 Dependin...

Page 34: ...e 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...

Page 35: ...abled 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 B...

Page 36: ...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 o...

Page 37: ...y FAILING will be reported Bit 5 WARN_PREFAIL Bit 6 WARN_ERR_LOG Bit 7 WARN_TEST_LOG min_temp Minimum Temperature Reports the coldest temperature the device has logged in C current_temp Current Temper...

Page 38: ...ode The fields have the following meaning Value Meaning Description num ID of the SSD 0 or 1 result_text Test result in user readable format If the test did not find any issues the result is PASS else...

Page 39: ...er 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 vol...

Page 40: ...00 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 time Sets the exposure time shutter width in micros...

Page 41: ...1920x1080 50 10 1920x1080 60 11 1920x1080 60i 12 1920x1080 50i 13 1920x1080 59 94i 14 1920x1080 59 94p 10 2 fps_mode mode Note This command is only available in the ATOM one SSM500 in Trigger Mode For...

Page 42: ...x1080 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 1...

Page 43: ...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 fram...

Page 44: ...put 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 leve...

Page 45: ...s 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 Lockin...

Page 46: ...ould 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 t...

Page 47: ...dapt to the new range Value Reset Minimal Maximal offset 0 60 60 10 9 sdi_white offset Sets the white level for SDI in legal range mode see sdi_range An offset value of 0 will result in an SDI white v...

Page 48: ...mal 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 factor Set post processing color sat...

Page 49: ...will run for 200 frames Value Default Minimal Maximal frames optional 200 1 1000 10 16 awb flag Enables continuous auto white balance Switching from disabled to enable will first reset the white bala...

Page 50: ...ll 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...

Page 51: ...red 10 22 black_master offset red offset green offset blue Set the black level offset for red green and blue components for selected output channel The processing is done in linear RGB domain pre gamm...

Page 52: ...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 655...

Page 53: ...oeff7 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 c0 c8 Sets the color cross talk matrix The Cross Talk b...

Page 54: ...ctor 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 red_offset green_offset blue_offset Sets the color cross talk offset in th...

Page 55: ...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 flag Multimatrix color correction control Flag...

Page 56: ...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 deg...

Page 57: ...turation 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 h...

Page 58: ...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 Poi...

Page 59: ...st 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...

Page 60: ...xel 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 pixel index Deletes a pixel coordinate given by in...

Page 61: ...y 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...

Page 62: ...he 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...

Page 63: ...e 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 c...

Page 64: ...e 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 gam...

Page 65: ...n 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...

Page 66: ...on 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 e...

Page 67: ...ut_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_gree...

Page 68: ...000 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...

Page 69: ...n linear min Brightnessnon linear Contrastlinear threshold Brightnesslinear Contrastnon inear threshold Gamma Example Pseudo Code to setup a REC 709 gamma curve float threshold 0 018 float linear_cont...

Page 70: ...of 2222 will result in the default REC 709 gamma curve 13 19 lut_fixed_mode mode The fixed gamma mode allows to choose between three fixed gamma tables which are shown in the table below Mode Descrip...

Page 71: ...stead 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 f...

Page 72: ...B 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...

Page 73: ...osure 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 resoluti...

Page 74: ...cription 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...

Page 75: ...OK set sdi time code to 2h 10m 53s timecode 2 10 53 system acknowledges OK 15 2 timecode_hold flag This command can be used to hold the timecode on the SDI output This can be used to trigger recording...

Page 76: ...nes 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 expo...

Page 77: ...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 us...

Page 78: ...easured 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 ind...

Page 79: ...iation semSetPoint Modified target value meanLuma Mean luminance meanLumaObject Mean luminance of object region meanHistogram Mean luminance determined by histogram clmHistogramSize Histogram bin coun...

Page 80: ...h 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...

Page 81: ...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...

Page 82: ...p 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...

Page 83: ...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...

Page 84: ...nt 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 speci...

Page 85: ...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 buffe...

Page 86: ...op 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 Sh...

Page 87: ...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 Po...

Page 88: ...r 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...

Page 89: ...arameter 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 Free...

Page 90: ...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...

Page 91: ...3 1 torque control 18 2 lens_active activate 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 w...

Page 92: ...mple 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 Filte...

Page 93: ...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...

Page 94: ...e 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 St...

Page 95: ...sition 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 position This comma...

Reviews: