]> git.giorgioravera.it Git - mercedes_me_api.git/commitdiff
Update README.md
authorGiorgio Ravera <47370115+xraver@users.noreply.github.com>
Tue, 29 Sep 2020 09:20:45 +0000 (11:20 +0200)
committerGitHub <noreply@github.com>
Tue, 29 Sep 2020 09:20:45 +0000 (11:20 +0200)
Updated README.md

README.md

index bf71d1581b18825ac13d1171c65bdbaa33e10a61..e94e5e52fae4b82c0d723d8f1b620ed14d8c4865 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,2 +1,42 @@
 # mercedes_me_api
-Script to interface with Mercedes Me API
+Script to interface with Mercedes Me APIs
+
+# Pre-Requirements
+1) Own a Mercedes Benz Car with Mercedes Me installed and working.
+2) Create an application in https://developer.mercedes-benz.com/
+3) Register to the following APIs:
+   - [Fuel Status](https://developer.mercedes-benz.com/products/fuel_status)
+   - [Vehicle Lock Status](https://developer.mercedes-benz.com/products/vehicle_lock_status)
+   - [Vehicle Status](https://developer.mercedes-benz.com/products/vehicle_status)
+
+Note: the APIs described above do not requires any subscription in case you use them with your own car associated the the Mercedes Me Account.
+
+# Installation
+To use this script it's necessary to perform the following instructions:
+1) clone the repository
+2) create a credentials files (.mercedes_credentials) with:
+> CLIENT_ID=""
+
+> CLIENT_SECRET=""
+
+> VEHICLE_ID=""
+
+where CLIENT_ID and CLIENT_SECRET referring to the application information that can be found in [Mercedes Developer Console](https://developer.mercedes-benz.com/console) and VEHICLE_ID is the VIN of your car.
+
+
+# Usage
+To execute the script the command is:
+
+> $ ./mercedes_me_api.sh <arguments>
+
+The possible arguments are:
+
+>    -t, --token        Procedure to obtatin the Access Token (stored into .mercedes_token)
+    
+>    -r, --refresh      Procedure to refresh the Access Token (stored into .mercedes_token)
+    
+>    -f, --fuel         Retrive the Fuel Status of your Vehicle
+    
+>    -l, --lock         Retrive the Lock Status of your Vehicle
+    
+>    -s, --status       Retrive the General Status of your Vehicle