set-ptz-config
Use the interface to set PTZ parameters.
HTTP Request
GET http://ip/mwapi?method=set-ptz-config¶m1=value1¶m2=value2...
| Parameter | Description |
|---|---|
| method | set-ptz-config |
| proto | Indicates the communication protocol that allows the camera and the converter to communicate to each other, including none. By default, it shows none. For now, only Sony VISCA Protocol is supported. |
| index | Indicates the ID of the camera, which allows the controller to identify different PTZ cameras, especially when multiple cameras are connected. The value ranges from 1 to 7. |
| baudrate | Indicates the control data speed. For example, "9600 baud" means that the PTZ control port is capable of transferring a maximum of 9600 bits per second. If multiple cameras are connected, each camera should be set to the same value. Supported options including: 2400, 4800, 9600, 19200 and 38400. |
| invert-pan | Indicates whether to reverse the pan-direction movement. If yes, it shows true; otherwise, it is false. |
| invert-tilt | Indicates whether to reverse the tilt-direction movement. If yes, it shows true; otherwise, it is false. |
| ip-addr | IP Address |
| port | Port. The value ranges from 1 to 65535 |
| visca-msg-hdr | Indicates whether Visca UDP message header is used. If yes, it shows true; otherwise, it is false. |
| focus-near-limit | Focus near limit. The value ranges from 0 to 65535 |
| focus-far-limit | Focus far limit. The value ranges from 0 to 65535 |
| pan-left-limit | Pan left limit. The value ranges from -32768 to 32767 |
| pan-center | Pan center. The value ranges from -32768 to 32767 |
| pan-right-limit | Pan right limit. The value ranges from -32768 to 32767 |
| tilt-top-limit | Tilt top limit. The value ranges from -32768 to 32767 |
| tilt-center | Tilt center. The value ranges from -32768 to 32767 |
| tilt-bottom-limit | Tilt bottom limit. The value ranges from -32768 to 32767 |
| zoom-out-limit | Zoom out limit. The value ranges from 0 to 32767 |
Response Body
{
"status": 0
}
| Name | Description |
|---|---|
| status | 0 indicates that the request was accepted successfully. Refer to API Status Codes to find specific description for other values. |
Example
1. None
http://ip/mwapi?method=set-ptz-config&proto=none
2. Visca
http://ip/mwapi?method=set-ptz-config&proto=visca&baudrate=4800&index=2&invert-pan=true&invert-tilt=true&focus-near-limit=0&focus-far-limit=2935&pan-left-limit=-2448&pan-center=0&pan-right-limit=2448&tilt-top-limit=1280&tilt-center=0&tilt-bottom-limit=-368&zoom-out-limit=16384
3. Visca UDP
http://ip/mwapi?method=set-ptz-config&proto=visca-udp&index=2&invert-pan=true&invert-tilt=true&ip-addr=10.10.10.123&port=1&visca-msg-hdr=false&focus-near-limit=0&focus-far-limit=2935&pan-left-limit=-2448&pan-center=0&pan-right-limit=2448&tilt-top-limit=1280&tilt-center=0&tilt-bottom-limit=-368&zoom-out-limit=16384
4. Visca UDP2rs232
http://ip/mwapi?method=set-ptz-config&proto=visca-udp2rs232&baudrate=4800&port=1
5. PELCO-D
http://ip/mwapi?method=set-ptz-config&proto=pelco-d&baudrate=4800&index=2&invert-pan=true&invert-tilt=true
6. PELCO-P
http://ip/mwapi?method=set-ptz-config&proto=pelco-d&baudrate=4800&index=2&invert-pan=true&invert-tilt=true