Dream Chip ATOM one User manual

1 of 36 User Manual - ProVideo GUI v1.2.4
Table of Contents
1 Overview.........................................................................................................................................2
2 Connecting with a Device...............................................................................................................3
3 General navigation...........................................................................................................................5
3.1 Toolbar.....................................................................................................................................5
3.2 Sidebar.....................................................................................................................................6
3.3 System Settings Dialog............................................................................................................
3.4 Debug Terminal.......................................................................................................................9
4 The Tabs.........................................................................................................................................11
4.1 In-Out Tab..............................................................................................................................11
4.2 Lens Driver Tab.....................................................................................................................15
4.3 Playback Tab..........................................................................................................................1
4.4 Black Level Tab.....................................................................................................................20
4.5 White Balance Tab.................................................................................................................21
4.6 Filter Tab................................................................................................................................22
4. Multi Color Controller Tab....................................................................................................23
4.8 Knee Function Tab.................................................................................................................24
4.9 Lookup Table Tab..................................................................................................................25
4.10 Defect Pixel Correction Tab – Full Version (ATOM one, ATOM one 4K mini).................28
4.11 Defect Pixel Correction Tab – Reduced Version (ATOM one mini and ATOM one
SSM500)........................................................................................................................................30
4.12 Output Tab...........................................................................................................................31
4.13 Info Tab................................................................................................................................33
4.14 Update Tab...........................................................................................................................35

2 of 36 User Manual - ProVideo GUI v1.2.4
1 Overvie
This manual describes the usage of the ProVideo GUI by Dream Chip. The GUI is used to
setup supported ProVideo devices which are attached over a serial interface. The GUI is
currently available for inux and Windows operating systems and supports the following
devices:
•ATOM one
•ATOM one mini (including AIR and waterproof variants)
•ATOM one 4K Mini
•ATOM one SSM500 (Trigger and SSM Mode)
The goal of this document is to describe the full functionality of the GUI. Not all devices
listed above support all features, so the actual appearance of the GUI might vary.
The screenshots in this documentation were created, while the GUI was connected to an
ATOM one camera. The application was run on a desktop PC running Ubuntu 18.04, on
other operating systems the style of the UI elements may vary.
The GUI mainly consists of two windows: The connection dialog is used to establish a
connection to a device, while the main window is used to setup the device. They are
described in detail in the following chapters.
The GUI is open source software, you can get the source code from Git ab:
https://gitlab.com/dreamchip/provideo-gui
The latest firmware and software updates, manuals and application notes for Dream Chip
products, including updates for the ProVideo GUI can be downloaded here:
https://gitlab.com/dreamchip/provideo-downloads

3 of 36 User Manual - ProVideo GUI v1.2.4
2 Connecting ith a Device
The GUI supports serial connections using either the RS485 or RS232 protocol. When
using RS232 only one device can be connected at a time, with RS485 multiple devices
can be connected over one bus. The standard power cable adapter provided with most
devices uses RS485.
On application startup the GUI will automatically search for connected devices on the last
used COM-Port. If one ore more devices are found, the GUI will connect to the first device
and directly open the main window. If no device can be found the connect dialog will open.
It has two pages, one for setting up RS485 the other for RS232 connections:
1 Choose between RS485 or RS232 connection.
2 COM-Port to which the device is connected. This will be “ttyUSBX” on inux and
“ComX” on Windows.
3 The Baudrate has to match the Baudrate of all connected devices. Using devices
with different Baudrates on the same RS485 Bus is not supported.
4 The Auto-Detection will find all devices wich are connected to the selected COM-
Port and match the selected Baudrate.
5 If the Auto-Detection fails, you can try the automated scan which will find all
devices which are connected to the selected COM-Port.
6 When manually connecting to a device, the Device Address has to match the
device parameters.
2
3
5
789
4
2
3
9
8
7
1
6

4 of 36 User Manual - ProVideo GUI v1.2.4
7 When connecting a new COM-Port device after the GUI was launched, click this
button to add it to the Port list.
8 Close the Connect Dialog. If you have previously tried to establish a connection to
a device, but the connection was unsuccessful, this will close the GUI (since it is in
disconnected state).
9 Connect to the device which is specified through the above mentioned settings
(see points 2, 3 and 6).

5 of 36 User Manual - ProVideo GUI v1.2.4
3 General navigation
After the connection was established, the main window will open. It has toolbar for general
options and a sidebar to navigate through the sub pages of the GUI.
3.1 Toolbar
1 Open the connect dialog (see chapter 2).
2 Open the system settings dialog ( see chapter 3.3)
3 oad settings from camera to GUI.
4 Save settings from GUI to camera for startup configuration.
5 Switch to configuration of SDI 1 UT.
6 Switch to configuration of SDI 2 UT.
7 Save current system settings to disk.
8 oad settings from disk into GUI and transfer them to the device.
9 Switch between connected devices. Only visible if the auto-detection was used to
connect with the device over RS485. The first number represents the device
address, the second number the device broadcast address.
10 Toggle broadcast mode. In broadcast mode the currently selected device will be
the broadcast master, all other devices in the same broadcast group will be slaves.
Settings applied to the master will also be applied on all slaves.
11 The Synchronise button is only enabled, if broadcast mode is active. Click it to
apply the settings of the current device (broadcast master) on all other devices
(broadcast slaves).
Note regarding ATOM one SSM500 cameras in Trigger Mode:
The ATOM one SSM500 in Trigger Mode has two independent chains ( ive and Playback).
The “SDI-1” and “SDI-2” buttons will thus be shown as “ IVE” and “P AY” and can be used
to switch to setup of either chain.
Additionally a new button “ IVE → P AY” will be shown if an ATOM one SSM500 in
Trigger Mode is detected. This button can be used to copy all settings from the ive chain
to the Playback chain. If you want to always apply all settings for both chains, enable the
“ ink” button which is placed to the right of the “ IVE → P AY” button.
12 4 51110
9
87
36

