Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Environment for osmocom-bb

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 manifests
Octocat-spinner-32 osmobom-bb @ b4a8bad
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .gitmodules
Octocat-spinner-32 Vagrantfile
Octocat-spinner-32 mobile.cfg


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
Something went wrong with that request. Please try again.