Bosch Building Technologies

    cancel
    Showing results for 
    Search instead for 
    Did you mean: 

    Which are the Absolute Positioning functions and protocols of Bosch Autodome & MIC cameras?

    Question

     

    Which are the Absolute Positioning functions and protocols of Bosch Autodome & MIC cameras?

     

    Answer

     

    This article contains detailed examples for the absolute position functions of the various IP models of the Autodome & MIC cameras.

    The support model series are:
    • Current Models: AUTODOME IP 4000/5000, AUTODOME IP 4000i/5000i, VG5 IP 7000, MIC IP 7000 & MIC IP 7000i, MIC IP 9000i
    • EOL models: VG5 700, VG5-800, JR HD


    NOTES:
    1. These commands will NOT work with either the Analog cameras with the serial interface.

    2. The HD cameras do not support the OSRD absolute position commands. The HD models operate using the BICOM protocol over IP.

     

    1. Command Repetition Rate


    In order to avoid conflicting commands to the camera pan & tilt motors, commands must be controlled using one of the following methods.

    • Wait for Acknowledge using the GET command

    After a SET command is issued, use the GET command to read the dome position and wait for the dome to reach the final position to ensure that it has stopped before sending another SET command.
    OR

    • Check to determine if the motors have stopped

    The compound PTZ command includes the motors status in the reply to the GET (Inquiry) command. After the camera is told to Move (SET command) to a position, then GET commands can be used to check the motor status. If the motors are still moving, then don’t send another Move (SET) commands.
    OR

    • Add a fixed delay time between commands

    A fixed delay of 100 mS could be added before a new SET command is issued. The camera will not reach the final position within this amount of time, but the internal buffer can receive commands at this rate. The camera will move to each position in the order that the commands are received, before it will move to the next position.
    NOTE: The Zoom position data updates at 4 times per second. If the Zoom command isn’t changed, then the value is not updated.

     

    Important: If commands are sent faster than 100 mS, the following will occur:

    • When the Autodome motors are in motion to go to a position, and they are not stopped before moving to another position, mechanical slippage will randomly occur.

    o This will cause a loss of the home position, which in turn will cause all movements after this to be incorrect.
    o This will occur more often if the new position is not in the same direction.

    • This will not happen when using the MIC IP 7000 camera, since it has an internal resolver that always ensures that any shifts in position are corrected.

     

    2. Bicom Protocol Message Syntax

     

    The Bicom message syntax consists of Flags + Server ID + Object ID + Operation + Bicom Data.

    • Flags:

    0x81 if a Return_Payload is expected
    0x80 if No Return_Payload

     

    • Bicom PTZ Server ID:

    0x0006 PTZ Server
    The PTZ server controls the pan, tilt and zoom position.

     

    • Object ID


    The Object ID consists of 4 Hex values (0x####). This document explains 0x1D0 & 0x, object ID.

     

    • Operation

    0x01 GET (Read a value back from the device)
    0x02 SET (Send a value to a device)
    0x03 SET_GET (Will perform either of the above actions)

     

    • Bicom Data (Up to 30 bytes)

    This depends on the type of command being sent. This document is restricted to the Absolute Position commands and the data bytes are defined below.

    NOTE: The 0x at the beginning of these values indicates that it is a Hex value. The 0x is only sent as the beginning characters of the Payload. It is removed for the rest of the data. Refer to the examples below.

     

    3. Position Coordinates


    The position data is defined by the Bosch Unified Coordinate System (UCS). The figure below illustrates how the UCS is defined.

    Central_Support_0-1628245511771.png

     

    NOTES:
    1. All versions of cameras have a Pan range of 0.00 to 359.99
    2. The Autodome cameras Tilt down from 90.00 Degrees (Horizon) to 180.00 Degrees (looking straight down).
    3. The MIC 7000 Camera Tilts up from 90.00 to 0.00.
    4. All camera models adjust the coordinates when mounted inverted when the correct setting is configured.

     

    4. Object ID 0x1D0 “Compound PTZ Command”


    This section describes the Pan/Tilt/Zoom Compound Absolute Position Object, plus Movement Status object.
    This object provides control of the Pan, Tilt, Zoom positions in a single command. There is also an option to ignore any of these positions.

    E.g. Send the Pan and Zoom position data and ignore the Tilt data.
    The Hex data for the Pan and Tilt positions is degrees (x100). The Zoom position Hex data is the focal length in mm (x 100).

    NOTES:
    1. The VG5 700; 800; JR HD FW version must be 5.5 or higher.
    2. The AutoDome IP 7000 series & MIC IP HD 7000 series FW version must be 5.92 or higher.
    3. This object is not supported by the VG4, VG5 600, MIC analog cameras, and the MIC IP PSU.
    a) There are separate documents available for these models.
    4. The Absolute Position command is typically used for a movement to an Alarm condition to move the cameras as quickly as possible to a known location. Therefore, the camera always responds to an Absolute Position command at the MAX speed after the camera reaches this position, the control then typically changes to use the Variable Speed PTZ command to provide finer control of the camera Section VII).
    5. The Maximum Speed varies for each model. Please refer to the Data Sheet for the specific values

    Central_Support_1-1628245558089.png

     

    • Definition of the Get command and response (PTZPosMoveStatus)

    Central_Support_2-1628245595690.png

     

    • Definition of the Set command and response (PTZPosMoveStatus) 

    Central_Support_3-1628245671048.png

     

    • Definition of the Data Bytes: 
     

    Central_Support_5-1628245709947.png

    *********Description of Individual Data Bytes*********
    Bytes# 0 - 5 : PTZ Positions - Request and Response
    PPPP - 2 bytes Pan Position in Degrees x 100 (UCS)
    TPTP - 2 bytes Tilt Position in Degrees x 100 (UCS)
    ZPZP - 2 bytes Zoom position in Focal Length x 100
    ******
    Byte 6 : Ignore Flags - Expects valid data during Request (SET/SETGET),
    Don’t care during GET or Response

    Central_Support_6-1628245732941.png

    IP - Ignore Pan: 1
    IT - Ignore Tilt: 1
    IZ - Ignore Zoom: 1

    ******
    Byte# 7 : Motors Move Flags - Don’t care during Request
    Motors status is reflected during Response
    MMF - Motors Move Flags reflects Motion Flags in the returned Data (GET)

    Central_Support_7-1628245752114.png

    PMF - Pan Move Flags: 0 - Stopped, 1 - Moving
    TMF - Tilt Move Flags: 0 - Stopped, 1 - Moving
    ZMF - Zoom Move Flags: 0 - Stopped, 1 – Moving

     

    • Magnification

    Refer to the PTZ_MovementReferenceGuide_Autodome_&_MIC_7000series_4_1.xlsx for a table of Magnification values.

     

    5. Compound PTZ Absolute Command Examples

     

    • RCP+


    Bosch IP Video products in video management system environments are mainly controlled and managed using an enhanced version of Remote Control Protocol, RCP+, pronounced “RCP plus”.

    This protocol defines commands and messages that allow to configure the units and to establish communication between units, or units and management systems. As RCP+ message and command sets are dependent on firmware features.

    Full RCP+ documentation is available, but a brief summary is:

    • RCP+ provides opcodes (e.g. 0x9A5) for data transfer. It may be used with any programming language such as C++ or CGI scripts.


    • CGI Script Example


    The use of absolute positioning does require detailed knowledge of programming or scripting languages and the user has to know how to use RCP+. The RCP+ Opcode used in this CGI script example is 0x09A5.

    Please refer to the complete RCP+ documentation on usage of this message.

    1. Syntax
    http://aaa.bbb.ccc.ddd/rcp.xml?command=0x09A5&type=P_OCTET&direction=WRITE&num=1&payload=0x80000601d...2pppptptpzpzpiiff 

    Where:

    • pp pp=Pan values in Hex (Degrees x 100) • tp tp = Tilt values in Hex (Degrees x 100)

    • zp zp=Zoom values in HEX (Focal Length x 100)

    • ii = Ignore flags (section V, ii)

    • ff = Motor Move Flags (section V, ii)

     

     

    6. Object ID 0x110 (Operation 0x85) “Variable Speed PTZ Command”


    This section describes the Variable Speed Pan/Tilt/Zoom Position Movement object. This object provides control of the Pan, Tilt, Zoom positions in a single command.
    NOTES:
    • The Hex data for the Pan and Tilt positions is degrees (x100).
    • The Zoom position Hex data is the focal length (x 100).


    Definition Position.MoveContVarSpeed: (0x85)

    Central_Support_8-1628245791889.png

    Notes:
    • A speed greater than 0 will cause the operation to start.
    • A speed equal to 0 for an individual command will cause that operation to stop for that one movement (P, T, or Z).
    • A speed equal to 0 for all three commands will stop ALL movement (PTZ)
    • The default mode is for the unit to operate in Proportional Speed. This means that a correction factor is applied to reduce the Speed, so that the control is smoother when at increased magnification factors.
    • The correlation of the Proportional Speed reduction versus the Zoom/Magnification Factor is provided in PTZ_MovementReferenceGuide_Autodome_&_MIC_7000series_4_0.xlsx.

     

    7. Variable Speed PTZ Command Examples


    Refer to Section 5. Compound PTZ Absolute Command Examples for more details on the format of these examples.


    Examples:

    Version history
    Revision #:
    6 of 6
    Last update:
    3 weeks ago
    Updated by:
     
    Attachments
    Icon--AD-black-48x48Icon--address-consumer-data-black-48x48Icon--appointment-black-48x48Icon--back-left-black-48x48Icon--calendar-black-48x48Icon--center-alignedIcon--Checkbox-checkIcon--clock-black-48x48Icon--close-black-48x48Icon--compare-black-48x48Icon--confirmation-black-48x48Icon--dealer-details-black-48x48Icon--delete-black-48x48Icon--delivery-black-48x48Icon--down-black-48x48Icon--download-black-48x48Ic-OverlayAlertIcon--externallink-black-48x48Icon-Filledforward-right_adjustedIcon--grid-view-black-48x48IC_gd_Check-Circle170821_Icons_Community170823_Bosch_Icons170823_Bosch_Icons170821_Icons_CommunityIC-logout170821_Icons_Community170825_Bosch_Icons170821_Icons_CommunityIC-shopping-cart2170821_Icons_CommunityIC-upIC_UserIcon--imageIcon--info-i-black-48x48Icon--left-alignedIcon--Less-minimize-black-48x48Icon-FilledIcon--List-Check-grennIcon--List-Check-blackIcon--List-Cross-blackIcon--list-view-mobile-black-48x48Icon--list-view-black-48x48Icon--More-Maximize-black-48x48Icon--my-product-black-48x48Icon--newsletter-black-48x48Icon--payment-black-48x48Icon--print-black-48x48Icon--promotion-black-48x48Icon--registration-black-48x48Icon--Reset-black-48x48Icon--right-alignedshare-circle1Icon--share-black-48x48Icon--shopping-bag-black-48x48Icon-shopping-cartIcon--start-play-black-48x48Icon--store-locator-black-48x48Ic-OverlayAlertIcon--summary-black-48x48tumblrIcon-FilledvineIc-OverlayAlertwhishlist