Versions Compared

Key

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

...

Sensor

The ON Semiconductor Imaging sensor being used.

Part number

The ON Semiconductor part number for this sensor.

Sensor version

The version of the image sensor.

Sensor type

Either 'Bayer' or 'SOC' sensor.

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 DevWare 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 FPGA version is displayed in parentheses.

Firmware

The version of the Firmware code on the Demo board.

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 Clock

The pixel clock output as calculated by DevWare DevWareX based on the specific configuration of the attached device.
It is intended to be the pixel rate at the sensor output.
DevWare 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 DevWare 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.

Format

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

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.

...


Vectorscope
The Vectorscope graph shows the distribution of the chrominance signal in the selected area. You will need to aim the camera at a color reference chart.
NOTE: DevWare DevWareX only uses 8-bit output for Bayer Sensors by Default. To switch to 10-bit output, go to the 'Sensor Output' Bayer Image Sensor Control Pages (See 2.2.4.2)

...

  • By right-clicking on a register (or bitfield) item in the Register dialog, then choosing "Add to Watch" from a popup menu.
  • By right-clicking on a register (or bitfield( item in the Log dialog, then choosing "Add to Watch" from a popup menu.
  • By using the Save/Load button to load a previously save watch list. DevWare DevWareX remembers your watch list when it exits and restores it when it starts up again.

...

  • Sensor Array Clock Speed : allows the user to inform the application that\nthe oscillator on the Demo board has been\nchanged from the factory installed oscillator.
  • Log FIle : enables various types of logging output, from DevWare DevWareX internal errors to USB traffic.
  • Sensor Base Address : allows the detected I2C address to be overridden or detected.
  • Debug Settings : enables debugging of displayed images.
    • Show Dropped Frames : very useful in displaying images that aren't in the expected format, or corrupted frames such as JPEG.
  • Sensor Output : allows the detected width/height/format to be overridden or detected.
  • Display : selects the display format - for remote display of DevWare DevWareX select "No DirectX".
  • Miscellaneous : various settings that could be enabled or disables as seen in the figure above.
  • Warning Dialogs : renables various warning messages that were disabled when their associated dialogs appeared.
  • Reset All : resets all settings to their defaults.

...

  • If the trouble shooting(See 2.2.17) pages did not help solve the problem you are having you may wish to email a bug report as follows:
  • In DevWareDevWareX, go to the menu Help -> Bug Report or select the picture of the "bug" from the toolbar.
  • Provide as detailed as possible a bug description (mention bug symptoms like 'no image', 'distorted image', etc.)
  • Provide information on how to reproduce the bug (what registers did you change, what buttons did you press before the bug showed up, etc)
  • Copy the contents of the system information window to the clipboard by pressing the Copy to Clipboard button.
  • Start an email and paste (Ctrl-V) the clipboard contents of system information into the text portion of the email. Edit this information as you see fit, see the note below.
  • Send the email to Aptina-IMAGING_DEMO_BUGS@onsemi.com.com
      NOTE: The system information that is gathered to help us solve the problems you encountered consists of the following sections: Application version info, Camera info, Windows Operating System info, Processor info, USB Host Controllers info and Image Sensor Register settings. The application only gathers this information and does not send anything. Please look through the information and edit it as you see fit before emailing it.

    Anchor
    Bookmark34
    Bookmark34
    Anchor
    _Toc372623605
    _Toc372623605
    3. About ON Semiconductor's Developer Suite

    The following list provides details about folders of interest installed in C:\Aptina Imaging
    Folders:

    appsApplications that use specialized libraries

    apps_data

    .INI files for ON Semiconductor sensors

    board_data

    Data files for ON Semiconductor demo boards

    capture

    Storage location of DevWare DevWareX captured images

    DevWare
    DevWareXFiles specific to DevWareDevWareX.exe

    doc

    Documents, schematics, and BOM's

    driversUSB drivers and User Guide

    firmware

    Demo board firmware files

    flashtool

    Flash Tool for automotive products

    fpga

    Demo board FPGA files

    include

    Include files for imaging applications

    imageformatsImage format .dll files

    lib

    ON Semiconductor Imaging library (midlib) files

    Plugins

    DevWare DevWareX plug-in files

    samples

    Sample imagine application code

    sensor_data

    ON Semiconductor sensor data (.SDAT) files

    "Start Menu" Index
    Here is a list of folders and their contents, that are accessible from the Windows Start menu.
    Folders:

    Docs

    Start->All Programs->Aptina Imaging->Docs
    Links for all documentation and schematics.

    SDK

    Start->All Programs->Aptina Imaging->SDK
    Links provided to sample applications to help users develop their own imaging applications.

    Tools

    Start->All Programs->Aptina Imaging->Tools
    Links for tools such as HardwareUpdate, RegPoke, Flashtool, etc.)


    Anchor
    Bookmark35
    Bookmark35
    Anchor
    _Toc372623606
    _Toc372623606
    3.1 HardwareUpdate Tool

    This is a Window's application that updates the firmware and FPGA code on the ON Semiconductor Imaging baseboard (Demo2X or Demo3). The tool is located in: Start menu -> All Programs -> Aptina Imaging -> Tools .


    Usage and Tips

...

  • Connect two Aptina Imaging Demo cameras to the system. Make sure the cameras are recognized and the drivers are installed.
  • Launch SideBySide from the desktop shortcut. The application will automatically start two instances of DevWare DevWareX and size the display windows evenly. The initial startup takes a little more time than normal, but requires no user interaction. Please be patient.
  • All DevWare DevWareX toolbars and dialogs are hidden by the application. They can be manually re-enabled if access to a specific control is needed.
  • Selecting Quit from the SideBySide control bar will close all DevWare DevWareX instances, it is not necessary to close each one separately.

...

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 or picking the 'Initialize' menu option below.

Initialize

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

Full Auto

Enable the recommended software color processing options
Note: for Bayer sensors only

Preview mode

Toggle the sensor between preview (viewfinder) and snapshot mode.
Note: typically not supported for VGA size and smaller sensors  

Check Sensor

Re-evaluate the current state of the sensor. This can help you recover from a situation where DevWare DevWareX is dropping all frames.


Anchor
Bookmark40
Bookmark40
Anchor
_Toc372623611
_Toc372623611
4.2 File menu commands

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 sensor.

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 DevWare 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>.

...

Whether the sensor outputs embedded data rows is different from whether DevWare DevWareX hides them.

Sensor

AR0132

AR0132

AR0220

AR0220

Emb. Data on

on

Off

On

On

Emb. Data hidden

Unhidden

Unhidden

Unhidden

Hidden

Height

964

960

980

980

Last row

963

959

979

947

Height - last row

1 (unhidden)

1 (unhidden)

1 (unhidden)

33

...

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 DevWare DevWareX main window. This bar may provide brief infomation about the currently selected feature, status of various Caps/Scroll/Num lock keys, etc.

 User Toolbar

Show or hide User Toolbar below the menu bar.

User Toolbar 2Show or hide User Toolbar in the right side of DevWare 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 PresetsDisplays the default presets file corresponding to the sensor connected.

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>

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.

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.

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 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.

...

Copy Image

Copies image to clip Board.

Edit Image in Aptina Viewer

Opens the image in Aptina Viewer to allow editing.

Edit Raw Image in Aptina Viewer

Opens the Raw image in Aptina Viewer so that it can be Edited.

Search Registers

Opens the Search Registers window to search for desired registers.

Edit Default Presets File

Opens the preset file(corresponding to the sensor connected) in not pad to allow editing.

4.10

...

DevWareX Register "Spying"

DevWare DevWareX spies on register writes, and if something that affects DevWare DevWareX changes, such as image format, then DevWare DevWareX adjusts automatically.

This includes writing to the attached device, any auxiliary boards (e.g. Dual Lane MIPI), and/or the basebase (Demo2X or Demo3).

...