drivers/ieee1394/ieee1394_transactions.h

   1 #ifndef _IEEE1394_TRANSACTIONS_H
   2 #define _IEEE1394_TRANSACTIONS_H
   3
   4 #include <linux/types.h>
   5
   6 #include "ieee1394_types.h"
   7
   8 struct hpsb_packet;
   9 struct hpsb_host;
  10
  11 int hpsb_get_tlabel(struct hpsb_packet *packet);
  12 void hpsb_free_tlabel(struct hpsb_packet *packet);
  13 struct hpsb_packet *hpsb_make_readpacket(struct hpsb_host *host, nodeid_t node,
  14                                          u64 addr, size_t length);
  15 struct hpsb_packet *hpsb_make_lockpacket(struct hpsb_host *host, nodeid_t node,
  16                                          u64 addr, int extcode, quadlet_t *data,
  17                                          quadlet_t arg);
  18 struct hpsb_packet *hpsb_make_lock64packet(struct hpsb_host *host,
  19                                            nodeid_t node, u64 addr, int extcode,
  20                                            octlet_t *data, octlet_t arg);
  21 struct hpsb_packet *hpsb_make_phypacket(struct hpsb_host *host, quadlet_t data);
  22 struct hpsb_packet *hpsb_make_isopacket(struct hpsb_host *host, int length,
  23                                         int channel, int tag, int sync);
  24 struct hpsb_packet *hpsb_make_writepacket(struct hpsb_host *host,
  25                                           nodeid_t node, u64 addr,
  26                                           quadlet_t *buffer, size_t length);
  27 struct hpsb_packet *hpsb_make_streampacket(struct hpsb_host *host, u8 *buffer,
  28                                            int length, int channel, int tag,
  29                                            int sync);
  30
  31 /*
  32  * hpsb_packet_success - Make sense of the ack and reply codes and
  33  * return more convenient error codes:
  34  * 0           success
  35  * -EBUSY      node is busy, try again
  36  * -EAGAIN     error which can probably resolved by retry
  37  * -EREMOTEIO  node suffers from an internal error
  38  * -EACCES     this transaction is not allowed on requested address
  39  * -EINVAL     invalid address at node
  40  */
  41 int hpsb_packet_success(struct hpsb_packet *packet);
  42
  43 /*
  44  * The generic read and write functions.  All recognize the local node ID
  45  * and act accordingly.  Read and write automatically use quadlet commands if
  46  * length == 4 and and block commands otherwise (however, they do not yet
  47  * support lengths that are not a multiple of 4).  You must explicitly specifiy
  48  * the generation for which the node ID is valid, to avoid sending packets to
  49  * the wrong nodes when we race with a bus reset.
  50  */
  51 int hpsb_read(struct hpsb_host *host, nodeid_t node, unsigned int generation,
  52               u64 addr, quadlet_t *buffer, size_t length);
  53 int hpsb_write(struct hpsb_host *host, nodeid_t node, unsigned int generation,
  54                u64 addr, quadlet_t *buffer, size_t length);
  55
  56 #ifdef HPSB_DEBUG_TLABELS
  57 extern spinlock_t hpsb_tlabel_lock;
  58 #endif
  59
  60 #endif /* _IEEE1394_TRANSACTIONS_H */