background image

19 of 73

Reference Manual ATOM one 4K mini

 7.7  prompt <flag>

Set prompt mode.

Flag

Function

0 (reset)

No prompt

1

'=>' prompt

 7.8  reboot

Does a system reboot (warm start).
A full reboot takes depending of configuration and camera about 30 seconds.

 7.9  fw_update

Set the system into USB firmware update mode. This mode is usually controlled by the 
Windows update software.

 7.10 version

Dumps a detailed version information about the system with system ID and firmware 
version.
The output looks like this:

platform: condor4k_mini_16
device name: ATOM one 4K mini
system-id: 003F001E-30324703-37313437-FFFFFFFF
hw revision: 00001602
system validity: LICENSED
feature mask HW: 0019A01C
feature mask SW: FFFFFFFF
resolution mask: 00000000-00000000-000FFFFF
loader version: 1328 (2)
sw-release-id: V1.1.2
sw-release-date: 2017-06-15 15:38:45 +0200 (Do, 15 Jun 2017)
sw-build-date: 2017-06-15 15:38:55

 7.11  identify

Dumps essential system information including the platform, RS485 configuration and the 
device name. This command can be used to identify all devices which are connected to 
one RS485 bus by sending it to device address 100 (the fail-safe device address).
Each device will wait until it is its turn before sending its ID string. The higher the RS485 
address of the device, the longer the device will wait before posting its stats, this ensures 

Summary of Contents for ATOM one 4K mini

Page 1: ...3 General Command Format 12 5 4 RS485 Addressing 13 5 5 RS485 Broadcasting 13 5 6 Inbuild Help 14 5 7 Command Parser 14 6 Settings Handling 15 6 1 Set Functions 15 6 2 Get Functions 15 6 3 auto_save...

Page 2: ...30 9 3 genlock mode 31 9 3 1 Status LED 32 9 4 genlock_crosslock enable vmode 32 9 5 genlock_offset v_offset h_offset 34 9 6 genlock_term enable 34 9 7 genlock_status 34 9 8 genlock_lol_filter time_ms...

Page 3: ...slope 50 12 Look up Table Management 51 12 1 1 How to setup a lookup table using interpolation 51 12 1 2 How to setup a lookup table using the fast gamma function 52 12 1 3 How to setup a lookup tabl...

Page 4: ...hipID lensFeatures focusNr zoomNr irisNr filterNr focusFeatures zoomFeatures irisFeatures filterFeatures 68 16 2 lens_active activate 69 16 3 lens_invert invFilter invIris invZoom invFocus 69 16 4 len...

Page 5: ...ates is found in chapter 3 We provide an open source free of charge GUI application which gives easy access to most camera functions for more details on the GUI see chapter 4 Chapter 5 and 6 describe...

Page 6: ...Power Male HR10 6 pin 2 AUX Female HR10 6 pin 2 1 1 Power and RS485 Connector The power connector is male and will mate with a female hirose HR10A 7P 6S 73 Note The pin order of HR10A of male and fem...

Page 7: ...the device the camera will go into a safe operational mode when the internal CPU temperature reaches 70 C this will be indicated by toggling the status LED between orange and red The camera will stay...

Page 8: ...g settings Red blinking fast Genlock Error Device was unable to lock to genlock signal Red blinking slow Bootloader Device is in bootloader mode and can be updated or update is running Toggle between...

Page 9: ...ion of the update script 3 2 1 Preparation for Update Open the folder with the firmware update on your PC You need to know your COM port of your USB RS485 interface This can be done by checking your D...

Page 10: ...ill go into update mode When this happens the camera will no longer send an image and the LED on the backside starts blinking red After 5 more seconds the firmware update starts This process takes abo...

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

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

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

Page 14: ...more details 5 6 Inbuild Help Type help to get a full list of supported commands It is possible to get a detailed help for each command by typing help cmd Example to get help for the video_mode comman...

Page 15: ...ons to extract the current settings out of the system Example video_mode video_mode 5 returned video_mode video_mode 5 returned 6 3 auto_save flag Controls auto save Flag Function 0 Auto save OFF 1 re...

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

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

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

Page 19: ...3F001E 30324703 37313437 FFFFFFFF hw revision 00001602 system validity LICENSED feature mask HW 0019A01C feature mask SW FFFFFFFF resolution mask 00000000 00000000 000FFFFF loader version 1328 2 sw re...

Page 20: ...ni_16 55 0 0 ATOM one 4K Front OK 7 12 name name string 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 t...

Page 21: ...terpolate LUT 1 LUT 2 lut_sample LUT 1 LUT 2 7 14 sdi2 mode The SDI 2 output can be configured to support alternative modes Mode Function 0 reset Same signal as SDI 1 mirrored 1 Use of a separate LUT...

Page 22: ...e maximum brightness of the attached display using the pq_max_brightness command see chapter 7 17 3 S Log3 A S Log3 gamma curve is used The user can setup the gain of the curve using the slog3_master_...

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

Page 24: ...or id Dumps camera temperature values in degree centigrade Temperature Sensor ID Function 0 System temperature with 0 1 C accuracy 1 CPU temperature with 0 1 C accuracy The output has the format temp...

Page 25: ...o safe mode to avoid over temperature CPU temperature 80 C It is persistent and can not be reset by the user Example over_temp_count over_temp_count 3 OK 7 25 fan_speed Dumps the current speed of the...

