Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The toolbar is displayed across the top of the application window, below the menu bar. The toolbar provides quick access to many tools used in DevWareX.
To hide or display the Toolbar, choose Toolbar from the View menu (ALT-V, T).

DetectDetect Devices - same action as "File→Detect Devices".  Find all sensors attached to the PC.

Info

Open or close the Info Dialog. The Info Dialog(See 2.2.5) contains an information window, Display Format choices and the current Mouse Selection choice.

 <F2> or <Ctrl-I>

Control

Open or close the Sensor Control Dialog(See 2.2.4). This set of pages gives access to a variety of image sensor registers through a user friendly interface.

 <F3> or <Ctrl-S>

Preset

Open or close the Preset Dialog(See 2.2.6). This dialog can be used to load or save the current state of the sensors (registers and color pipe settings).

 <Ctrl-P>

Register

Open or close the Register Dialog(See 2.2.7). The Register Dialog allows the user to read and write registers on the image sensor.

 <F4> or <Ctrl-R>

WarnOpen or close the Register Overwrite Dialog.  User Guide is here.

Log

Open or close the Register Log Dialog(See 2.2.8). This dialog logs sensor register writes.

 <Ctrl-L>

Graphs

Open or close the Analysis Dialog(See 2.2.9). The Analysis Dialog displays a graphical interpretation of a selected area of the display.

 <F5>

Magnify

Open or close the Magnifying Glass(See 2.2.10).  Allows user to magnify a section of the display window.


Image

Opens the Image Navigation(See 2.2.11) window.  Useful for navigating an image whose output size is larger than display area.


Watch

Opens the Watch Dialog(See 2.2.13) that allows the user to monitor volatile registers by re-reading them at a set time period.


Options

Opens the Options Dialog(See 2.2.15).


Play

Start displaying the image stream.


Pause

Pause the image stream.


Stop

Stop displaying the image stream.


Reset

(Soft) Reset the sensor to the power-on-defaults. This option loads the [reset] section from the appropriate .ini file.
Note: After resetting the sensor the user should re-load the default register settings by clicking the 'Init' button on the toolbar.


Init

Load the initialization register settings for the sensor. The register settings can be found in the [Demo Initialization] section from the appropriate .ini file.


Full Auto

Enable the default software color processing options.
Note: For Bayer sensors only.


Preview

Toggle the sensor between Preview (viewfinder), snapshot mode, and for sensors that support it video mode via a pull-down.
Note: Typically not supported for VGA size and smaller sensors.


Grab

Capture the displayed sensor image to hard disk or cancel an image capture.

 <F9>

LockFor sensors that support it,  simulates half-press of a camera shutter to lock auto-functions such as AE, AWB, and Auto Focus.

Snapshot

Capture the "full resolution" image to hard disk or cancel an image capture.
For sensors that support them, there is a pull-down where features such as SnapShot-and-lock, Zero shutter lag, and Snapshot Over Video can be demonstrated

 <Ctrl-F9>

Record

Records the image stream to hard disk.
Note: The video is uncompressed and will take significant hard disk space. This mode is for characterization only.


A Power-Point remote clicker's page-down and page-up buttons can be to start/stop recording when the PC is equipped with the IR interface.

 <F8> or

page-down = record start

page-up =
record stop

In

Zoom in on the displayed image.
Note: Zooming beyond 2x might not be supported by your graphics adapter and could lead to image artifacts and potentially to program instability.

 <F10>

Out

Zoom out on the displayed image.

 <F11>

Full

Displays the image in a full screen mode. This feature supports the following standard display modes:
640x480, 800x600, 1024x768, 1280x1024, 1600x1200 and 2048x1536
If the image from the sensor is not one of these sizes, the full screen mode will use the next larger size and fill in the extra area with black pixels. If the image is larger than the maximum size supported by the display device, it will shrink the image to fit. To return back to windowed mode, hit any key or click the mouse.

 <F12>

Bug

Generates a bug report that collects information directly related to the camera setup which is useful for debugging.


Home

