blob: 5f809f50845febd89968a62bbefac81d5bbc99b2 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001#ifndef _IEEE1394_TRANSACTIONS_H
2#define _IEEE1394_TRANSACTIONS_H
3
4#include "ieee1394_core.h"
5
Linus Torvalds1da177e2005-04-16 15:20:36 -07006int hpsb_get_tlabel(struct hpsb_packet *packet);
7void hpsb_free_tlabel(struct hpsb_packet *packet);
Linus Torvalds1da177e2005-04-16 15:20:36 -07008struct hpsb_packet *hpsb_make_readpacket(struct hpsb_host *host, nodeid_t node,
9 u64 addr, size_t length);
10struct hpsb_packet *hpsb_make_lockpacket(struct hpsb_host *host, nodeid_t node,
Stefan Richtere1d118f2006-07-03 12:02:28 -040011 u64 addr, int extcode, quadlet_t *data,
Linus Torvalds1da177e2005-04-16 15:20:36 -070012 quadlet_t arg);
Stefan Richtere1d118f2006-07-03 12:02:28 -040013struct hpsb_packet *hpsb_make_lock64packet(struct hpsb_host *host,
14 nodeid_t node, u64 addr, int extcode,
15 octlet_t *data, octlet_t arg);
16struct hpsb_packet *hpsb_make_phypacket(struct hpsb_host *host, quadlet_t data);
17struct hpsb_packet *hpsb_make_isopacket(struct hpsb_host *host, int length,
18 int channel, int tag, int sync);
19struct hpsb_packet *hpsb_make_writepacket(struct hpsb_host *host,
20 nodeid_t node, u64 addr,
21 quadlet_t *buffer, size_t length);
Linus Torvalds1da177e2005-04-16 15:20:36 -070022struct hpsb_packet *hpsb_make_streampacket(struct hpsb_host *host, u8 *buffer,
Stefan Richtere1d118f2006-07-03 12:02:28 -040023 int length, int channel, int tag,
24 int sync);
Linus Torvalds1da177e2005-04-16 15:20:36 -070025
26/*
27 * hpsb_packet_success - Make sense of the ack and reply codes and
28 * return more convenient error codes:
29 * 0 success
30 * -EBUSY node is busy, try again
31 * -EAGAIN error which can probably resolved by retry
32 * -EREMOTEIO node suffers from an internal error
33 * -EACCES this transaction is not allowed on requested address
34 * -EINVAL invalid address at node
35 */
36int hpsb_packet_success(struct hpsb_packet *packet);
37
Linus Torvalds1da177e2005-04-16 15:20:36 -070038/*
Stefan Richtere1d118f2006-07-03 12:02:28 -040039 * The generic read and write functions. All recognize the local node ID
Linus Torvalds1da177e2005-04-16 15:20:36 -070040 * and act accordingly. Read and write automatically use quadlet commands if
41 * length == 4 and and block commands otherwise (however, they do not yet
42 * support lengths that are not a multiple of 4). You must explicitly specifiy
43 * the generation for which the node ID is valid, to avoid sending packets to
44 * the wrong nodes when we race with a bus reset.
45 */
46int hpsb_read(struct hpsb_host *host, nodeid_t node, unsigned int generation,
47 u64 addr, quadlet_t *buffer, size_t length);
48int hpsb_write(struct hpsb_host *host, nodeid_t node, unsigned int generation,
49 u64 addr, quadlet_t *buffer, size_t length);
Linus Torvalds1da177e2005-04-16 15:20:36 -070050
51#endif /* _IEEE1394_TRANSACTIONS_H */