OpenDigitalRadio - User contributions [en]

DAB reception

2017-03-14T22:01:51Z

Albrechtl:

__NOTOC__

This side informs you about a concept of a open source DAB receiver.

==Existing open DAB/DAB+/T-DMB software receiver==
[[Image:Phon3b small.jpg|100px|right]]

===Software Defined DAB Receiver (complete software receiver)===
*[http://www.sdr-j.tk/index.html Qt-DAB] (running on Linux and Windows, using RTL2832 based USB dongles)
*[http://www.welle.io welle.io] (running on Linux and Windows, using RTL2832 based USB dongles and airspy dongles)
*[http://www.zsn.zhaw.ch/de/engineering/zsn/projekte/gnu-radio.html DAB receiver for gnuradio] (by Zurich School of Engineering, documentation in German)

===Software defined DAB receiver (up to logical layer)===
*[[Gnuradio DAB constellation using gr-dab and USRP]]
*[https://github.com/andrmuel/gr-dab Gnuradio blocks for DAB reception] (developments from Andreas Mueller, ETHZ)
**[http://www.0x7.ch/text/dab-report.pdf Documentation] any other information on http://www.0x7.ch/text/#index3h2
*[https://www.cgran.org/browser/projects/dabp/trunk Under construction gnuradio project on DAB+ reception on CGRAN]

===Software defined DAB receiver (from logical layer up to application layer)===
====Openmokast====

Open Receiver project from CRC using RDI streams from DAB baseband receivers/decoders.
*http://www.openmokast.org

Receiver for the Psion Wavefinder
*[http://sourceforge.net/projects/opendab/ OpenDAB]

==Open source DAB receiver (concept)==
===Goal===
To develop libraries to cover all parts of a full DAB and DAB+ SDR receiver.
*Well defined library APIs
*Easy to use APIs
*Cross platform support (x86, arm, Linux, Windows, etc.)

===Requirements===
*Based on the SDR-J code
*Use of C++11 to use the threading feature
*Multicore support
*cmake as build environment

===Architecture===
[[File:DAB_Receiver_Concept.png|800px]]
{| class="wikitable"
|-
! Library Name
! Purpose
|-
| [[libsdrsource]]
|
Interface to different SDR devices
|-
| [[libdabdemod]]
|
*OFDM demodulation
*Frequency synchronization
*Time synchronization
*Output of the digital DAB stream
|-
|libdabdecode
|
*DAB and DAB+ frame decoding (FIC, Superframes etc.)
*CRC correction
*Output of MPEG or ACC stream
|-
| End user program
|
*Place holder for GUIs
*There can be a QT GUI, a GTK GUI or a Kodi plugin
|}

===API description===
*TBD

===To be discussed===
*Naming of libraries
*APIs

===GUI Wishlist===
*Easy to use
*Channel scan
*High DPI support
*libnotify support

Libdabdemod

2016-02-15T20:06:43Z

Albrechtl: Added flow charts

=Introduction=
libdabdemod is a library that demodulates the digital OFDM DAB signal and outputs the digital DAB stream.
At the moment this library is in the concept phase.

=Usage=
==Tune to a specific frequency==
This flowchart shows how to tune to a specific frequency or channel.

[[File:Libdabdemod_tune_frequency.png|200px]]

==Tune to a specific service channel==
This flowchart shows how to tune to a specific service channel.

[[File:Libdabdemod_set_service_channel.png|200px]]

=API Description=

<code>DemodError LibDABDemod::SetDevice(LibSDRSource* libSDRSource)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the SDR driver source from the library libsdrsource.
|-
| '''Parameter'''
| libSDRSource: libsdrsource object
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::OpenDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::CloseDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::Start(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Starts the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::Stop(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Stops the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::SetChannel(string Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel (Band III: 5A to 13F; L band: LA to LP)
|-
| '''Parameter'''
| ''Channel'': Channel string e.g.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetChannel(string* Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current channel
|-
| '''Parameter'''
| ''Channel'': Channel string e.g. “5A”
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetSignalStatus(CSignalStatus* SignalStatus)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current signal status
|-
| '''Parameter'''
| ''SignalStatus'': Pinter to signal status object.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::RemoveServiceComponent(CServiceComponent ServiceComponent)</code>
{| class="wikitable"
|-
| '''Description'''
| Removes a selected service component
|-
| '''Parameter'''
| ''ServiceComponent'': Service component object
|-
| '''return'''
| Error code enum object
|}

<code>CServiceComponent LibDABDemod::AddServiceComponent(char mode, char SubChId, short StartCU, char UEP_EEP, char UEPTabldx, char EEPIdx, short CUNum, short PacketAddr, char FECScheme)</code>
{| class="wikitable"
|-
| '''Description'''
| Adds a service component
|-
| '''Parameter'''
| ''Mode'': DAB Mode. 0: DAB audio, 1: DAB+ audio, 2: packet, 3: stream 
''SubChId'': Sub-channel identifier 
''StartCU'': Address the first Capacity Unit (CU) of the sub-channel 
''UEP_EEP'': Short or the long form of the size and protection field. 0: short form (UEP), 1: long form (EEP) 
''UEPTabldx'': UEP Table index. Only used if UEP_EEP=0 
''EEPIdx'': Protection level. Only used if UEP_EEP=1 
''CUNum'': Sub-channel size (CUs) 
''PacketAddr'': Address of the packet in which the service component is carried 
''FECScheme'': FEC Scheme 
|-
| '''return'''
| Service component object, NULL if an error occurred
|}
For a detailed description please see "ETSI EN 300 401" section 6.2 "Sub-channel organization" and 6.3 "Service organization". [https://www.worlddab.org/technology-rollout/standards/technical-specifications-list]

<code>DemodError LibDABDemod::GetServiceData(CServiceComponent ServiceComponent, CServiceData &ServiceData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the data of a selected service channel. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''ServiceComponent'': Service component buffer
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetFICData(CFICData &FICData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the FIC data. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''FICData'': FIC data buffer
|-
| '''return'''
| Error code enum object
|}

File:Libdabdemod set service channel.png

2016-02-15T20:01:44Z

Albrechtl: Flowchart that shows how to set a specific service channel

Flowchart that shows how to set a specific service channel

File:Libdabdemod tune frequency.png

2016-02-15T20:00:34Z

Albrechtl: Flowchart that shows how to tune to a specific frequency or channel

Flowchart that shows how to tune to a specific frequency or channel

Libsdrsource

2016-02-10T21:18:08Z

Albrechtl: Add description

=Introduction=
libsdrsource is a library that provides the same interface for different SDR devices. At the moment this library is in the concept phase.

=API Description=

<code>SDRError LibSDRSource::Open(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::Close(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::Reset(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Resets the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::GetSamples(CSDRSamples &SampleBuffer)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the IQ samples. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''SampleBuffer'': Sample buffer
|-
| '''return'''
| SDR error enum object
|}

Libdabdemod

2016-02-10T21:16:17Z

Albrechtl: /* API Description */ Add description

=Introduction=
libdabdemod is a library that demodulates the digital OFDM DAB signal and outputs the digital DAB stream.
At the moment this library is in the concept phase.

=API Description=

<code>DemodError LibDABDemod::SetDevice(LibSDRSource* libSDRSource)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the SDR driver source from the library libsdrsource.
|-
| '''Parameter'''
| libSDRSource: libsdrsource object
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::OpenDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::CloseDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::Start(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Starts the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::Stop(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Stops the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::SetChannel(string Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel (Band III: 5A to 13F; L band: LA to LP)
|-
| '''Parameter'''
| ''Channel'': Channel string e.g.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetChannel(string* Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current channel
|-
| '''Parameter'''
| ''Channel'': Channel string e.g. “5A”
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetSignalStatus(CSignalStatus* SignalStatus)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current signal status
|-
| '''Parameter'''
| ''SignalStatus'': Pinter to signal status object.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::RemoveServiceComponent(CServiceComponent ServiceComponent)</code>
{| class="wikitable"
|-
| '''Description'''
| Removes a selected service component
|-
| '''Parameter'''
| ''ServiceComponent'': Service component object
|-
| '''return'''
| Error code enum object
|}

<code>CServiceComponent LibDABDemod::AddServiceComponent(char mode, char SubChId, short StartCU, char UEP_EEP, char UEPTabldx, char EEPIdx, short CUNum, short PacketAddr, char FECScheme)</code>
{| class="wikitable"
|-
| '''Description'''
| Adds a service component
|-
| '''Parameter'''
| ''Mode'': DAB Mode. 0: DAB audio, 1: DAB+ audio, 2: packet, 3: stream 
''SubChId'': Sub-channel identifier 
''StartCU'': Address the first Capacity Unit (CU) of the sub-channel 
''UEP_EEP'': Short or the long form of the size and protection field. 0: short form (UEP), 1: long form (EEP) 
''UEPTabldx'': UEP Table index. Only used if UEP_EEP=0 
''EEPIdx'': Protection level. Only used if UEP_EEP=1 
''CUNum'': Sub-channel size (CUs) 
''PacketAddr'': Address of the packet in which the service component is carried 
''FECScheme'': FEC Scheme 
|-
| '''return'''
| Service component object, NULL if an error occurred
|}
For a detailed description please see "ETSI EN 300 401" section 6.2 "Sub-channel organization" and 6.3 "Service organization". [https://www.worlddab.org/technology-rollout/standards/technical-specifications-list]

<code>DemodError LibDABDemod::GetServiceData(CServiceComponent ServiceComponent, CServiceData &ServiceData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the data of a selected service channel. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''ServiceComponent'': Service component buffer
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetFICData(CFICData &FICData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the FIC data. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''FICData'': FIC data buffer
|-
| '''return'''
| Error code enum object
|}

Libdabdemod

2016-02-10T21:06:18Z

Albrechtl: /* API Description */ Added class LibDABDemod

=API Description=

<code>DemodError LibDABDemod::SetDevice(LibSDRSource* libSDRSource)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the SDR driver source from the library libsdrsource.
|-
| '''Parameter'''
| libSDRSource: libsdrsource object
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::OpenDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::CloseDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::Start(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Starts the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::Stop(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Stops the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::SetChannel(string Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel (Band III: 5A to 13F; L band: LA to LP)
|-
| '''Parameter'''
| ''Channel'': Channel string e.g.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetChannel(string* Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current channel
|-
| '''Parameter'''
| ''Channel'': Channel string e.g. “5A”
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetSignalStatus(CSignalStatus* SignalStatus)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current signal status
|-
| '''Parameter'''
| ''SignalStatus'': Pinter to signal status object.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::RemoveServiceComponent(CServiceComponent ServiceComponent)</code>
{| class="wikitable"
|-
| '''Description'''
| Removes a selected service component
|-
| '''Parameter'''
| ''ServiceComponent'': Service component object
|-
| '''return'''
| Error code enum object
|}

<code>CServiceComponent LibDABDemod::AddServiceComponent(char mode, char SubChId, short StartCU, char UEP_EEP, char UEPTabldx, char EEPIdx, short CUNum, short PacketAddr, char FECScheme)</code>
{| class="wikitable"
|-
| '''Description'''
| Adds a service component
|-
| '''Parameter'''
| ''Mode'': DAB Mode. 0: DAB audio, 1: DAB+ audio, 2: packet, 3: stream 
''SubChId'': Sub-channel identifier 
''StartCU'': Address the first Capacity Unit (CU) of the sub-channel 
''UEP_EEP'': Short or the long form of the size and protection field. 0: short form (UEP), 1: long form (EEP) 
''UEPTabldx'': UEP Table index. Only used if UEP_EEP=0 
''EEPIdx'': Protection level. Only used if UEP_EEP=1 
''CUNum'': Sub-channel size (CUs) 
''PacketAddr'': Address of the packet in which the service component is carried 
''FECScheme'': FEC Scheme 
|-
| '''return'''
| Service component object, NULL if an error occurred
|}
For a detailed description please see "ETSI EN 300 401" section 6.2 "Sub-channel organization" and 6.3 "Service organization". [https://www.worlddab.org/technology-rollout/standards/technical-specifications-list]

<code>DemodError LibDABDemod::GetServiceData(CServiceComponent ServiceComponent, CServiceData &ServiceData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the data of a selected service channel. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''ServiceComponent'': Service component buffer
|-
| '''return'''
| Error code enum object
|}

<code>DemodError LibDABDemod::GetFICData(CFICData &FICData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the FIC data. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''FICData'': FIC data buffer
|-
| '''return'''
| Error code enum object
|}

Libdabdemod

2016-02-10T21:04:15Z

Albrechtl: /* API Description */ Some minor changes

=API Description=

<code>DemodError SetDevice(LibSDRSource* libSDRSource)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the SDR driver source from the library libsdrsource.
|-
| '''Parameter'''
| libSDRSource: libsdrsource object
|-
| '''return'''
| Error code enum object
|}

<code>DemodError OpenDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError CloseDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError Start(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Starts the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError Stop(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Stops the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError SetChannel(string Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel (Band III: 5A to 13F; L band: LA to LP)
|-
| '''Parameter'''
| ''Channel'': Channel string e.g.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetChannel(string* Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current channel
|-
| '''Parameter'''
| ''Channel'': Channel string e.g. “5A”
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetSignalStatus(CSignalStatus* SignalStatus)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current signal status
|-
| '''Parameter'''
| ''SignalStatus'': Pinter to signal status object.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError RemoveServiceComponent(CServiceComponent ServiceComponent)</code>
{| class="wikitable"
|-
| '''Description'''
| Removes a selected service component
|-
| '''Parameter'''
| ''ServiceComponent'': Service component object
|-
| '''return'''
| Error code enum object
|}

<code>CServiceComponent AddServiceComponent(char mode, char SubChId, short StartCU, char UEP_EEP, char UEPTabldx, char EEPIdx, short CUNum, short PacketAddr, char FECScheme)</code>
{| class="wikitable"
|-
| '''Description'''
| Adds a service component
|-
| '''Parameter'''
| ''Mode'': DAB Mode. 0: DAB audio, 1: DAB+ audio, 2: packet, 3: stream 
''SubChId'': Sub-channel identifier 
''StartCU'': Address the first Capacity Unit (CU) of the sub-channel 
''UEP_EEP'': Short or the long form of the size and protection field. 0: short form (UEP), 1: long form (EEP) 
''UEPTabldx'': UEP Table index. Only used if UEP_EEP=0 
''EEPIdx'': Protection level. Only used if UEP_EEP=1 
''CUNum'': Sub-channel size (CUs) 
''PacketAddr'': Address of the packet in which the service component is carried 
''FECScheme'': FEC Scheme 
|-
| '''return'''
| Service component object, NULL if an error occurred
|}
For a detailed description please see "ETSI EN 300 401" section 6.2 "Sub-channel organization" and 6.3 "Service organization". [https://www.worlddab.org/technology-rollout/standards/technical-specifications-list]

<code>DemodError GetServiceData(CServiceComponent ServiceComponent, CServiceData &ServiceData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the data of a selected service channel. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''ServiceComponent'': Service component buffer
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetFICData(CFICData &FICData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the FIC data. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''FICData'': FIC data buffer
|-
| '''return'''
| Error code enum object
|}

Libsdrsource

2016-02-10T21:03:22Z

Albrechtl: /* API Description */ Some minor changes

=API Description=

<code>SDRError LibSDRSource::Open(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::Close(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::Reset(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Resets the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::GetSamples(CSDRSamples &SampleBuffer)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the IQ samples. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''SampleBuffer'': Sample buffer
|-
| '''return'''
| SDR error enum object
|}

Libsdrsource

2016-02-10T21:00:27Z

Albrechtl: Created page with "=API Description= <code>SDRError LibSDRSource::Open(void)</code> {| class="wikitable" |- | '''Description''' | Opens the SDR device |- | '''Parameter''' | none |- | '''retur..."

=API Description=

<code>SDRError LibSDRSource::Open(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::Close(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::Reset(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Resets the SDR device
|-
| '''Parameter'''
| none
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| FrequencyKHz: Pointer to frequency in KHz
|-
| '''return'''
| SDR error enum object
|}

<code>SDRError LibSDRSource::GetSamples(CSDRSamples &SampleBuffer)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the IQ samples. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| SampleBuffer: Sample buffer
|-
| '''return'''
| SDR error enum object
|}

Libdabdemod

2016-02-10T20:47:46Z

Albrechtl: /* API Description */ Add AddServiceComponent() description

=API Description=

<code>DemodError SetDevice(LibSDRSource* libSDRSource)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the SDR driver source from the library libsdrsource.
|-
| '''Parameter'''
| libSDRSource: libsdrsource object
|-
| '''return'''
| Error code enum object
|}

<code>DemodError OpenDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError CloseDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError Start(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Starts the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError Stop(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Stops the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError SetChannel(string Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel (Band III: 5A to 13F; L band: LA to LP)
|-
| '''Parameter'''
| ''Channel'': Channel string e.g.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetChannel(string* Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current channel
|-
| '''Parameter'''
| ''Channel'': Channel string e.g. “5A”
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetSignalStatus(CSignalStatus* SignalStatus)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current signal status
|-
| '''Parameter'''
| ''SignalStatus'': Pinter to signal status object.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError RemoveServiceComponent(CServiceComponent ServiceComponent)</code>
{| class="wikitable"
|-
| '''Description'''
| Removes a selected service component
|-
| '''Parameter'''
| ''ServiceComponent'': Service component object
|-
| '''return'''
| Error code enum object
|}

<code>CServiceComponent AddServiceComponent(char mode, char SubChId, short StartCU, char UEP_EEP, char UEPTabldx, char EEPIdx, short CUNum, short PacketAddr, char FECScheme)</code>
{| class="wikitable"
|-
| '''Description'''
| Adds a service component
|-
| '''Parameter'''
| Mode: DAB Mode. 0: DAB audio, 1: DAB+ audio, 2: packet, 3: stream 
SubChId: Sub-channel identifier 
StartCU: Address the first Capacity Unit (CU) of the sub-channel 
UEP_EEP: Short or the long form of the size and protection field. 0: short form (UEP), 1: long form (EEP) 
UEPTabldx: UEP Table index. Only used if UEP_EEP=0 
EEPIdx: Protection level. Only used if UEP_EEP=1 
CUNum: Sub-channel size (CUs) 
PacketAddr: Address of the packet in which the service component is carried 
FECScheme: FEC Scheme 
|-
| '''return'''
| Service component object, NULL if an error occurred
|}
For a detailed description please see "ETSI EN 300 401" section 6.2 "Sub-channel organization" and 6.3 "Service organization". [https://www.worlddab.org/technology-rollout/standards/technical-specifications-list]

<code>DemodError GetServiceData(CServiceComponent ServiceComponent, CServiceData &ServiceData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the data of a selected service channel. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''ServiceComponent'': Service component buffer
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetFICData(CFICData &FICData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the FIC data. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''FICData'': FIC data buffer
|-
| '''return'''
| Error code enum object
|}

Libdabdemod

2016-02-09T21:55:36Z

Albrechtl: Initial page

=API Description=

<code>DemodError SetDevice(LibSDRSource* libSDRSource)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the SDR driver source from the library libsdrsource.
|-
| '''Parameter'''
| libSDRSource: libsdrsource object
|-
| '''return'''
| Error code enum object
|}

<code>DemodError OpenDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Opens the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError CloseDevice(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Closes the device
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError Start(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Starts the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError Stop(void)</code>
{| class="wikitable"
|-
| '''Description'''
| Stops the OFDM demodulation
|-
| '''Parameter'''
| none
|-
| '''return'''
| Error code enum object
|}

<code>DemodError SetFrequency(int32_t FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel frequency in kHz
|-
| '''Parameter'''
| ''FrequencyKHz'': Channel frequency in kHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError SetChannel(string Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Sets the channel (Band III: 5A to 13F; L band: LA to LP)
|-
| '''Parameter'''
| ''Channel'': Channel string e.g.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetFrequency(int32_t* FrequencyKHz)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current frequency
|-
| '''Parameter'''
| ''FrequencyKHz'': Pointer to frequency in KHz
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetChannel(string* Channel)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current channel
|-
| '''Parameter'''
| ''Channel'': Channel string e.g. “5A”
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetSignalStatus(CSignalStatus* SignalStatus)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the current signal status
|-
| '''Parameter'''
| ''SignalStatus'': Pinter to signal status object.
|-
| '''return'''
| Error code enum object
|}

<code>DemodError RemoveServiceComponent(CServiceComponent ServiceComponent)</code>
{| class="wikitable"
|-
| '''Description'''
| Removes a selected service component
|-
| '''Parameter'''
| ''ServiceComponent'': Service component object
|-
| '''return'''
| Error code enum object
|}

<code>CServiceComponent AddServiceComponent(char mode, char SubChId, short StartCU, char UEP_EEP, char UEPTabldx, char EEPIdx, short CUNum, short PacketAddr, char FECScheme)</code>
{| class="wikitable"
|-
| '''Description'''
| Adds a service component
|-
| '''Parameter'''
| Mode: TBD 
SubChId: TBD 
StartCU: TBD 
UEP_EEP: TBD 
UEPTabldx: TBD 
EEPIdx: TBD 
CUNum: TBD 
PacketAddr: TBD 
FECScheme: TBD 
|-
| '''return'''
| Service component object, NULL if an error occurred
|}

<code>DemodError GetServiceData(CServiceComponent ServiceComponent, CServiceData &ServiceData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the data of a selected service channel. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''ServiceComponent'': Service component buffer
|-
| '''return'''
| Error code enum object
|}

<code>DemodError GetFICData(CFICData &FICData)</code>
{| class="wikitable"
|-
| '''Description'''
| Gets the FIC data. This method is blocking. It blocks until new data is available.
|-
| '''Parameter'''
| ''FICData'': FIC data buffer
|-
| '''return'''
| Error code enum object
|}

DAB reception

2016-02-09T21:11:34Z

Albrechtl: /* Architecture */ Add wiki page links

__NOTOC__
This side informs you about a concept of a open source DAB receiver.

==Open source DAB receiver concept==
===Goal===
To develop libraries to cover all parts of a full DAB and DAB+ SDR receiver.
*Well defined library APIs
*Easy to use APIs
*Cross platform support (x86, arm, Linux, Windows, etc.)

===Requirements===
*Based on the SDR-J code
*Use of C++11 to use the threading feature
*Multicore support
*cmake as build environment

===Architecture===
[[File:DAB_Receiver_Concept.png|800px]]
{| class="wikitable"
|-
! Library Name
! Purpose
|-
| [[libsdrsource]]
|
Interface to different SDR devices
|-
| [[libdabdemod]]
|
*OFDM demodulation
*Frequency synchronization
*Time synchronization
*Output of the digital DAB stream
|-
|libdabdecode
|
*DAB and DAB+ frame decoding (FIC, Superframes etc.)
*CRC correction
*Output of MPEG or ACC stream
|-
| End user program
|
*Place holder for GUIs
*There can be a QT GUI, a GTK GUI or a Kodi plugin
|}

===API description===
*TBD

===To be discussed===
*Naming of libraries
*APIs

===GUI Wishlist===
*Easy to use
*Channel scan
*High DPI support
*libnotify support

==Existing open DAB/DAB+/T-DMB software receiver==
[[Image:Phon3b small.jpg|100px|right]]

===Software Defined DAB Receiver (complete software receiver)===
*[http://www.sdr-j.tk/index.html SDR-J] (running on Linux and Windows, using RTL2832 based USB sticks)
*[http://www.zsn.zhaw.ch/de/engineering/zsn/projekte/gnu-radio.html DAB receiver for gnuradio] (by Zurich School of Engineering, documentation in German)

===Software defined DAB receiver (up to logical layer)===
*[[Gnuradio DAB constellation using gr-dab and USRP]]
*[https://github.com/andrmuel/gr-dab Gnuradio blocks for DAB reception] (developments from Andreas Mueller, ETHZ)
**[http://www.0x7.ch/text/dab-report.pdf Documentation] any other information on http://www.0x7.ch/text/#index3h2
*[https://www.cgran.org/browser/projects/dabp/trunk Under construction gnuradio project on DAB+ reception on CGRAN]

===Software defined DAB receiver (from logical layer up to application layer)===
====Openmokast====

Open Receiver project from CRC using RDI streams from DAB baseband receivers/decoders.
*http://www.openmokast.org

Receiver for the Psion Wavefinder
*[http://sourceforge.net/projects/opendab/ OpenDAB]

DAB reception

2016-02-04T18:24:25Z

Albrechtl: Added DAB receiver concept

__NOTOC__
This side informs you about a concept of a open source DAB receiver.

==Open source DAB receiver concept==
===Goal===
To develop libraries to cover all parts of a full DAB and DAB+ SDR receiver.
*Well defined library APIs
*Easy to use APIs
*Cross platform support (x86, arm, Linux, Windows, etc.)

===Requirements===
*Based on the SDR-J code
*Use of C++11 to use the threading feature
*Multicore support
*cmake as build environment

===Architecture===
[[File:DAB_Receiver_Concept.png|800px]]
{| class="wikitable"
|-
! Library Name
! Purpose
|-
| libsdrsource
|
Interface to different SDR devices
|-
| libdabdemod
|
*OFDM demodulation
*Frequency synchronization
*Time synchronization
*Output of the digital DAB stream
|-
|libdabdecode
|
*DAB and DAB+ frame decoding (FIC, Superframes etc.)
*CRC correction
*Output of MPEG or ACC stream
|-
| End user program
|
*Place holder for GUIs
*There can be a QT GUI, a GTK GUI or a Kodi plugin
|}

===API description===
*TBD

===To be discussed===
*Naming of libraries
*APIs

===GUI Wishlist===
*Easy to use
*Channel scan
*High DPI support
*libnotify support

==Existing open DAB/DAB+/T-DMB software receiver==
[[Image:Phon3b small.jpg|100px|right]]

===Software Defined DAB Receiver (complete software receiver)===
*[http://www.sdr-j.tk/index.html SDR-J] (running on Linux and Windows, using RTL2832 based USB sticks)
*[http://www.zsn.zhaw.ch/de/engineering/zsn/projekte/gnu-radio.html DAB receiver for gnuradio] (by Zurich School of Engineering, documentation in German)

===Software defined DAB receiver (up to logical layer)===
*[[Gnuradio DAB constellation using gr-dab and USRP]]
*[https://github.com/andrmuel/gr-dab Gnuradio blocks for DAB reception] (developments from Andreas Mueller, ETHZ)
**[http://www.0x7.ch/text/dab-report.pdf Documentation] any other information on http://www.0x7.ch/text/#index3h2
*[https://www.cgran.org/browser/projects/dabp/trunk Under construction gnuradio project on DAB+ reception on CGRAN]

===Software defined DAB receiver (from logical layer up to application layer)===
====Openmokast====

Open Receiver project from CRC using RDI streams from DAB baseband receivers/decoders.
*http://www.openmokast.org

Receiver for the Psion Wavefinder
*[http://sourceforge.net/projects/opendab/ OpenDAB]

File:DAB Receiver Concept.png

2016-02-04T18:13:45Z

Albrechtl: Library concept of a DAB receiver

Library concept of a DAB receiver