Smartthings Remote control for Outlander PHEV

Features:

• switch on/off condition/heater
• change mode of air conditioner: heater/cool/windscreen for 10/20/30 mins,
• show battery level
• support google home
• check if doors are closed
• possibility to control over voice(by Google assistant)

Cloud Installation

• cloud installation
• hetzner cloud
• scaleway cloud

Installation Steps

1. Install Server using Docker or Manual Installation
2. create Device Handler
3. create smartapp
4. Configure smartthings application on android or apple
5. Get "Smartthings Application Id" and "Smartthings Application Secret"
6. Configure Server
7. Add Smartthings devices

Server Docker Installation

• Supported Architectures: amd64,x86-64,arm64,ppc64le,arm/v7

docker run --name=smartthings-phevctl  -p 8080:8080 -p 8099:8099 vassio/smartthings-phevctl

Server Manual Installation

sudo touch /bin/phevctl
sudo echo "docker run vassio/phevctl $*">/bin/phevctl
sudo chmod +x /bin/phevctl
wget -qO- https://getpm2.com/install.sh | bash
sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u ${currentUser} --hp ${HOME}
sudo npm i smartthings-phevctl -g
sudo pm2 start `npm root -g`/smartthings-phevctl/smartthings-phevctl.js
sudo pm2 save

Smartthings installation

Create Custom DHT

1. open https://graph.api.smartthings.com/
2. open your location/ or create a new one
3. open "My Device Handler" and "create New Device Handler"
4. select from code and add [Outlander PHEV Action.groovy](./dht/Outlander PHEV Action.groovy) and [Outlander PHEV Battery.groovy](./dht/Outlander PHEV Battery.groovy)and [Outlander PHEV Doors.groovy](./dht/Outlander PHEV Doors.groovy)
5. click save

Create SmartApp

1. open https://graph.api.smartthings.com/
2. open your location
3. create a new SmartApp
4. select from code and add remote-ctrl-gsm.groovy
5. open smartapp application and click "App Settings"
6. enable "OAuth"
7. Save and publish application

Configure Smartthings application

1. open smartthings application in Phone Android or Apple
2. select location
3. add SmartApp
4. add "remote-ctrl-gsm"
5. set IP and port of server and click save

Get "Smartthings Application Id" and "Smartthings Application Secret"

1. open https://graph.api.smartthings.com/
2. select smartapps in your location
3. select your smartapp
4. get "Smartthings Application Id" and "Smartthings Application Secret" from the page

Configure Server

1. open server http://<IP>:8080
2. default login/password: admin/admin
3. configure "Smartthings Application Id", "Smartthings Application Secret" and mac address
4. click save

Add a new Smartthings device

1. select devices->add Device
2. Device will be appear om Smartthings App

Local Network Installation(under NAT)

• install [Smartthings Hub)[https://www.samsung.com/us/smart-home/smartthings/hubs/] on location.
• during installation smartapp select hub.

Authentication

Local authentication (default)

default login/password: admin/admin

change password for user

add a new User

Keycloak authentication

restart Application