nn::camera::CTR::GetBufferErrorInterruptEvent Function

Syntax

void GetBufferErrorInterruptEvent(
     nn::os::Event * pEvent,
     Port port
);

Arguments

Name Description
out pEvent Event caused when a buffer error or reboot occurs.
in port Specifies port on which to detect interrupts.

Return Values

None.

Description

Gets the event used to detect camera buffer error interrupts and reboots.

Reboot notifications occur for both PORT_CAM1 and PORT_CAM2.

This function gets an auto-reset event in pEvent regardless of how the application was initialized.

When the camera data transfer does not happen in time and the SoC buffer overflows, camera image data is not retrieved and the pEvent obtained by this function is in the signaled state. In such a case, the SoC buffer is cleared by the camera library. Upon detecting the signaled state, reconfigure the transfer with the SetReceiving function and resume data retrieval with the StartCapture function.

The camera may also behave abnormally following a large static electricity shock. When the camera library detects abnormal operation, it resets and reboots the camera, and restores the previous settings. Recovery halts image data retrieval from the camera and clears the SoC buffer, after which the pEvent obtained by this function is in the signaled state. Upon detecting the signaled state, reconfigure the transfer with the SetReceiving function and resume data retrieval with the StartCapture function.

For either buffer overflows or reboots, the SoC buffer state is the same following the signal of the pEvent obtained by this function, so there is no need for the application to implement any special handling code.

Revision History

2010/07/14
Added to description of conditions for an event to enter the signaled state.
2010/06/17
Added information on event types.
2010/01/07
Initial version.

CONFIDENTIAL