1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
|
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License, Version 1.0 only
* (the "License"). You may not use this file except in compliance
* with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* or http://www.opensolaris.org/os/licensing.
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright (c) 1999-2000 by Sun Microsystems, Inc.
* All rights reserved.
*/
#ifndef _SYS_1394_ADAPTERS_HCI1394_TLABEL_H
#define _SYS_1394_ADAPTERS_HCI1394_TLABEL_H
#pragma ident "%Z%%M% %I% %E% SMI"
/*
* hci1394_tlabel.h
* These routines track the tlabel usage for a 1394 adapter.
*/
#ifdef __cplusplus
extern "C" {
#endif
#include <sys/types.h>
#include <sys/conf.h>
#include <sys/ddi.h>
#include <sys/sunddi.h>
#include <sys/time.h>
#include <sys/note.h>
/*
* TLABEL_RANGE specifies the number of tlabels that will be allocated for a
* given node. tlabels are allocated starting at 0 and going up to
* (TLABEL_RANGE - 1).
*
* e.g. if TLABEL_RANGE was set to 4, each node could have at most 4 outstanding
* transactions to any other node at any given time and the tlabels allocated
* would be 0, 1, 2, and 3.
*
* NOTE: the maximum value of TLABEL_RANGE is 64.
*/
#define TLABEL_RANGE 64
/* TLABEL_MASK is the mask used to extract the 6-bit tlabel */
#define TLABEL_MASK 0x3F
/*
* destination - a 16-bit value where the most significant 10-bits are the bus
* # and the least significant 6 bits are the node #. The upper
* 16 bits of this word are not used.
*
* tlabel - the 1394 tlabel to be used. A number ranging from
* 0 - (TLABEL_RANGE - 1)
*/
typedef struct hci1394_tlabel_info_s {
uint_t tbi_destination;
uint_t tbi_tlabel;
} hci1394_tlabel_info_t;
_NOTE(SCHEME_PROTECTS_DATA("Single thread modifies", \
hci1394_tlabel_info_s::tbi_destination \
hci1394_tlabel_info_s::tbi_tlabel))
/* structure used to keep track of tlabels */
typedef struct hci1394_tlabel_s {
/*
* The maximum node number that we have sent a tlabel to inclusive. This
* is used as an optimization during reset processing.
*/
uint_t tb_max_node;
/*
* Status if we have sent a broadcast request out. This is used as an
* optimization during reset processing.
*/
boolean_t tb_bcast_sent;
/*
* free is used to keep track of free tlabels. The free tlabels are
* tracked as a bit mask. If the bit is set to 1 the tlabel is free,
* if set to 0 the tlabel is used.
*/
uint64_t tb_free[IEEE1394_MAX_NODES];
/*
* bad is used to keep track of bad tlabels. A bad tlabel is used for a
* ATREQ that was pended but the response was never received. They will
* be put back into the free list when > 2 times the split timeout has
* gone by (from the initial transfer). The bad tlabels are tracked as
* a bit mask. If the bit is set to 1 the tlabel is bad, if set to 0 the
* tlabel is good.
*/
uint64_t tb_bad[IEEE1394_MAX_NODES];
/*
* last tracks the last used tlabel for a given node. This allows us to
* walk through the tlabels for each node during tlabel allocation
* (i.e. so we always don't allocate the same tlabel over and over again
* if the device is accessed serially).
*/
uint8_t tb_last[IEEE1394_MAX_NODES];
/*
* Times are in nS. reclaim_time is set to the duration to wait to
* reclaim the bad tlabels. bad_timestamp is a timestamp for when the
* last bad tlabel was added into the bit mask.
*/
hrtime_t tb_bad_timestamp[IEEE1394_MAX_NODES];
hrtime_t tb_reclaim_time;
/*
* *_lookup[node][tlabel]
* Used to track a generic pointer for a given node/tlabel.
*/
void *tb_lookup[IEEE1394_MAX_NODES][TLABEL_RANGE];
/* general driver info */
hci1394_drvinfo_t *tb_drvinfo;
kmutex_t tb_mutex;
} hci1394_tlabel_t;
_NOTE(SCHEME_PROTECTS_DATA("Single thread modifies", \
hci1394_tlabel_s::tb_reclaim_time))
/* handle passed back from init() and used for rest of functions */
typedef struct hci1394_tlabel_s *hci1394_tlabel_handle_t;
void hci1394_tlabel_init(hci1394_drvinfo_t *drvinfo, hrtime_t reclaim_time_nS,
hci1394_tlabel_handle_t *tlabel_handle);
void hci1394_tlabel_fini(hci1394_tlabel_handle_t *tlabel_handle);
int hci1394_tlabel_alloc(hci1394_tlabel_handle_t tlabel_handle,
uint_t destination, hci1394_tlabel_info_t *tlabel_info);
void hci1394_tlabel_free(hci1394_tlabel_handle_t tlabel_handle,
hci1394_tlabel_info_t *tlabel_info);
void hci1394_tlabel_register(hci1394_tlabel_handle_t tlabel_handle,
hci1394_tlabel_info_t *tlabel_info, void *cmd);
void hci1394_tlabel_lookup(hci1394_tlabel_handle_t tlabel_handle,
hci1394_tlabel_info_t *tlabel_info, void **cmd);
void hci1394_tlabel_bad(hci1394_tlabel_handle_t tlabel_handle,
hci1394_tlabel_info_t *tlabel_info);
void hci1394_tlabel_reset(hci1394_tlabel_handle_t tlabel_handle);
void hci1394_tlabel_set_reclaim_time(hci1394_tlabel_handle_t tlabel_handle,
hrtime_t reclaim_time_nS);
#ifdef __cplusplus
}
#endif
#endif /* _SYS_1394_ADAPTERS_HCI1394_TLABEL_H */
|
