cellular-infrastructure
/
osmo-iuh
mirror of https://gerrit.osmocom.org/osmo-iuh
9
0
Fork 0
Code Issues Releases Wiki Activity
Osmocom code for the Iuh interface (HNBAP, RUA, RANAP) https://osmocom.org/projects/libosmo-ranap
644 Commits 25 Branches 18 Tags 20 MiB
C 97.5%
Makefile 1.7%
Python 0.5%
Shell 0.2%
Go to file
Pau Espin 02de780ceb hnbap: Drop no longer existing asn1c param -fnative-types 
This is an option enabled by default and not existent as cmdline param
since asn1c 0.9.26.

For some reason, when dropping it, asn1c generates different description
comment section on related files. In any case, this makes hnbap look
like other libraries which already got this param removed and hence also
generateds code looks the same.

Change-Id: Iccf81539a5045416185e619d24c3d542204437e6
 		2021-10-27 16:32:58 +02:00
asn1 debian, asn1tostruct.py: switch to python3 2019-12-11 11:37:21 +01:00
contrib contrib/osmo-iuh.spec.in: fix header packaging 2021-10-26 09:21:02 +02:00
debian Provide libosmo-rua as a public shared library 2021-10-22 15:43:17 +02:00
doc manuals: generate vty reference xml at build time 2021-02-23 19:55:03 +01:00
include hnbap: Drop no longer existing asn1c param -fnative-types 2021-10-27 16:32:58 +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 hnbap: Drop no longer existing asn1c param -fnative-types 2021-10-27 16:32:58 +02:00
.gitignore contrib: integrate RPM spec 2020-05-20 08:50:55 +00:00
.gitreview add .gitreview to support git review plugin 2017-08-08 17:02:18 +00:00
COPYING move COPYING file to root directory 2015-12-21 21:01:00 +01:00
Makefile.am Provide libosmo-rua as a public shared library 2021-10-22 15:43:17 +02:00
README.md README.md: Document how to re-generate code from ASN1 files 2021-10-22 23:19:06 +02:00
TODO-RELEASE debian: Actually build manuals; add osmo-hnbgw-doc package 2021-01-07 13:56:26 +01:00
configure.ac Provide libosmo-rua as a public shared library 2021-10-22 15:43:17 +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-hnbap.pc.in Provide libosmo-hnbap as a public shared library 2021-10-22 15:42:27 +02:00
libosmo-ranap.pc.in add pkg-config file for libosmo-ranap 2016-01-03 18:12:22 +01:00
libosmo-rua.pc.in Provide libosmo-rua as a public shared library 2021-10-22 15:43:17 +02:00
libosmo-sabp.pc.in sabp: Generate C/H files for SABP; create libosmo-sabp 2019-09-23 20:23:51 +02:00
move-asn1-header-files.sh move-asn1-header-files.sh: Replace original asn file path in generated asn1 header files 2021-10-22 23:15:31 +02:00

README.md

osmo-iuh - Osmocom Iuh and HNB-GW implementation

This repository contains a C-language implementation of the 3GPP Iuh interface, together with a HNB-GW (Home NodeB Gateway). You can use it to interface Iuh-speaking femtocells/small cells to Iu-speaking MSCs and SGSNs.

It is part of the Osmocom Open Source Mobile Communications project.

Homepage

The official homepage of the project is https://osmocom.org/projects/osmohnbgw/wiki

GIT Repository

You can clone from the official libosmocore.git repository using

git clone git://git.osmocom.org/osmo-iuh.git

There is a cgit interface at http://git.osmocom.org/osmo-iuh/

Documentation

There is currently no documentation beyond the wiki available on the homepage. We would love to see somebody contributing a manual that can be part of the osmo-gsm-manuals suite.

Mailing List

Discussions related to osmo-iuh are happening on the openbsc@lists.osmocom.org mailing list, please see https://lists.osmocom.org/mailman/listinfo/openbsc for subscription options and the list archive.

Please observe the Osmocom Mailing List Rules when posting.

Contributing

Our coding standards are described at https://osmocom.org/projects/cellular-infrastructure/wiki/Coding_standards

We us a gerrit based patch submission/review process for managing contributions. Please see https://osmocom.org/projects/cellular-infrastructure/wiki/Gerrit for more details

The current patch queue for osmo-iuh can be seen at https://gerrit.osmocom.org/#/q/project:osmo-iuh+status:open

Building

It is generally best to check the wiki for the most up-to-date build instructions.

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

Using

Note: osmo-iuh just left very active development (December 2015, January 2016), so your mileage may vary.

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, and it will establish Iu (over SUA) connections towards the MSC and SGSN.

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)
  • Then in osmo-iuh.git: make -C src/ regen