* Copyright (c) 2005 Marcus Overhagen <marcus@overhagen.de>
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without restriction,
* including without limitation the rights to use, copy, modify,
* merge, publish, distribute, sublicense, and/or sell copies of
* the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*/
* it is not final, and will be changed before a public release
* is made of the DVB framework (media add-on and example player).
*
* The driver should publish in /dev/dvb/cardname/n (with n=1..).
* It must implement the ioctl codes from dvb_ioctl_t.
* The driver must have buffers readable by userspace, it
* should directly use DMA buffers for that.
* The DVB add-on expects DVB_CAPTURE to block until data is
* available, or a timeout has expired. If the timeout expired,
* it must return B_TIMED_OUT. This ensures that the driver
* doesn't block when reception conditions are going bad, and
* allows user space programs to recognize this.
* If the ioctl succeeds, the driver must record the capture end time
* and report the data pointer and size. The data must stay valid
* for a few ms, to give the user space thread, running at realtime
* priority, a chance to read it. The driver must do at least
* double buffering to achieve this.
* For DVB-T, two buffers of 61 kByte give about 16 ms validity period
* for each buffer, thats enough. A 100 ms timout is used, to ensure
* that DVB_CAPTURE doesn't block when no data is available.
*
* A normal ioctl sequence is:
* - DVB_GET_INTERFACE_INFO
* - DVB_SET_TUNING_PARAMETERS
* - DVB_GET_STATUS
* - DVB_START_CAPTURE
* - DVB_CAPTURE (repeated)
* - DVB_STOP_CAPTURE
*
* The following ioctls can be called at any time,
* including when capture is active:
* - DVB_GET_INTERFACE_INFO
* - DVB_GET_FREQUENCY_INFO
* - DVB_GET_TUNING_PARAMETERS
* - DVB_GET_STATUS
* - DVB_GET_SS
* - DVB_GET_BER
* - DVB_GET_SNR
* - DVB_GET_UPC
*
* In future releases, other ioctls that are not yet defined may
* be called. It's important that the driver does not crash, but
* instead returnes an error code.
*
* Parameter reference for ioctl() functions:
*
* opcode | parameter | description
* --------------------------+-------------------------+-----------------------------------------
* DVB_GET_INTERFACE_INFO | dvb_interface_info_t | get interface capabilites (memset to 0 first)
* DVB_GET_FREQUENCY_INFO | dvb_frequency_info_t | get interface capabilites (memset to 0 first)
* DVB_SET_TUNING_PARAMETERS | dvb_tuning_parameters_t | perform tuning information
* DVB_GET_TUNING_PARAMETERS | dvb_tuning_parameters_t | get active parameters (after autotuning) (memset to 0 first)
* DVB_START_CAPTURE | (none) | start the capture
* DVB_STOP_CAPTURE | (none) | stop the capture
* DVB_GET_STATUS | dvb_status_t | get current status
* DVB_GET_SS | uint32 | signal strength, range 0 to 1000
* DVB_GET_BER | uint32 | block error rate, range 0 to 1000
* DVB_GET_SNR | uint32 | signal noise ratio, range 0 to 1000
* DVB_GET_UPC | uint32 | XXX ???, range 0 to 1000
* DVB_CAPTURE | dvb_capture_t | get information about captured data
*
*/
#ifndef __DVB_H
#define __DVB_H
#include <Drivers.h>
typedef enum {
DVB_TYPE_UNKNOWN = -1,
DVB_TYPE_DVB_C = 0x10,
DVB_TYPE_DVB_H = 0x20,
DVB_TYPE_DVB_S = 0x30,
DVB_TYPE_DVB_T = 0x40,
} dvb_type_t;
typedef enum {
DVB_BANDWIDTH_AUTO = 0,
DVB_BANDWIDTH_5_MHZ = 5000,
DVB_BANDWIDTH_6_MHZ = 6000,
DVB_BANDWIDTH_7_MHZ = 7000,
DVB_BANDWIDTH_8_MHZ = 8000,
} dvb_bandwidth_t;
typedef enum {
DVB_POLARITY_UNKNOWN = -1,
DVB_POLARITY_VERTICAL = 1,
DVB_POLARITY_HORIZONTAL = 2,
} dvb_polarity_t;
typedef enum {
DVB_MODULATION_AUTO,
DVB_MODULATION_QPSK,
DVB_MODULATION_16_QAM,
DVB_MODULATION_32_QAM,
DVB_MODULATION_64_QAM,
DVB_MODULATION_128_QAM,
DVB_MODULATION_256_QAM,
} dvb_modulation_t;
typedef enum {
DVB_TRANSMISSION_MODE_AUTO,
DVB_TRANSMISSION_MODE_2K,
DVB_TRANSMISSION_MODE_4K,
DVB_TRANSMISSION_MODE_8K,
} dvb_transmission_mode_t;
typedef enum {
DVB_FEC_AUTO,
DVB_FEC_NONE,
DVB_FEC_1_2,
DVB_FEC_2_3,
DVB_FEC_3_4,
DVB_FEC_4_5,
DVB_FEC_5_6,
DVB_FEC_6_7,
DVB_FEC_7_8,
DVB_FEC_8_9,
} dvb_code_rate_t;
typedef enum {
DVB_GUARD_INTERVAL_AUTO,
DVB_GUARD_INTERVAL_1_4,
DVB_GUARD_INTERVAL_1_8,
DVB_GUARD_INTERVAL_1_16,
DVB_GUARD_INTERVAL_1_32,
} dvb_guard_interval_t;
typedef enum {
DVB_HIERARCHY_AUTO,
DVB_HIERARCHY_NONE,
DVB_HIERARCHY_1,
DVB_HIERARCHY_2,
DVB_HIERARCHY_4,
} dvb_hierarchy_t;
typedef enum {
DVB_INVERSION_AUTO,
DVB_INVERSION_ON,
DVB_INVERSION_OFF,
} dvb_inversion_t;
typedef enum {
DVB_STATUS_SIGNAL = 0x0001,
DVB_STATUS_CARRIER = 0x0002,
DVB_STATUS_LOCK = 0x0004,
DVB_STATUS_VITERBI = 0x0008,
DVB_STATUS_SYNC = 0x0010,
} dvb_status_t;
typedef enum {
DVB_GET_INTERFACE_INFO = (B_DEVICE_OP_CODES_END + 0x100),
DVB_GET_FREQUENCY_INFO = (B_DEVICE_OP_CODES_END + 0x120),
DVB_SET_TUNING_PARAMETERS,
DVB_GET_TUNING_PARAMETERS,
DVB_START_CAPTURE,
DVB_STOP_CAPTURE,
DVB_GET_STATUS,
DVB_GET_SS,
DVB_GET_BER,
DVB_GET_SNR,
DVB_GET_UPC,
DVB_CAPTURE,
} dvb_ioctl_t;
typedef struct {
uint32 version;
uint32 flags;
dvb_type_t type;
uint32 _res1[16];
char name[100];
char info[500];
uint32 _res2[16];
} dvb_interface_info_t;
typedef struct {
uint32 _res1[16];
uint64 frequency_min;
uint64 frequency_max;
uint64 frequency_step;
uint32 _res2[64];
} dvb_frequency_info_t;
typedef struct {
uint64 frequency;
dvb_inversion_t inversion;
dvb_bandwidth_t bandwidth;
dvb_modulation_t modulation;
dvb_hierarchy_t hierarchy;
dvb_code_rate_t code_rate_hp;
dvb_code_rate_t code_rate_lp;
dvb_transmission_mode_t transmission_mode;
dvb_guard_interval_t guard_interval;
} dvb_t_tuning_parameters_t;
typedef struct {
uint64 frequency;
dvb_inversion_t inversion;
dvb_modulation_t modulation;
uint32 symbolrate;
dvb_polarity_t polarity;
} dvb_s_tuning_parameters_t;
typedef struct {
union {
dvb_t_tuning_parameters_t dvb_t;
dvb_s_tuning_parameters_t dvb_s;
uint32 _pad[32];
} u;
} dvb_tuning_parameters_t;
typedef struct {
void * data;
size_t size;
bigtime_t end_time;
uint32 _res[2];
} dvb_capture_t;
#endif
