Camera Interface

Detailed Description

Interface for camera.

Summary

The Camera interface provides a general API for configuring and controlling camera panels.

Classes
struct	e_camera_status_t
struct	st_camera_callback_args
struct	st_cru_buffer_cfg
struct	st_cru_cfg
struct	st_cru_api
struct	st_cru_instance

Typedefs
typedef struct e_camera_status_t	camera_status_t
typedef uint32_t	camera_event_t
typedef struct st_camera_callback_args	camera_callback_args_t
typedef struct st_cru_buffer_cfg	camera_buffer_cfg_t
typedef struct st_cru_cfg	cru_cfg_t
typedef void	cru_ctrl_t
typedef struct st_cru_api	cru_api_t
typedef struct st_cru_instance	camera_instance_t

Enumerations
enum	camera_state_t

---

Class Documentation

RZA::e_camera_status_t

struct RZA::e_camera_status_t

CAMERA status

Class Members
camera_state_t	state	Current state.
uint32_t *	p_buffer	Pointer to active buffer.
uint32_t	data_size	Size of data written at the end of one-frame capture.

RZA::st_camera_callback_args

struct RZA::st_camera_callback_args

CAMERA callback function parameter data

Class Members
camera_event_t	event	Event causing the callback.
uint8_t *	p_buffer	Pointer to buffer that contains captured data.
void *	p_context	Placeholder for user data. Set in cru_api_t::open function in cru_cfg_t.

RZA::st_cru_buffer_cfg

struct RZA::st_cru_buffer_cfg

Buffer addresses

Class Members
uint8_t *	pp_buffer[8]	Pointer to array of buffer pointers.
uint8_t	num_buffers	Number of buffers to use.

RZA::st_cru_cfg

struct RZA::st_cru_cfg

CRU configuration parameters.

Public Attributes
uint16_t	x_capture_start_pixel
	Horizontal position to start capture.
uint16_t	x_capture_pixels
	Number of horizontal pixels to capture.
uint16_t	y_capture_start_pixel
	Vertical position to start capture.
uint16_t	y_capture_pixels
	Number of vertical lines/pixels to capture.
camera_buffer_cfg_t	buffer_cfg
	Buffer Configuration.
void(*	p_callback )(camera_callback_args_t *p_args)
	Callback provided when a image conversion ISR occurs.
void const *	p_extend
	Placeholder for user data.

RZA::st_cru_api

struct RZA::st_cru_api

CRU functions implemented at the HAL layer will follow this API.

Public Attributes
fsp_err_t(*	open )(cru_ctrl_t *const p_ctrl, cru_cfg_t const *const p_cfg)
fsp_err_t(*	close )(cru_ctrl_t *const p_ctrl)
fsp_err_t(*	captureStart )(cru_ctrl_t *const p_ctrl)
fsp_err_t(*	captureStop )(cru_ctrl_t *const p_ctrl)
fsp_err_t(*	statusGet )(cru_ctrl_t *const p_ctrl, camera_status_t *p_status)

Member Data Documentation

open

fsp_err_t(* open) (cru_ctrl_t *const p_ctrl, cru_cfg_t const *const p_cfg)

Initial configuration.

Note

To reconfigure after calling this function, call cru_api_t::close first.

Parameters

[in]	p_ctrl	Pointer to control structure.
[in]	p_cfg	Pointer to pin configuration structure.

close

fsp_err_t(* close) (cru_ctrl_t *const p_ctrl)

Closes the driver and allows reconfiguration. May reduce power consumption.

Parameters

[in]

p_ctrl

Pointer to control structure.

captureStart

fsp_err_t(* captureStart) (cru_ctrl_t *const p_ctrl)

Start a capture.

Parameters

[in]

p_ctrl

Pointer to control structure.

captureStop

fsp_err_t(* captureStop) (cru_ctrl_t *const p_ctrl)

Stop a capture

Parameters

[in]

p_ctrl

Pointer to control structure.

statusGet

fsp_err_t(* statusGet) (cru_ctrl_t *const p_ctrl, camera_status_t *p_status)

Check scan status.

Parameters

[in]	p_ctrl	Pointer to control handle structure
[out]	p_status	Pointer to store current status in

RZA::st_cru_instance

struct RZA::st_cru_instance

This structure encompasses everything that is needed to use an instance of this interface.

Class Members
cru_ctrl_t *	p_ctrl	Pointer to the control structure for this instance.
cru_cfg_t const *	p_cfg	Pointer to the configuration structure for this instance.
cru_api_t const *	p_api	Pointer to the API structure for this instance.

Typedef Documentation

camera_status_t

typedef struct e_camera_status_t camera_status_t

CAMERA status Please refer to the struct e_camera_status_t.

camera_event_t

typedef uint32_t camera_event_t

CAMERA callback event - see implementation

camera_callback_args_t

typedef struct st_camera_callback_args camera_callback_args_t

CAMERA callback function parameter data Please refer to the struct st_camera_callback_args.

camera_buffer_cfg_t

typedef struct st_cru_buffer_cfg camera_buffer_cfg_t

Buffer addresses Please refer to the struct st_cru_buffer_cfg.

cru_cfg_t

typedef struct st_cru_cfg cru_cfg_t

CRU configuration parameters. Please refer to the struct st_cru_cfg.

cru_ctrl_t

typedef void cru_ctrl_t

CRU control block. Allocate an instance specific control block to pass into the CRU API calls.

cru_api_t

typedef struct st_cru_api cru_api_t

CRU functions implemented at the HAL layer will follow this API. Please refer to the struct st_cru_api.

camera_instance_t

typedef struct st_cru_instance camera_instance_t

This structure encompasses everything that is needed to use an instance of this interface. Please refer to the struct st_cru_instance.

Enumeration Type Documentation

camera_state_t

enum camera_state_t

CAMERA states.

Enumerator
CAMERA_STATE_IDLE	CAMERA is idle.
CAMERA_STATE_IN_PROGRESS	CAMERA capture in progress.
CAMERA_STATE_BUSY	CAMERA reset in progress.