Hanwha Vision

Hanwha Vision & Home Assistant: Integration Fixes

Can't get your Hanwha Vision (Wisenet) camera to work with Home Assistant? Our guide solves integration errors, streaming issues, and sensor problems.

Is this your issue?

Home Assistant cannot discover the Hanwha Vision or Wisenet camera
The ONVIF integration fails with an 'Authentication failed' error
The camera connects, but the video stream entity is unavailable or black
Motion detection events are not being registered in Home Assistant
PTZ (pan-tilt-zoom) controls are not working from the Home Assistant dashboard
The connection is unstable and the camera becomes 'unavailable' frequently
Error messages in Home Assistant logs related to ONVIF or stream setup

Sound familiar? The guide below will help you fix it.

Integrating Hanwha Vision (Wisenet) Cameras with Home Assistant

Connecting your Hanwha Vision (formerly known as Hanwha Techwin, Wisenet, or Samsung) cameras into Home Assistant can elevate your smart home security. You can create powerful automations based on motion detection, view live feeds in your dashboards, and centralise your device controls. The key to this integration is the ONVIF protocol, a universal standard for IP cameras.

This guide will walk you through the essential steps to get your Hanwha cameras connected and troubleshoot common problems like connection failures and missing video streams.

Pre-requisite: Enable ONVIF on Your Hanwha Camera

Before you even open Home Assistant, you must configure your camera to allow ONVIF connections.

Log in to your Camera's Web Interface: Find your camera's IP address and enter it into a web browser. Log in using your admin credentials.
Navigate to ONVIF Settings: The exact location can vary slightly depending on firmware, but it is typically found under Network > ONVIF.
Enable ONVIF: There will be a master checkbox to enable the ONVIF protocol. Make sure this is ticked.
Create an ONVIF User: This is a critical step. For security, you must create a specific user for ONVIF connections. Do not use the main 'admin' account.
- Click the 'Add' button in the user section.
- Create a new username (e.g., 'homeassistant').
- Create a strong, unique password.
- Set the user level to 'Operator' or 'User'. This gives Home Assistant rights to view video and see events, but not change critical camera settings.
Save your changes. The camera may need to reboot.

Adding Your Camera to Home Assistant

Once ONVIF is enabled on the camera, the process in Home Assistant is straightforward.

Navigate to Settings > Devices & Services.
Home Assistant may have already discovered the camera on your network. If so, you can click 'Configure' on the discovered device.
If not, click 'Add Integration' and search for 'ONVIF'.
The system will prompt for connection details. If the camera was not auto-discovered, you will need to enter the IP address.
It will then ask for the ONVIF username and password you created in the previous step. Enter them carefully.
If successful, the integration will be added, and you will see your camera device with its associated entities.

Troubleshooting Common Integration Problems

'Failed to Connect' or 'Authentication Failed'

If Home Assistant fails to connect, go back and double-check these points:

ONVIF Enabled: Are you certain you enabled the main ONVIF toggle on the camera?
Correct Credentials: Did you enter the specific ONVIF user's credentials, not the admin credentials? Check for typos.
Network Issues: Is the camera on the same local network as your Home Assistant instance? If you use VLANs, ensure there is a firewall rule allowing communication on port 80 and the ONVIF port (often 554 or 8000).

Video Stream is Black or Not Loading

This is a common issue that usually relates to the stream profile configuration.

Select the Correct Profile: In Home Assistant, go to the ONVIF integration's configuration options. You should see a dropdown to select the video profile. Hanwha cameras often have multiple profiles (e.g., for high-res, low-res). Try switching to a different profile.
Check Camera-Side Configuration: Log back into the camera's web UI. Go to Video & Audio settings. Ensure that the profiles are enabled and configured with a compatible video codec, such as H.264. Home Assistant can sometimes have issues with H.265 streams depending on your hardware and setup.
RTSP URL: As a last resort, you can use the generic 'Generic Camera' integration in Home Assistant and manually enter the camera's RTSP stream URL, but the ONVIF method is strongly preferred as it also provides sensor data.

Motion Detection Sensor Not Working

The ONVIF integration should create a binary_sensor for motion detection. If it's not working:

Enable Motion Detection on Camera: In the camera's web UI, go to the Event settings. You must set up and enable a Motion Detection zone. If motion detection is turned off on the camera itself, it has no events to send to Home Assistant.
Check ONVIF Subscriptions: Ensure that the ONVIF user has the rights to access event information. The 'Operator' role should be sufficient.

By following these steps, you can successfully integrate your high-quality Hanwha Vision cameras with Home Assistant and build a more robust and automated security system.

What if this wasn't your problem to solve?

scOS detects suspicious activity — not motion. It only alerts you when something matters, like a person would. Designed to be left alone. All features included.

Detects Suspicious Activity

Not motion — actual suspicious behaviour. Like a person would notice.

Designed to Be Left Alone

No settings to tweak. No app to check. It just works.

All Features Included

No subscriptions. No tiers. Everything works from day one.

See why this keeps happening

Works with any wired camera brand. See all features

Frequently Asked Questions

Home Assistant uses the ONVIF protocol to communicate with Hanwha Vision (formerly Samsung/Wisenet) cameras. You must first enable ONVIF within the camera's own web interface and create a specific ONVIF user account. Without this step, Home Assistant will not be able to connect.

Log in to your camera's web interface. Go to 'Network' -> 'ONVIF'. Here, you need to enable ONVIF and then add a new user. It is a security best practice to create a dedicated user for Home Assistant with 'Operator' or 'User' level privileges, rather than using the main admin account.

This usually means the streaming profile is not configured correctly. In Home Assistant's ONVIF integration settings, you can choose which video profile to use (e.g., Profile1, Profile2). Try switching to a different profile. Also, verify in the camera's web settings under 'Video & Audio' that the chosen profile is active and configured with a supported codec like H.264.

Yes. Once integrated via ONVIF, Home Assistant will automatically create a binary sensor for motion detection (often called `binary_sensor.camera_name_motion_alarm`). You can use this sensor as a trigger in your automations, for example, to turn on lights when the camera detects movement. If the sensor isn't working, ensure 'Motion Detection' is enabled and configured in the camera's 'Event' settings.

All Troubleshooting Guides