TI J721E Imaging User Guide
(ISP Tuning Tool Server) APIs

Introduction

This section contains APIs for ISP Tuning Tool Server.

Functions

int itt_server_init (void *appObj, void *appFileSaveCallback, void *appDccUpdateCallback)
 initialization routine for ITT server. More...
 
void itt_ctrl_cmdHandlerEcho (char *cmd, uint32_t prmSize)
 Handler for command "echo". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler. More...
 
void itt_ctrl_cmdHandlerIssRead2AParams (char *cmd, uint32_t prmSize)
 Handler for command "iss_read_2a_params". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler. More...
 
void itt_ctrl_cmdHandlerIssWrite2AParams (char *cmd, uint32_t prmSize)
 Handler for command "iss_write_2a_params". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler. More...
 
void itt_ctrl_cmdHandlerIssFileSave (char *cmd, uint32_t prmSize)
 Handler for commands "iss_raw_save" and "iss_yuv_save". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler. More...
 
void itt_ctrl_cmdHandlerIssDccSendFile (char *cmd, uint32_t prmSize)
 Handler for command "iss_send_dcc_file". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler Reserved for future use. More...
 
void itt_ctrl_cmdHandlerIssReadSensorReg (char *cmd, uint32_t prmSize)
 Handler for command "iss_read_sensor_reg". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler Inputs. More...
 
void itt_ctrl_cmdHandlerIssWriteSensorReg (char *cmd, uint32_t prmSize)
 Handler for command "iss_write_sensor_reg". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler Inputs. More...
 
void itt_ctrl_cmdHandlerIssDevCtrl (char *cmd, uint32_t prmSize)
 Handler for command "dev_ctrl". Generic device control. Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler. More...
 
int32_t itt_register_object (vx_context context, vx_node *node, tivx_raw_image *raw_image_handle, vx_image *yuv_image_handle, uint8_t object_name)
 Function used to register needed objects for EdgeAI ISP Live Tuning. More...
 
int32_t itt_server_edge_ai_init ()
 initialization routine for ITT server on EdgeAI. More...
 

Function Documentation

◆ itt_server_init()

int itt_server_init ( void *  appObj,
void *  appFileSaveCallback,
void *  appDccUpdateCallback 
)

initialization routine for ITT server.

This must be called from any application which needs to control ISP tuning at runtime. Inputs

  1. appObj - Pointer to application object, compatible to the argument expected by appFileSaveCallback
  2. appFileSaveCallback - Callback funcion implemented in the calling application. This callback would take appObj as an argument. If any of these arguments are NULL, live tuning will still work but RAW and YUV save features wil not be available.

◆ itt_ctrl_cmdHandlerEcho()

void itt_ctrl_cmdHandlerEcho ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "echo". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler.

Inputs

  1. cmd - Array of bytes
  2. prmSize - Number of valid bytes in cmd.

Responds by sending the same command back to ITT Client (on PC)

◆ itt_ctrl_cmdHandlerIssRead2AParams()

void itt_ctrl_cmdHandlerIssRead2AParams ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "iss_read_2a_params". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler.

Inputs

  1. cmd - Array of bytes in the format AlgItt_IssAewb2AParams
  2. prmSize - Number of valid bytes in cmd.

Reads current state of AE and AWB and sends back to ITT Client (on PC)

◆ itt_ctrl_cmdHandlerIssWrite2AParams()

void itt_ctrl_cmdHandlerIssWrite2AParams ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "iss_write_2a_params". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler.

Inputs

  1. cmd - Array of bytes in the format AlgItt_IssAewb2AParams
  2. prmSize - Number of valid bytes in cmd.

Writes the data received from the client to 2A algorithms and sends back PASS/FAIL status to ITT Client (on PC)

◆ itt_ctrl_cmdHandlerIssFileSave()

void itt_ctrl_cmdHandlerIssFileSave ( char *  cmd,
uint32_t  prmSize 
)

Handler for commands "iss_raw_save" and "iss_yuv_save". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler.

Inputs

  1. cmd - String value "iss_raw_save" OR "iss_yuv_save"
  2. prmSize - Number of valid bytes in cmd.

Invokes appFileSaveCallback to capture RAW/YUV images. Send the image to ITT Client (on PC)

◆ itt_ctrl_cmdHandlerIssDccSendFile()

void itt_ctrl_cmdHandlerIssDccSendFile ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "iss_send_dcc_file". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler Reserved for future use.

◆ itt_ctrl_cmdHandlerIssReadSensorReg()

void itt_ctrl_cmdHandlerIssReadSensorReg ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "iss_read_sensor_reg". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler Inputs.

  1. cmd - 12-byte array containing --— 4-byte Channel ID --— 4-byte Sensor Register Address --— 4-byte Sensor Register Value. To be ignored
  2. prmSize - Number of valid bytes in cmd.

Reads sensor register and sends back to ITT Client (on PC)

◆ itt_ctrl_cmdHandlerIssWriteSensorReg()

void itt_ctrl_cmdHandlerIssWriteSensorReg ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "iss_write_sensor_reg". Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler Inputs.

  1. cmd - 12-byte array containing --— 4-byte Channel ID --— 4-byte Sensor Register Address --— 4-byte Sensor Register Value.
  2. prmSize - Number of valid bytes in cmd.

Writes the value to specified sensor register and sends back status (PASS/FAIL) to ITT Client (on PC)

◆ itt_ctrl_cmdHandlerIssDevCtrl()

void itt_ctrl_cmdHandlerIssDevCtrl ( char *  cmd,
uint32_t  prmSize 
)

Handler for command "dev_ctrl". Generic device control. Function callback passed to network_api utils. Must comply with the syntax of NetworkCtrl_Handler.

Currently supports reading Deserializer, Serializer and Sensor registers in batch mode Inputs

  1. cmd - Script specifying the commands to be executed
  2. prmSize - Number of valid bytes in cmd.

Executes the script and sends the results (PASS/FAIL) to ITT Client (on PC)

◆ itt_register_object()

int32_t itt_register_object ( vx_context  context,
vx_node *  node,
tivx_raw_image *  raw_image_handle,
vx_image *  yuv_image_handle,
uint8_t  object_name 
)

Function used to register needed objects for EdgeAI ISP Live Tuning.

Currenlty only two nodes are supported: VISS and LDC.

◆ itt_server_edge_ai_init()

int32_t itt_server_edge_ai_init ( )

initialization routine for ITT server on EdgeAI.

This must be called from any application which needs to control ISP tuning at runtime.