OsmocomBB

https://osmocom.org/projects/baseband/wiki
Admin
OsmocomBB is a free and open-source GSM baseband software implementation that replaces proprietary...
Tokens:1,986,457
Snippets:16,769
Trust Score:9.6
Update:1 month ago
Show doc for...
Tokens:
Raw
### Getting started instructions

Source: https://osmocom.org/projects/baseband/wiki/Mobile/3/annotate

Instructions for getting started with mobile.

```text
You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone.
```

--------------------------------

### Getting started heading

Source: https://osmocom.org/projects/baseband/wiki/Mobile/3/annotate

Heading for the getting started section.

```text
== Getting started with {{{mobile}}} ==
```

--------------------------------

### Getting started with mobile

Source: https://osmocom.org/projects/baseband/wiki/Mobile/8/annotate

Getting started section: requires a CalypsoSerialCable, osmocon, and the layer1 firmware image.

```text
== Getting started with {{{mobile}}} ==

You need to follow the usual procedure using a CalypsoSerialCable, [wiki:osmocon] and the {{{layer1.*.bin}}} firmware image for your phone.
```

--------------------------------

### Start OsmoBTS

Source: https://osmocom.org/projects/baseband/wiki/CalypsoBTS/2/diff

Command to start OsmoBTS and example output.

```text
sudo osmobts-trx -c ~/.osmocom/osmo-bts.cfg -r 99
```

```text
((*)) 
  | 
 / \ OsmoBTS 
Using MAC address of eth0: 'xx:xx:xx:xx:xx:xx' 
... 
<000a> trx_if.c:176 No response from tranceiver 
<000a> trx_if.c:176 No response from tranceiver 
<000a> trx_if.c:176 No response from tranceiver
```

--------------------------------

### Initialize Configuration Files

Source: https://osmocom.org/projects/baseband/wiki/CalypsoBTS/5/diff

Create the necessary configuration directory and files.

```bash
# Create the configuration folder if it isn't exist yet 
 mkdir ~/.osmocom 
 
 cd ~/.osmocom 
 touch ~/.osmocom/open-bsc.cfg 
 touch ~/.osmocom/osmo-bts.cfg 
```

--------------------------------

### Running guide introduction (Textile markup)

Source: https://osmocom.org/projects/baseband/wiki/FakeTRX/15/annotate

Introductory text for the running guide, assuming the Osmocom GSM network side stack is compiled and installed.

```textile
This guide assumes that you already have the Osmocom GSM [[cellular-infrastructure:|network side stack]] compiled and installed. If not, the simplest way is to use the [[osmonitb:|Network in the Box]].
```

--------------------------------

### Tutorial Introduction

Source: https://osmocom.org/projects/baseband/wiki/Flashing/5/annotate

Introductory warning and instructions for the flashing tutorial.

```text
This tutorial explains how to flash one or multiple application(s) into C123 phone. Read carefully, otherwise you might brick your phone. Even if you follow this tutorial, you may brick your phone if you run into cable problem, weak battery or software fault. Also be sure to have another phone for unattended charging. The charger is supported, but if firmware crashes, battery might get overloaded. '''Never charge unattended! '''After flashing, the original firmware is gone, so be sure to save complete flash memory, if you want to restore original firmware in the future.
```

--------------------------------

### Startup Note

Source: https://osmocom.org/projects/baseband/wiki/Mobile/7/annotate

Steps to follow when starting the mobile program.

```text
Note: 
You should:
 * start {{{mobile}}}
 * start [wiki:osmocon] and load the {{{layer1.*.bin}}} firmware image for your phone  
 * press the start button on your phone
```

--------------------------------

### Start PC/SC daemon on old systems without systemd

Source: https://osmocom.org/projects/baseband/wiki/SoftSIM/14/annotate

Use this command to start the PC/SC daemon on systems that do not use systemd. This is a prerequisite for the SoftSIM setup.

```bash
$ sudo service pcscd start

```

--------------------------------

### Build osmocomBB with arm-none-eabi toolchain

Source: https://osmocom.org/projects/baseband/wiki/Software_Getting_Started/34

Example command after installing gcc-arm-none-eabi on Ubuntu/Debian.

```bash
make -e CROSS_TOOL_PREFIX=arm-none-eabi-

```

--------------------------------

### Bootloader procedure intro

Source: https://osmocom.org/projects/baseband/wiki/SciphoneDreamG2/17/annotate

Introduction to the bootloader procedure.

```wiki
For executing U-Boot and Linux using the MTK romloader, proceed as follows:
```

--------------------------------

### Finish Installation

Source: https://osmocom.org/projects/baseband/wiki/CalypsoBTS/3/diff

Commands to compile and install the software.

```sh
#!sh
make
sudo make install
sudo ldconfig
cd ..
```

--------------------------------

### Osmocon Beacon Output

Source: https://osmocom.org/projects/baseband/wiki/CalypsoRomloader/2/annotate

Example output observed when starting the romloader process.

```text
Sending beacon...
```

--------------------------------

### Start OsmoBTS with TRX backend

Source: https://osmocom.org/projects/baseband/wiki/FakeTRX/14/annotate

Step 3 of the FakeTRX setup: start OsmoBTS, optionally enabling the TRX backend during a from-source build with ./configure --enable-trx=yes.

```text
3. Start [[OsmoBTS:]] (in case you want to [[cellular-infrastructure:build from source]], enable the TRX backend with @./configure --enable-trx=yes@).
```

--------------------------------

### Build with arm-none-eabi toolchain prefix

Source: https://osmocom.org/projects/baseband/wiki/Software_Getting_Started/29

Example command after installing gcc-arm-none-eabi package on Ubuntu.

```bash
make -e CROSS_TOOL_PREFIX=arm-none-eabi-
```

--------------------------------

### Initialize configuration files

Source: https://osmocom.org/projects/baseband/wiki/CalypsoBTS/3

Creates the necessary directory and configuration files for OpenBSC and OsmoBTS.

```sh
# Create the configuration folder if it isn't exist yet
mkdir ~/.osmocom

cd ~/.osmocom
touch ~/.osmocom/open-bsc.cfg
touch ~/.osmocom/osmo-bts.cfg
```

--------------------------------

### Run osmo-bts-trx with configuration files

Source: https://osmocom.org/projects/baseband/wiki/FakeTRX/41/diff

Starts the BTS with two configuration files.

```shell
osmo-bts-trx -c ./osmo-bts-trx.cfg ./osmo-bts.cfg 
```
Tokens:
Raw