[Ovmsdev] Getting Started with OVMS v3.1

[Mark Webb-Johnson]

FYI: Email sent to all purchasers of OVMS v3.1 modules

Firstly, thank you for your support of the Open Vehicles project.

As the first production batch of OVMS v3.1 kits has been shipped, you should be receiving yours any day now (if not already), we thought it useful to give you a few pointers for getting started with OVMS v3.1.

1] Unboxing

There is a short unboxing video on youtube. It gives an overview of what is in the kit, and what you can do to get started:

https://www.youtube.com/watch?v=HpyI1q4Y89I <https://www.youtube.com/watch?v=HpyI1q4Y89I>

2] User Guide

Work on the user guide has begun, but is just starting and the document is expected to evolve rapidly over the coming weeks and months. You can always find the latest version here:

https://docs.google.com/document/d/16JrXR7rybp-18DrEoeh1rg6GqQT_jVBvhaXh2oEWRHw/edit?usp=sharing <https://docs.google.com/document/d/16JrXR7rybp-18DrEoeh1rg6GqQT_jVBvhaXh2oEWRHw/edit?usp=sharing>

You can comment directly on that document, and suggest revisions. If you would like to volunteer to help extend it, that would be most appreciated - please let us know and we’ll open up more access to it for you.

3] Hologram

To simplify getting started, a Hologram SIM has been included with the modem in every OVMS v3.1 kit. Hologram have also kindly provided a coupon code “OVMS” that can be used to get US$5 credit; this can be used for both existing as well as new Hologram customers. You can simply enter that coupon code at checkout (when purchasing data credits, etc).

When activating your Hologram SIM, you’ll need to enter the ICCID written on the SIM itself. You can also get that electronically (without having to open up the package) from the web or terminal shells with the following command:

OVMS# metric list m.net.mdm.iccid

4] Firmware Status

The firmware is continually evolving on a daily basis, and the development team regularly releases updates for over-the-air download and install. In these early days of production v3.1, it is important that you update your firmware on a regular basis. Please make sure you are running the latest firmware before reporting an issue.

The simplest way to update the module firmware is to connect it as a client to your wifi network (or phone hotspot), and then use the web interface Config / Firmware / Flash-from-Web; that will show you the version you are running, as well as the latest version available for update. One click on 'Flash now' and the update will be downloaded and installed. Alternatively, you can download the firmware update to a file named ovms3.bin in the root directory of a FAT formatted SD CARD and insert the card into the module's slot - the new firmware will be updated automatically and the file renamed ovms3.done to signify completion.

5] Support

Please remember that this first production batch is intended for experienced OVMS v2 users and v3 developers, and note:

Firmware is not complete, and should be considered beta.

Functionality is approximately equivalent to basic OVMS v2 firmware, but some advanced features (such as ACC, SMS control, etc) are not available yet.

Firmware is far in advance of v2 in other aspects (such as built in web server, metrics, console, tcp/ip support, diagnostics, geofencing, scripting, etc).

Firmware can be updated either Over The Air (OTA), by Micro SD card, or over USB interface.

Vehicle support currently includes: Kia Soul EV, Nissan Leaf, Renault Twizy, and Tesla Roadster.

If you do experience a problem, or need assistance, please start by talking to other OVMS v3.1 users/developers in your area. If you still can't solve the issue, then eMail support at openvehicles.com <mailto:support at openvehicles.com>. Software issues can be reported directly to the project GitHub issue tracker here:

https://github.com/openvehicles/Open-Vehicle-Monitoring-System-3/issues <https://github.com/openvehicles/Open-Vehicle-Monitoring-System-3/issues>

Thank you for your support of the project.
Open Vehicles
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openvehicles.com/pipermail/ovmsdev/attachments/20180408/a7d62c95/attachment-0001.html>