/
Register Analyzer User Guide

Register Analyzer User Guide

Sept 18, 2013

Introduction

Register Analyzer is the tool for Aptina Engineer to analyze sensor register settings from Aptina customers. The tool can be used to:

  1. Retrieve sensor register settings and filter out the verbose comments from customer supplied text file.

  2. Convert customer register settings to Aptina DevWare INI files.

  3. Open DevWare Sdat file to check the register symbolic reference, bit-field value and access register detail descriptions.

  4. Compare the customer register settings with DevWare system dump or INI files. Highlight the different register/bit-filed values for user's evaluations.

As shown in Figure 1 and Figure 2, the four tabs, "Retrieve Register Settings", "Convert to INI", "Process Register Data", "Analyze Register Data", categorized the above four major functions.

Supported Sensors

Current released version support all the Aptina raw sensor products. SOCs/Companion chips will be included in the later release.

Operation Procedures

The procedure provided here is an example of how to use this tool. It may not need to follow exactly the number of steps. But some steps do need certain information loaded/processed before this tool can continue.


Figure 1. Regsiter Analyzer GUI.

  1. Retrieve Register Settings from Customer files

GUI Widgets Explanation in Figure 2:

  1. "User Defined Pattern": This is for user to define the text retrieving patterns.

  2. "Starting Tag": User type in the text string before the required register information.

  3. "Ending Tag": User type in the text string after the required register information.

  4. "Inclusive": Mark the Starting/Ending Tag included or not included in the retrieving register text string. For example, in this customer format:

[00016263] REG=0x302A, VAL=0x0006 (dec: 6)
The user needed register data is: REG=0x302A, VAL=0x0006
So, the Starting Tag is "] " (not inclusive), and the Ending Tag is "(dec" (not inclusive).
Or, the Starting Tag is "REG=" (inclusive), and the Ending Tag is "(" (not inclusive).

  1. "Ignore Case": is for tool to take care or ignore the capital case in the text string.

  2. "Fixed Pattern 1:" is a pre-defined customer format which the register address value (Hex) in the bracket and follow with the register value (Hex) outside.

  3. "Fixed Pattern 2:" is a pre-defined customer format which the register address value (Hex) on the left side of the "=" sign and register value (Hex) on the right.

  4. "Line by Line Manual Retrieve": This is for user to do the text retrieving/parsing for specific lines.

  5. "Select Pattern": Use select the "User Defined Pattern" on the left, or use "Fixed Pattern1/2" to retrieve the selected line in the opened Text-Box on the bottom. As shown in Figure 3, the opened Customer/Raw Text File in the Text-Box.

  6. "Add ": To retrieve the selected text with the select pattern to the right-side of Text-Box.

  7. " Delete": To delete the selected text on the right-side of Text-Box.


Figure 2 Retrieve Register Settings Tab.
Typical Operation Steps:
Step 1: As shown in Figure 3, the first step is to open the customer supplied register setting file. It can be a DevWare INI file format or a customer specific text format. The Register Analyzer tool provides several different "Retrieving" function for user to extract customer register settings.
Step 2, 3: User specifies the "Starting" and "Ending" tags for the tool to retrieve the register settings. The example in Figure 3 uses starting tag "Reg=" and ending tag as "(".
Step 4: Click "Retrieve All" to extract all register settings which start from "Reg=" and end with "(". The result shows in the "Retrieved/converted INI file" window on the right.

Figure 3. Register Analyzer Operation Procedure (Retrieve Register Settings).

  1. Convert the Customer Register Settings to DevWare INI file format:

GUI Widget Explanation in Figure 4:

  1. "String before Register Address": This is for user to define the text before Register Address. Leave it blank if not applicable.

  2. "Separator": User type in the separator between Register Address and value.

  3. "String before Register value": This is for user to define the text before Register Value. Leave it blank if not applicable.

  4. "Hexadecimal/Decimal": User select the input Register Address/Value pair is Hex or Dec value. The output INI file is always use Hex value.

  5. "Convert to INI": Activate the conversion procedure. Based on the above widget settings, the tool converts the Text from the Right-size of Text-Box to the Left-side of Text-Box.


Figure 4. Convert to INI Tab.
Typical Operation Steps (Continue from previous section):
Step 5: Move all the Retrieved settings from the right side of windows to the left side window for Converting process. Since the retrieved settings may not be the DevWare recognized INI file format.
Step 6: Specify the characters or string before the Register Address.
Step 7: Specify the characters or string that separate the Register Address and Values.
Step 8: Specify the characters or string before the Register Values.
Click "Convert to INI" button to convert the customer register settings to Aptina DevWare INI file format.
Step 9: User can save the converted settings to a INI file for loading to DevWare later.


Figure 5. Register Analyzer Operation Procedure (Convert to INI file)

  1. *Process the Register Settings with Aptina XSDAT file:*

GUI Widget Explanation in Figure 6:

  1. "Sdat File": Type in the sensor directory and file name. Or display the current opened sensor data file name if use "Browse" button.

  2. "Browse": Search the Aptina sensor data file (.xsdat) from the pop-up File Dialog box.

  3. "Probe/Load": If the "Sdat File" box is empty, this button will activate the sensor probing procedure to find the sensor data file (the senor and Aptina Demo system must be connected to PC). If the "Sdat File" box has a file name exist, this button will load the current sensor data file showed in the box.

  4. "Use Register Name": Convert the output INI Register List from Hex address to symbolic name based on the current opened xsdat file. Format Example:

FIELD_WR= CAM_AWB_X_SHIFT, 0x001E

  1. "Use Register Address": Convert the output INI Register List from symbolic name to Hex address based on the current opened xsdat file. Format Example:

REG = 0xC804, 0x0080

  1. "Remove non-exist Registers": Remove the non-existed register address based on the current opened xsdat file.