3.4. Digital TV Conditional Access kABI

struct dvb_ca_en50221

Structure describing a CA interface

Definition:

struct dvb_ca_en50221 {
    struct module *owner;
    int (*read_attribute_mem)(struct dvb_ca_en50221 *ca, int slot, int address);
    int (*write_attribute_mem)(struct dvb_ca_en50221 *ca, int slot, int address, u8 value);
    int (*read_cam_control)(struct dvb_ca_en50221 *ca, int slot, u8 address);
    int (*write_cam_control)(struct dvb_ca_en50221 *ca, int slot, u8 address, u8 value);
    int (*read_data)(struct dvb_ca_en50221 *ca, int slot, u8 *ebuf, int ecount);
    int (*write_data)(struct dvb_ca_en50221 *ca, int slot, u8 *ebuf, int ecount);
    int (*slot_reset)(struct dvb_ca_en50221 *ca, int slot);
    int (*slot_shutdown)(struct dvb_ca_en50221 *ca, int slot);
    int (*slot_ts_enable)(struct dvb_ca_en50221 *ca, int slot);
    int (*poll_slot_status)(struct dvb_ca_en50221 *ca, int slot, int open);
    void *data;
    void *private;
};

Members

owner

the module owning this structure

read_attribute_mem

function for reading attribute memory on the CAM

write_attribute_mem

function for writing attribute memory on the CAM

read_cam_control

function for reading the control interface on the CAM

write_cam_control

function for reading the control interface on the CAM

read_data

function for reading data (block mode)

write_data

function for writing data (block mode)

slot_reset

function to reset the CAM slot

slot_shutdown

function to shutdown a CAM slot

slot_ts_enable

function to enable the Transport Stream on a CAM slot

poll_slot_status

function to poll slot status. Only necessary if DVB_CA_FLAG_EN50221_IRQ_CAMCHANGE is not set.

data

private data, used by caller.

private

Opaque data used by the dvb_ca core. Do not modify!

NOTE

the read_*, write_* and poll_slot_status functions will be called for different slots concurrently and need to use locks where and if appropriate. There will be no concurrent access to one slot.

void dvb_ca_en50221_camchange_irq(struct dvb_ca_en50221 *pubca, int slot, int change_type)

A CAMCHANGE IRQ has occurred.

Parameters

struct dvb_ca_en50221 *pubca

CA instance.

int slot

Slot concerned.

int change_type

One of the DVB_CA_CAMCHANGE_* values

void dvb_ca_en50221_camready_irq(struct dvb_ca_en50221 *pubca, int slot)

A CAMREADY IRQ has occurred.

Parameters

struct dvb_ca_en50221 *pubca

CA instance.

int slot

Slot concerned.

void dvb_ca_en50221_frda_irq(struct dvb_ca_en50221 *ca, int slot)

An FR or a DA IRQ has occurred.

Parameters

struct dvb_ca_en50221 *ca

CA instance.

int slot

Slot concerned.

int dvb_ca_en50221_init(struct dvb_adapter *dvb_adapter, struct dvb_ca_en50221 *ca, int flags, int slot_count)

Initialise a new DVB CA device.

Parameters

struct dvb_adapter *dvb_adapter

DVB adapter to attach the new CA device to.

struct dvb_ca_en50221 *ca

The dvb_ca instance.

int flags

Flags describing the CA device (DVB_CA_EN50221_FLAG_*).

int slot_count

Number of slots supported.

Description

return 0 on success, nonzero on failure

void dvb_ca_en50221_release(struct dvb_ca_en50221 *ca)

Release a DVB CA device.

Parameters

struct dvb_ca_en50221 *ca

The associated dvb_ca instance.