OVMS Setup

Tools and parts required:

USB-A to micro USB cable

OVMS kit, includes OVMS, serial cable, gsm cable, hologram SIM card, and K-line adapter kit (optional)

Hook & loop, or adhesive tape for physical installation.

Small screw driver.

Setting up the user account

Visit https://www.openvehicles.com/ –  When creating an account here make sure you use ev@gruber.com email in order to keep track of future updates. (**ev@gruber.com is being used by the company account [username: grubermotors, password: Timex2112], so use your company email for now). This will later be updated to the owner’s email so they can have control over it.

Example username and password :

Username: bethsquiers

Password: Squiers#412

1. Go to login at the top right
2. Select Create new account
3. Enter in the user information
   1. Blah…
4. Open the activation link sent to ev@gruber.com
5. Set the password with the mask Lastname#VIN
6. Select the Vehicles tab in the profile page
7. Select the link Register an Open Vehicle
   1. Set the vehicle ID to the VIN
   2. Set the vehicle name to the name the owner uses for the Roadster, or simply the paint color. The owner can change the name themselves later on.
   3. Set the password with the mask Lastname#VIN
   4. Select Register Vehicle button

Adding a Vehicle to the OVMS App

1. Download the app from the Google Play Store or Apple App Store
2. Open the OVMS app
3. Select the dropdown triangle near the top left to bring up several screen options
4. Select Settings from the dropdown
5. Select the + near the upper right corner of the screen to add a vehicle
6. Enter the Vehicle ID VIN
7. Enter a vehicle nickname for Vehicle Label
8. Enter the Vehicle Server Password Lastname#VIN
9. Enter the Module/SMS Password Lastname#VIN
10. Make sure the server is set to api.openvehicles.com
11. Slide the vehicle images at the bottom until you reach the Roadster with your paint color
12. Select the save button at the top right

For iOS users

1. Download the app from the Apple App Store
2. Open the OVMS app
3. Select Settings in the bottom right corner
4. Select New in the upper left corner of the screen to add a vehicle
   1. Feel free to select Edit in the top right corner, the red delete button next to the sample Roadster to remove it
5. Enter the Vehicle ID VIN
6. Enter a vehicle nickname for Vehicle Label
7. Enter the Vehicle Server Password Lastname#VIN
8. Enter the Module/SMS Password Lastname#VIN
9. Make sure the server is set to api.openvehicles.com
10. Slide the vehicle images at the bottom until you reach the Roadster with your paint color
11. Select the < Back button in the top left corner to save

Setting up the OVMS

Make sure the computer you are using to set up the OVMS has the ability to connect to a WiFi Access point and a separate USB hub to isolate the computer’s USB ports from the OVMS device.

1. Open the OVMS by removing the four screws on the bottom
2. Remove the internal PCB and locate the Nano SIM card holder, J4, on the cellular daughterboard
3. Remove the Nano SIM card from the Hologram SIM card holder and install it in the Nano SIM card holder, J4, on the cellular daughterboard
   1. The metal latch of the Nano SIM card holder slides towards the Micro USB port
   2. Then swing the latch upwards and install the Nano SIM card with its metal contacts facing down towards the PCB
   3. The Nano SIM card is keyed with a notch in one corner, so it can be installed in the correct orientation
   4. Swing the latch downwards and then slide the latch back to its original position
4. If you need to add the K-line expansion board do so now
   1. Remove the two Phillips-head screws on the cellular daughterboard near each of the UMCCs (Ultra-Miniature Coaxial Connector)
   2. Take the two brass male-female screw posts and screw them into the threaded holes you removed the Phillips-head screws
   3. Tighten the brass posts with a small pair of  serrated pliers
   4. Install the expansion board with the white triagnle corner
   5. Flip Black Dip Switch to #1 position.
5. Connect a USB hub to your computer
6. Connect the OVMS to the USB hub using a USB Type-A to USB Micro-B
7. You should see the OVMS show up in the WiFi devices list with the SSID OVMS
8. Select the OVMS access point and use the password OVMSinit
9. Open a browser and navigate to 192.168.4.1 in the URL bar
10. Select the Start setup now button at the top
11. Set the Module ID to VIN
12. Set the password with the mask Lastname#VIN
13. The OVMS will reboot and show up in the WiFi devices list with the SSID VIN
14. Select the access point with the VIN, and use the password Lastname#VIN
15. Select the Reload Page button on the webpage now
16. Enter the password Lastname#VIN, and leave the username blank
17. Enter the Gruber Motors SSID GMC, and password GruberEV
18. The OVMS should connect to the Gruber Motors WiFi network
19. Login to the OVMS again by simply entering the password Lastname#VIN
20. Select Asia-Pacific (openvehicles.com) as the Update Server
21. The OVMS will now attempt to update the firmware
    1. You should see the message Downloading… (XXXXXXX bytes so far) repeat several times as the update is downloaded until the Expected file size is reached
22. Once you see OTA flash was successful, then select the Reboot now button wait for the webpage to reload
    1. If the page doesn’t load, then reconnect to the WiFi access point with the SSID VIN
    2. Reload the webpage and login to the OVMS again by simply entering the password Lastname#VIN
23. Select Tesla Roadster for Vehicle Type
24. Set the Distance unit to Miles
25. The OVMS data server should already be set to Asia-Pacific (openvehicles.com)
26. The Vehicle ID should already be set to VIN
27. Enter the password Lastname#VIN
28. The OVMS should now try to login to the openvehicle.com website with the credentials you provided
    1. The state should say Connected OVMS V2 login Successful
