| #ifndef _IEEE1394_HOSTS_H |
| #define _IEEE1394_HOSTS_H |
| |
| #include <linux/device.h> |
| #include <linux/wait.h> |
| #include <linux/list.h> |
| #include <asm/semaphore.h> |
| |
| #include "ieee1394_types.h" |
| #include "csr.h" |
| |
| /* size of the array used to store config rom (in quadlets) |
| maximum is 0x100. About 0x40 is needed for the default |
| entries. So 0x80 should provide enough space for additional |
| directories etc. |
| Note: All lowlevel drivers are required to allocate at least |
| this amount of memory for the configuration rom! |
| */ |
| #define CSR_CONFIG_ROM_SIZE 0x100 |
| |
| struct hpsb_packet; |
| struct hpsb_iso; |
| |
| struct hpsb_host { |
| struct list_head host_list; |
| |
| void *hostdata; |
| |
| atomic_t generation; |
| |
| int refcount; |
| |
| struct list_head pending_packets; |
| spinlock_t pending_pkt_lock; |
| struct hpsb_queue_struct timeout_tq; |
| |
| 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; |
| |
| struct device device; |
| }; |
| |
| |
| |
| 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 |
| * 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, |
| }; |
| |
| enum reset_types { |
| /* 166 microsecond reset -- only type of reset available on |
| non-1394a capable IEEE 1394 controllers */ |
| LONG_RESET, |
| |
| /* Short (arbitrated) reset -- only available on 1394a capable |
| IEEE 1394 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; |
| |
| /* This function must store a pointer to the configuration ROM into the |
| * location referenced to by pointer and return the size of the ROM. It |
| * may not fail. If any allocation is required, it must be done |
| * earlier. |
| */ |
| size_t (*get_rom) (struct hpsb_host *host, quadlet_t **pointer); |
| |
| /* 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 for 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); |
| }; |
| |
| |
| extern struct list_head hpsb_hosts; |
| extern struct semaphore hpsb_hosts_lock; |
| |
| |
| /* |
| * In order to prevent hosts from unloading, use hpsb_ref_host(). This prevents |
| * the host from going away (e.g. makes module unloading of the driver |
| * impossible), but still can not guarantee it (e.g. PC-Card being pulled by the |
| * user). hpsb_ref_host() returns false if host could not be locked. If it is |
| * successful, host is valid as a pointer until hpsb_unref_host() (not just |
| * until after remove_host). |
| */ |
| int hpsb_ref_host(struct hpsb_host *host); |
| void hpsb_unref_host(struct hpsb_host *host); |
| |
| struct hpsb_host *hpsb_alloc_host(struct hpsb_host_driver *drv, size_t extra); |
| void hpsb_add_host(struct hpsb_host *host); |
| void hpsb_remove_host(struct hpsb_host *h); |
| |
| /* updates the configuration rom of a host. |
| * rom_version must be the current version, |
| * otherwise it will fail with return value -1. |
| * Return value -2 indicates that the new |
| * rom version is too big. |
| * Return value 0 indicates success |
| */ |
| int hpsb_update_config_rom(struct hpsb_host *host, |
| const quadlet_t *new_rom, size_t size, unsigned char rom_version); |
| |
| /* reads the current version of the configuration rom of a host. |
| * buffersize is the size of the buffer, rom_size |
| * returns the size of the current rom image. |
| * rom_version is the version number of the fetched rom. |
| * return value -1 indicates, that the buffer was |
| * too small, 0 indicates success. |
| */ |
| int hpsb_get_config_rom(struct hpsb_host *host, quadlet_t *buffer, |
| size_t buffersize, size_t *rom_size, unsigned char *rom_version); |
| |
| #endif /* _IEEE1394_HOSTS_H */ |