Page 26: ...one 4K mini cameras from Q1 2021 When being shipped each camera is already configured with the correct calibration profile and the setting will survive a firmware update This means usually you do not...

Page 27: ...gain you have to divide it by 1000 and then multiply it with the ISO at gain 1 To read out the ISO at gain 1 you can use the cam_info command see below For the ATOM one 4K mini it will report the fol...

Page 28: ...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 out...

Page 29: ...ownscale command in section 9 2 Mode ID Resolution Frame Rate 25 3840x2160 UHD 30 26 3840x2160 UHD 25 27 3840x2160 UHD 24 28 3840x2160 UHD 23 98 29 3840x2160 UHD 29 97 30 3840x2160 UHD 50 31 3840x2160...

Page 30: ...s Examples Enable downscaler on first SDI output 1 downscale 1 1 0 Enable downscaler and interlacer on second SDI output 1 downscale 2 1 1 Please not that the downscale and interlace flags are only ap...

Page 31: ...0i50 If you want to lock to another frequency e g i50 use the genlock_crosslock command Flag Mode Comment 0 Disable Genlock off 1 Input Slave In this mode the system will genlock to the external tri l...

Page 32: ...rational mode the camera locks to a tri level sync signal that matches the cameras current video mode Using the crosslock option the camera can also lock to other input signals This is valid for both...

Page 33: ...ndard does not define any interlaced video modes it is also possible to crosslock to interlaced tri level sync signals see the following table for all available modes vmode Parameter Required Tri Levl...

Page 34: ...enlock Slave Mode see chapter 9 3 In Master mode this setting has no effect and the termination will always be disabled Enable Function 0 Termination off 1 Termination on reset 9 7 genlock_status Use...

Page 35: ...r and will stretch die output values to adapt to the new range Value Reset Minimal Maximal offset 0 60 60 9 10 sdi_white offset Sets the white level for SDI in legal range mode see sdi_range An offset...

Page 36: ...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 9 14 post_sat factor Set post processing color satu...

Page 37: ...e shot white balance 9 17 awb flag Enables continuous auto white balance Flag Function 0 reset disable 1 enable 9 18 awb_speed speed Sets the control speed of the continuous auto white balance Value R...

Page 38: ...K 3 Flash 5000K 4 Daylight D55 5500K 5 Daylight D60 6000K 6 Daylight D65 6500K 7 Shady 7500K 8 Cloudy 8500K 9 Blue Sky 10000K 9 20 gain_red gain Set gain factor for red component for selected output c...

Page 39: ...ack_master 10 20 30 9 24 black_red offset 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...

Page 40: ...8 filter_enable flag Enable function for the filter functions Flag Function 0 disable 1 reset enable 9 29 filter_detail level Set the detail enhance level Value Reset Minimal Maximal level 0 0 65 9 30...

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

Page 42: ...ange of 2048 0x800 to 2047 0x7FF 0 is represented as 0x000 Value Reset Minimal Maximal red_offset 0 2048 2047 green_offset 0 2048 2047 blue_offset 0 2048 2047 9 34 color_space color space Configures t...

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

Page 44: ...44 of 73 Reference Manual ATOM one 4K mini Value Minimal Maximal Comment...

Page 45: ...1 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 Satura...

Page 46: ...orrected using the Lens Shading Correction module Please note that this is an advanced feature that requires the right measurement equipment to be setup correctly see setup instructions at the end of...

Page 47: ...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 over...

Page 48: ...est 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 49: ...ordinates from the defect pixel table 10 7 dpc_save Saves defect pixel table to persistent memory 10 8 dpc_load Loads defect pixel table from persistent memory 10 9 dpc_auto_load Automatically detects...

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

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

Page 52: ...LUT 2 12 1 2 How to setup a lookup table using the fast gamma function When using fast gamma setup switch to lut mode 1 lut_mode 1 Method 3 The fast gamma lut setup will calculate the lut using a func...

Page 53: ...lue 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...

Page 54: ...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 positio...

Page 55: ...0 yi_0 xi_7 yi_7 Same as lut_sample but only for red component 12 9 lut_interpolate Interpolates all look up tables based on the given sample points 12 10 lut_interpolate_red Interpolates the red look...

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

Page 57: ...function part The linear part ranges from 0 to 0 018 and is computed by the following formula Vout 4 5 V in The maximum value in this range is Vout min lim V in 0 018 4 5 Vin 4 5 0 018 0 081 The non...

Page 58: ...lb 0 int c int round contrast 1000 0f c 1099 int g int round linear_contrast 1000 0f g 450 int b int round brightness 1000 0f b 99 Example curve for REC 709 lut_gamma 18 4500 0 1099 450 99 OK 12 18 l...

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

Page 60: ...GB 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 61: ...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 62: ...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 63: ...4 OK set sdi time code to 2h 10m 53s timecode 2 10 53 system acknowledges OK 14 2 timecode_hold flag This command can be used to hold the timecode on the SDI output This can be used to trigger recordi...

Page 64: ...ines 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 exp...

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

Page 67: ...tPoint Modified target value meanLuma Mean luminance meanLumaObject Mean luminance of object region meanHistogram Mean luminance determined by histogram clmHistogramSize Histogram bin count sumHistogr...

Page 68: ...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 69: ...t3 1 torque control 16 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...

Page 70: ...ample 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 Filt...

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

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

Page 73: ...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 16 15 filter_pos position This comma...

Reviews: