This page is part of archived documentation for openHAB 4.3. Go to the current stable version
# LG HomBot Binding
The binding integrates a modified LG HomBot VR6260 based vacuum robots. Details on how to modify your HomBot can be found at roboter-forum.com (opens new window). The binding uses the HTTP service on port 6260 right now. Please take care when modifying your HomBot! This binding is a complement to a modified HomBot not an excuse to do the modification. Remember, You are responsible if You brick Your HomBot.
# Supported Things
Hacked LG HomBot series 62XX are supported.
The service that the binding connects to is actually lg.srv found at sourceforge.net (opens new window) running on a HomBot.
# Discovery
The auto-discovery should hopefully find your HomBot, be aware that it will try to connect to port 6260 on all IP-addresses on your subnet. If you already know the IP-address of your HomBot you might as well just configure it.
# Thing Configuration
The thing only requires an IP-address to function, this could also be found using the discovery method. The parameter is called "ipAdress".
You can also configure the polling interval in seconds by setting "pollingPeriod", and the network port of the server by using "port".
# Channels
| Channel Type ID | Item Type | Description | Read/Write |
|---|---|---|---|
| state | String | Current state of the HomBot. | R |
| battery | Number | Current battery charge. | R |
| cpuLoad | Number | Current CPU load. | R |
| srvMem | Number | Current server memory load. | R |
| clean | Switch | Start cleaning / return home. | RW |
| start | Switch | Start cleaning. | RW |
| home | Switch | Send HomBot home. | RW |
| pause | Switch | Pause current activity. | RW |
| turbo | Switch | Turn turbo on/off. | RW |
| repeat | Switch | Turn repeat cleaning on/off. | RW |
| mode | String | Current cleaning mode. | RW |
| nickname | String | Nickname of the HomBot. | R |
| move | String | Manually control the HomBot. | RW |
| camera | Image | Image from the top camera. | R |
| lastClean | DateTime | Date of last clean. | R |
| map | Image | Image of clean area. | R |
| monday | DateTime | Time when cleaning is on Mondays. | R |
| tuesday | DateTime | Time when cleaning is on Tuesdays. | R |
| wednsday | DateTime | Time when cleaning is on Wednsdays. | R |
| thursday | DateTime | Time when cleaning is on Thursdays. | R |
| friday | DateTime | Time when cleaning is on Fridays. | R |
| saturday | DateTime | Time when cleaning is on Saturdays. | R |
| sunday | DateTime | Time when cleaning is on Sundays. | R |
# Full Example
Example of how to configure a thing.
demo.thing
Thing lghombot:LGHomBot:mycleanerbot "LGHomBot" @ "Living Room" [ ipAdress="192.168.0.2", pollingPeriod="3", port="6260" ]
Here are some examples on how to map the channels to items.
demo.items:
String HomBot_State "State [%s]" <CleaningRobot> { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:state" }
Number HomBot_Battery "Battery [%d%%]" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:battery" }
Switch HomBot_Clean "Clean" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:clean" }
Switch HomBot_Start "Start" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:start" }
Switch HomBot_Home "Home" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:home" }
Switch HomBot_Pause "Pause" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:pause" }
Switch HomBot_Turbo "Turbo" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:turbo" }
Switch HomBot_Repeat "Repeat" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:repeat" }
String HomBot_CleanMode "Clean mode [%s]" { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:mode" }
String HomBot_Nickname { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:nickname" }
Image HomBot_Camera { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:camera" }
DateTime HomBot_LastClean { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:lastClean" }
Image HomBot_Map { channel="lghombot:LGHomBot:a4_24_56_8f_2c_5b:map" }
demo.sitemap:
sitemap demo label="Main Menu"
{
Frame label="HomBot" {
Text item=HomBot_State
Text item=HomBot_Battery
Switch item=HomBot_Clean
Switch item=HomBot_Start
Switch item=HomBot_Home
Switch item=HomBot_Pause
Switch item=HomBot_Turbo
Switch item=HomBot_Repeat
Selection item=HomBot_CleanMode mappings=[
"ZZ"="Zigzag mode",
"SB"="Cell by cell mode",
"SPOT"="Spiral spot mode",
"MACRO_SECTOR" = "My space mode" ]
Text item=HomBot_Nickname
Image item=HomBot_Camera
DateTime item=HomBot_LastClean
Image item=HomBot_Map
}
}