Announcement

Collapse
No announcement yet.

Worx Landroid Robot Lawn Mower

Collapse
This topic is closed.
X
This is a sticky topic.
X
X
 
  • Filter
  • Time
  • Show
Clear All
new posts

  • Worx Landroid Robot Lawn Mower

    DESCRIPTION

    This plug-in is designed to work with the Worx Landroid WiFi Connected Robot Mowers, models 2017 and 2018. It supports multiple robots, as long as they are registered on the same Worx account/email address. However, this plugin has only been tested with a single Worx Landroid S WR106SI.1.

    REQUIREMENTS
    • This plugin is for HS3 or HS3PRO. It works with both Windows and Linux versions
    • .NET Framework 4.7.1 or later, or mono 5.10 or later needs to be installed on your Homeseer machine
    • A valid Worx account with the robot(s) properly registered
    INSTALLATION

    There are no additional software requirements. The plug-in can be installed from the HS3 updater, and can be found under the section “Robotics”.

    CONFIGURATION

    After installation and starting the plug-in, go to the configuration page. They are three tabs:
    • Setup: For a first setup, enter your email address and password used when registering your Worx Landroid device(s). Then restart the plugin. You can also enable Scheduler and Zone support here.
    • Robots: After successful setup, your robots will be listed here.
    • Settings: Details plug-in settings. Normally, there is no need to change any of those and change of settings might negatively impact the functionality of the plug-in.
    TROUBLESHOOTING

    If anything doesn’t work, you can try one the following:
    • Check the HS3 eventlog for any errors or clues.
    • Linux only: Make sure Mono 5.10 or later is installed. Check your version using "mono --version"
    • Windows only: Make sure .NET Framework 4.7.1 or later is installed. Because it is difficult to see what version is actually installed, I suggest using this tool: http://www.asoft.be/prod_netver.html
    • Ensure the correct email address and password is entered in the plugin setup.
    • If all fails, enable debug logging and log to file. Send me the log so I can investigate.

    NOTES
    • This plugin uses a non-public API from Worx Landroid and Worx could change their API at any time, crippling this plugin. In the unlikely event that this happens I will do my best to update this plugin in a reasonable time frame. However, as the API is non-public, no guarantees can be given and worst case the plugin might stop functioning and I will never be able to get it to work again.
    • The plug-in has been tested with a Worx Landroid S WR106SI.1 with firmware 3.45.
    • The plug-in should be able to support any other Worx Landroid 2017/2018 model with WiFi and with latest firmware installed. As I only own a single mower, please let me know if something doesn't work as expected.
    Last edited by stefxx; October 5th, 2018, 08:10 AM.
    stefxx

  • #2
    Screenshots

    Some screenshots of the Worx Landroid plug-in.

    After entering your Worx Landroid registration information, your robots are shown here:
    Click image for larger version  Name:	 Views:	1 Size:	113.9 KB ID:	1248986

    Main devices, that holds the current status, errors and actions:
    Click image for larger version  Name:	 Views:	1 Size:	292.1 KB ID:	1248877
    You can start, stop and pause your robot here. Also, the Rain Delay can be set. The status updates automatically every 10 minutes, or more frequent when the robot is working and has a new status to report. You can refresh the data manually by pressing "Refresh", but normally that should not be necessary. Some fields require a little explanation:
    - Status: Unknown, Idle, Home, Start sequence, Leaving home, Follow wire, Searching home, Searching wire, Mowing, Lifted, Trapped, Blade blocked, Debug, Remote control, Going Home, Zone training, Border cut, Searching zone or Pause
    - Error: should be "No error" or "Raining" (if Rain Delay > 0). Other errors are Unknown, Trapped, Lifted, Wire missing, Outside wire, Close door before mowing, Close door to go home, Blade motor blocked, Wheel motor blocked, Trapped timeout, Upside down, Battery low, Reverse wire, Charge error, Timeout finding home and Battery overtemp
    - Worktime & Worktime Blade: Actual worktime in days.hours:minutes format
    - Run: The Landroid has 10 Runs, and than restarts from Run 1. If you enable zones (see below), you can configure a Zone for each run.
    - Zone: The current or next Zone that will be selected based on the Run number and zone configuration
    - Battery Status: Charged, Charging or Error.

    Zones configuration, only available when enabled in the plugin configuration:
    Click image for larger version  Name:	 Views:	1 Size:	338.8 KB ID:	1248878 - Root: "Get" refreshes the current config. Normally it will update automatically, unless a settings has been changed. Status will be set to "Pending changes" until "Get" or "Set" is selected.
    - Root: "Set" will save the zone settings into the Landroid. Status will return to "No status".
    - Run 1-10: Tells the robot in which zone to start for each run.
    - Zone 1 - 4: "Start" will attempt to start directly in this zone. It works by temporarily changing the zone configuration. This should be transparent but I am still testing this if this works reliable. If not, this option might be removed in a future version.
    - Zone 1 - 4: "Meter" is the amount of meters of wire the Robot will travel to decide in which zone the Robot is.

    Scheduler configuration, only available when enabled in the plugin configuration:
    Click image for larger version  Name:	 Views:	1 Size:	460.4 KB ID:	1248879
    - Root: "Get" refreshes the current config. Normally it will update automatically, unless a settings has been changed. Status will be set to "Pending changes" until "Get" or "Set" is selected.
    - Root: "Set" will save the scheduler settings into the Landroid. Status will return to "No status".
    <Day> Start: Time to start
    <Day> End: Time to stop. If this time is earlier than the start time, the next day is assumed.
    <Day> Edge: Include edge mowing for that day
    Scheduler Type: Automatic or Manual. It seems that "Automatic" overrules your schedule and behaves like you just unpacked your Landroid (there is a default schedule in the Landroid). If you want to set the Start and End times yourself, set it to Manual. If you like to disable the scheduler completely, set all start- and end-times to 00:00.
    Time Extend: Add or subtract % of time to the scheduler without changing all individual timers.
    Last edited by stefxx; October 1st, 2018, 01:25 PM.
    stefxx

    Comment


    • #3
      Release notes

      Release 3.0.0.3, 13-04-2019
      - Upgrade to API v2
      - Fixed WiFi signal for Landroid M models

      Release 3.0.0.2, 02-04-2019
      - Fixed device images
      - Fixed Parent/Child device relationship

      Release 3.0.0.1, 14-10-2018
      - Upgrade to MQTTnet 2.8.3
      - Better support for multiple robots
      - Fixed status images for error device ("lifted" and "wire reversed")
      - Reconnect if no message received in 30 minutes

      Release 3.0.0.0, 01-10-2018
      - Improved Zone start
      - Zone device now always displays current or next (start) zone, even when zone configuration changed during a run
      - Adjusted WiFi signal strength/icon thresholds
      - Fixed firmware icon (Linux)
      - Fixed/changed other icons
      - Several minor fixes/improvements

      Release 0.0.0.1, 22-09-2018
      - Initial (beta) version
      Last edited by stefxx; October 14th, 2018, 12:34 PM.
      stefxx

      Comment

      Working...
      X