Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added PYTHON=

...

Command

Definition

BITFIELD

Write a value to a bitfield of a register.

DATATYPE

Define the data type and optional valid range of a named register or bitfield.

DELAY

Delay a certain amount of time (in milliseconds) before continuing.

ERROR_IF

Output an error message and stop execution if a condition is met.

FAR1

Write a value to a sensor register on the first attached camera.

FAR2

Write a value to a sensor register on the second attached camera.

FIELD_WR

Write to a register or bitfield by name. Command works for any kind of register, variable or SFR.

ICON

Define the icon for a User Toolbar button.

IF_FIELD

Similar to LOAD, but conditioned on the value of a register.

IF_REG

Similar to LOAD, but conditioned on the value of a register.

IF_SERIAL

Similar to IF_REG, but can access any device on the SHiP bus.

IMAGE

Set software to expect the given image size and type. Command does not change sensor mode.

LOAD

Load a preset from an ini file.

LOAD_PROM

Load a preset from an EEPROM.

LOG

Add a text string to the Log window.

MEM

Write a value to an SOC RAM location.

MEM8

Write a value to an 8-bit SOC RAM location.

MEM32

Write a value to a 32-bit SOC RAM location.

MENUITEM

Define sub-menu items for a User Toolbar button.

OPTION

Set a DevWare Option variable.

POLL_FIELD

Poll a register. Similar to DELAY, but conditioned on the value of a register.

POLL_REG

Poll a register. Similar to DELAY, but conditioned on the value of a register.

POLL_VAR

Poll a variable. Similar to DELAY, but conditioned on the value of a variable.

PROMPT

Give the user a multiple-choice dialog, or show a message.

PYTHONInvoke a one-line Python statement.

REG

Write a value to a register.

REG_BURST

Write a sequence of register values in one bus transaction.

SAVE_IMAGE

Write image data to files.

SAVE_REGS

Write register values to a file.

SENSOR_BASE

Set or detect the sensor SHiP base address.

SERIAL_REG

Low-level write to Two-Wire Serial Interface register.

SFR

Write a value to a special function register, on certain sensors.

SFR8

Write a value to an 8-bit special function register, on certain sensors.

STATE

Set a variable within the software, not on the sensor.

TOOLTIP

Define a tooltip for a User Toolbar button.

VAR

Write a value to a firmware variable.

VAR32

Write a value to a 32-bit firmware variable.

VAR8

Write a value to an 8-bit firmware variable.

XMCLK

Set the XMCLK (sensor external clock) frequency.

...

Anchor
PROMPT
PROMPT
PROMPT = "<message>" [, "<choice1>", LOAD=<preset1>, etc.] //<comment>

Create a multiple-choice dialog box, and execute the preset chosen by the user. A "Skip this" choice is automatically added so the user can choose to do nothing. The user can stop execution of the current preset by clicking Cancel.

The choices are optional. If there are no choices then the dialog only shows the message and OK and Cancel buttons that will continue execution of the current preset or stop execution.

Commas are allowed inside quoted strings. The \n sequence in the message will convert to a newline.

Example: Ask user whether to do parallel or serial configuration.
PROMPT= "Is this camera using a parallel or serial interface?", "Parallel". LOAD=Parallel Init, "Serial", LOAD=Serial Init

Anchor
PYTHON
PYTHON
PYTHON = <statement>

Execute a single Python statement. This makes it convenient to have a small Python instruction in an otherwise non-Python preset. Typical uses would be to set a register to a calculated value, or call a Python function defined elsewhere in the ini file.

Example: Call a Python function.
PYTHON= setExposureMode(SensorExposureMode.EXPOSURE_MODE_HDR_DLO)

Anchor
REG
REG
REG = [<page>,] <address>, <value> //<comment>

Write a value to a sensor register.

Example: Set register 0xE0 on page 1 to value of 1
REG= 1, 0xE0, 0x0001 // ENABLE ccp format = jpeg

...