195 lines · c
1/* SPDX-License-Identifier: GPL-2.0-or-later */2/* cx25840 internal API header3 *4 * Copyright (C) 2003-2004 Chris Kennedy5 */6 7#ifndef _CX25840_CORE_H_8#define _CX25840_CORE_H_9 10#include <linux/videodev2.h>11#include <media/v4l2-device.h>12#include <media/v4l2-ctrls.h>13#include <linux/i2c.h>14 15struct cx25840_ir_state;16 17enum cx25840_model {18 CX23885_AV,19 CX23887_AV,20 CX23888_AV,21 CX2310X_AV,22 CX25840,23 CX25841,24 CX25842,25 CX25843,26 CX25836,27 CX25837,28};29 30enum cx25840_media_pads {31 CX25840_PAD_INPUT,32 CX25840_PAD_VID_OUT,33 34 CX25840_NUM_PADS35};36 37/**38 * struct cx25840_state - a device instance private data39 * @c: i2c_client struct representing this device40 * @sd: our V4L2 sub-device41 * @hdl: our V4L2 control handler42 * @volume: audio volume V4L2 control (non-cx2583x devices only)43 * @mute: audio mute V4L2 control (non-cx2583x devices only)44 * @pvr150_workaround: whether we enable workaround for Hauppauge PVR15045 * hardware bug (audio dropping out)46 * @generic_mode: whether we disable ivtv-specific hacks47 * this mode gets turned on when the bridge driver calls48 * cx25840 subdevice init core op49 * @radio: set if we are currently in the radio mode, otherwise50 * the current mode is non-radio (that is, video)51 * @std: currently set video standard52 * @vid_input: currently set video input53 * @vid_config: currently set video output configuration54 * only used in the generic mode55 * @aud_input: currently set audio input56 * @audclk_freq: currently set audio sample rate57 * @audmode: currently set audio mode (when in non-radio mode)58 * @vbi_line_offset: vbi line number offset59 * @id: exact device model60 * @rev: raw device id read from the chip61 * @is_initialized: whether we have already loaded firmware into the chip62 * and initialized it63 * @vbi_regs_offset: offset of vbi regs64 * @fw_wait: wait queue to wake an initialization function up when65 * firmware loading (on a separate workqueue) finishes66 * @fw_work: a work that actually loads the firmware on a separate67 * workqueue68 * @ir_state: a pointer to chip IR controller private data69 * @pads: array of supported chip pads (currently only a stub)70 */71struct cx25840_state {72 struct i2c_client *c;73 struct v4l2_subdev sd;74 struct v4l2_ctrl_handler hdl;75 struct {76 /* volume cluster */77 struct v4l2_ctrl *volume;78 struct v4l2_ctrl *mute;79 };80 int pvr150_workaround;81 bool generic_mode;82 int radio;83 v4l2_std_id std;84 enum cx25840_video_input vid_input;85 u32 vid_config;86 enum cx25840_audio_input aud_input;87 u32 audclk_freq;88 int audmode;89 int vbi_line_offset;90 enum cx25840_model id;91 u32 rev;92 int is_initialized;93 unsigned int vbi_regs_offset;94 wait_queue_head_t fw_wait;95 struct work_struct fw_work;96 struct cx25840_ir_state *ir_state;97#if defined(CONFIG_MEDIA_CONTROLLER)98 struct media_pad pads[CX25840_NUM_PADS];99#endif100};101 102static inline struct cx25840_state *to_state(struct v4l2_subdev *sd)103{104 return container_of(sd, struct cx25840_state, sd);105}106 107static inline struct v4l2_subdev *to_sd(struct v4l2_ctrl *ctrl)108{109 return &container_of(ctrl->handler, struct cx25840_state, hdl)->sd;110}111 112static inline bool is_cx2583x(struct cx25840_state *state)113{114 return state->id == CX25836 ||115 state->id == CX25837;116}117 118static inline bool is_cx2584x(struct cx25840_state *state)119{120 return state->id == CX25840 ||121 state->id == CX25841 ||122 state->id == CX25842 ||123 state->id == CX25843;124}125 126static inline bool is_cx231xx(struct cx25840_state *state)127{128 return state->id == CX2310X_AV;129}130 131static inline bool is_cx2388x(struct cx25840_state *state)132{133 return state->id == CX23885_AV ||134 state->id == CX23887_AV ||135 state->id == CX23888_AV;136}137 138static inline bool is_cx23885(struct cx25840_state *state)139{140 return state->id == CX23885_AV;141}142 143static inline bool is_cx23887(struct cx25840_state *state)144{145 return state->id == CX23887_AV;146}147 148static inline bool is_cx23888(struct cx25840_state *state)149{150 return state->id == CX23888_AV;151}152 153/* ----------------------------------------------------------------------- */154/* cx25850-core.c */155int cx25840_write(struct i2c_client *client, u16 addr, u8 value);156int cx25840_write4(struct i2c_client *client, u16 addr, u32 value);157u8 cx25840_read(struct i2c_client *client, u16 addr);158u32 cx25840_read4(struct i2c_client *client, u16 addr);159int cx25840_and_or(struct i2c_client *client, u16 addr, unsigned int mask,160 u8 value);161int cx25840_and_or4(struct i2c_client *client, u16 addr, u32 and_mask,162 u32 or_value);163void cx25840_std_setup(struct i2c_client *client);164 165/* ----------------------------------------------------------------------- */166/* cx25850-firmware.c */167int cx25840_loadfw(struct i2c_client *client);168 169/* ----------------------------------------------------------------------- */170/* cx25850-audio.c */171void cx25840_audio_set_path(struct i2c_client *client);172int cx25840_s_clock_freq(struct v4l2_subdev *sd, u32 freq);173 174extern const struct v4l2_ctrl_ops cx25840_audio_ctrl_ops;175 176/* ----------------------------------------------------------------------- */177/* cx25850-vbi.c */178int cx25840_s_raw_fmt(struct v4l2_subdev *sd, struct v4l2_vbi_format *fmt);179int cx25840_s_sliced_fmt(struct v4l2_subdev *sd,180 struct v4l2_sliced_vbi_format *fmt);181int cx25840_g_sliced_fmt(struct v4l2_subdev *sd,182 struct v4l2_sliced_vbi_format *fmt);183int cx25840_decode_vbi_line(struct v4l2_subdev *sd,184 struct v4l2_decode_vbi_line *vbi);185 186/* ----------------------------------------------------------------------- */187/* cx25850-ir.c */188extern const struct v4l2_subdev_ir_ops cx25840_ir_ops;189int cx25840_ir_log_status(struct v4l2_subdev *sd);190int cx25840_ir_irq_handler(struct v4l2_subdev *sd, u32 status, bool *handled);191int cx25840_ir_probe(struct v4l2_subdev *sd);192int cx25840_ir_remove(struct v4l2_subdev *sd);193 194#endif195