29. Skip the modem setup step as the GSM antenna needs to be connected to the OVMS when enabling the Modem otherwise you could damage the OVMS
30. Login to the OVMS website and update the email address to the customers email
31. The OVMS is ready to install in the Roadster and provide remote access through the OVMS App

Activating the Hologram SIM Card

You need to provide the owner with the ICCID number—it is an 18-22 digit number found on the plastic sheath under ICCID or on the back of the SIM card.

1. Ask the owner to visit hologram.io/start
2. Provide them the ICCID number for the SIM card you installed in the OVMS or plan to send to them
3. Inform them to use the coupon code OVMS when signing up for the pay-as-you-go plan
4. I selected the Professional plan, though most owner will likely need to choose the Maker plan
5. I then chose the Flexible Data plan (pay as you go) because I don’t yet know if we will need more than 250MB/month
6. It includes 1MB for free each month and each additional MB is charge at $.40 (though it is charged per KB)
7. We will need to determine the amount of data usage so owners know what to expect
8. I then entered the ICCID number
9. I named the SIM after the name of the vehicle
10. I enabled autofill and set the balance to $5 when the amount gets to $1 (it automatically fills the account with $20 to start and it cannot be adjusted)
11. I added a credit card
12. On the next page I applied the OVMS coupon code for $5 off the data usage (I imagine it is a one time deal)
13. It showed a pop up that asked we setup the APN correctly, so I just agreed
14. I went to the Modem Config menu in the OVMS and set the APN, under the Internet section, to hologram with no username or password

Adding a K-Line Expansion Board

1. Open the OVMS with an appropriate screw driver.
2. Remove the two black screw from the top of the ovms opposite of the GSM/GPS gold external antenna connections.
3. Flip the tiny black dip switch to #1 on the K-line board to add TPMS functionality via shell.
4. Add the supplied gold standoffs by screwing them in in place of the black screws you removed in step 2,
5. Pop on your K-Line board over the rows of pins while keeping the orientation correct, there will be two tabs with holes that go over the screw holes of step 2.
6. Put back the black screws thru the K-line board, screwing into the gold stand offs you just added.
7. Put your cover back on and screw back together.
8. Internally your OVMS with K-Line expansion board is complete, now use the web portal moving forward.

 

 

Connecting to Wi-Fi:

(********** input your specific OVMS data)

 

You will need a laptop to connect to the OVMS. Open your laptop, within ~200ft of your Roadster, and look for a WiFi network SSID (name of the WiFi network) “**********” to connect to. The password will be just like your OVMS app password *********, and that will grant you access into your OVMS’s network. Open a web browser and enter the 192.168.4.1 into the URL bar, use the previous password without a username to login to the OVMS to get access to the dashboard to make changes.

From here you will need to go to Config on the top menu bar, and select WiFi from the drop down. Under the “WiFi client networks” section, you will find the green plus used to add new WiFi networks for the OVMS to connect to when in range. Enter your home network’s SSID (name of the WiFi network) and the password, select save at the bottom, and if the OVMS doesn’t automatically reboot then select Status from the top menu bar scroll down to the card with the title Module, and select the reboot button in the bottom left corner. Once the OVMS has rebooted and you have logged back in, go back to the Status screen and scroll down to the bottom and on the left side will be a card with the title WiFi. There you will see next to STA SSID is your home WiFi’s SSID, signal strength, etc., you should also see in the card titled Server that the OVMS has connected to the server so your app can also see the OVMS. Look for “State: Connected” and below it “OVMS V2 login successful, …” to make sure it has internet access and that the phone app can get information from your Roadster.

Please also check that the auto start for the cellular is enabled by going to Config on the top menu bar, and select Auto start from the drop down. Under the “… client mode SSID” drop down there’s a checkbox labeled Start Modem, make sure that box is checked to ensure the cellular modem starts up. If that is already enabled, then select the “… client mode SSID” drop down and select the top line item “Any known SSID (scan mode)”. This ensures that any WiFi networks you add will be automatically connected when they are within range.

Hope this helps.

 

Email Template

Hello (Customer Name),   Your OVMS is setup and live! You will need to activate it’s Hologram SIM card from hologram.io/start if you plan to have remote access to your Roadster while it is away from your home WiFi network. Use the ICCID number #********************; that is your SIM card’s unique ID. You can use the coupon code OVMS when signing up for the pay-as-you-go plan to get a discount.   If you plan to only have the OVMS connected to your home WiFi network, then please let me know if you can provide your network name (SSID) and password or if I should get you instructions on how to do it yourself.               **Location of certain buttons in app vary between phone OS (Android & iOS)**   Right now though, we can go through the steps to get the OVMS phone app and connect it to your Roadster to get live data/control.   1.  Download the OVMS app from the Google Play Store or Apple App Store.   2.  Open the OVMS app.   3.  Select Settings from the drop down menu, or find the setting tab at the  bottom right.   4.  Select the drop down triangle near the top left or pick “NEW” button to add a vehicle.   5.  Enter Vehicle ID: *****   6.  Enter Vehicle nickname: **********   7.  Enter the Vehicle Server Password: **********   8.  Enter the Module/SMS Password: **********   9.  Make sure the Server is set to api.openvehicles.com  < not an option to enter in iOS app.   10. Slide the vehicle images at the bottom until you reach the Roadster with your paint color.   11. To save this just pick the floppy disk top right or pick “<CARS” button in iOS app.   12. ENJOY 🙂   If you have any questions, please do not hesitate to message or call us for help. Thank You! Quality Checks: Set up OVMS to automatically scan for known ssids in (done in web portal)…. Also, test OVMS app during test drive, verify GPS is moving, TPMS is reading, temps, etc…