Download File

Command Sections
4.1.8
Read Mailbox
The mailboxes are useful for two control devices (connected to different interfaces
at the camera) communicating via the camera. One control device writes data to
the mailbox, the other one can read the message. There is a simple acknowledge
mechanism for the writer of a message to see, if the message has been read by
the receiving device. See also command “Get Mailbox Status”.
a.) Command Message:
Code
Length Mailbox No.
0x0F10 0x0007 0x####
Parameter:
Cks.
0x..
No. (index) of mailbox to be read, range from [0 to Number of
Mailboxes – 1]
b.) Response Message:
Code
Length Mailbox No.
0x0F90 0x0049 0x####
Return
values:
Notes:
Read Status
Data[0]
.. Data[63 Cks.
]
0x####
0x##
.. 0x##
0x##
 No. (index) of mailbox, same as input parameter
 Status of read operation, where:
 0x0000: No message available, content of the mailbox not
valid
 0x0001: New message is ready, content of the mailbox is
valid
 0x0003: Content of the mailbox is valid, but message was
already read (by recipient)
 64 byte of data. If not all 64 byte shall contain valid data, the
user must implement a size mechanism by himself, e.g. by
defining the first byte or word as size parameter!
 A read mailbox will not clear or empty the mailbox, thus the
content of the mailbox can be read many times. It can be
evaluated by the read status (see above), if a message in the
mailbox is new and unread.
c.) Failure / Warning Response Message:
Code
Length Message
0x0FD0 0x0009 0x########
Return
values:
Cks.
0x##
 PCO_ERROR_FIRMWARE_NOT_SUPPORTED or
PCO_ERROR_FIRMWARE_UNKNOWN_COMMAND if the
command is not supported by the camera.
 PCO_ERROR_FIRMWARE_VALUE_OUT_OF_RANGE
 error code, less than 0 (see also section 5. Error / Warning
Codes)
pco.edge Low Level Description V1.01 © PCO AG, Germany
25