6 of 36 User Manual - ProVideo GUI v1.2.4
3.2 Sidebar
Note: For better presentability the screenshot of the sidebar has been turned left by 90
degrees. A click on a symbol opens the corresponding tab:
1 In-Out Tab: Configure exposure settings, lens shading correction, video output,
genlock and timecode features.
2 ens Driver Tab: Configure a connected automated lens (only available for some
camera models).
3 Playback Tab: Control slow-motion recording and playback (only available for
ATOM one SSM500 cameras in Trigger Mode).
4 Black evel Tab: Configure black levels and flare compensation.
5 White Balance Tab: Configure white balance settings.
6 Filter Tab: Configure denoise and detail filters.
7 Multi Color Controller Tab: Configure color correction.
8 Knee Function Tab: Configure the knee function.
9 ookup Table Tab: Configure the gamma correction lookup table.
10 Defect Pixel Correction Tab: Setup the automatic defect pixel correction and create
a defect pixel table.
11 Output Tab: Configure the RGB to YcbCr matrix and fine tune the SDI output
range.
12 Info Tab: Show device and software information and change system settings.
13 Update Tab: Perform device updates.
The tab pages will be described in detail in chapter 4.
13
12 3 456 7 8910 11 12

7 of 36 User Manual - ProVideo GUI v1.2.4
3.3 System Settings Dialog
The settings dialog is used to configure general device and GUI settings.
Note: The GUI Settings (points 11, 12 and 13) will be saved when the GUI is closed and
are restored when it is opened again.
1 Use this field to enter a new device name.
2 Click to apply the device name on the device.
13
1
2
3
4
5
6
10
14
11
9
12
15
7
8

8 of 36 User Manual - ProVideo GUI v1.2.4
3 Change the Calibration Profile. The amount of profiles available depends on the
camera model, this setting is not available on all cameras. For details see the
description of the “calibration_profile” command in the Reference Manual of your
camera.
4 Change the baudrate of the RS232 port of the device. Usually this should be left at
the default setting.
5 Change the baudrate of the RS485 port of the device. Usually this should be left at
the default setting.
6 Change the RS485 address of the device. Before connecting multiple devices to
one RS485 bus, make sure that all devices have different addresses, or you will
have address conflicts!
7 Change the RS485 broadcast address of the device. This is useful if you want to
have multiple broadcast groups on one RS485 bus.
8 Enable or disable the RS485 termination.
Note: RS485 termination has to be setup according to your bus topology. Wrong
termination will degrade signal quality and can cause broken device
communication.
9 Click this button to apply the new Serial interface settings. Without this step, the
settings will be left unchanged.
10 Use this to reset all settings to factory defaults. Careful: This will delete any
calibration you have done, e.g. to the multi color controller. If needed save those
settings separately before performing a full reset!
11 Enable the engineering mode to display additional GUI elements. Careful:
Changing engineering settings can drastically decrease the image quality.
12 Enable the Debug Terminal (see chapter 3.4 for more details).
13 Enable a periodic connection check. If enabled the GUI will ping the connected
device every 2 seconds. If device connection is lost, a dialog will be displayed.
14 Close the settings dialog. Please not that this will not save any settings. If you
have made changes which you want to apply permanently, click the “Apply and
Save” button first.
15 Apply all Settings and Save the settings permanently. This has the same effect as
clicking the save settings button in the toolbar. If you do not want to save the
settings permanently, use the Buttons 2 and 7 and then close the dialog using the
button 11.

9 of 36 User Manual - ProVideo GUI v1.2.4
3.4 Debug Terminal
The Debug Terminal shows all commands which are send by the GUI. It can also be used
to manually send commands to the device.
By default the Debug Terminal opens as a docked widget of the main window. You can turn
it into a stand-alone window by grabbing it and dragging it away from the main window.
The Debug Terminal can be useful to understand how the ProVideo command system of
your device works. Simply open the debug terminal, make changes in the GUI and watch
the output.
1 History of send / received commands. This window shows a maximum of 10000
lines, older lines get deleted as soon as this limit is reached.
2 The command line can be used to enter your own commands (see the reference
manual of your device for a full list of the available commands). The command line
features a command history which you can access by pressing the Arrow Up and
Down keys on your keyboard while the command line is active. The command
history can contain up to 100 commands, older commands are deleted as soon as
this limit is reached.
You can also copy and paste a list of commands, e.g. from a text document to the
command line, all commands will then be executed. Please make sure that you
have selected an appropriate command response wait time (see point 3).
3 Since the Debug Terminal does not know how long a manually entered command
has to be processed in the device a maximum wait time has to be specified. For
most commands the default of 200ms is sufficient.
For long commands like storing the DPCC table or enabling Genlock you will have
to increase the wait time, otherwise you will not see the answer of the device. If
you run a script with multiple commands by pasting it into the command line make
sure to select a wait time which is long enough for the most time consuming
command in the script.
1
2
3456

10 of 36 User Manual - ProVideo GUI v1.2.4
4 Click this button to show the in-application help of the Debug Terminal.
5 Click this button to save the current content of the Debug Terminal to a text file. If
you experience problems with your device like commands which are not correctly
executed, it can be helpful for the Dream Chip support team if you send them the
command log for investigation.
6 This button clears the content of the Debug Terminal. The command history is not
deleted.