retronetworking
/
osmo-isdntap
13
0
Fork 0
Code Pull Requests Releases Wiki Activity
ISDN tapping/tracing/recording software. Allows to record D-channels as GSMTAP and can store raw B-channel data for calls as files. Supports only DAHDI for now.
54 Commits 1 Branch 0 Tags 95 KiB
C 81.7%
Shell 7.4%
M4 5.5%
Makefile 5.4%
Go to file
Harald Welte 5479d21914 check for DAHDI_RXMIRROR during configure stage 
We require a DAHDI that has CONFIG_DAHDI_MIRROR enabled, which
declares DAHDI_RXMIRROR and DAHDI_TXMIRROR.  Let's check for that
rather than failing only at compile time.

Closes: OS#5886
 		2023-06-09 10:32:00 +02:00
contrib Initial WIP code; doens'tdo anything useful yet 2022-10-15 22:20:03 +02:00
debian Initial WIP code; doens'tdo anything useful yet 2022-10-15 22:20:03 +02:00
doc fill example config file with some actual config 2022-11-07 20:00:30 +01:00
src don't accept any arbitrary string as 'name' as we use it in a path 2022-11-08 09:06:56 +01:00
tests add q931 decoder unit tests 2022-10-16 19:43:02 +02:00
.gitignore Initial WIP code; doens'tdo anything useful yet 2022-10-15 22:20:03 +02:00
COPYING Add actual GPLv2 license text 2022-11-07 20:07:44 +01:00
Makefile.am Initial WIP code; doens'tdo anything useful yet 2022-10-15 22:20:03 +02:00
README.md README.md add link to homepage 2022-11-08 12:17:09 +01:00
configure.ac check for DAHDI_RXMIRROR during configure stage 2023-06-09 10:32:00 +02:00
git-version-gen Initial WIP code; doens'tdo anything useful yet 2022-10-15 22:20:03 +02:00

README.md

osmo-isdntap - Osmocom ISDN tap daemon

This repository contains a small stand-alone [daemon] program that you can run to create recordings of ISDN calls.

It is part of the Osmocom retronetworking project.

The program works by passively decoding the ISDN D-channel, specifically the Q.931 call control protocol. Whenever a call is being set up, it starts to capture the B-channel timeslot allocated to that call. It creates two files, one for each of the two directions of the call. The files contain the raw transparent binary B-channel data.

Currently the only supported ISDN hardware/driver interface is DAHDI.

Currently, only PRI (primary rate) ISDN interfaces are supported.

Homepage

https://osmocom.org/projects/osmo-isdntap/wiki

GIT Repository

You can clone from the official osmo-isdntap.git repository using

git clone https://gitea.osmocom.org/retronetworking/osmo-isdntap

There is a web interface at https://gitea.osmocom.org/retronetworking/osmo-isdntap

Converting recordings to audio

If you'd like to convert any of the recorded files to audio, you can use the following example command to do so:

sox --channels 1 --type raw --rate 8000 -e a-law isdntap-03012342111-03012343038-20221016-212558-8-tx.raw output.wav

The generated output.wav file can then be played back with any standard audio player.