312 lines
11 KiB
C
312 lines
11 KiB
C
/*
|
|
*
|
|
* $Id$
|
|
*
|
|
* Copyright (C) 2005 Mike Isely <isely@pobox.com>
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
*
|
|
*/
|
|
#ifndef __PVRUSB2_HDW_H
|
|
#define __PVRUSB2_HDW_H
|
|
|
|
#include <linux/usb.h>
|
|
#include <linux/videodev2.h>
|
|
#include "pvrusb2-io.h"
|
|
#include "pvrusb2-ctrl.h"
|
|
|
|
|
|
/* Private internal control ids, look these up with
|
|
pvr2_hdw_get_ctrl_by_id() - these are NOT visible in V4L */
|
|
#define PVR2_CID_STDENUM 1
|
|
#define PVR2_CID_STDCUR 2
|
|
#define PVR2_CID_STDAVAIL 3
|
|
#define PVR2_CID_INPUT 4
|
|
#define PVR2_CID_AUDIOMODE 5
|
|
#define PVR2_CID_FREQUENCY 6
|
|
#define PVR2_CID_HRES 7
|
|
#define PVR2_CID_VRES 8
|
|
|
|
/* Legal values for the INPUT state variable */
|
|
#define PVR2_CVAL_INPUT_TV 0
|
|
#define PVR2_CVAL_INPUT_SVIDEO 1
|
|
#define PVR2_CVAL_INPUT_COMPOSITE 2
|
|
#define PVR2_CVAL_INPUT_RADIO 3
|
|
|
|
/* Values that pvr2_hdw_get_signal_status() returns */
|
|
#define PVR2_SIGNAL_OK 0x0001
|
|
#define PVR2_SIGNAL_STEREO 0x0002
|
|
#define PVR2_SIGNAL_SAP 0x0004
|
|
|
|
|
|
/* Subsystem definitions - these are various pieces that can be
|
|
independently stopped / started. Usually you don't want to mess with
|
|
this directly (let the driver handle things itself), but it is useful
|
|
for debugging. */
|
|
#define PVR2_SUBSYS_B_ENC_FIRMWARE 0
|
|
#define PVR2_SUBSYS_B_ENC_CFG 1
|
|
#define PVR2_SUBSYS_B_DIGITIZER_RUN 2
|
|
#define PVR2_SUBSYS_B_USBSTREAM_RUN 3
|
|
#define PVR2_SUBSYS_B_ENC_RUN 4
|
|
|
|
#define PVR2_SUBSYS_CFG_ALL ( \
|
|
(1 << PVR2_SUBSYS_B_ENC_FIRMWARE) | \
|
|
(1 << PVR2_SUBSYS_B_ENC_CFG) )
|
|
#define PVR2_SUBSYS_RUN_ALL ( \
|
|
(1 << PVR2_SUBSYS_B_DIGITIZER_RUN) | \
|
|
(1 << PVR2_SUBSYS_B_USBSTREAM_RUN) | \
|
|
(1 << PVR2_SUBSYS_B_ENC_RUN) )
|
|
#define PVR2_SUBSYS_ALL ( \
|
|
PVR2_SUBSYS_CFG_ALL | \
|
|
PVR2_SUBSYS_RUN_ALL )
|
|
|
|
enum pvr2_config {
|
|
pvr2_config_empty,
|
|
pvr2_config_mpeg,
|
|
pvr2_config_vbi,
|
|
pvr2_config_radio,
|
|
};
|
|
|
|
const char *pvr2_config_get_name(enum pvr2_config);
|
|
|
|
struct pvr2_hdw;
|
|
|
|
/* Create and return a structure for interacting with the underlying
|
|
hardware */
|
|
struct pvr2_hdw *pvr2_hdw_create(struct usb_interface *intf,
|
|
const struct usb_device_id *devid);
|
|
|
|
/* Poll for background activity (if any) */
|
|
void pvr2_hdw_poll(struct pvr2_hdw *);
|
|
|
|
/* Trigger a poll to take place later at a convenient time */
|
|
void pvr2_hdw_poll_trigger_unlocked(struct pvr2_hdw *);
|
|
|
|
/* Register a callback used to trigger a future poll */
|
|
void pvr2_hdw_setup_poll_trigger(struct pvr2_hdw *,
|
|
void (*func)(void *),
|
|
void *data);
|
|
|
|
/* Destroy hardware interaction structure */
|
|
void pvr2_hdw_destroy(struct pvr2_hdw *);
|
|
|
|
/* Set up the structure and attempt to put the device into a usable state.
|
|
This can be a time-consuming operation, which is why it is not done
|
|
internally as part of the create() step. Return value is exactly the
|
|
same as pvr2_hdw_init_ok(). */
|
|
int pvr2_hdw_setup(struct pvr2_hdw *);
|
|
|
|
/* Initialization succeeded */
|
|
int pvr2_hdw_init_ok(struct pvr2_hdw *);
|
|
|
|
/* Return true if in the ready (normal) state */
|
|
int pvr2_hdw_dev_ok(struct pvr2_hdw *);
|
|
|
|
/* Return small integer number [1..N] for logical instance number of this
|
|
device. This is useful for indexing array-valued module parameters. */
|
|
int pvr2_hdw_get_unit_number(struct pvr2_hdw *);
|
|
|
|
/* Get pointer to underlying USB device */
|
|
struct usb_device *pvr2_hdw_get_dev(struct pvr2_hdw *);
|
|
|
|
/* Retrieve serial number of device */
|
|
unsigned long pvr2_hdw_get_sn(struct pvr2_hdw *);
|
|
|
|
/* Called when hardware has been unplugged */
|
|
void pvr2_hdw_disconnect(struct pvr2_hdw *);
|
|
|
|
/* Get the number of defined controls */
|
|
unsigned int pvr2_hdw_get_ctrl_count(struct pvr2_hdw *);
|
|
|
|
/* Retrieve a control handle given its index (0..count-1) */
|
|
struct pvr2_ctrl *pvr2_hdw_get_ctrl_by_index(struct pvr2_hdw *,unsigned int);
|
|
|
|
/* Retrieve a control handle given its internal ID (if any) */
|
|
struct pvr2_ctrl *pvr2_hdw_get_ctrl_by_id(struct pvr2_hdw *,unsigned int);
|
|
|
|
/* Retrieve a control handle given its V4L ID (if any) */
|
|
struct pvr2_ctrl *pvr2_hdw_get_ctrl_v4l(struct pvr2_hdw *,unsigned int ctl_id);
|
|
|
|
/* Retrieve a control handle given its immediate predecessor V4L ID (if any) */
|
|
struct pvr2_ctrl *pvr2_hdw_get_ctrl_nextv4l(struct pvr2_hdw *,
|
|
unsigned int ctl_id);
|
|
|
|
/* Commit all control changes made up to this point */
|
|
int pvr2_hdw_commit_ctl(struct pvr2_hdw *);
|
|
|
|
/* Return name for this driver instance */
|
|
const char *pvr2_hdw_get_driver_name(struct pvr2_hdw *);
|
|
|
|
/* Return PVR2_SIGNAL_XXXX bit mask indicating signal status */
|
|
unsigned int pvr2_hdw_get_signal_status(struct pvr2_hdw *);
|
|
|
|
/* Query device and see if it thinks it is on a high-speed USB link */
|
|
int pvr2_hdw_is_hsm(struct pvr2_hdw *);
|
|
|
|
/* Turn streaming on/off */
|
|
int pvr2_hdw_set_streaming(struct pvr2_hdw *,int);
|
|
|
|
/* Find out if streaming is on */
|
|
int pvr2_hdw_get_streaming(struct pvr2_hdw *);
|
|
|
|
/* Configure the type of stream to generate */
|
|
int pvr2_hdw_set_stream_type(struct pvr2_hdw *, enum pvr2_config);
|
|
|
|
/* Get handle to video output stream */
|
|
struct pvr2_stream *pvr2_hdw_get_video_stream(struct pvr2_hdw *);
|
|
|
|
/* Emit a video standard struct */
|
|
int pvr2_hdw_get_stdenum_value(struct pvr2_hdw *hdw,struct v4l2_standard *std,
|
|
unsigned int idx);
|
|
|
|
/* Enable / disable various pieces of hardware. Items to change are
|
|
identified by bit positions within msk, and new state for each item is
|
|
identified by corresponding bit positions within val. */
|
|
void pvr2_hdw_subsys_bit_chg(struct pvr2_hdw *hdw,
|
|
unsigned long msk,unsigned long val);
|
|
|
|
/* Retrieve mask indicating which pieces of hardware are currently enabled
|
|
/ configured. */
|
|
unsigned long pvr2_hdw_subsys_get(struct pvr2_hdw *);
|
|
|
|
/* Adjust mask of what get shut down when streaming is stopped. This is a
|
|
debugging aid. */
|
|
void pvr2_hdw_subsys_stream_bit_chg(struct pvr2_hdw *hdw,
|
|
unsigned long msk,unsigned long val);
|
|
|
|
/* Retrieve mask indicating which pieces of hardware are disabled when
|
|
streaming is turned off. */
|
|
unsigned long pvr2_hdw_subsys_stream_get(struct pvr2_hdw *);
|
|
|
|
|
|
/* Enable / disable retrieval of CPU firmware. This must be enabled before
|
|
pvr2_hdw_cpufw_get() will function. Note that doing this may prevent
|
|
the device from running (and leaving this mode may imply a device
|
|
reset). */
|
|
void pvr2_hdw_cpufw_set_enabled(struct pvr2_hdw *, int enable_flag);
|
|
|
|
/* Return true if we're in a mode for retrieval CPU firmware */
|
|
int pvr2_hdw_cpufw_get_enabled(struct pvr2_hdw *);
|
|
|
|
/* Retrieve a piece of the CPU's firmware at the given offset. Return
|
|
value is the number of bytes retrieved or zero if we're past the end or
|
|
an error otherwise (e.g. if firmware retrieval is not enabled). */
|
|
int pvr2_hdw_cpufw_get(struct pvr2_hdw *,unsigned int offs,
|
|
char *buf,unsigned int cnt);
|
|
|
|
/* Retrieve previously stored v4l minor device number */
|
|
int pvr2_hdw_v4l_get_minor_number(struct pvr2_hdw *);
|
|
|
|
/* Store the v4l minor device number */
|
|
void pvr2_hdw_v4l_store_minor_number(struct pvr2_hdw *,int);
|
|
|
|
/* Direct read/write access to chip's registers:
|
|
chip_id - unique id of chip (e.g. I2C_DRIVERD_xxxx)
|
|
reg_id - register number to access
|
|
setFl - true to set the register, false to read it
|
|
val_ptr - storage location for source / result. */
|
|
int pvr2_hdw_register_access(struct pvr2_hdw *,
|
|
u32 chip_id,unsigned long reg_id,
|
|
int setFl,u32 *val_ptr);
|
|
|
|
/* The following entry points are all lower level things you normally don't
|
|
want to worry about. */
|
|
|
|
/* Issue a command and get a response from the device. LOTS of higher
|
|
level stuff is built on this. */
|
|
int pvr2_send_request(struct pvr2_hdw *,
|
|
void *write_ptr,unsigned int write_len,
|
|
void *read_ptr,unsigned int read_len);
|
|
|
|
/* Slightly higher level device communication functions. */
|
|
int pvr2_write_register(struct pvr2_hdw *, u16, u32);
|
|
|
|
/* Call if for any reason we can't talk to the hardware anymore - this will
|
|
cause the driver to stop flailing on the device. */
|
|
void pvr2_hdw_render_useless(struct pvr2_hdw *);
|
|
|
|
/* Set / clear 8051's reset bit */
|
|
void pvr2_hdw_cpureset_assert(struct pvr2_hdw *,int);
|
|
|
|
/* Execute a USB-commanded device reset */
|
|
void pvr2_hdw_device_reset(struct pvr2_hdw *);
|
|
|
|
/* Execute hard reset command (after this point it's likely that the
|
|
encoder will have to be reconfigured). This also clears the "useless"
|
|
state. */
|
|
int pvr2_hdw_cmd_deep_reset(struct pvr2_hdw *);
|
|
|
|
/* Execute simple reset command */
|
|
int pvr2_hdw_cmd_powerup(struct pvr2_hdw *);
|
|
|
|
/* Order decoder to reset */
|
|
int pvr2_hdw_cmd_decoder_reset(struct pvr2_hdw *);
|
|
|
|
/* Direct manipulation of GPIO bits */
|
|
int pvr2_hdw_gpio_get_dir(struct pvr2_hdw *hdw,u32 *);
|
|
int pvr2_hdw_gpio_get_out(struct pvr2_hdw *hdw,u32 *);
|
|
int pvr2_hdw_gpio_get_in(struct pvr2_hdw *hdw,u32 *);
|
|
int pvr2_hdw_gpio_chg_dir(struct pvr2_hdw *hdw,u32 msk,u32 val);
|
|
int pvr2_hdw_gpio_chg_out(struct pvr2_hdw *hdw,u32 msk,u32 val);
|
|
|
|
/* This data structure is specifically for the next function... */
|
|
struct pvr2_hdw_debug_info {
|
|
int big_lock_held;
|
|
int ctl_lock_held;
|
|
int flag_ok;
|
|
int flag_disconnected;
|
|
int flag_init_ok;
|
|
int flag_streaming_enabled;
|
|
unsigned long subsys_flags;
|
|
int cmd_debug_state;
|
|
int cmd_debug_write_len;
|
|
int cmd_debug_read_len;
|
|
int cmd_debug_write_pend;
|
|
int cmd_debug_read_pend;
|
|
int cmd_debug_timeout;
|
|
int cmd_debug_rstatus;
|
|
int cmd_debug_wstatus;
|
|
unsigned char cmd_code;
|
|
};
|
|
|
|
/* Non-intrusively retrieve internal state info - this is useful for
|
|
diagnosing lockups. Note that this operation is completed without any
|
|
kind of locking and so it is not atomic and may yield inconsistent
|
|
results. This is *purely* a debugging aid. */
|
|
void pvr2_hdw_get_debug_info(const struct pvr2_hdw *hdw,
|
|
struct pvr2_hdw_debug_info *);
|
|
|
|
/* Cause modules to log their state once */
|
|
void pvr2_hdw_trigger_module_log(struct pvr2_hdw *hdw);
|
|
|
|
/* Cause encoder firmware to be uploaded into the device. This is normally
|
|
done autonomously, but the interface is exported here because it is also
|
|
a debugging aid. */
|
|
int pvr2_upload_firmware2(struct pvr2_hdw *hdw);
|
|
|
|
/* List of device types that we can match */
|
|
extern struct usb_device_id pvr2_device_table[];
|
|
|
|
#endif /* __PVRUSB2_HDW_H */
|
|
|
|
/*
|
|
Stuff for Emacs to see, in order to encourage consistent editing style:
|
|
*** Local Variables: ***
|
|
*** mode: c ***
|
|
*** fill-column: 75 ***
|
|
*** tab-width: 8 ***
|
|
*** c-basic-offset: 8 ***
|
|
*** End: ***
|
|
*/
|