blob: 0af810bd97820d0ef2ef12aba2635d03447de364 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
<style type="text/css" media="print"> div.pb { page-break-before: always; } </style>
Copyright (C) 2014-2016, Jaguar Land Rover
This document is licensed under Creative Commons
Attribution-ShareAlike 4.0 International.
**Version 0.5.0**
# BUILD INSTRUCTIONS FOR RVI #
This document describes the build process from source for the RVI
project on an Ubuntu 14.04 Linux machine. Packages are also available
for [Ubuntu](INSTALL_ubuntu.md), [Debian](INSTALL_debian.md),
and [Raspbian](INSTALL_raspbian.md).
Please see ```README.md``` for a general description of the project
and its structure.
Please see ```CONFIGURE.md``` for details on configuring and launching
the system once it has been built.
The first milestone of the RVI project is the HVAC demo. Please see
```hvac_demo/README.md``` for details on how to setup, launch and
drive the demo.
# READER ASSUMPTIONS #
In order to build the system, the reader is assumed to be able to:
1. Have a basic understanding of Linux system operations.
2. Install packages on the system.
Please note that the configuration process described in
```CONFIGURE.md``` may have additional skill requirements.
# PREREQUISITES #
1. The Ubuntu 14.04 system have the latest updates installed.
2. The user can gain root access to install packages.
3. There is at least 5GB of space availabled for packages and code.
----
<div class="pb"></div>
# INSTALLATION PROCESS #
## INSTALL DEVELOPMENT TOOLS ##
Use ```apt-get``` to install git, which is used to access the Automotive
Grade Linux repositories where the code resides:
sudo apt-get install git
Also ensure that you have the latest BlueZ Linux Bluetooth headers
and that g++ is installed on your system:
sudo apt-get install libbluetooth-dev g++
## INSTALL ERLANG ##
Install Erlang 18.2, or a later version 18 release:
Tested packages of the latest versions of Erlang can be downloaded from
[packages.erlang-solutions.com](https://www.erlang-solutions.com/resources/download.html)
Add the following line to your /etc/apt/sources.list
deb http://packages.erlang-solutions.com/ubuntu trusty contrib
Update and install esl-erlang
sudo apt-get update
sudo apt-get install esl-erlang
**If you receive an authentication error** (such as NO_PUBKEY):
note the hexadecimal value (e.g., 6D975C4791E7EE5E) and request the key:
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys HEX
where HEX is the hexadecimal value specified in the error.
Then rerun the ```update``` and ```install``` commands.
## CLONE THE RVI REPOSITORY ##
Use the newly installed ```git``` tool to clone (copy) the RVI repository
to the build system.
git clone https://github.com/PDXostc/rvi_core.git
The clone will be downloaded into a newly created ```rvi_core``` subdirectory.
<div class="pb"></div>
## BUILD THE RVI SYSTEM ##
Run ```make``` to build the dependency code in ```deps``` and the
top level project in the ```rvi``` directory.
make compile
The local ```rebar``` command is used to retrieve the dependencies. See
```rebar.config``` and ```deps/*/rebar.config``` for a list of
dependencies.
See the [rebar](https://github.com/basho/rebar) project for a detailed
description of the rebar Erlang build tool.
Expected output:
$ make
./rebar get-deps
==> goldrush (get-deps)
==> lager (get-deps)
==> src (get-deps)
==> ale (get-deps)
==> src (get-deps)
...
./rebar compile
==> goldrush (compile)
Compiled src/glc.erl
Compiled src/glc_lib.erl
Compiled src/glc_code.erl
...
/.../rvi_core/deps/exo/src/exo_ssh.erl:18: Warning: undefined callback function code_change/3 (behaviour 'ssh_channel')
/.../rvi_core/deps/exo/src/exo_ssh.erl:18: Warning: undefined callback function handle_call/3 (behaviour 'ssh_channel')
...
cp deps/setup/setup_gen scripts/
(cd components/authorize && make escript)
ERL_LIBS=/.../rvi_core/components/authorize/..:/..../jlr/rvi_core/components/authorize/../../deps ./rebar escriptize
==> authorize (escriptize)
cp components/authorize/author scripts/
$
Some warnings are expected, and are usually not a failure indication:
The compiled code is available under ```ebin/```, ```components/*/ebin``` and ```deps/*/ebin```.
## CREATE A RELEASE ##
See [CONFIGURE.md](CONFIGURE.md) ([PDF](doc/pdf/CONFIGURE.pdf)) for details
on configuring and creating a developer and production release that can be
launched.
|
