subdevice.h

Go to the documentation of this file.

#ifndef _COBALT_RTDM_ANALOGY_SUBDEVICE_H
#define _COBALT_RTDM_ANALOGY_SUBDEVICE_H

#include <linux/list.h>
#include <rtdm/analogy/instruction.h>
#include <rtdm/analogy/command.h>
#include <rtdm/analogy/channel_range.h>

/* --- Subdevice descriptor structure --- */

struct a4l_device;
struct a4l_buffer;

struct a4l_subdevice {

        struct list_head list;
        struct a4l_device *dev;
        unsigned int idx;
        struct a4l_buffer *buf;
        /* Subdevice's status (busy, linked?) */
        unsigned long status;
        /* Descriptors stuff */
        unsigned long flags;
        struct a4l_channels_desc *chan_desc;
        struct a4l_rngdesc *rng_desc;
        struct a4l_cmd_desc *cmd_mask;
        /* Functions stuff */
        int (*insn_read) (struct a4l_subdevice *, struct a4l_kernel_instruction *);
        int (*insn_write) (struct a4l_subdevice *, struct a4l_kernel_instruction *);
        int (*insn_bits) (struct a4l_subdevice *, struct a4l_kernel_instruction *);
        int (*insn_config) (struct a4l_subdevice *, struct a4l_kernel_instruction *);
        int (*do_cmd) (struct a4l_subdevice *, struct a4l_cmd_desc *);
        int (*do_cmdtest) (struct a4l_subdevice *, struct a4l_cmd_desc *);
        void (*cancel) (struct a4l_subdevice *);
        void (*munge) (struct a4l_subdevice *, void *, unsigned long);
        int (*trigger) (struct a4l_subdevice *, lsampl_t);
        char priv[0];
};

/* --- Subdevice related functions and macros --- */

struct a4l_channel *a4l_get_chfeat(struct a4l_subdevice * sb, int idx);
struct a4l_range *a4l_get_rngfeat(struct a4l_subdevice * sb, int chidx, int rngidx);
int a4l_check_chanlist(struct a4l_subdevice * subd,
                       unsigned char nb_chan, unsigned int *chans);

#define a4l_subd_is_input(x) ((A4L_SUBD_MASK_READ & (x)->flags) != 0)
/* The following macro considers that a DIO subdevice is firstly an
   output subdevice */
#define a4l_subd_is_output(x) \
        ((A4L_SUBD_MASK_WRITE & (x)->flags) != 0 || \
         (A4L_SUBD_DIO & (x)->flags) != 0)

/* --- Upper layer functions --- */

struct a4l_subdevice * a4l_get_subd(struct a4l_device *dev, int idx);
struct a4l_subdevice * a4l_alloc_subd(int sizeof_priv,
                            void (*setup)(struct a4l_subdevice *));
int a4l_add_subd(struct a4l_device *dev, struct a4l_subdevice * subd);
int a4l_ioctl_subdinfo(struct a4l_device_context * cxt, void *arg);
int a4l_ioctl_chaninfo(struct a4l_device_context * cxt, void *arg);
int a4l_ioctl_rnginfo(struct a4l_device_context * cxt, void *arg);
int a4l_ioctl_nbchaninfo(struct a4l_device_context * cxt, void *arg);
int a4l_ioctl_nbrnginfo(struct a4l_device_context * cxt, void *arg);

#endif /* !_COBALT_RTDM_ANALOGY_SUBDEVICE_H */