KallistiOS git master
Independent SDK for the Sega Dreamcast
Loading...
Searching...
No Matches
broadband_adapter.h
Go to the documentation of this file.
1/* KallistiOS ##version##
2
3 dc/net/broadband_adapter.h
4 Copyright (C) 2001-2002 Megan Potter
5
6*/
7
8/** \file dc/net/broadband_adapter.h
9 \brief Broadband Adapter support.
10 \ingroup bba
11
12 This file contains declarations related to support for the HIT-0400
13 "Broadband Adapter". There's not really anything that users will generally
14 have to deal with in here.
15
16 \author Megan Potter
17*/
18
19#ifndef __DC_NET_BROADBAND_ADAPTER_H
20#define __DC_NET_BROADBAND_ADAPTER_H
21
22#include <kos/cdefs.h>
23__BEGIN_DECLS
24
25#include <arch/types.h>
26
27/** \defgroup bba Broadband Adapter
28 \brief Driver for the Dreamcast's BBA (RTL8139C).
29 \ingroup networking_drivers
30 @{
31*/
32
33/** \defgroup bba_regs Registers
34 \brief Registers and related info for the broadband adapter
35 @{
36*/
37
38/** \defgroup bba_regs_locs Locations
39 \brief Locations for various broadband adapter registers.
40
41 The default assumption is that these are all RW at any aligned size unless
42 otherwise noted. ex (RW 32bit, RO 16/8) indicates read/write at 32bit and
43 read-only at 16 or 8bits.
44
45 @{
46*/
47#define RT_IDR0 0x00 /**< \brief MAC address 0 (RW 32bit, RO 16/8) */
48#define RT_IDR1 0x01 /**< \brief MAC address 1 (Read-only) */
49#define RT_IDR2 0x02 /**< \brief MAC address 2 (Read-only) */
50#define RT_IDR3 0x03 /**< \brief MAC address 3 (Read-only) */
51#define RT_IDR4 0x04 /**< \brief MAC address 4 (RW 32bit, RO 16/8) */
52#define RT_IDR5 0x05 /**< \brief MAC address 5 (Read-only) */
53#define RT_RES06 0x06 /**< \brief Reserved */
54#define RT_RES07 0x07 /**< \brief Reserved */
55#define RT_MAR0 0x08 /**< \brief Multicast filter 0 (RW 32bit, RO 16/8) */
56#define RT_MAR1 0x09 /**< \brief Multicast filter 1 (Read-only) */
57#define RT_MAR2 0x0A /**< \brief Multicast filter 2 (Read-only) */
58#define RT_MAR3 0x0B /**< \brief Multicast filter 3 (Read-only) */
59#define RT_MAR4 0x0C /**< \brief Multicast filter 4 (RW 32bit, RO 16/8) */
60#define RT_MAR5 0x0D /**< \brief Multicast filter 5 (Read-only) */
61#define RT_MAR6 0x0E /**< \brief Multicast filter 6 (Read-only) */
62#define RT_MAR7 0x0F /**< \brief Multicast filter 7 (Read-only) */
63#define RT_TXSTATUS0 0x10 /**< \brief Transmit status 0 (32bit only) */
64#define RT_TXSTATUS1 0x14 /**< \brief Transmit status 1 (32bit only) */
65#define RT_TXSTATUS2 0x18 /**< \brief Transmit status 2 (32bit only) */
66#define RT_TXSTATUS3 0x1C /**< \brief Transmit status 3 (32bit only) */
67#define RT_TXADDR0 0x20 /**< \brief Tx descriptor 0 (32bit only) */
68#define RT_TXADDR1 0x24 /**< \brief Tx descriptor 1 (32bit only) */
69#define RT_TXADDR2 0x28 /**< \brief Tx descriptor 2 (32bit only) */
70#define RT_TXADDR3 0x2C /**< \brief Tx descriptor 3 (32bit only) */
71#define RT_RXBUF 0x30 /**< \brief Receive buffer start address (32bit only) */
72#define RT_RXEARLYCNT 0x34 /**< \brief Early Rx byte count (RO 16bit) */
73#define RT_RXEARLYSTATUS 0x36 /**< \brief Early Rx status (RO) */
74#define RT_CHIPCMD 0x37 /**< \brief Command register */
75#define RT_RXBUFTAIL 0x38 /**< \brief Current address of packet read (queue tail) (16bit only) */
76#define RT_RXBUFHEAD 0x3A /**< \brief Current buffer address (queue head) (RO 16bit) */
77#define RT_INTRMASK 0x3C /**< \brief Interrupt mask (16bit only) */
78#define RT_INTRSTATUS 0x3E /**< \brief Interrupt status (16bit only) */
79#define RT_TXCONFIG 0x40 /**< \brief Tx config (32bit only) */
80#define RT_RXCONFIG 0x44 /**< \brief Rx config (32bit only) */
81#define RT_TIMER 0x48 /**< \brief A general purpose counter, any write clears (32bit only) */
82#define RT_RXMISSED 0x4C /**< \brief 24 bits valid, write clears (32bit only) */
83#define RT_CFG9346 0x50 /**< \brief 93C46 command register */
84#define RT_CONFIG0 0x51 /**< \brief Configuration reg 0 */
85#define RT_CONFIG1 0x52 /**< \brief Configuration reg 1 */
86#define RT_RES53 0x53 /**< \brief Reserved */
87#define RT_TIMERINT 0x54 /**< \brief Timer interrupt register (32bit only) */
88#define RT_MEDIASTATUS 0x58 /**< \brief Media status register */
89#define RT_CONFIG3 0x59 /**< \brief Config register 3 */
90#define RT_CONFIG4 0x5A /**< \brief Config register 4 */
91#define RT_RES5B 0x5B /**< \brief Reserved */
92#define RT_MULTIINTR 0x5C /**< \brief Multiple interrupt select (32bit only) */
93#define RT_RERID 0x5E /**< \brief PCI Revision ID (10h) (Read-only) */
94#define RT_RES5F 0x5F /**< \brief Reserved */
95#define RT_MII_TSAD 0x60 /**< \brief Transmit status of all descriptors (RO 16bit) */
96#define RT_MII_BMCR 0x62 /**< \brief Basic Mode Control Register (16bit only) */
97#define RT_MII_BMSR 0x64 /**< \brief Basic Mode Status Register (RO 16bit) */
98#define RT_AS_ADVERT 0x66 /**< \brief Auto-negotiation advertisement reg (16bit only) */
99#define RT_AS_LPAR 0x68 /**< \brief Auto-negotiation link partner reg (RO 16bit) */
100#define RT_AS_EXPANSION 0x6A /**< \brief Auto-negotiation expansion reg (RO 16bit) */
101
102#define RT_CONFIG5 0xD8 /**< \brief Config register 5 */
103/** @} */
104
105/** \defgroup bba_regs_fields Fields
106 \brief Register fields for the broadband adapter
107 @{
108*/
109
110/** \defgroup bba_miicb MII Control Bits
111 \brief BBA media independent interface control register fields
112 @{
113*/
114#define RT_MII_RESET 0x8000 /**< \brief Reset the MII chip */
115#define RT_MII_RES4000 0x4000 /**< \brief Reserved */
116#define RT_MII_SPD_SET 0x2000 /**< \brief 1 for 100 0 for 10. Ignored if AN enabled. */
117#define RT_MII_AN_ENABLE 0x1000 /**< \brief Enable auto-negotiation */
118#define RT_MII_RES0800 0x0800 /**< \brief Reserved */
119#define RT_MII_RES0400 0x0400 /**< \brief Reserved */
120#define RT_MII_AN_START 0x0200 /**< \brief Start auto-negotiation */
121#define RT_MII_DUPLEX 0x0100 /**< \brief 1 for full 0 for half. Ignored if AN enabled. */
122/** @} */
123
124/** \defgroup bba_miisb MII Status Bits
125 \brief BBA media independent interface status register fields
126 @{
127*/
128#define RT_MII_LINK 0x0004 /**< \brief Link is present */
129#define RT_MII_AN_CAPABLE 0x0008 /**< \brief Can do auto negotiation */
130#define RT_MII_AN_COMPLETE 0x0020 /**< \brief Auto-negotiation complete */
131#define RT_MII_10_HALF 0x0800 /**< \brief Can do 10Mbit half duplex */
132#define RT_MII_10_FULL 0x1000 /**< \brief Can do 10Mbit full */
133#define RT_MII_100_HALF 0x2000 /**< \brief Can do 100Mbit half */
134#define RT_MII_100_FULL 0x4000 /**< \brief Can do 100Mbit full */
135/** @} */
136
137/** \defgroup bba_cbits Command Bits
138 \brief BBA command register fields
139
140 OR appropriate bit values together and write into the RT_CHIPCMD register to
141 execute the command.
142
143 @{
144*/
145#define RT_CMD_RESET 0x10 /**< \brief Reset the RTL8139C */
146#define RT_CMD_RX_ENABLE 0x08 /**< \brief Enable Rx */
147#define RT_CMD_TX_ENABLE 0x04 /**< \brief Enable Tx */
148#define RT_CMD_RX_BUF_EMPTY 0x01 /**< \brief Empty the Rx buffer */
149/** @} */
150
151/** \defgroup bba_ibits Interrupt Status Bits
152 \brief BBA interrupt status fields
153 @{
154*/
155#define RT_INT_PCIERR 0x8000 /**< \brief PCI Bus error */
156#define RT_INT_TIMEOUT 0x4000 /**< \brief Set when TCTR reaches TimerInt value */
157#define RT_INT_RXFIFO_OVERFLOW 0x0040 /**< \brief Rx FIFO overflow */
158#define RT_INT_RXFIFO_UNDERRUN 0x0020 /**< \brief Packet underrun / link change */
159#define RT_INT_LINK_CHANGE 0x0020 /**< \brief Packet underrun / link change */
160#define RT_INT_RXBUF_OVERFLOW 0x0010 /**< \brief Rx BUFFER overflow */
161#define RT_INT_TX_ERR 0x0008 /**< \brief Tx error */
162#define RT_INT_TX_OK 0x0004 /**< \brief Tx OK */
163#define RT_INT_RX_ERR 0x0002 /**< \brief Rx error */
164#define RT_INT_RX_OK 0x0001 /**< \brief Rx OK */
165
166/** \brief Composite RX bits we check for while doing an RX interrupt. */
167#define RT_INT_RX_ACK (RT_INT_RXFIFO_OVERFLOW | RT_INT_RXBUF_OVERFLOW | RT_INT_RX_OK)
168/** @} */
169
170/** \defgroup bba_tbits RTL8139C Transmit Status Bits
171 \brief BBA transmit status register fields
172 @{
173*/
174#define RT_TX_CARRIER_LOST 0x80000000 /**< \brief Carrier sense lost */
175#define RT_TX_ABORTED 0x40000000 /**< \brief Transmission aborted */
176#define RT_TX_OUT_OF_WINDOW 0x20000000 /**< \brief Out of window collision */
177#define RT_TX_STATUS_OK 0x00008000 /**< \brief Status ok: a good packet was transmitted */
178#define RT_TX_UNDERRUN 0x00004000 /**< \brief Transmit FIFO underrun */
179#define RT_TX_HOST_OWNS 0x00002000 /**< \brief Set to 1 when DMA operation is completed */
180#define RT_TX_SIZE_MASK 0x00001fff /**< \brief Descriptor size mask */
181/** @} */
182
183/** \defgroup bba_rbits Receive Status Bits
184 \brief BBA receive status register fields
185 @{
186*/
187#define RT_RX_MULTICAST 0x8000 /**< \brief Multicast packet */
188#define RT_RX_PAM 0x4000 /**< \brief Physical address matched */
189#define RT_RX_BROADCAST 0x2000 /**< \brief Broadcast address matched */
190#define RT_RX_BAD_SYMBOL 0x0020 /**< \brief Invalid symbol in 100TX packet */
191#define RT_RX_RUNT 0x0010 /**< \brief Packet size is <64 bytes */
192#define RT_RX_TOO_LONG 0x0008 /**< \brief Packet size is >4K bytes */
193#define RT_RX_CRC_ERR 0x0004 /**< \brief CRC error */
194#define RT_RX_FRAME_ALIGN 0x0002 /**< \brief Frame alignment error */
195#define RT_RX_STATUS_OK 0x0001 /**< \brief Status ok: a good packet was received */
196/** @} */
197
198/** \defgroup bba_configrx RTL8139C RX Config Register (RT_RXCONFIG) bits
199
200 From RTL8139C(L) datasheet v1.4.
201
202 @{
203*/
204#define RT_ERTH(n) ((n) <<24) /**< \brief Early RX Threshold multiplier n/16 or 0 for none */
205
206#define RT_RXC_MulERINT 0x00020000 /**< \brief 0 for Early Receive Interrupt only on familiar protocols 1 for any */
207#define RT_RXC_RER8 0x00010000 /**< \brief 1 sets the acceptance of runt error packets */
208#define RT_RXC_RXFTH(n) ((n) <<13) /**< \brief 2^(4+n) bytes from 0-6 (16b - 1Kb) or 7 for none */
209#define RT_RXC_RBLEN(n) ((n) <<11) /**< \brief Set Rx ring buffer len to 16b + 2^(3+n) kb. */
210#define RT_RXC_MXDMA(n) ((n) << 8) /**< \brief 2^(4+n) bytes from 0-6 (16b - 1Kb) or 7 for unlimited */
211
212#define RT_RXC_WRAP 0x00000080 /**< \brief 0 to use wrapping mode or 1 to not (Ignored for 64Kb buffer length) */
213#define RT_RXC_9356SEL 0x00000040 /**< \brief 0 if EEPROM is 9346, 1 if 9356. RO */
214#define RT_RXC_AER 0x00000020 /**< \brief Accept Error Packets */
215#define RT_RXC_AR 0x00000010 /**< \brief Accept Runt (8-64 byte) Packets */
216#define RT_RXC_AB 0x00000008 /**< \brief Accept Broadcast Packets */
217#define RT_RXC_AM 0x00000004 /**< \brief Accept Multicast Packets */
218#define RT_RXC_APM 0x00000002 /**< \brief Accept Physical Match Packets */
219#define RT_RXC_AAP 0x00000001 /**< \brief Accept Physical Address Packets */
220/** @} */
221
222/** \defgroup bba_config1bits RTL8139C Config Register 1 (RT_CONFIG1) Bits
223 \brief BBA config register 1 fields
224
225 From RTL8139C(L) datasheet v1.4
226
227 @{
228*/
229#define RT_CONFIG1_LED1 0x80 /**< \brief XXX DC bba has no LED, maybe repurposed. */
230#define RT_CONFIG1_LED0 0x40 /**< \brief XXX DC bba has no LED, maybe repurposed. */
231#define RT_CONFIG1_DVRLOAD 0x20 /**< \brief Sets the Driver as loaded. */
232#define RT_CONFIG1_LWACT 0x10 /**< \brief LWAKE active mode. Default 0. */
233#define RT_CONFIG1_MEMMAP 0x08 /**< \brief Registers mapped to PCI mem space. Read Only */
234#define RT_CONFIG1_IOMAP 0x04 /**< \brief Registers mapped to PCI I/O space. Read Only */
235#define RT_CONFIG1_VPD 0x02 /**< \brief Enable Vital Product Data. */
236#define RT_CONFIG1_PMEn 0x01 /**< \brief Power Management Enable */
237/** @} */
238
239/** \defgroup bba_config4bits RTL8139C Config Register 4 (RT_CONFIG4) Bits
240 \brief BBA config register 4 fields
241
242 From RTL8139C(L) datasheet v1.4. Only RT_CONFIG4_RxFIFIOAC is used.
243
244 @{
245*/
246#define RT_CONFIG4_RxFIFIOAC 0x80 /**< \brief Auto-clear the Rx FIFO overflow. */
247#define RT_CONFIG4_AnaOff 0x40 /**< \brief Turn off analog power. Default 0. */
248#define RT_CONFIG4_LongWF 0x20 /**< \brief Long Wake-up Frames. */
249#define RT_CONFIG4_LWPME 0x10 /**< \brief LWake vs PMEB. */
250#define RT_CONFIG4_RES08 0x08 /**< \brief Reserved. */
251#define RT_CONFIG4_LWPTN 0x04 /**< \brief LWAKE Pattern. */
252#define RT_CONFIG4_RES02 0x02 /**< \brief Reserved. */
253#define RT_CONFIG4_PBWake 0x01 /**< \brief Disable pre-Boot Wakeup. */
254/** @} */
255
256/** \defgroup bba_config5bits RTL8139C Config Register 5 (RT_CONFIG5) Bits
257 \brief BBA config register 5 fields
258
259 From RTL8139C(L) datasheet v1.4. Only RT_CONFIG5_LDPS is used.
260
261 @{
262*/
263#define RT_CONFIG5_RES80 0x80 /**< \brief Reserved. */
264#define RT_CONFIG5_BWF 0x40 /**< \brief Enable Broadcast Wakeup Frame. Default 0. */
265#define RT_CONFIG5_MWF 0x20 /**< \brief Enable Multicast Wakeup Frame. Default 0. */
266#define RT_CONFIG5_UWF 0x10 /**< \brief Enable Unicast Wakeup Frame. Default 0. */
267#define RT_CONFIG5_FIFOAddr 0x08 /**< \brief Set FIFO address pointer. For testing only. */
268#define RT_CONFIG5_LDPS 0x04 /**< \brief Disable Link Down Power Saving mode. */
269#define RT_CONFIG5_LANW 0x02 /**< \brief Enable LANWake signal. */
270#define RT_CONFIG5_PME_STS 0x01 /**< \brief Allow PCI reset to set PME_Status bit. */
271/** @} */
272
273/** @} */
274
275/** @} */
276
277/** \brief Retrieve the MAC Address of the attached BBA.
278
279 This function reads the MAC Address of the BBA and places it in the buffer
280 passed in. The resulting data is undefined if no BBA is connected.
281
282 \param arr The array to read the MAC into.
283*/
284void bba_get_mac(uint8 *arr);
285
286/** \defgroup bba_rx RX
287 \brief Receive packet API for the BBA
288 @{
289*/
290
291/** \brief Receive packet callback function type.
292
293 When a packet is received by the BBA, the callback function will be called
294 to handle it.
295
296 \param pkt A pointer to the packet in question.
297 \param len The length, in bytes, of the packet.
298*/
299typedef void (*eth_rx_callback_t)(uint8 *pkt, int len);
300
301/** \brief Set the ethernet packet receive callback.
302
303 This function sets the function called when a packet is received by the BBA.
304 Generally, this inputs into the network layer.
305
306 \param cb A pointer to the new callback function.
307*/
308void bba_set_rx_callback(eth_rx_callback_t cb);
309
310/** @} */
311
312/** \defgroup bba_tx TX
313 \brief Transmit packet API for the BBA
314 @{
315*/
316
317/** \defgroup bba_txrv Return Values
318 \brief Return values for bba_tx()
319 @{
320*/
321#define BBA_TX_OK 0 /**< \brief Transmit success */
322#define BBA_TX_ERROR -1 /**< \brief Transmit error */
323#define BBA_TX_AGAIN -2 /**< \brief Retry transmit again */
324/** @} */
325
326/** \defgroup bba_wait Wait Modes
327 \brief Wait modes for bba_tx()
328 @{
329*/
330#define BBA_TX_NOWAIT 0 /**< \brief Don't block waiting for the transfer. */
331#define BBA_TX_WAIT 1 /**< \brief Wait, if needed on transfer. */
332/** @} */
333
334/** \brief Transmit a single packet.
335
336 This function transmits a single packet on the bba, waiting for the link to
337 become stable, if requested.
338
339 \param pkt The packet to transmit.
340 \param len The length of the packet, in bytes.
341 \param wait BBA_TX_WAIT if you don't mind blocking for the
342 all clear to transmit, BBA_TX_NOWAIT otherwise.
343
344 \retval BBA_TX_OK On success.
345 \retval BBA_TX_ERROR If there was an error transmitting the packet.
346 \retval BBA_TX_AGAIN If BBA_TX_NOWAIT was specified and it is not ok to
347 transmit right now.
348*/
349int bba_tx(const uint8 *pkt, int len, int wait);
350
351/** @} */
352
353/* \cond */
354/* Initialize */
355int bba_init(void);
356
357/* Shutdown */
358int bba_shutdown(void);
359/* \endcond */
360
361/** @} */
362
363__END_DECLS
364
365#endif /* __DC_NET_BROADBAND_ADAPTER_H */
366
cdefs.h
Various common macros used throughout the codebase.
bba_set_rx_callback
void bba_set_rx_callback(eth_rx_callback_t cb)
Set the ethernet packet receive callback.
eth_rx_callback_t
void(* eth_rx_callback_t)(uint8 *pkt, int len)
Receive packet callback function type.
Definition broadband_adapter.h:299
bba_tx
int bba_tx(const uint8 *pkt, int len, int wait)
Transmit a single packet.
bba_get_mac
void bba_get_mac(uint8 *arr)
Retrieve the MAC Address of the attached BBA.
uint8
unsigned char uint8
8-bit unsigned integer
Definition types.h:35
types.h
Common integer types.