vassio/smartthings-phevctl repository overview

⁠Smartthings Remote control for Outlander PHEV

⁠Server Docker Installation

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 papawattu/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)
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)[https://play.google.com/store/apps/details?id=com.samsung.android.oneconnect&hl=en&gl=US⁠] or (Apple)[https://apps.apple.com/us/app/smartthings/id1222822904⁠]
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

⁠Authentication

⁠Local authentication (default)

⁠change password for user

⁠add a new User

⁠Keycloak authentication

restart Application