Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 58 lines (33 sloc) 1.959 kB
563c65f @jonasb can you read me?
jonasb authored
1 ## About
2
3 Forskmocom is a development environment for [OsmocomBB](http://bb.osmocom.org) which uses [Vagrant](http://vagrantup.com/) to create a virtual machine where all dependencies are installed and set up. The goal is to facilitate using and developing OsmocomBB.
4
a51ad78 @jonasb add instructions for how to run hello_world
jonasb authored
5 This environment should work equally well on Windows, Linux and OS X. The virtual machine is a Ubuntu image based on the [forskbox](https://github.com/forskningsavd/forskbox).
563c65f @jonasb can you read me?
jonasb authored
6
7 ## Getting started
8
035bc23 @jonasb formatting of README.md
jonasb authored
9 ### Prerequisites
563c65f @jonasb can you read me?
jonasb authored
10
035bc23 @jonasb formatting of README.md
jonasb authored
11 * [git](http://git-scm.com/)
12 * [Vagrant](http://vagrantup.com/)
13
14 ### Get the source
563c65f @jonasb can you read me?
jonasb authored
15
16 git clone git@github.com:forskningsavd/forskmocom.git
17 cd forskmocom
18 git submodule init
19 git submodule update
20
035bc23 @jonasb formatting of README.md
jonasb authored
21 ### Set up virtual machine
563c65f @jonasb can you read me?
jonasb authored
22
23 vagrant up
24
035bc23 @jonasb formatting of README.md
jonasb authored
25 ### Enable USB in VirtualBox
563c65f @jonasb can you read me?
jonasb authored
26
27 vagrant halt
28
a51ad78 @jonasb add instructions for how to run hello_world
jonasb authored
29 Launch VirtualBox and edit the settings for the `forskmocom_*` virtual machine to [enable USB](http://www.virtualbox.org/manual/ch03.html#idp11188688).
563c65f @jonasb can you read me?
jonasb authored
30
31 vagrant up
32
035bc23 @jonasb formatting of README.md
jonasb authored
33 ### Build OsmocomBB
563c65f @jonasb can you read me?
jonasb authored
34
35 vagrant ssh
36 cd /vagrant/osmobom-bb/src
37 make
38
035bc23 @jonasb formatting of README.md
jonasb authored
39 ### Run `hello_world`
a51ad78 @jonasb add instructions for how to run hello_world
jonasb authored
40
41 Remove the battery and put it back, connect the phone to your computer with an appropriate [cable](http://bb.osmocom.org/trac/wiki/Hardware/SerialCable). Upload `hello_world` to the phone (`c123xor` and `compal_e88` depends on your phone model):
42
43 osmocon -p /dev/ttyUSB0 -m c123xor \
44 -c target/firmware/board/compal_e88/hello_world.highram.bin \
45 target/firmware/board/compal_e88/chainload.compalram.bin
46
47 Press the power-on button on the phone briefly to start the actual upload. If everything works you should get a flashing `Hello World` on the phone.
48
49 ## Troubleshooting
50
035bc23 @jonasb formatting of README.md
jonasb authored
51 ### `Cannot open serial device /dev/ttyUSB0` when running `osmocon`
a51ad78 @jonasb add instructions for how to run hello_world
jonasb authored
52
53 You haven't [enabled USB](http://www.virtualbox.org/manual/ch03.html#idp11188688) in VirtualBox or you haven't connected the USB cable.
54
55 ## TODO
56
57 * Wrapper for `osmocon` to enable specifying target phone once, and reducing some arguments
Something went wrong with that request. Please try again.