Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
slydiman authored Apr 4, 2021
1 parent 9b91f5f commit 0ce60e1
Showing 1 changed file with 5 additions and 3 deletions.
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
The [ONVIF](https://www.home-assistant.io/integrations/onvif/) integration in `Home Assistant` is very conservative.
It does not work with many cameras because a lot of bugs are not fixed for years.
It does not work with many cameras because some bugs are not fixed for years.
It is impossible to setup some cameras at all. Some cameras can be added, but sensors do not work.

This integration depends on [onvif-zeep-async==1.0.0](https://github.com/hunterjm/python-onvif-zeep-async) and `onvif-zeep-async` depends on [zeep[async]==4.0.0](https://github.com/mvantellingen/python-zeep).
Expand All @@ -11,12 +11,14 @@ Perhaps you need to wait another year. Perhaps this will never happen. Who knows
I have collected few own patches to `zeep` and `ONVIF integration`.
I have renamed `zeep` and `onvif-zeep-async` modules to avoid conflicts and fixed the `ONVIF integration` to use these modules.

If you need to use `XM` (XiongMai, XMEye, iCSee), `Wansview`, `Wanscam` and many other `ONVIF` cameras, which are not supported yet, with `Home Assistant` `ONVIF integration` right now,
If you need to use `XM` (XiongMai, XMEye, iCSee), `Wansview` and many other `ONVIF` cameras, which are not supported yet, with `Home Assistant` `ONVIF integration` right now,
just unpack [ha_custom_onvif.zip](https://github.com/slydiman/ha_custom_onvif/releases/latest) to `config`/`custom_components` folder of your `Home Assistant` and restart it.

I hope one day this will no longer be necessary.

Known bugs: Some Wanscam cameras can be added but still not work because GetStreamUri request fails with unknown reason.
Known bugs: `Wanscam` `ONVIF` implementation is very buggy. Some `Wanscam` cameras can be added after disabling `Renew` request immediately after creating `PullPointSubscription` (`event.py`, line 86).
But it still does not work because `GetStreamUri` request fails. It seems `Wanscam` expects `<Stream` or `<tt:Stream` tag, but got `<ns1:Stream xmlns:ns1="http://www.onvif.org/ver10/schema">`.
Currently I don't know how to gracefully clean namespaces ns0, ns1, etc. in the soap request generated by zeep. There is no way to provide a custom nsmap.

Note: I have inversed the value of the binary_sensor (motion detection) because it is necessary at least for XM cameras.
If you don't need it, just remove the word `not` in the file `binary_sensor.py`, line 50.

0 comments on commit 0ce60e1

Please sign in to comment.