Configuration — Hanwha SUNAPI CCTV¶

Everything you can add with this adapter: where it goes in the tree, what you fill in, and what you can tell it to do.

Hanwha Device¶

Hanwha Wisenet camera or NVR — SUNAPI connection root


Add it under	nothing — this is the top of the tree
Identified by	nothing — there is only one
Role	—

Setting	Required	Default	Accepted values	What it does
ip_address	yes	—	host name or IP address	Device host or IP address
port	optional	`443`	1–65535	SUNAPI HTTP(S) service port
use_tls	optional	`true`	yes / no	Connect to SUNAPI over HTTPS/TLS
tls_thumbprint	optional	—	text	Optional SHA-256 certificate thumbprint to pin (hex). When set, only a matching certificate is accepted. Leave empty to accept the device's self-signed certificate (logged as unverified).
rtsp_port	optional	`554`	1–65535	RTSP streaming port (554 for cameras; set 558 for NVRs)
rtsp_profile_main	optional	—	a number	Pin the HD (main) stream to a specific SUNAPI video profile. Leave empty to let the adapter pick the channel's largest picture from the device's own profile list.
rtsp_profile_sub	optional	—	a number	Pin the SD (sub) stream to a specific SUNAPI video profile. Leave empty to let the adapter pick the channel's smallest picture from the device's own profile list.
username	yes	—	text	SUNAPI authentication username
password	optional	—	text	SUNAPI authentication password (optional for passwordless setups) (stored as a secret)

Command	What happens
Reset	Reset to initial state
Synchronize Access	Synchronizes current access settings to the device
Full Access Synchronization	Clears stored synchronization state and performs a full re-upload of all access data

Camera channel — video, PTZ, presets, snapshot, playback, events


Add it under	Hanwha Device (up to 64)
Identified by	the address you fill in below
Role	an access point people pass through

Setting	Required	Default	Accepted values	What it does
address	yes	—	1–64	SUNAPI channel index — PQ address is 1-based; wire Channel = Address − 1 (0-based on the device)

Command	What happens
Live Stream	Start live video stream
Playback	Start video playback from recording
Seek	Seek to a specific time in recording
Pause	Pause playback
Resume	Resume paused playback
Speed	Set playback speed and direction
Snapshot	Capture a still image from the camera
PTZ Move	Continuous PTZ move — adapter moves camera until stop is received
PTZ Stop	Stop all PTZ movement
Go to Preset	Move camera to preset position
Store Preset	Save current position as preset
Arm	Arm security monitoring
Disarm	Disarm security monitoring

Alarm relay output port

Setting	Required	Default	Accepted values	What it does
address	yes	—	1–16	Alarm output port number (1-based)

Command	What happens
Activate	Activate output relay or control point
Deactivate	Deactivate output relay or control point