NanEyeGS - Awaiba Viewer

CONFIDENTIAL
Co
nf
id
en
NanEyeGS in
Awaiba Viewer
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
1/13
CONFIDENTIAL
Co
Revision History:
Version
Date
Modifications
Author
1.0.0
16-10-14
Document creation
João Santos
1.1.0
04-11-14
General Update
João Santos
nf
id
en
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
2/13
CONFIDENTIAL
Co
Table of Contents
1 Introduction......................................................................................................................................................................5
2 NanEye GS.......................................................................................................................................................................6
nf
2.1.1 Sensor control.....................................................................................................................................................6
2.1.1.1 General....................................................................................................................................................6
2.1.1.2 Expert Registers......................................................................................................................................8
2.2 How to enable the high dynamic range mode...........................................................................................................10
id
en
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
3/13
CONFIDENTIAL
Co
Index of Tables
Index of Figures
nf
Figure 1: NanEyeUSB2 Viewer - Main Interface.................................................................................................................6
Figure 2: General registers....................................................................................................................................................7
Figure 3: NanEye GS Expert Registers................................................................................................................................8
Figure 4: Piece wise linear programmable response function............................................................................................10
Figure 5: Nan Eye GS Viewer – Office desk .....................................................................................................................11
Figure 6: Nan Eye GS Viewer - High Dynamic Range office desk - linear mode.............................................................12
id
Figure 7: Nan Eye GS Viewer - High Dynamic Range linear mode office desk - short exposure time............................13
en
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
4/13
CONFIDENTIAL
Co
1 Introduction
The document will describe the NanEyeGS specific options that can be used inside the Awaiba
Viewer software.
•
•
nf
•
Capture data from up to 1 NanEyeGS sensor TrenzModule USB2 board;
Capture data from up to 1 NanEyeGS sensor IduleModule USB3 board;
Capture data from up to 2 NanEyeGS sensor with disposcope USB3 board;
Please check our software page to download the most recent version of Awaiba Viewer.
id
This document describes the NanEye GS registers that can be changed, as well as which parameters
they can receive.
For more information regarding the registers, please check the NanEye GS spec.
en
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
5/13
CONFIDENTIAL
Co
2 NanEye GS
This option is used with the Trenz Module board with AwaibaViewer.
Also, with the NanEyeGS USB3 board, you have also the same interface, and in the stereo option,
you have the same interface for both sensors.
nf
To view all the options please check the Awaiba Viewer QuickStart document that can be
downloaded in Awaiba's software webpage.
id
en
ti
Figure 1: NanEyeUSB2 Viewer - Main Interface
al
2.1.1 Sensor control
2.1.1.1 General
Figure 2 shows the general registers that can be changed by the user:
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
6/13
CONFIDENTIAL
Co
nf
Figure 2: General registers
•
•
◦
This value changes the exposure time of the sensor;
◦
The higher this value, the brigher the image, but a high value will reduce the frame rate.
Gain:
◦
Can have values between 0 and 15;
◦
0 is the brighest and 15 the darkest.
Offset:
◦
Can have values between 0 and 15;
◦
0 is the darkest and 15 is the brightest.
Exposure:
◦
Can have values between 0 and 255;
◦
0 is the darkest and 255 the brightest;
◦
Generally, this value is set to 255, and the user changes the pre-scaler to adjust the image
brightness.
Frame Rate:
Can vary from 0 to 11.5 frames per second;
◦
The values in ms are computed assuming the sensor operation at 25Mhz, which is the
default evaluation unit FPGA program. If you load an FPGA program with 50Mhz or
12.5MHz sensor clock, please follow the indication how to reprogram the FPGA board
with an alternative bit file and how to adjust the sensor .ini file to achieve correct
Exposure and frame rate values.
Please note that the Actually transmitted frame rate is limited by the USB and System
bandwidth, and is Indicated in the top left of the viewer (4). The Cypress driver used has
a maximum data rate limit to 11 Fps. If the sensor runs at higher frame rate, the
additional frames will be discarded.
al
◦
◦
DATE:
ti
•
Can have values between 0 and 255;
en
•
◦
id
•
Pre-Scaler:
04/11/14
16-10-14
Version 1.1.0
PAGE:
7/13
CONFIDENTIAL
Co
◦
Please do adjust the Frame rate and the exposure time, such that the sensor frame rate is
always below the indicated Maximum Frame Rate for the chosen exposure time setting!
For NanEyeGS in IduleModule, the user can only change the pre-scaler and the exposure registers.
2.1.1.2 Expert Registers
nf
On Figure 3 there is the Expert Registers tab, that allow the user to change all the sensors registers,
according to the NanEyeGS spec documentation.
id
en
ti
al
Figure 3: NanEye GS Expert Registers
The values can be represented in binary, decimal or hexadecimal, according to the user's needs.
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
8/13
CONFIDENTIAL
Co
By means of the Tap "Expert Registers" the user can take direct control over the sensor Registers. It
is mandatory to consult the Sensor Specification which explains each of the bit's in the sensor's I2C
register bank's and their functionality to properly adjust the settings in this tap.
nf
For convenience of the user, the bit groups more frequently accessed are grouped to an alias, that
writes only to part of a register. Bit's exceeding the applicable bit field of the respective function are
ignored when written to the sensor by the lower levels of the software.
The registers are name from Reg0 to Reg15 and its values are the same as defined in the
specification.
id
Also the user can change the FPGAFrameRate, that is the frame rate value * 100. For example,
by default, the value is 1100, that means that the user will get 11 frames per second. If the user
changes to 900, it will start receiving 9 frames per second.
Please reefer to the NanEye_GS ASIC specification Chapter: "Registers" for the definition of each
of those bit's and explanation of they're functionality or send an email to [email protected].
en
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
9/13
CONFIDENTIAL
Co
2.2 How to enable the high dynamic range mode
nf
The dynamic range mode provides a piece wise linear response (PWL) with a programmable
compression threshold and slope. The below figure explains the working principle of the Piece wise
linear response mode. For low illumination intensities, the pixels response is left unchanged, and
behaves like a standard integrating pixel. It's slope is defined by the total Exposure time (also
referred to as "integration time). After the pixel signal reaches a certain threshold, which is
programmed by means of the bit's 7:2 of the register 0x08, the response curve of the pixel is
flattened.
id
en
ti
Figure 4: Piece wise linear programmable response function
al
The response slope beyond the threshold is a linear function of the difference between
(Reg 0x06) - (Reg 0x07). The registers for Exposure and PWL time respectively. The signal level
of the threshold is set by Register 0x08 bits 7:2.
The higher the value of the bits 7:2 in Register 0x08 is set, the lower in signal range the
compression threshold is set.
Finally, the pixel reset voltage, which can be set by register 0x0A bits 2:0 should preferably be set at
it's highest value to allow the maximum analogue swing of the pixel.
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
10/13
CONFIDENTIAL
Co
A good starting combination of values to enable work with the high dynamic range mode are:
Reg6 = 0xFF
Reg7 = 0xFA
Reg8= 0xE5
nf
to enable the PWL mode, finally bit 1 of register 0x03 has be set to 1.
Reg3 = 0x8E
id
The overall exposure time is then adjusted by means of the prescalar value, Reg5 or the Prescalar
slider in the General tap.
As a result, an image which can cover a wide dynamic range between shades and bright part's can be
captured within the same frame.
Image in PWL response mode, showing an office desk with mostly closed sun shields and bright
sun illuminated outside, in Figure 5:
en
ti
al
Figure 5: Nan Eye GS Viewer – Office desk
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
11/13
CONFIDENTIAL
Co
Linear mode with same exposure time, in Figure 6:
nf
id
en
Figure 6: Nan Eye GS Viewer - High Dynamic Range office desk - linear mode
Linear mode short exposure time, in Figure 7:
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
12/13
CONFIDENTIAL
Co
nf
id
Figure 7: Nan Eye GS Viewer - High Dynamic Range linear mode office desk - short exposure time
en
ti
al
DATE:
04/11/14
16-10-14
Version 1.1.0
PAGE:
13/13

Download Report