Dream Chip ATOM one 4K mini Manuale utente
1 of 73 Reference Manual ATOM one 4K mini
Table of Contents
1 Overview.........................................................................................................................................5
2 General Operation...........................................................................................................................6
2.1 Connectors...............................................................................................................................6
2.1.1 Power and RS485 Connector...........................................................................................6
2.1.2 AUX Connector................................................................................................................6
2.2 Over Temperature Protection...................................................................................................7
2.3 Status LED...............................................................................................................................8
3 Firmware Update.............................................................................................................................9
3.1 Firmware Update via GUI.......................................................................................................9
3.2 Firmware Update via Script.....................................................................................................9
3.2.1 Preparation for Update.....................................................................................................9
3.2.2 Update of Firmware.........................................................................................................9
4 ProVideo GUI................................................................................................................................11
5 Terminal Usage..............................................................................................................................12
5.1 Terminal.................................................................................................................................12
5.2 Terminal Settings...................................................................................................................12
5.3 General Command Format.....................................................................................................12
5.4 RS485 Addressing..................................................................................................................13
5.5 RS485 Broadcasting..............................................................................................................13
5.6 Inbuild Help...........................................................................................................................14
5.7 Command Parser....................................................................................................................14
6 Settings Handling..........................................................................................................................15
6.1 Set Functions..........................................................................................................................15
6.2 Get Functions.........................................................................................................................15
6.3 auto_save <flag>....................................................................................................................15
6.4 save_settings..........................................................................................................................15
6.5 load_settings..........................................................................................................................16
6.6 reset_settings..........................................................................................................................16
6.7 dump_settings........................................................................................................................16
7 System Commands........................................................................................................................17
7.1 rs232_baud <baud_rate>.......................................................................................................17
7.2 rs485_baud <baud_rate>.......................................................................................................17
7.3 rs485_addr <address>............................................................................................................17
7.4 rs485_bc_addr <address>......................................................................................................17
7.5 rs485_bc_master <address>...................................................................................................18
7.6 rs485_term <flag>.................................................................................................................18
7.7 prompt <flag>........................................................................................................................19
7.8 reboot.....................................................................................................................................19
7.9 fw_update...............................................................................................................................19
7.10 version..................................................................................................................................19
7.11 identify.................................................................................................................................19
7.12 name <name string>............................................................................................................20
7.13 out <index>..........................................................................................................................20
7.14 sdi2 <mode>........................................................................................................................21
7.15 flip <mode>.........................................................................................................................22
2 of 73 Reference Manual ATOM one 4K mini
7.16 log_mode <mode>...............................................................................................................22
7.17 pq_max_brightness <max>..................................................................................................23
7.18 slog3_master_gain <gain>..................................................................................................23
7.19 audio_enable <flag>............................................................................................................23
7.20 audio_gain <gain>...............................................................................................................23
7.21 temp <sensor id>..................................................................................................................24
7.22 max_temp.............................................................................................................................24
7.23 max_temp_reset...................................................................................................................25
7.24 over_temp_count.................................................................................................................25
7.25 fan_speed.............................................................................................................................25
7.26 fan_target <temp>................................................................................................................25
7.27 calibration_profile <id>.......................................................................................................26
7.28 volatile <value>...................................................................................................................26
8 Camera Commands.......................................................................................................................27
8.1 cam_gain <gain>...................................................................................................................27
8.2 cam_exposure <time>............................................................................................................27
8.3 cam_info................................................................................................................................28
9 Video Commands..........................................................................................................................29
9.1 video_mode <mode>.............................................................................................................29
9.2 downscale <channel> <downscale> <interlace>...................................................................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>...............................................................................................34
9.9 sdi_black <offset>..................................................................................................................35
9.10 sdi_white <offset>...............................................................................................................35
9.11 sdi_range <flag>..................................................................................................................35
9.12 post_bright <offset>.............................................................................................................36
9.13 post_cont <factor>...............................................................................................................36
9.14 post_sat <factor>.................................................................................................................36
9.15 post_hue <offset>................................................................................................................36
9.16 wb.........................................................................................................................................37
9.17 awb <flag>...........................................................................................................................37
9.18 awb_speed <speed>.............................................................................................................37
9.19 wb_preset <id>....................................................................................................................37
9.20 gain_red <gain>...................................................................................................................38
9.21 gain_blue <gain>.................................................................................................................38
9.22 gain_green <gain>...............................................................................................................39
9.23 black_master <offset red> <offset green> <offset blue>....................................................39
9.24 black_red <offset>...............................................................................................................39
9.25 black_blue <offset>.............................................................................................................39
9.26 black_green <offset>...........................................................................................................39
9.27 flare <red level> <green level> <blue level>......................................................................39
9.28 filter_enable <flag>.............................................................................................................40
3 of 73 Reference Manual ATOM one 4K mini
9.29 filter_detail <level>.............................................................................................................40
9.30 filter_denoise <level>..........................................................................................................40
9.31 color_conv <c0> .. <c8>......................................................................................................40
9.32 color_cross <c0> .. <c8>.....................................................................................................41
9.33 color_cross_offset <red_offset> <green_offset> <blue_offset>.........................................42
9.34 color_space<color space>....................................................................................................42
9.35 mcc <flag>...........................................................................................................................43
9.36 mcc_opmode <flag>............................................................................................................43
9.37 mcc_blink <mask> [<period_ms>]......................................................................................43
9.38 mcc_set <segment> [<saturation>] [<hue>]........................................................................43
9.39 lsc <enable> <k> <offset> <slope>.....................................................................................46
10 Defect Pixel Correction...............................................................................................................48
10.1 dpc <flag>............................................................................................................................48
10.2 dpc_mode <mode>..............................................................................................................48
10.3 dpc_test_mode <mode>.......................................................................................................48
10.4 dpc_level <detection level>.................................................................................................48
10.5 dpc_add_pixel <x> <y>.......................................................................................................49
10.6 dpc_del_pixel.......................................................................................................................49
10.7 dpc_save...............................................................................................................................49
10.8 dpc_load...............................................................................................................................49
10.9 dpc_auto_load......................................................................................................................49
11 Knee Function..............................................................................................................................50
11.1 knee <enable> <point> <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 table using the fixed gamma mode.........................................52
12.2 lut_enable <index> <flag>...................................................................................................52
12.3 lut_mode <mode>................................................................................................................53
12.4 lut_preset <index>...............................................................................................................53
12.5 lut_sample <xi_0> <yi_0> ... <xi_7> <yi_7>.....................................................................54
12.6 lut_sample_red <xi_0> <yi_0> ... <xi_7> <yi_7>..............................................................55
12.7 lut_sample_green <xi_0> <yi_0> ... <xi_7> <yi_7>...........................................................55
12.8 lut_sample_blue <xi_0> <yi_0> ... <xi_7> <yi_7>............................................................55
12.9 lut_interpolate......................................................................................................................55
12.10 lut_interpolate_red.............................................................................................................55
12.11 lut_interpolate_green.........................................................................................................55
12.12 lut_interpolate_blue...........................................................................................................55
12.13 lut_reset..............................................................................................................................55
12.14 lut_reset_red.......................................................................................................................55
12.15 lut_reset_green...................................................................................................................55
12.16 lut_reset_blue.....................................................................................................................56
12.17 lut_fun_rec709 <threshold> <linear contrast> <linear brightness> <contrast> <gamma>
<brightness>..................................................................................................................................56
12.18 lut_fast_gamma <gamma>................................................................................................58
12.19 lut_fixed_mode <mode>....................................................................................................58
13 Image statistic commands............................................................................................................60
4 of 73 Reference Manual ATOM one 4K mini
13.1 stat_rgb.................................................................................................................................60
13.2 stat_hist <mode>..................................................................................................................60
13.3 stat_exp <mode>..................................................................................................................61
14 SDI Time code.............................................................................................................................63
14.1 timecode <hour> <minute> <second>.................................................................................63
14.2 timecode_hold <flag>..........................................................................................................63
15 Auto Exposure.............................................................................................................................64
15.1 aec <enable> <setPoint> <speed> <clmTolerance> <costGain> <costTint> <costApt>
<taf> <maxGain> <useCustomWeights>......................................................................................64
15.2 aec_weight <index> <weight>............................................................................................66
15.3 stat_ae..................................................................................................................................66
16 Lens Drive Unit...........................................................................................................................68
16.1 lens_setup <address> <chipID> <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 lens_stop <stop>..................................................................................................................70
16.5 lens_info...............................................................................................................................70
16.6 focus_pos <position>...........................................................................................................70
16.7 fine_focus <enable>.............................................................................................................70
16.8 focus_setup <speed> <stepMode> <torque>.......................................................................71
16.9 zoom_pos <position>...........................................................................................................71
16.10 zoom_setup <speed> <stepMode> <torque>....................................................................71
16.11 iris_pos <position>.............................................................................................................71
16.12 iris_setup <speed> <stepMode> <torque>........................................................................72
16.13 iris_apt <aperture>.............................................................................................................72
16.14 iris_table <apt0> <pos0> ... <apt8> <pos8>......................................................................72
16.15 filter_pos <position>..........................................................................................................73
16.16 filter_setup <speed> <stepMode> <torque>......................................................................73
5 of 73 Reference Manual ATOM one 4K mini
1 Overview
This manual describes the usage of the ATOM one 4K mini camera system.
The general operation of the device is described in chapter 2. Information on firmware
updates is found in chapter .
We provide an open-source, free of charge GUI application which gives easy access to
most camera functions, for more details on the GUI see chapter 4.
Chapter 5 and 6 describe how to connect with the device and how the settings on the
device are handled using terminal commands.
For details on the camera functions, please refer to the API chapters of this manual which
start with chapter 7.
6 of 73 Reference Manual ATOM one 4K mini
2 eneral Operation
For regular operation the camera needs only a power supply. For controlling and updating
the camera a RS485 connection is required.
This can be done with the given RS485 USB converter. Connect the USB connector to
your PC and let the operation system install the required drivers.
For RS485 an address is required to access the camera. The default address is “1”.
After powering up the camera the camera will boot. The boot process takes ~ seconds.
2.1 Connectors
The ATOM one 4K has two 6 pin Hirose HR10 connectors.
1. Power: Male HR10 6 pin
2. AUX: Female HR10 6 pin
2.1.1 Power and RS485 Connector
The power connector is male and will mate with a female hirose HR10A-7P-6S(7 ) .
Note: The pin order of HR10A of male and female is counted in different directions.
The following table shows the numbering and cable colors of used Dream Chip adapters.
Female
HR10A-7P-6S(7 )
Signal Cable
6 wire
Cable
4 wire
USB RS485
6 Power in
6- 6 Volt
Red Red -
5 GND Brown Brown Black (gnd)
4 RS485_TX_P Black Looped to pin 1
RS485_TX_N Green Looped to pin 2
2 RS485_RX_N Yellow Black Yellow (D-)
1 RS485_RX_P Orange Orange Orange (D+)
2.1.2 AUX Connector
The axillary connector is female and will mate with a male hirose HR10A-7P-6P(7 ).
Note: The pin order of HR10A of male and female is counted in different directions.
7 of 73 Reference Manual ATOM one 4K mini
This connector has a , V Uart interface to control the camera.
The interface behaves like the RS485, but must be use for peer to peer conections. No
adressing like on RS485 is required.
The I2C interface is reserved for future use like lense control or other extentions.
The following table shows the numbering and cable colors of used Dream Chip adapters.
Pin HR10A-7P-
6P(7 )
Signal Kabel
6 polig
USB RS2 2 TTL
1 Power out
bypassed from
power connector
pin 6.
Red -
2 GND Brown Black (gnd)
Uart TX Black Yellow (RX)
4 Uart RX Green Orange (TX)
5 Iris SCL Yellow
6 Iris SDA Orange
2.2 Over-Temperature Protection
The ATOM one mini has a very compact design which does not allow for active cooling.
Thus the device will get hot under operation. To protect the device the camera will go into
a safe operational mode when the internal CPU temperature reaches 70°C, this will be
indicated by toggling the status LED between orange and red.
The camera will stay in this state until the CPU temperature drops below 50°C, it will then
reboot automatically and resume operation. Alternatively you can power-cycle the device,
but keep in mind that as long as you did not improve the cooling the camera will probably
reach the temperature limit again after a short time.
To keep track of the current cpu temperature use the temp command. The camera also
logs the maximum CPU temperature which can be read out using the max_temp
command. You can reset the logged maximum temperature using the max_temp_reset
command.
Every time the camera reaches the 80°C temperature limit, an over temperature counter
will be incremented. You can read the counter value by using the over_temp_count
command. This counter value is persistent and can not be reset by the user.
8 of 73 Reference Manual ATOM one 4K mini
2.3 Status LED
The Status LED shows the status of the device.
Value Status Note
Purple blinking Booting Device is booting
Yellow blinking Busy Device is processing a command or
loading settings
Red blinking (fast) Genlock Error Device was unable to lock to genlock
signal
Red blinking (slow) Bootloader Device is in bootloader mode and can be
updated or update is running
Toggle between Yellow and
Red
Over Temperature The device reached it’s maximum
temperature of 80°C and is in safe mode.
Power cycle device or wait until
temperature drops below 50°C to resume
operation.
Blue blinking Ready Running, OK status
9 of 73 Reference Manual ATOM one 4K mini
3 Firmware Update
Firmware can only be updated via a serial connection. Make sure, that the power supply of
the camera and the computer for the update are in a stable state.
You can download the latest updated from our GitLab repository:
https://gitlab.com/dreamchip/provideo-downloads
3.1 Firmware Update via UI
You can use the ProVideo GUI (see chapter 4) to update your cameras’ firmware. This is
generally a lot easier, but in some cases (e.g. incompatible GUI and firmware) not
possible.
To perform the update simply connect your camera with the included RS485 USB adapter
to your PC, start the ProVideo GUI, go to the Update Tab, choose the Firmware file and
start the update.
3.2 Firmware Update via Script
The update requires a manual adaption of the update script.
3.2.1 Preparation for Update
Open the folder with the firmware update on your PC.
You need to know your COM port of your USB RS485 interface. This can be done by
checking your “Devices and Printers” in your Windows system.
You also need to know your RS485 ID of your ATOM one camera. The default is 1.
Now you must edit the update_firmware.bat file and edit the to your settings.
The header of the files looks like this:
@echo off
REM SET YOUR COM PORT TO YOUR RS485 USB COM PORT
set COM_PORT=COM156
REM SET THE RS485_ID to your ATOM on C mer ID. Def ult is 1
set RS485_ID=1
Save your changes.
3.2.2 Update of Firmware
Make sure your update_firmware.bat reflects the correct COM port and RS485_ID as
shown in the previous chapter.
Connect the RS485 USB adapter to your PC and to the ATOM one camera.
Power up the camera and wait until its fully started. This takes ~ seconds until the LED
on the backside is blinking blue.
Now start the update_firmware.bat file.
10 of 73 Reference Manual ATOM one 4K mini
After 2 seconds the camera will go into update mode. When this happens the camera will
no longer send an image and the LED on the backside starts blinking red.
After 5 more seconds the firmware update starts.
This process takes about ~10 minutes.
After the firmware update is done, power cycle the camera.
Indice
Altri manuali Dream Chip Macchina fotografica digitale
