Setting up an HTML5 development environment

OpenIVI Mobility includes an HTML5 runtime for OpenIVI Mobility applications, available at its GitHub repo. It supports two modes of operation:

  • Running on a PC for test/development

  • Running on an actual OpenIVI device for real-world usage

Additionally, when it’s running on a device, you can do remote debugging through Google Chrome.

Building

Linux

Install dependencies

sudo apt-get update
sudo apt-get install build-essential cmake libgles2-mesa-dev libegl1-mesa-dev libwayland-dev qtbase5-dev
sudo apt-get install libqt5dbus5 libqt5webkit5-dev exuberant-ctags

Create a build directory and configure the build with cmake

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug ..

Build

make

Run

./openivi-html5

MacOS

Install dependencies:

  • install Qt Creator from http://www.qt.io/download-open-source/. Note that the default install includes support files for iOS; these are not required for OpenIVI Mobility, and take 7GB of disk space, so you may wish to deselect them during install.

  • install the homebrew version of ctags; the stock xcode one will not work: brew install ctags

Create a build directory and configure the build with cmake. Note that on OSX, you will need to tell cmake where to find Qt; the default install location is ~/Qt/<version>/clang_64/

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PREFIX_PATH=~/Qt/5.5/clang_64/ ..

Build

make

Run

./openivi-html5

GENIVI Software Loading Manager Integration

Openivi-html5 integrates with a slightly modified version of the GENIVI Software Loading Manager.

First, follow the openivi-html5 README instructions to build and run it. After the "Run" step you should see the Getting Started screen.

The integration depends on some extra features that are only on our branch of the SLM. In a new terminal clone the GENIVI Software Management repo:

git clone -b feat/hmi-api git@github.com:cajun-rat/genivi_software_management.git
cd genivi_software_management/

OSX additional directions

The software manager and sota client require gtk and dbus, neither of which are available by default on OSX. You can install them using homebrew, though it does require a couple of extra commands.

brew install pygtk
brew install homebrew/python/python-dbus
ln -sfv /usr/local/opt/d-bus/*.plist ~/Library/LaunchAgents
launchctl load ~/Library/LaunchAgents/org.freedesktop.dbus-session.plist

These four commands should be sufficient for a fresh install, but note that if you’ve previously had dbus installed, you may need to delete, recreate, and reload the launch agent plist file.

Now start the software loading manager (note that this opens 5 terminals) by running:

sh start_swm.sh

Or, on OSX:

sh start_swm_osx.sh

Back in the openivi-html5 window, click on the menu item "File → Open File" and open openivi-html5/example/demo.html

You should see "There are 0 updates available"

Now in another new terminal, navigate to genivi_software_management and run:

python sota_client.py

You should see the update appear in the openivi-html5 gui along with the text "Awaiting Approval. There are 1 updates available". To start the update hit the "Approve Updates" button.

The openivi-html5 gui should show the update installing, then return to the "There are 0 updates available" state.

Remote Debugging

WebKit HTML5 remote debugging is enabled by default on port 9221. With openivi-html5 running, just point Google Chrome (or Chromium) at http://localhost:9221 This works with remote computers too: just find the IP address of the embedded machine with ifconfig.