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.