Osmocom code for the Iuh interface (HNBAP, RUA, RANAP) https://osmocom.org/projects/libosmo-ranap
Go to file
Neels Hofmeyr 4d675a7df9 hnbgw: add cmdline arg parsing with default options
Default options taken from osmo-nitb:

    -h --help                  This text.
    -d option --debug=DHNBAP:DSUA:DRUA:DRANAP:DMAIN  Enable debugging.
    -D --daemonize             Fork the process into a background daemon.
    -s --disable-color
    -T --timestamp             Prefix every log line with a timestamp.
    -V --version               Print the version of OsmoHNBGW.
    -e --log-level number      Set a global loglevel.

Change-Id: I931cee01c605c1b507c16041ada226cf963ea433
2016-08-18 02:36:03 +02:00
asn1 asn1tostruct.py: use '#\!/usr/bin/env python', not '#\!/usr/bin/python' 2016-07-12 00:44:18 +02:00
contrib jenkins.sh: build both with checked-in and regenerated asn1 code 2016-07-12 00:44:18 +02:00
doc rename README.msc to README 2016-03-30 14:10:39 +02:00
include attempt to fix parallel build, improve AM logic 2016-05-15 23:28:14 +00:00
pcap Better capture for PS Data 2016-02-18 13:21:30 +01:00
specs import TR 25.931 with examples of signalling procedures 2016-02-22 09:17:15 +01:00
src hnbgw: add cmdline arg parsing with default options 2016-08-18 02:36:03 +02:00
.gitignore attempt to fix parallel build, improve AM logic 2016-05-15 23:28:14 +00:00
COPYING move COPYING file to root directory 2015-12-21 21:01:00 +01:00
Makefile.am move asn1 headers to include/ dir (5/5) 2016-01-04 18:11:19 +01:00
README update dependencies in README file 2016-04-09 20:29:37 +02:00
configure.ac Remove osmo-iuh subdir level from include/ (2/2) 2016-01-05 12:00:06 +01:00
git-version-gen add git-version-gen to auto-generate git based version number 2016-01-03 18:08:05 +01:00
libosmo-ranap.pc.in add pkg-config file for libosmo-ranap 2016-01-03 18:12:22 +01:00
move-asn1-header-files.sh make regen: ~8x faster: use sed script instead of single invocations 2016-07-12 00:44:18 +02:00

README

Osmocom Iuh experimentation code
(C) 2015 by Harald Welte <laforge@gnumonks.org>

This code is a playground for implementing something along the lines of
the an Iuh interface of a HNB-GW.  The intent is to later integrate this
with OsmoNITB + OsmoSGSN, in order to have 3G capable 'network in the
box'.

h1. Building

As external library dependencies, you will need
* libosmocore from git://git.osmocom.org/libosmocore
* libasn1c from git://git.osmocom.org/libasn1c
* libsctp-dev (this is the package name in Debian)
* libosmo-netif from git://git.osmocom.org/libosmo-netif (sysmocom/sctp branch)
* libosmo-sccp from git://git.osmocom.org/libosmo-sccp (sysmocom/iu branch)

To bootstrap the build, in the root directory, run:

    autoreconf --install

After that, run the usual

    ./configure [options]
    make
    [sudo] make install

h1. Using

Note: osmo-iuh is in active development (December 2015, January 2016) so below
statements may outdate rapidly.

there's not much to use yet.  But if you run the 'hnbgw' executable,
it will open a listening SCTP socket and wait for incoming Iuh
connections.  It will accept any HNB-REGISTER-REQUEST, so the homeNodeB
should start to establish RUA and RANAP (which we haven't implemented
yet).

h1. Regenerating C code from ASN.1 source

In order to re-generate the C source code from the ASN.1 source,
you will need a modified asn1c which has the following features:
* APER support (the patch from Eurecom, or its forward-ported version
  from the aper branch of git://git.osmocom.org/asn1c)
* support for prefixing the generated types (aper-prefix branch of
  git://git.osmocom.org/asn1c)