README: Migrate to README.md

Change-Id: Ic6553d7f672d737cc2813b3b0aeb7fc1d4715ce5
1 file changed
tree: be4fc3e804d9b338774e3ddacda7b486aa9c4e48
  1. contrib/
  2. doc/
  3. src/
  4. tests/
  5. .gitignore
  6. configure.ac
  7. git-version-gen
  8. Makefile.am
  9. osmoappdesc.py
  10. README.md
README.md

Osmocom E1 recorder

(C) 2016 by Harald Welte laforge@gnumonks.org

The idea of this program is to be able to build a "poor mans E1/T1 recorder" purposes of data analysis, without any special equipment.

This approach is more risky than a purely passive, hardware based approach as that of the Osmocom e1-tracer released at https://osmocom.org/projects/e1-t1-adapter/wiki/E1_tracer

If you can, it is strongly recommended to use the purely passive, high-impedance tap approach of e1-tracer and not the poor-man's software proxy approach presented in osmo-e1-recorder.

Setup

To do so, two E1 cards are used as some kind of proxy for the E1 communication. Recording of a single E1 link always requires two E1 interface cards, one for each direction.

Recording can be performed either

  • passively, using a E1 Tap aapter
  • asa proxy / man-in-the-middle

All timeslots will be opened in "raw" mode, making sure the recording will work wheter or not there is HLDC-based signalling (MTP or LAPD), PCM voice, TRAU frames or anything else on the line.

Recording will be done on a per-timeslot basis, dumping the raw bytes read for this timeslot into a file.

New files are started regularly, after reaching a pre-determined file size limit. File names contain RTC time stamping and timeslot number.

Later possible extensions could include automatic detection of the payload and a more intelligent storage format (e.g. in case of HDLC bsaed signalling).