Opens the ON Semiconductor homepage (http://www.onsemi.com/) in your browser.


...

The version of the Firmware code on the Demo board

Sensor

The ON Semiconductor Imaging sensor being used (only appears if value is different than "Part Number").

Part numberNumber

The ON Semiconductor part number for this sensor.

FamilyWill appear when a sensor is a member of a "family" of sensors (e.g., Hyperlux).

Sensor version

The version of the image sensor.

Sensor type

Either 'Bayer' or 'SOC' sensor.

Die Temp.Die Temperature.
InterfaceSensor output type; Parallel, MIPI, HiSpi, etc.

Software:


Build name

The version and type of build (either Release or Beta).

Build version

The full version number (major.minor.revision.build) of the DevWareX application.

Build date

Date the software was compiled. (MM/DD/YYYY)

Demo Board:

Type of Demo board being used (for example: DEMO2X or DEMO3).
Note: The FW version and FPGA version is displayed in parentheses.

Firmware

Input ClockThe sensor's input clock (in MHz).

Array Clock

The oscillator frequency being used (in MHz).
Note: This value can be modified by the user through the Options Dialog(See 2.2.15).

Pixel Output Clock

The pixel clock output as calculated by DevWareX based on the specific configuration of the attached device.
It is intended to be the pixel rate at the sensor output.
DevWareX has different ways of deriving clocks from each other.  In most cases, array clock was derived from external clock, and then pixel clock was derived from array clock.

Array Clock is nominally the sensor array clock. It's the clock used to calculate row time, exposure time, etc.
Pixel Clock is PIXCLK for the parallel interface, or the pixel rate. There is also Input Clock which is the clock input to the sensor.

Normally, the clock rates are re-measured when a PLL register is changed. Depending on the demo kit configuration, it may not be possible to measure the clocks from software. Demo2X can measure PIXCLK if the sensor is streaming in parallel mode. Demo3 can measure Input Clock if it is hooked up to the Demo3 clock sense line. Once one of the clocks is measured, the other two can be calculated from the PLL settings.

The clock speed on the Options dialog sets the Array Clock value (in case DevWareX can't measure it), and Pixel Clock and Input Clock will be automatically calculated according to the PLL settings.

Width

The pixel width of the displayed sensor image.

Height

The pixel height of the displayed sensor image.

FormatImage Type

The current sensor image format (for example 'YCbCr', 'Bayer 8', 'Bayer 10', etc.).

Frames

Size (bytes)Size of image data, in bytes.

Frames

A frame counter that gets increased for each displayed sensor image.

Dropped frames

Dropped frames are possible under the following circumstances:

  • The application couldn't determine the end-of-frame because of a change in the data flow (this is not a sensor issue).
  • The image data is sent faster then the computer can handle. This can happen on slower PC's/laptops or when other applications are slowing down the computer.
    To view the dropped (incomplete) frames regardless, go to the Options Dialog(See 2.2.15) and enable 'Debug Mode (show dropped frames)'.

FPS (Sensor)

The computed number of Frames Per Second that the sensor is running at based on register settings and oscillator (see Clock above) value.
Note: SOC sensors dynamically change the frame rate for exposure purposes. To update the FPS number click the 'Refresh' button at the bottom of the main Sensor Control dialog(See 2.2.4).

FPS (Datalink)

The number of Frames Per Second that the camera sends to the host computer via USB (or other data link). This number can be influenced by the speed of the computer, or the host controller and drivers.

FPS (Display)

The number of Frames Per Second that are displayed on the computer. A camera frame is first converted from its native format (see above) to a 32bit RGB image and finally converted to the display adapter's resolution (preferably also 32 bit). Software image processing can slow down the display frame rate. The display frame rate is also affected by the host computer's display drivers. The Accelerated selection on the Options(See 2.2.15) dialog can help.

Cursor pos

The mouse cursor position when the mouse is over the display area. Expressed as a positive (width, height) value relative to the upper-right most pixel (0,0).

Raw Data

The unprocessed sensor data at the mouse cursor position. For SOC sensors the data is separated into Y, Cb, and Cr values. For Bayer sensors there is a single data value, with the Bayer color pattern position indicated in parentheses (R, Gr, Gb, or B).

R: Output

The value of the Red component of the displayed image at the mouse cursor position.

G: Output

The value of the Green component of the displayed image at the mouse cursor position.

B: Output

The value of the Blue component of the displayed image at the mouse cursor position.

...

 This dialog can be used to load or save the current state of the sensor registers and color pipe settings. This information is stored within an .ini file which is loaded for each version of the sensor. For example, the file for the MT9V112 REV3 AR0544CS-REV1 would be located in C:\Aptina Imaging\apps_data\MT9V112AR0544CS-REV3REV1.ini.

All sensors have a 'Demo Initialization' preset. Bayer Sensors typically have a 'Color Processing ON' and 'Color Processing OFF' Preset as well.
INI files are plain text and can be edited by the user.

See the INI File Users 's Guide for more information about ini files and the command syntax.Save Options:
The Save Options sub-dialog allows software settings and/or specific groupings of registers to be saved.

...

The Register Dialog allows the user Image Added

INI file and optional Initializer: Location of main INI file on first line, and optional location of Initializer file (for those sensors with separate Python-settings files).

Preset Actions: various actions available for the loaded INI file.

  • Open: open an additional INI file.  Same operation as available in "File / Open Additional Presets ..."
  • Edit: edit the INI file, using the edit application associated with ".ini" files.
  • Edit Initializer: edit the Initializer file (when present), using the edit application associated with ".py" files.
    • Note: notepad.exe will be used if no edit application is associated with ".py" files.
  • Reload: reread the INI file - to be used if "Edit" or "Edit Initializer" have modified their respective files.
  • Default: go back to the default INI file - the INI file associated with the loaded SDAT file.
  • Load: will load and run the Preset highlighted in the "Presets" window.
  • Rename: rename the selected Preset.
    • Note that the INI file is automatically saved, but does not need to be Reloaded.

Preset Name Search: enter search terms. Only preset names matching all terms will be shown.

Presets: displays all available Presets.  Note that Dialog Settings "Options..." can be used to show "Hidden" presets.

Dialog Settings: various settings that are available.

  • Warnings: Show the Register Overwrite Warnings dialog. Same operation as the "Warn" Toolbar.
    • This will check for accidental overwrite of OTPM-trimmed registers, or other inappropriate register values.
    • Checking this report should be part of the verification of any new mode presets.
  • Options...: show "Hidden" presets.
  • Guide: opens the on-line INI Users Guide.

Anchor
Bookmark22
Bookmark22
Anchor
_Toc372623593
_Toc372623593
2.2.7 Register Dialog

The Register Dialog allows the user to read and write registers on the image sensor. For a more user-friendly way to access registers use the Sensor Control Dialog(See 2.2.4) .
The drop-list box and tabs at the top of the Dialog (Sensor Core, Color Pipe, etc.) are used for sensors that have multiple address spaces/pages/register categories. To choose an address space, select it from the drop-list or click the appropriate tab. The tabs hold the six most recently used pages. Sensors with only one address space do not have any tabs.

...

Open Sensor Data File 

Open a specific sensor data (SDAT) file for the current sensor.

Open Image or Video File

Open an image file and display the image, instead of a sensorof a sensor.

Recent Sensors / ImagesShow a list of the most recent SDAT and image files.
Refresh Register ListReopen a specific sensor data (SDAT) file for the current sensor(Using file browse).

Open Default Presets

Open an INI file as the default presets file. (same as the Browse... button on the Presets dialog).

Open Additional Presets

Open an INI file as an additional presets file. This INI file will not affect the dfault presets file, and it will not be used to specify the actions of the DevWareX toolbar.Refresh Register List

Reopen a specific sensor data (SDAT) file for the current sensor(Using file browse).

Probe for Devices

Re-run the device probe that will determine what sensor you have attached and automatically select the right SDAT file.

Capture Image

Capture the currently displayed sensor image to hard disk <F9 >.

Take Snapshot

Capture the sensor image to hard disk <Ctrl-F9 >.

Record Video

Record the image stream to hard disk Note: the video is uncompressed and will take significant hard disk space. This mode is for characterization only.

Exit

Exit the application. <Alt-F4>.

...

Help Topics

Offers you an index to topics on which you can get help.

Tutorial VideosPoints to our YouTube channel. The video support link is https://www.youtube.com/user/AptinaDeveloper/videos

Bug report

When you find a problem with this software, please file for a bug report by following the information in the Bug Report Dialog.

System DumpOpens system information in Bug Report pop up window.
Performance OverlayPerformance log is displayed as overlay on the image or view finder.
Performance DumpPerformance Dump is displayed as part of overlay
Check for updatesDisplays the latest DevSuite daily build that could be installed
Internet Home Page
Opens the page http://www.onsemi.com/

About

Version and copyright information.

...

This only occurs when you hide extra rows. In your table below the only case where you used the 'Hide' option is the right-most column, 'AR0220AT/hidden'. In all other columns you have not used the 'Hide' option, so the 'last row' is 'height' - 1.

Double-click "Mouse Selection" bar to open the dialog that allows setting of up to 8 unique mouse configurations.  Also see "Lock Mouse Selection", here.

Summary

Not using 'Hide' option: 'last row' = 'height' - 1
Using 'Hide' option: 'last row' = 'height' - number_of_hidden_extra_rows - 1

...

Displays the default presets file corresponding to the sensor connected

Toolbar

Show or hide the Toolbar(See 2.2.2).

Status Bar

Show or hide the Status Bar that appears along the bottom of the DevWareX main window. This bar may provide brief infomation about the currently selected feature, status of various Caps/Scroll/Num lock keys, etc.

 User User Toolbar

Show or hide User Toolbar below the menu bar.

User Toolbar 2Show or hide User Toolbar in the right side of DevWareX to enable adding desired shortcuts needed by user.
Plugins ToolbarShow or hide Plugins menu(See 2.2.1.1).
Toolbar LabelsShow or hide labels for the options in the toolbar.Default Presets
RulersShow or hide the pixel labels in the live video display.
Pixel Values in HexWhen fully zoomed-in in the live video display, show the pixel values in hex or decimal.

Info Dialog

Open or Close the Info(See 2.2.5) Dialog . This dialog contains Demo System information, display format choices and the current mouse selection(See 4.4) choice. <F2> or <Ctrl-I>

Sensor Control

Open or Close the Sensor Control(See 2.2.4) pages. This set of pages provides access to a variety of image sensor registers through a user friendly interface. <F3> or <Ctrl-S>through a user friendly interface. <F3> or <Ctrl-S>

ColorPipeOpen or Close the ColorPipe dialog.  User Guide can be found here.

Preset Dialog

Open or Close the Presets(See 2.2.6) dialog. This dialog can be used to load or save the current state of the sensors (registers and color pipe settings). <Ctrl-P>

Register Dialog
 

Open or Close the Register(See 2.2.7) Dialog. This dialog allows the user to read and write registers on the image sensor. <F4> or <Ctrl-R>

Register Data sheetOpen or Close Register Data Sheet window containing register bit information

User ControlCreate your own presets using a text editor, or various tools in DevWareX. User Guide can be found here.
Register All Access
(Peek & Poke)
Opens the Peek & Poke(See 2.2.12) dialog. This dialog allows the user to quickly read or write registers by specifying specific addresses and values.
Register Overwrite
Warnings
Open or Close the Warn Dialog. User Guide can be found here.

Log Dialog

Open or Close the Register Log(See 2.2.8) Dialog. This dialog allows the user to view and log all the register changes that are happening. This could be useful when manipulating higher-level user interfaces on the Sensor Control pages. <Ctrl-L>

Peek & Poke
 

Opens the Peek & Poke(See 2.2.12) dialog. This dialog allows the user to quickly read or write registers by specifying specific addresses and values.the Sensor Control pages. <Ctrl-L>

Analysis Graphs

Open or Close the Analysis(See 2.2.9) Dialog. This dialog displays a graphical interpretation of a selected area of the display. <F5>

Magnifier

Open or Close the Magnifier(See 2.2.10) window. This feature allows user to zoom a desired section of the display area.

Image NavigatorOpen or Close Image Navigator Window.

Watch

Open or Close the Watch(See 2.2.13) Dialog. This dialog allows the user to add individual registers and track their value in real time.

Embedded Data ViewerOpens or Closes Embedded Data Viewer which could be used to log embedded data to a desired .csv file

.

Captured ImagesOpens or closes captured images window showing the images captured in the particular instance of DevWare.
Python ConsoleOpens the Python console where commands could be entered.
Debug ConsoleOpens Debug console.
EEPROM PresetsOpens EEPROM Presets console.View sensordata
Warning LogOpens the Warning Log Dialog.
Mouse Selection AreaOpens the Mouse Selection Dialog.  Allows for selecting up to 8 different mouse selection configurations.
View Sensor Data FileOpens the sensor data file for the connected sensor.

Zoom in

Zoom in on the display image. <F10>

Zoom out

Zoom out on the display image. <F11>

Full Screen

Switches the display into FullScreen Mode. To return back to windowed mode, hit any key. <F12 >

Options

Open or Close the Options(See 2.2.15) Dialog.

Center All DialogsUse when switching between different sized monitors and dialogs are positioned off the screen.

Open or Close​

Opens the Peek & Poke(See 2.2.12) dialog. This dialog allows the user to quickly read or write registers by specifying specific addresses and values​

Anchor
Bookmark47
Bookmark47
4.7 Gray Checker

...