3256cc1398
trivial edits of a few comments Signed-off-by: Stefan Richter <stefanr@s5r6.in-berlin.de> Signed-off-by: Ben Collins <bcollins@debian.org> Signed-off-by: Jody McIntyre <scjody@steamballoon.com> Signed-off-by: Andrew Morton <akpm@osdl.org> Signed-off-by: Linus Torvalds <torvalds@osdl.org>
216 lines
6.8 KiB
C
216 lines
6.8 KiB
C
#ifndef _IEEE1394_HOSTS_H
|
|
#define _IEEE1394_HOSTS_H
|
|
|
|
#include <linux/device.h>
|
|
#include <linux/wait.h>
|
|
#include <linux/list.h>
|
|
#include <linux/timer.h>
|
|
#include <linux/skbuff.h>
|
|
|
|
#include <asm/semaphore.h>
|
|
|
|
#include "ieee1394_types.h"
|
|
#include "csr.h"
|
|
|
|
|
|
struct hpsb_packet;
|
|
struct hpsb_iso;
|
|
|
|
struct hpsb_host {
|
|
struct list_head host_list;
|
|
|
|
void *hostdata;
|
|
|
|
atomic_t generation;
|
|
|
|
struct sk_buff_head pending_packet_queue;
|
|
|
|
struct timer_list timeout;
|
|
unsigned long timeout_interval;
|
|
|
|
unsigned char iso_listen_count[64];
|
|
|
|
int node_count; /* number of identified nodes on this bus */
|
|
int selfid_count; /* total number of SelfIDs received */
|
|
int nodes_active; /* number of nodes that are actually active */
|
|
|
|
nodeid_t node_id; /* node ID of this host */
|
|
nodeid_t irm_id; /* ID of this bus' isochronous resource manager */
|
|
nodeid_t busmgr_id; /* ID of this bus' bus manager */
|
|
|
|
/* this nodes state */
|
|
unsigned in_bus_reset:1;
|
|
unsigned is_shutdown:1;
|
|
|
|
/* this nodes' duties on the bus */
|
|
unsigned is_root:1;
|
|
unsigned is_cycmst:1;
|
|
unsigned is_irm:1;
|
|
unsigned is_busmgr:1;
|
|
|
|
int reset_retries;
|
|
quadlet_t *topology_map;
|
|
u8 *speed_map;
|
|
struct csr_control csr;
|
|
|
|
/* Per node tlabel pool allocation */
|
|
struct hpsb_tlabel_pool tpool[64];
|
|
|
|
struct hpsb_host_driver *driver;
|
|
|
|
struct pci_dev *pdev;
|
|
|
|
int id;
|
|
|
|
struct device device;
|
|
struct class_device class_dev;
|
|
|
|
int update_config_rom;
|
|
struct work_struct delayed_reset;
|
|
|
|
unsigned int config_roms;
|
|
|
|
struct list_head addr_space;
|
|
};
|
|
|
|
|
|
|
|
enum devctl_cmd {
|
|
/* Host is requested to reset its bus and cancel all outstanding async
|
|
* requests. If arg == 1, it shall also attempt to become root on the
|
|
* bus. Return void. */
|
|
RESET_BUS,
|
|
|
|
/* Arg is void, return value is the hardware cycle counter value. */
|
|
GET_CYCLE_COUNTER,
|
|
|
|
/* Set the hardware cycle counter to the value in arg, return void.
|
|
* FIXME - setting is probably not required. */
|
|
SET_CYCLE_COUNTER,
|
|
|
|
/* Configure hardware for new bus ID in arg, return void. */
|
|
SET_BUS_ID,
|
|
|
|
/* If arg true, start sending cycle start packets, stop if arg == 0.
|
|
* Return void. */
|
|
ACT_CYCLE_MASTER,
|
|
|
|
/* Cancel all outstanding async requests without resetting the bus.
|
|
* Return void. */
|
|
CANCEL_REQUESTS,
|
|
|
|
/* Start or stop receiving isochronous channel in arg. Return void.
|
|
* This acts as an optimization hint, hosts are not required not to
|
|
* listen on unrequested channels. */
|
|
ISO_LISTEN_CHANNEL,
|
|
ISO_UNLISTEN_CHANNEL
|
|
};
|
|
|
|
enum isoctl_cmd {
|
|
/* rawiso API - see iso.h for the meanings of these commands
|
|
(they correspond exactly to the hpsb_iso_* API functions)
|
|
* INIT = allocate resources
|
|
* START = begin transmission/reception
|
|
* STOP = halt transmission/reception
|
|
* QUEUE/RELEASE = produce/consume packets
|
|
* SHUTDOWN = deallocate resources
|
|
*/
|
|
|
|
XMIT_INIT,
|
|
XMIT_START,
|
|
XMIT_STOP,
|
|
XMIT_QUEUE,
|
|
XMIT_SHUTDOWN,
|
|
|
|
RECV_INIT,
|
|
RECV_LISTEN_CHANNEL, /* multi-channel only */
|
|
RECV_UNLISTEN_CHANNEL, /* multi-channel only */
|
|
RECV_SET_CHANNEL_MASK, /* multi-channel only; arg is a *u64 */
|
|
RECV_START,
|
|
RECV_STOP,
|
|
RECV_RELEASE,
|
|
RECV_SHUTDOWN,
|
|
RECV_FLUSH
|
|
};
|
|
|
|
enum reset_types {
|
|
/* 166 microsecond reset -- only type of reset available on
|
|
non-1394a capable controllers */
|
|
LONG_RESET,
|
|
|
|
/* Short (arbitrated) reset -- only available on 1394a capable
|
|
controllers */
|
|
SHORT_RESET,
|
|
|
|
/* Variants that set force_root before issueing the bus reset */
|
|
LONG_RESET_FORCE_ROOT, SHORT_RESET_FORCE_ROOT,
|
|
|
|
/* Variants that clear force_root before issueing the bus reset */
|
|
LONG_RESET_NO_FORCE_ROOT, SHORT_RESET_NO_FORCE_ROOT
|
|
};
|
|
|
|
struct hpsb_host_driver {
|
|
struct module *owner;
|
|
const char *name;
|
|
|
|
/* The hardware driver may optionally support a function that is used
|
|
* to set the hardware ConfigROM if the hardware supports handling
|
|
* reads to the ConfigROM on its own. */
|
|
void (*set_hw_config_rom) (struct hpsb_host *host, quadlet_t *config_rom);
|
|
|
|
/* This function shall implement packet transmission based on
|
|
* packet->type. It shall CRC both parts of the packet (unless
|
|
* packet->type == raw) and do byte-swapping as necessary or instruct
|
|
* the hardware to do so. It can return immediately after the packet
|
|
* was queued for sending. After sending, hpsb_sent_packet() has to be
|
|
* called. Return 0 on success, negative errno on failure.
|
|
* NOTE: The function must be callable in interrupt context.
|
|
*/
|
|
int (*transmit_packet) (struct hpsb_host *host,
|
|
struct hpsb_packet *packet);
|
|
|
|
/* This function requests miscellanous services from the driver, see
|
|
* above for command codes and expected actions. Return -1 for unknown
|
|
* command, though that should never happen.
|
|
*/
|
|
int (*devctl) (struct hpsb_host *host, enum devctl_cmd command, int arg);
|
|
|
|
/* ISO transmission/reception functions. Return 0 on success, -1
|
|
* (or -EXXX errno code) on failure. If the low-level driver does not
|
|
* support the new ISO API, set isoctl to NULL.
|
|
*/
|
|
int (*isoctl) (struct hpsb_iso *iso, enum isoctl_cmd command, unsigned long arg);
|
|
|
|
/* This function is mainly to redirect local CSR reads/locks to the iso
|
|
* management registers (bus manager id, bandwidth available, channels
|
|
* available) to the hardware registers in OHCI. reg is 0,1,2,3 for bus
|
|
* mgr, bwdth avail, ch avail hi, ch avail lo respectively (the same ids
|
|
* as OHCI uses). data and compare are the new data and expected data
|
|
* respectively, return value is the old value.
|
|
*/
|
|
quadlet_t (*hw_csr_reg) (struct hpsb_host *host, int reg,
|
|
quadlet_t data, quadlet_t compare);
|
|
};
|
|
|
|
|
|
struct hpsb_host *hpsb_alloc_host(struct hpsb_host_driver *drv, size_t extra,
|
|
struct device *dev);
|
|
int hpsb_add_host(struct hpsb_host *host);
|
|
void hpsb_remove_host(struct hpsb_host *h);
|
|
|
|
/* The following 2 functions are deprecated and will be removed when the
|
|
* raw1394/libraw1394 update is complete. */
|
|
int hpsb_update_config_rom(struct hpsb_host *host,
|
|
const quadlet_t *new_rom, size_t size, unsigned char rom_version);
|
|
int hpsb_get_config_rom(struct hpsb_host *host, quadlet_t *buffer,
|
|
size_t buffersize, size_t *rom_size, unsigned char *rom_version);
|
|
|
|
/* Updates the configuration rom image of a host. rom_version must be the
|
|
* current version, otherwise it will fail with return value -1. If this
|
|
* host does not support config-rom-update, it will return -EINVAL.
|
|
* Return value 0 indicates success.
|
|
*/
|
|
int hpsb_update_config_rom_image(struct hpsb_host *host);
|
|
|
|
#endif /* _IEEE1394_HOSTS_H */
|