FAQ - drudge/homebridge-mobilelink GitHub Wiki

What does this plugin do?

My goal was to get basic automation in place with the Home+ app that automatically turns certain accessories off when running on generator power. I'm happy to report that the plugin does indeed achieve my goal.

It creates a new Outlet on your Homebridge. The Outlet will set In Use based on when the generator is detected to be running.

---

Why is the outlet always On?

The Outlet will be On as long as the generator is on standby and reachable via WiFi. If the generator is running, the outlet's In Use property will change. This is the main trigger for automations.

---

Why can't I power on/off the generator with the outlet?

I have not found a way to remotely active or disable the generator through the Mobile App. If you've seen any app or way to accomplish this, please let me know and I'll research how to make it work in this plugin.

---

How do I generate an auth token?

If you're feeling adventurous and want to try it out, you can generate a new auth token using curl. Edit the UserLogin and UserPassword values in the JSON request below to match your MobileLink account, and then copy and paste the command into your terminal and execute it.

curl -s -X "POST" "https://api.mobilelinkgen.com/Users/login" \
     -H 'Content-Type: application/json' \
     -H 'Accept: application/json' \
     -H 'User-Agent: StandbyStatusProd/1.4.9.3148 (iPhone; iOS 14.0; Scale/3.00)' \
     -d $'{
  "SharedKey": "GeneseeDepot13",
  "UserLogin": "[email protected]",
  "UserPassword": "password"
}' | awk -F"[,:}]" '{for(i=1;i<=NF;i++){if($i~/'AuthToken'\042/){print $(i+1)}}}' | tr -d '"' | sed -n 1p

As long as your credentials are correct, you'll see your new auth token printed to your terminal.

If you have homebridge-config-ui-x, you can enter your newly generated auth token in the settings screen to get started.

If you prefer to hand-edit your config.json, add a new object, similar to the one below, to your platforms array, replacing the value for authToken with your generated token:

{
    "authToken": "token",
    "discoverFrequency": 60000,
    "platform": "MobileLink"
}