osmo-iuh

Osmocom code for the Iuh interface (HNBAP, RUA, RANAP) https://osmocom.org/projects/libosmo-ranap

Go to file

Neels Hofmeyr f495b2347b hnbgw: make Iuh bind address configurable via VTY Add config node hnbgw/iuh/bind, taking an IPv4 address. Use this address to bind the Iuh server. This is particularly useful for the ip.access nano3G, which is very sensitive with SCTP addresses that don't respond to SCTP heartbeats. If the hnbgw listens on 0.0.0.0, there will be SCTP heartbeats for all local interfaces on the machine that the hnbgw runs on; the nano3G will interpret the "missing", or rather, redundant heartbeat acks for the interfaces that aren't really related to the Iuh server and assume a broken Iuh link, leading to an Iuh shutdown and reconnection, looping every minute or so. By binding the hnbgw to only one local interface, the SCTP addresses can be reduced and "missing" heartbeat acks can be avoided. Change-Id: Ie2749c152b878e17aa65dfb806826357d5c494f1		2016-08-18 03:21:22 +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	hnbgw vty: add empty hnbgw and hnbgw/iuh vty nodes	2016-08-18 03:21:22 +02: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: make Iuh bind address configurable via VTY	2016-08-18 03:21:22 +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	hnbgw vty: add empty hnbgw and hnbgw/iuh vty nodes	2016-08-18 03:21:22 +02: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)