From 0f9fb18d4d7c6ad1bf4f85aca1b773b1328c8c68 Mon Sep 17 00:00:00 2001
From: Mahasri Kalavala <mahasri.kalavala@gmail.com>
Date: Sat, 18 May 2019 16:28:31 -0400
Subject: [PATCH] updated docs.

---
 hik-vision camera/readme.md | 30 +++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/hik-vision camera/readme.md b/hik-vision camera/readme.md
index 53c3b11..1e43c91 100644
--- a/hik-vision camera/readme.md	
+++ b/hik-vision camera/readme.md	
@@ -34,6 +34,28 @@ Also, for the text overlay to work, the authentication for web must be digest/ba
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_025.jpg"></img></br>
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_026.jpg"></img></br>
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_026a.jpg"></img></br>
+The "Integration Protocol" under Advanced settings is only visible if you have the latest firmware. The reason you don't see that option in the above screenshots is because I had older version of firmware, and I updated it to enable text overlay feature.
+
+The following is the Home Assistant REST API sensor that sets a given text to the camera.  For more information, go to
+[https://github.com/skalavala/mysmarthome/blob/master/packages/cameras.yaml#L141](https://github.com/skalavala/mysmarthome/blob/master/packages/cameras.yaml#L141)
+
+```
+rest_command:
+  set_camera_textoverlay_left_bottom:
+    url: http://192.168.xxx.xxx/Video/inputs/channels/1/overlays/text/1
+    username: !secret camera_username
+    password: !secret camera_password
+    method: PUT
+    content_type: 'text/xml'
+    payload: >-
+      <?xml version="1.0" encoding="UTF-8"?>
+      <TextOverlay version="1.0" xmlns="http://www.hikvision.com/ver10/XMLSchema">
+      <id>1</id><enabled>true</enabled>
+      <posX>45</posX><posY>520</posY>
+      <message>{{ message }} </message>
+      </TextOverlay>
+```
+
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_027.jpg"></img></br>
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_028.jpg"></img></br>
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_029.jpg"></img></br>
@@ -46,10 +68,12 @@ Also, for the text overlay to work, the authentication for web must be digest/ba
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_036.jpg"></img></br>
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_037.jpg"></img></br>
 
-Make sure you check the "1" checkbox under **Text Overlay** and enter some text and save settings if you want to update the text programmatically. 
-AlsoIf you get the "Parameter Error" while saving, that means you mus be using wrong browser. Make sure you use IE11 browser with the ActiveX plugin installed.
+Make sure you check the "1" checkbox under **Text Overlay**, enter some text and save settings if you want to update the text programmatically. 
+Also, if you get the "Parameter Error" while saving, that means you are using wrong browser! 
 
-**Hikvision settings are best updated using IE11 browser!** When something doesn't work the way it is expected, this is something to keep an eye on.
+**Make sure you use IE11 browser with the ActiveX plugin installed.**
+
+**Hikvision settings are best updated using IE11 browser!**
 
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_038.jpg"></img></br>
 <img src="https://raw.githubusercontent.com/skalavala/mysmarthome/master/hik-vision%20camera/images/screenshot_039.jpg"></img></br>