Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Branch: master
Fetching contributors…

Cannot retrieve contributors at this time

58 lines (33 sloc) 1.91 KB


Forskmocom is a development environment for OsmocomBB which uses Vagrant to create a virtual machine where all dependencies are installed and set up. The goal is to facilitate using and developing OsmocomBB.

This environment should work equally well on Windows, Linux and OS X. The virtual machine is a Ubuntu image based on the forskbox.

Getting started


Get the source

git clone
cd forskmocom
git submodule init
git submodule update

Set up virtual machine

vagrant up

Enable USB in VirtualBox

vagrant halt

Launch VirtualBox and edit the settings for the forskmocom_* virtual machine to enable USB.

vagrant up

Build OsmocomBB

vagrant ssh
cd /vagrant/osmobom-bb/src

Run hello_world

Remove the battery and put it back, connect the phone to your computer with an appropriate cable. Upload hello_world to the phone (c123xor and compal_e88 depends on your phone model):

osmocon -p /dev/ttyUSB0 -m c123xor \
    -c target/firmware/board/compal_e88/hello_world.highram.bin \

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.


Cannot open serial device /dev/ttyUSB0 when running osmocon

You haven't enabled USB in VirtualBox or you haven't connected the USB cable.


  • Wrapper for osmocon to enable specifying target phone once, and reducing some arguments
Jump to Line
Something went wrong with that request. Please try again.