wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 1 | /* |
| 2 | dm9000.c: Version 1.2 12/15/2003 |
| 3 | |
| 4 | A Davicom DM9000 ISA NIC fast Ethernet driver for Linux. |
| 5 | Copyright (C) 1997 Sten Wang |
| 6 | |
Wolfgang Denk | d79de1d | 2013-07-08 09:37:19 +0200 | [diff] [blame] | 7 | * SPDX-License-Identifier: GPL-2.0+ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 8 | |
| 9 | (C)Copyright 1997-1998 DAVICOM Semiconductor,Inc. All Rights Reserved. |
| 10 | |
| 11 | V0.11 06/20/2001 REG_0A bit3=1, default enable BP with DA match |
Wolfgang Denk | a1be476 | 2008-05-20 16:00:29 +0200 | [diff] [blame] | 12 | 06/22/2001 Support DM9801 progrmming |
| 13 | E3: R25 = ((R24 + NF) & 0x00ff) | 0xf000 |
| 14 | E4: R25 = ((R24 + NF) & 0x00ff) | 0xc200 |
| 15 | R17 = (R17 & 0xfff0) | NF + 3 |
| 16 | E5: R25 = ((R24 + NF - 3) & 0x00ff) | 0xc200 |
| 17 | R17 = (R17 & 0xfff0) | NF |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 18 | |
Wolfgang Denk | a1be476 | 2008-05-20 16:00:29 +0200 | [diff] [blame] | 19 | v1.00 modify by simon 2001.9.5 |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 20 | change for kernel 2.4.x |
| 21 | |
Wolfgang Denk | a1be476 | 2008-05-20 16:00:29 +0200 | [diff] [blame] | 22 | v1.1 11/09/2001 fix force mode bug |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 23 | |
| 24 | v1.2 03/18/2003 Weilun Huang <weilun_huang@davicom.com.tw>: |
| 25 | Fixed phy reset. |
| 26 | Added tx/rx 32 bit mode. |
| 27 | Cleaned up for kernel merge. |
| 28 | |
| 29 | -------------------------------------- |
| 30 | |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 31 | 12/15/2003 Initial port to u-boot by |
| 32 | Sascha Hauer <saschahauer@web.de> |
| 33 | |
| 34 | 06/03/2008 Remy Bohmer <linux@bohmer.net> |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 35 | - Fixed the driver to work with DM9000A. |
| 36 | (check on ISR receive status bit before reading the |
| 37 | FIFO as described in DM9000 programming guide and |
| 38 | application notes) |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 39 | - Added autodetect of databus width. |
Remy Bohmer | f4329dc | 2008-06-03 15:26:22 +0200 | [diff] [blame] | 40 | - Made debug code compile again. |
Remy Bohmer | 16cb264 | 2008-06-03 15:26:23 +0200 | [diff] [blame] | 41 | - Adapt eth_send such that it matches the DM9000* |
| 42 | application notes. Needed to make it work properly |
| 43 | for DM9000A. |
Remy Bohmer | 2f13d2c | 2008-06-03 15:26:24 +0200 | [diff] [blame] | 44 | - Adapted reset procedure to match DM9000 application |
| 45 | notes (i.e. double reset) |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 46 | - some minor code cleanups |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 47 | These changes are tested with DM9000{A,EP,E} together |
Remy Bohmer | cd9a36c | 2009-05-03 12:11:40 +0200 | [diff] [blame] | 48 | with a 200MHz Atmel AT91SAM9261 core |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 49 | |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 50 | TODO: external MII is not functional, only internal at the moment. |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 51 | */ |
| 52 | |
| 53 | #include <common.h> |
| 54 | #include <command.h> |
| 55 | #include <net.h> |
| 56 | #include <asm/io.h> |
Remy Bohmer | cd9a36c | 2009-05-03 12:11:40 +0200 | [diff] [blame] | 57 | #include <dm9000.h> |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 58 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 59 | #include "dm9000x.h" |
| 60 | |
| 61 | /* Board/System/Debug information/definition ---------------- */ |
| 62 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 63 | /* #define CONFIG_DM9000_DEBUG */ |
| 64 | |
| 65 | #ifdef CONFIG_DM9000_DEBUG |
Remy Bohmer | f4329dc | 2008-06-03 15:26:22 +0200 | [diff] [blame] | 66 | #define DM9000_DBG(fmt,args...) printf(fmt, ##args) |
| 67 | #define DM9000_DMP_PACKET(func,packet,length) \ |
| 68 | do { \ |
| 69 | int i; \ |
Thomas Weber | c1ff529 | 2009-12-09 09:38:04 +0100 | [diff] [blame] | 70 | printf("%s: length: %d\n", func, length); \ |
Remy Bohmer | f4329dc | 2008-06-03 15:26:22 +0200 | [diff] [blame] | 71 | for (i = 0; i < length; i++) { \ |
| 72 | if (i % 8 == 0) \ |
| 73 | printf("\n%s: %02x: ", func, i); \ |
| 74 | printf("%02x ", ((unsigned char *) packet)[i]); \ |
| 75 | } printf("\n"); \ |
| 76 | } while(0) |
| 77 | #else |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 78 | #define DM9000_DBG(fmt,args...) |
Remy Bohmer | f4329dc | 2008-06-03 15:26:22 +0200 | [diff] [blame] | 79 | #define DM9000_DMP_PACKET(func,packet,length) |
| 80 | #endif |
| 81 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 82 | /* Structure/enum declaration ------------------------------- */ |
| 83 | typedef struct board_info { |
| 84 | u32 runt_length_counter; /* counter: RX length < 64byte */ |
| 85 | u32 long_length_counter; /* counter: RX length > 1514byte */ |
| 86 | u32 reset_counter; /* counter: RESET */ |
| 87 | u32 reset_tx_timeout; /* RESET caused by TX Timeout */ |
| 88 | u32 reset_rx_status; /* RESET caused by RX Statsus wrong */ |
| 89 | u16 tx_pkt_cnt; |
| 90 | u16 queue_start_addr; |
| 91 | u16 dbug_cnt; |
| 92 | u8 phy_addr; |
| 93 | u8 device_wait_reset; /* device state */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 94 | unsigned char srom[128]; |
Remy Bohmer | 90d1fed | 2008-06-05 13:03:36 +0200 | [diff] [blame] | 95 | void (*outblk)(volatile void *data_ptr, int count); |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 96 | void (*inblk)(void *data_ptr, int count); |
| 97 | void (*rx_status)(u16 *RxStatus, u16 *RxLen); |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 98 | struct eth_device netdev; |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 99 | } board_info_t; |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 100 | static board_info_t dm9000_info; |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 101 | |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 102 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 103 | /* function declaration ------------------------------------- */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 104 | static int dm9000_probe(void); |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 105 | static u16 dm9000_phy_read(int); |
| 106 | static void dm9000_phy_write(int, u16); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 107 | static u8 DM9000_ior(int); |
| 108 | static void DM9000_iow(int reg, u8 value); |
| 109 | |
| 110 | /* DM9000 network board routine ---------------------------- */ |
Jason Jin | c74c436 | 2011-08-25 15:46:43 +0800 | [diff] [blame] | 111 | #ifndef CONFIG_DM9000_BYTE_SWAPPED |
Mike Frysinger | 6f6ce11 | 2010-07-05 02:29:21 -0400 | [diff] [blame] | 112 | #define DM9000_outb(d,r) writeb(d, (volatile u8 *)(r)) |
| 113 | #define DM9000_outw(d,r) writew(d, (volatile u16 *)(r)) |
| 114 | #define DM9000_outl(d,r) writel(d, (volatile u32 *)(r)) |
| 115 | #define DM9000_inb(r) readb((volatile u8 *)(r)) |
| 116 | #define DM9000_inw(r) readw((volatile u16 *)(r)) |
| 117 | #define DM9000_inl(r) readl((volatile u32 *)(r)) |
Jason Jin | c74c436 | 2011-08-25 15:46:43 +0800 | [diff] [blame] | 118 | #else |
| 119 | #define DM9000_outb(d, r) __raw_writeb(d, r) |
| 120 | #define DM9000_outw(d, r) __raw_writew(d, r) |
| 121 | #define DM9000_outl(d, r) __raw_writel(d, r) |
| 122 | #define DM9000_inb(r) __raw_readb(r) |
| 123 | #define DM9000_inw(r) __raw_readw(r) |
| 124 | #define DM9000_inl(r) __raw_readl(r) |
| 125 | #endif |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 126 | |
| 127 | #ifdef CONFIG_DM9000_DEBUG |
| 128 | static void |
| 129 | dump_regs(void) |
| 130 | { |
| 131 | DM9000_DBG("\n"); |
| 132 | DM9000_DBG("NCR (0x00): %02x\n", DM9000_ior(0)); |
| 133 | DM9000_DBG("NSR (0x01): %02x\n", DM9000_ior(1)); |
| 134 | DM9000_DBG("TCR (0x02): %02x\n", DM9000_ior(2)); |
| 135 | DM9000_DBG("TSRI (0x03): %02x\n", DM9000_ior(3)); |
| 136 | DM9000_DBG("TSRII (0x04): %02x\n", DM9000_ior(4)); |
| 137 | DM9000_DBG("RCR (0x05): %02x\n", DM9000_ior(5)); |
| 138 | DM9000_DBG("RSR (0x06): %02x\n", DM9000_ior(6)); |
Remy Bohmer | f4329dc | 2008-06-03 15:26:22 +0200 | [diff] [blame] | 139 | DM9000_DBG("ISR (0xFE): %02x\n", DM9000_ior(DM9000_ISR)); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 140 | DM9000_DBG("\n"); |
| 141 | } |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 142 | #endif |
| 143 | |
Remy Bohmer | 90d1fed | 2008-06-05 13:03:36 +0200 | [diff] [blame] | 144 | static void dm9000_outblk_8bit(volatile void *data_ptr, int count) |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 145 | { |
| 146 | int i; |
| 147 | for (i = 0; i < count; i++) |
| 148 | DM9000_outb((((u8 *) data_ptr)[i] & 0xff), DM9000_DATA); |
| 149 | } |
| 150 | |
Remy Bohmer | 90d1fed | 2008-06-05 13:03:36 +0200 | [diff] [blame] | 151 | static void dm9000_outblk_16bit(volatile void *data_ptr, int count) |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 152 | { |
| 153 | int i; |
| 154 | u32 tmplen = (count + 1) / 2; |
| 155 | |
| 156 | for (i = 0; i < tmplen; i++) |
| 157 | DM9000_outw(((u16 *) data_ptr)[i], DM9000_DATA); |
| 158 | } |
Remy Bohmer | 90d1fed | 2008-06-05 13:03:36 +0200 | [diff] [blame] | 159 | static void dm9000_outblk_32bit(volatile void *data_ptr, int count) |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 160 | { |
| 161 | int i; |
| 162 | u32 tmplen = (count + 3) / 4; |
| 163 | |
| 164 | for (i = 0; i < tmplen; i++) |
| 165 | DM9000_outl(((u32 *) data_ptr)[i], DM9000_DATA); |
| 166 | } |
| 167 | |
| 168 | static void dm9000_inblk_8bit(void *data_ptr, int count) |
| 169 | { |
| 170 | int i; |
| 171 | for (i = 0; i < count; i++) |
| 172 | ((u8 *) data_ptr)[i] = DM9000_inb(DM9000_DATA); |
| 173 | } |
| 174 | |
| 175 | static void dm9000_inblk_16bit(void *data_ptr, int count) |
| 176 | { |
| 177 | int i; |
| 178 | u32 tmplen = (count + 1) / 2; |
| 179 | |
| 180 | for (i = 0; i < tmplen; i++) |
| 181 | ((u16 *) data_ptr)[i] = DM9000_inw(DM9000_DATA); |
| 182 | } |
| 183 | static void dm9000_inblk_32bit(void *data_ptr, int count) |
| 184 | { |
| 185 | int i; |
| 186 | u32 tmplen = (count + 3) / 4; |
| 187 | |
| 188 | for (i = 0; i < tmplen; i++) |
| 189 | ((u32 *) data_ptr)[i] = DM9000_inl(DM9000_DATA); |
| 190 | } |
| 191 | |
| 192 | static void dm9000_rx_status_32bit(u16 *RxStatus, u16 *RxLen) |
| 193 | { |
Remy Bohmer | 2e1604f | 2008-06-04 10:47:25 +0200 | [diff] [blame] | 194 | u32 tmpdata; |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 195 | |
| 196 | DM9000_outb(DM9000_MRCMD, DM9000_IO); |
| 197 | |
Remy Bohmer | 2e1604f | 2008-06-04 10:47:25 +0200 | [diff] [blame] | 198 | tmpdata = DM9000_inl(DM9000_DATA); |
TsiChung Liew | 73dab3a | 2008-06-25 15:48:52 -0500 | [diff] [blame] | 199 | *RxStatus = __le16_to_cpu(tmpdata); |
| 200 | *RxLen = __le16_to_cpu(tmpdata >> 16); |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 201 | } |
| 202 | |
| 203 | static void dm9000_rx_status_16bit(u16 *RxStatus, u16 *RxLen) |
| 204 | { |
| 205 | DM9000_outb(DM9000_MRCMD, DM9000_IO); |
| 206 | |
TsiChung Liew | 73dab3a | 2008-06-25 15:48:52 -0500 | [diff] [blame] | 207 | *RxStatus = __le16_to_cpu(DM9000_inw(DM9000_DATA)); |
| 208 | *RxLen = __le16_to_cpu(DM9000_inw(DM9000_DATA)); |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 209 | } |
| 210 | |
| 211 | static void dm9000_rx_status_8bit(u16 *RxStatus, u16 *RxLen) |
| 212 | { |
| 213 | DM9000_outb(DM9000_MRCMD, DM9000_IO); |
| 214 | |
TsiChung Liew | 73dab3a | 2008-06-25 15:48:52 -0500 | [diff] [blame] | 215 | *RxStatus = |
| 216 | __le16_to_cpu(DM9000_inb(DM9000_DATA) + |
| 217 | (DM9000_inb(DM9000_DATA) << 8)); |
| 218 | *RxLen = |
| 219 | __le16_to_cpu(DM9000_inb(DM9000_DATA) + |
| 220 | (DM9000_inb(DM9000_DATA) << 8)); |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 221 | } |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 222 | |
| 223 | /* |
| 224 | Search DM9000 board, allocate space and register it |
| 225 | */ |
| 226 | int |
| 227 | dm9000_probe(void) |
| 228 | { |
| 229 | u32 id_val; |
| 230 | id_val = DM9000_ior(DM9000_VIDL); |
| 231 | id_val |= DM9000_ior(DM9000_VIDH) << 8; |
| 232 | id_val |= DM9000_ior(DM9000_PIDL) << 16; |
| 233 | id_val |= DM9000_ior(DM9000_PIDH) << 24; |
| 234 | if (id_val == DM9000_ID) { |
| 235 | printf("dm9000 i/o: 0x%x, id: 0x%x \n", CONFIG_DM9000_BASE, |
| 236 | id_val); |
| 237 | return 0; |
| 238 | } else { |
| 239 | printf("dm9000 not found at 0x%08x id: 0x%08x\n", |
| 240 | CONFIG_DM9000_BASE, id_val); |
| 241 | return -1; |
| 242 | } |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 243 | } |
| 244 | |
| 245 | /* General Purpose dm9000 reset routine */ |
| 246 | static void |
| 247 | dm9000_reset(void) |
| 248 | { |
Remy Bohmer | 2f13d2c | 2008-06-03 15:26:24 +0200 | [diff] [blame] | 249 | DM9000_DBG("resetting DM9000\n"); |
| 250 | |
| 251 | /* Reset DM9000, |
| 252 | see DM9000 Application Notes V1.22 Jun 11, 2004 page 29 */ |
| 253 | |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 254 | /* DEBUG: Make all GPIO0 outputs, all others inputs */ |
| 255 | DM9000_iow(DM9000_GPCR, GPCR_GPIO0_OUT); |
Remy Bohmer | 2f13d2c | 2008-06-03 15:26:24 +0200 | [diff] [blame] | 256 | /* Step 1: Power internal PHY by writing 0 to GPIO0 pin */ |
| 257 | DM9000_iow(DM9000_GPR, 0); |
| 258 | /* Step 2: Software reset */ |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 259 | DM9000_iow(DM9000_NCR, (NCR_LBK_INT_MAC | NCR_RST)); |
Remy Bohmer | 2f13d2c | 2008-06-03 15:26:24 +0200 | [diff] [blame] | 260 | |
| 261 | do { |
| 262 | DM9000_DBG("resetting the DM9000, 1st reset\n"); |
| 263 | udelay(25); /* Wait at least 20 us */ |
| 264 | } while (DM9000_ior(DM9000_NCR) & 1); |
| 265 | |
| 266 | DM9000_iow(DM9000_NCR, 0); |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 267 | DM9000_iow(DM9000_NCR, (NCR_LBK_INT_MAC | NCR_RST)); /* Issue a second reset */ |
Remy Bohmer | 2f13d2c | 2008-06-03 15:26:24 +0200 | [diff] [blame] | 268 | |
| 269 | do { |
| 270 | DM9000_DBG("resetting the DM9000, 2nd reset\n"); |
| 271 | udelay(25); /* Wait at least 20 us */ |
| 272 | } while (DM9000_ior(DM9000_NCR) & 1); |
| 273 | |
| 274 | /* Check whether the ethernet controller is present */ |
| 275 | if ((DM9000_ior(DM9000_PIDL) != 0x0) || |
| 276 | (DM9000_ior(DM9000_PIDH) != 0x90)) |
| 277 | printf("ERROR: resetting DM9000 -> not responding\n"); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 278 | } |
| 279 | |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 280 | /* Initialize dm9000 board |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 281 | */ |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 282 | static int dm9000_init(struct eth_device *dev, bd_t *bd) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 283 | { |
| 284 | int i, oft, lnk; |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 285 | u8 io_mode; |
| 286 | struct board_info *db = &dm9000_info; |
| 287 | |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 288 | DM9000_DBG("%s\n", __func__); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 289 | |
| 290 | /* RESET device */ |
| 291 | dm9000_reset(); |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 292 | |
| 293 | if (dm9000_probe() < 0) |
| 294 | return -1; |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 295 | |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 296 | /* Auto-detect 8/16/32 bit mode, ISR Bit 6+7 indicate bus width */ |
| 297 | io_mode = DM9000_ior(DM9000_ISR) >> 6; |
| 298 | |
| 299 | switch (io_mode) { |
| 300 | case 0x0: /* 16-bit mode */ |
| 301 | printf("DM9000: running in 16 bit mode\n"); |
| 302 | db->outblk = dm9000_outblk_16bit; |
| 303 | db->inblk = dm9000_inblk_16bit; |
| 304 | db->rx_status = dm9000_rx_status_16bit; |
| 305 | break; |
| 306 | case 0x01: /* 32-bit mode */ |
| 307 | printf("DM9000: running in 32 bit mode\n"); |
| 308 | db->outblk = dm9000_outblk_32bit; |
| 309 | db->inblk = dm9000_inblk_32bit; |
| 310 | db->rx_status = dm9000_rx_status_32bit; |
| 311 | break; |
| 312 | case 0x02: /* 8 bit mode */ |
| 313 | printf("DM9000: running in 8 bit mode\n"); |
| 314 | db->outblk = dm9000_outblk_8bit; |
| 315 | db->inblk = dm9000_inblk_8bit; |
| 316 | db->rx_status = dm9000_rx_status_8bit; |
| 317 | break; |
| 318 | default: |
| 319 | /* Assume 8 bit mode, will probably not work anyway */ |
| 320 | printf("DM9000: Undefined IO-mode:0x%x\n", io_mode); |
| 321 | db->outblk = dm9000_outblk_8bit; |
| 322 | db->inblk = dm9000_inblk_8bit; |
| 323 | db->rx_status = dm9000_rx_status_8bit; |
| 324 | break; |
| 325 | } |
| 326 | |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 327 | /* Program operating register, only internal phy supported */ |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 328 | DM9000_iow(DM9000_NCR, 0x0); |
| 329 | /* TX Polling clear */ |
| 330 | DM9000_iow(DM9000_TCR, 0); |
| 331 | /* Less 3Kb, 200us */ |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 332 | DM9000_iow(DM9000_BPTR, BPTR_BPHW(3) | BPTR_JPT_600US); |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 333 | /* Flow Control : High/Low Water */ |
| 334 | DM9000_iow(DM9000_FCTR, FCTR_HWOT(3) | FCTR_LWOT(8)); |
| 335 | /* SH FIXME: This looks strange! Flow Control */ |
| 336 | DM9000_iow(DM9000_FCR, 0x0); |
| 337 | /* Special Mode */ |
| 338 | DM9000_iow(DM9000_SMCR, 0); |
| 339 | /* clear TX status */ |
| 340 | DM9000_iow(DM9000_NSR, NSR_WAKEST | NSR_TX2END | NSR_TX1END); |
| 341 | /* Clear interrupt status */ |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 342 | DM9000_iow(DM9000_ISR, ISR_ROOS | ISR_ROS | ISR_PTS | ISR_PRS); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 343 | |
Ben Warren | 8707f62 | 2009-10-21 21:53:39 -0700 | [diff] [blame] | 344 | printf("MAC: %pM\n", dev->enetaddr); |
Andrew Dyer | a62f5d4 | 2008-08-26 17:03:38 -0500 | [diff] [blame] | 345 | |
| 346 | /* fill device MAC address registers */ |
| 347 | for (i = 0, oft = DM9000_PAR; i < 6; i++, oft++) |
Ben Warren | 8707f62 | 2009-10-21 21:53:39 -0700 | [diff] [blame] | 348 | DM9000_iow(oft, dev->enetaddr[i]); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 349 | for (i = 0, oft = 0x16; i < 8; i++, oft++) |
| 350 | DM9000_iow(oft, 0xff); |
| 351 | |
| 352 | /* read back mac, just to be sure */ |
| 353 | for (i = 0, oft = 0x10; i < 6; i++, oft++) |
| 354 | DM9000_DBG("%02x:", DM9000_ior(oft)); |
| 355 | DM9000_DBG("\n"); |
| 356 | |
| 357 | /* Activate DM9000 */ |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 358 | /* RX enable */ |
| 359 | DM9000_iow(DM9000_RCR, RCR_DIS_LONG | RCR_DIS_CRC | RCR_RXEN); |
| 360 | /* Enable TX/RX interrupt mask */ |
| 361 | DM9000_iow(DM9000_IMR, IMR_PAR); |
| 362 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 363 | i = 0; |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 364 | while (!(dm9000_phy_read(1) & 0x20)) { /* autonegation complete bit */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 365 | udelay(1000); |
| 366 | i++; |
| 367 | if (i == 10000) { |
| 368 | printf("could not establish link\n"); |
| 369 | return 0; |
| 370 | } |
| 371 | } |
| 372 | |
| 373 | /* see what we've got */ |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 374 | lnk = dm9000_phy_read(17) >> 12; |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 375 | printf("operating at "); |
| 376 | switch (lnk) { |
| 377 | case 1: |
| 378 | printf("10M half duplex "); |
| 379 | break; |
| 380 | case 2: |
| 381 | printf("10M full duplex "); |
| 382 | break; |
| 383 | case 4: |
| 384 | printf("100M half duplex "); |
| 385 | break; |
| 386 | case 8: |
| 387 | printf("100M full duplex "); |
| 388 | break; |
| 389 | default: |
| 390 | printf("unknown: %d ", lnk); |
| 391 | break; |
| 392 | } |
| 393 | printf("mode\n"); |
| 394 | return 0; |
| 395 | } |
| 396 | |
| 397 | /* |
| 398 | Hardware start transmission. |
| 399 | Send a packet to media from the upper layer. |
| 400 | */ |
Joe Hershberger | ab1ac41 | 2012-05-21 14:45:23 +0000 | [diff] [blame] | 401 | static int dm9000_send(struct eth_device *netdev, void *packet, int length) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 402 | { |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 403 | int tmo; |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 404 | struct board_info *db = &dm9000_info; |
| 405 | |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 406 | DM9000_DMP_PACKET(__func__ , packet, length); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 407 | |
Remy Bohmer | 16cb264 | 2008-06-03 15:26:23 +0200 | [diff] [blame] | 408 | DM9000_iow(DM9000_ISR, IMR_PTM); /* Clear Tx bit in ISR */ |
| 409 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 410 | /* Move data to DM9000 TX RAM */ |
Remy Bohmer | 16cb264 | 2008-06-03 15:26:23 +0200 | [diff] [blame] | 411 | DM9000_outb(DM9000_MWCMD, DM9000_IO); /* Prepare for TX-data */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 412 | |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 413 | /* push the data to the TX-fifo */ |
Remy Bohmer | 90d1fed | 2008-06-05 13:03:36 +0200 | [diff] [blame] | 414 | (db->outblk)(packet, length); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 415 | |
| 416 | /* Set TX length to DM9000 */ |
| 417 | DM9000_iow(DM9000_TXPLL, length & 0xff); |
| 418 | DM9000_iow(DM9000_TXPLH, (length >> 8) & 0xff); |
| 419 | |
| 420 | /* Issue TX polling command */ |
Remy Bohmer | 16cb264 | 2008-06-03 15:26:23 +0200 | [diff] [blame] | 421 | DM9000_iow(DM9000_TCR, TCR_TXREQ); /* Cleared after TX complete */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 422 | |
| 423 | /* wait for end of transmission */ |
Jean-Christophe PLAGNIOL-VILLARD | 0383694 | 2008-10-16 15:01:15 +0200 | [diff] [blame] | 424 | tmo = get_timer(0) + 5 * CONFIG_SYS_HZ; |
Remy Bohmer | 16cb264 | 2008-06-03 15:26:23 +0200 | [diff] [blame] | 425 | while ( !(DM9000_ior(DM9000_NSR) & (NSR_TX1END | NSR_TX2END)) || |
| 426 | !(DM9000_ior(DM9000_ISR) & IMR_PTM) ) { |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 427 | if (get_timer(0) >= tmo) { |
| 428 | printf("transmission timeout\n"); |
| 429 | break; |
| 430 | } |
| 431 | } |
Remy Bohmer | 16cb264 | 2008-06-03 15:26:23 +0200 | [diff] [blame] | 432 | DM9000_iow(DM9000_ISR, IMR_PTM); /* Clear Tx bit in ISR */ |
| 433 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 434 | DM9000_DBG("transmit done\n\n"); |
| 435 | return 0; |
| 436 | } |
| 437 | |
| 438 | /* |
| 439 | Stop the interface. |
| 440 | The interface is stopped when it is brought. |
| 441 | */ |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 442 | static void dm9000_halt(struct eth_device *netdev) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 443 | { |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 444 | DM9000_DBG("%s\n", __func__); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 445 | |
| 446 | /* RESET devie */ |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 447 | dm9000_phy_write(0, 0x8000); /* PHY RESET */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 448 | DM9000_iow(DM9000_GPR, 0x01); /* Power-Down PHY */ |
| 449 | DM9000_iow(DM9000_IMR, 0x80); /* Disable all interrupt */ |
| 450 | DM9000_iow(DM9000_RCR, 0x00); /* Disable RX */ |
| 451 | } |
| 452 | |
| 453 | /* |
| 454 | Received a packet and pass to upper layer |
| 455 | */ |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 456 | static int dm9000_rx(struct eth_device *netdev) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 457 | { |
| 458 | u8 rxbyte, *rdptr = (u8 *) NetRxPackets[0]; |
| 459 | u16 RxStatus, RxLen = 0; |
Remy Bohmer | 5f63bf4 | 2008-06-03 15:26:21 +0200 | [diff] [blame] | 460 | struct board_info *db = &dm9000_info; |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 461 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 462 | /* Check packet ready or not, we must check |
| 463 | the ISR status first for DM9000A */ |
| 464 | if (!(DM9000_ior(DM9000_ISR) & 0x01)) /* Rx-ISR bit must be set. */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 465 | return 0; |
| 466 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 467 | DM9000_iow(DM9000_ISR, 0x01); /* clear PR status latched in bit 0 */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 468 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 469 | /* There is _at least_ 1 package in the fifo, read them all */ |
| 470 | for (;;) { |
| 471 | DM9000_ior(DM9000_MRCMDX); /* Dummy read */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 472 | |
Remy Bohmer | 90d1fed | 2008-06-05 13:03:36 +0200 | [diff] [blame] | 473 | /* Get most updated data, |
| 474 | only look at bits 0:1, See application notes DM9000 */ |
| 475 | rxbyte = DM9000_inb(DM9000_DATA) & 0x03; |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 476 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 477 | /* Status check: this byte must be 0 or 1 */ |
| 478 | if (rxbyte > DM9000_PKT_RDY) { |
| 479 | DM9000_iow(DM9000_RCR, 0x00); /* Stop Device */ |
| 480 | DM9000_iow(DM9000_ISR, 0x80); /* Stop INT request */ |
| 481 | printf("DM9000 error: status check fail: 0x%x\n", |
| 482 | rxbyte); |
| 483 | return 0; |
| 484 | } |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 485 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 486 | if (rxbyte != DM9000_PKT_RDY) |
| 487 | return 0; /* No packet received, ignore */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 488 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 489 | DM9000_DBG("receiving packet\n"); |
| 490 | |
| 491 | /* A packet ready now & Get status/length */ |
| 492 | (db->rx_status)(&RxStatus, &RxLen); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 493 | |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 494 | DM9000_DBG("rx status: 0x%04x rx len: %d\n", RxStatus, RxLen); |
| 495 | |
| 496 | /* Move data from DM9000 */ |
| 497 | /* Read received packet from RX SRAM */ |
| 498 | (db->inblk)(rdptr, RxLen); |
| 499 | |
| 500 | if ((RxStatus & 0xbf00) || (RxLen < 0x40) |
| 501 | || (RxLen > DM9000_PKT_MAX)) { |
| 502 | if (RxStatus & 0x100) { |
| 503 | printf("rx fifo error\n"); |
| 504 | } |
| 505 | if (RxStatus & 0x200) { |
| 506 | printf("rx crc error\n"); |
| 507 | } |
| 508 | if (RxStatus & 0x8000) { |
| 509 | printf("rx length error\n"); |
| 510 | } |
| 511 | if (RxLen > DM9000_PKT_MAX) { |
| 512 | printf("rx length too big\n"); |
| 513 | dm9000_reset(); |
| 514 | } |
| 515 | } else { |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 516 | DM9000_DMP_PACKET(__func__ , rdptr, RxLen); |
Remy Bohmer | eec38a1 | 2008-06-03 15:26:25 +0200 | [diff] [blame] | 517 | |
| 518 | DM9000_DBG("passing packet to upper layer\n"); |
| 519 | NetReceive(NetRxPackets[0], RxLen); |
| 520 | } |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 521 | } |
| 522 | return 0; |
| 523 | } |
| 524 | |
| 525 | /* |
| 526 | Read a word data from SROM |
| 527 | */ |
Remy Bohmer | cd9a36c | 2009-05-03 12:11:40 +0200 | [diff] [blame] | 528 | #if !defined(CONFIG_DM9000_NO_SROM) |
| 529 | void dm9000_read_srom_word(int offset, u8 *to) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 530 | { |
| 531 | DM9000_iow(DM9000_EPAR, offset); |
| 532 | DM9000_iow(DM9000_EPCR, 0x4); |
stefano babic | edb0687 | 2007-08-21 15:50:33 +0200 | [diff] [blame] | 533 | udelay(8000); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 534 | DM9000_iow(DM9000_EPCR, 0x0); |
David Brownell | 7190757 | 2009-04-16 23:15:15 -0700 | [diff] [blame] | 535 | to[0] = DM9000_ior(DM9000_EPDRL); |
| 536 | to[1] = DM9000_ior(DM9000_EPDRH); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 537 | } |
| 538 | |
Remy Bohmer | cd9a36c | 2009-05-03 12:11:40 +0200 | [diff] [blame] | 539 | void dm9000_write_srom_word(int offset, u16 val) |
stefano babic | 6708a60 | 2007-08-30 23:01:49 +0200 | [diff] [blame] | 540 | { |
| 541 | DM9000_iow(DM9000_EPAR, offset); |
| 542 | DM9000_iow(DM9000_EPDRH, ((val >> 8) & 0xff)); |
| 543 | DM9000_iow(DM9000_EPDRL, (val & 0xff)); |
| 544 | DM9000_iow(DM9000_EPCR, 0x12); |
| 545 | udelay(8000); |
| 546 | DM9000_iow(DM9000_EPCR, 0); |
| 547 | } |
Remy Bohmer | cd9a36c | 2009-05-03 12:11:40 +0200 | [diff] [blame] | 548 | #endif |
Ben Warren | 8707f62 | 2009-10-21 21:53:39 -0700 | [diff] [blame] | 549 | |
| 550 | static void dm9000_get_enetaddr(struct eth_device *dev) |
| 551 | { |
| 552 | #if !defined(CONFIG_DM9000_NO_SROM) |
| 553 | int i; |
| 554 | for (i = 0; i < 3; i++) |
| 555 | dm9000_read_srom_word(i, dev->enetaddr + (2 * i)); |
| 556 | #endif |
| 557 | } |
stefano babic | 6708a60 | 2007-08-30 23:01:49 +0200 | [diff] [blame] | 558 | |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 559 | /* |
| 560 | Read a byte from I/O port |
| 561 | */ |
| 562 | static u8 |
| 563 | DM9000_ior(int reg) |
| 564 | { |
| 565 | DM9000_outb(reg, DM9000_IO); |
| 566 | return DM9000_inb(DM9000_DATA); |
| 567 | } |
| 568 | |
| 569 | /* |
| 570 | Write a byte to I/O port |
| 571 | */ |
| 572 | static void |
| 573 | DM9000_iow(int reg, u8 value) |
| 574 | { |
| 575 | DM9000_outb(reg, DM9000_IO); |
| 576 | DM9000_outb(value, DM9000_DATA); |
| 577 | } |
| 578 | |
| 579 | /* |
| 580 | Read a word from phyxcer |
| 581 | */ |
| 582 | static u16 |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 583 | dm9000_phy_read(int reg) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 584 | { |
| 585 | u16 val; |
| 586 | |
| 587 | /* Fill the phyxcer register into REG_0C */ |
| 588 | DM9000_iow(DM9000_EPAR, DM9000_PHY | reg); |
| 589 | DM9000_iow(DM9000_EPCR, 0xc); /* Issue phyxcer read command */ |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 590 | udelay(100); /* Wait read complete */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 591 | DM9000_iow(DM9000_EPCR, 0x0); /* Clear phyxcer read command */ |
| 592 | val = (DM9000_ior(DM9000_EPDRH) << 8) | DM9000_ior(DM9000_EPDRL); |
| 593 | |
| 594 | /* The read data keeps on REG_0D & REG_0E */ |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 595 | DM9000_DBG("dm9000_phy_read(0x%x): 0x%x\n", reg, val); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 596 | return val; |
| 597 | } |
| 598 | |
| 599 | /* |
| 600 | Write a word to phyxcer |
| 601 | */ |
| 602 | static void |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 603 | dm9000_phy_write(int reg, u16 value) |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 604 | { |
| 605 | |
| 606 | /* Fill the phyxcer register into REG_0C */ |
| 607 | DM9000_iow(DM9000_EPAR, DM9000_PHY | reg); |
| 608 | |
| 609 | /* Fill the written data into REG_0D & REG_0E */ |
| 610 | DM9000_iow(DM9000_EPDRL, (value & 0xff)); |
| 611 | DM9000_iow(DM9000_EPDRH, ((value >> 8) & 0xff)); |
| 612 | DM9000_iow(DM9000_EPCR, 0xa); /* Issue phyxcer write command */ |
Remy Bohmer | 61b8dbd | 2008-06-03 15:26:26 +0200 | [diff] [blame] | 613 | udelay(500); /* Wait write complete */ |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 614 | DM9000_iow(DM9000_EPCR, 0x0); /* Clear phyxcer write command */ |
Andy Fleming | 0d2df96 | 2011-03-22 22:49:13 -0500 | [diff] [blame] | 615 | DM9000_DBG("dm9000_phy_write(reg:0x%x, value:0x%x)\n", reg, value); |
wdenk | 7ac1610 | 2004-08-01 22:48:16 +0000 | [diff] [blame] | 616 | } |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 617 | |
| 618 | int dm9000_initialize(bd_t *bis) |
| 619 | { |
| 620 | struct eth_device *dev = &(dm9000_info.netdev); |
| 621 | |
Ben Warren | 8707f62 | 2009-10-21 21:53:39 -0700 | [diff] [blame] | 622 | /* Load MAC address from EEPROM */ |
| 623 | dm9000_get_enetaddr(dev); |
| 624 | |
Remy Bohmer | 7eefd92 | 2009-05-02 21:49:18 +0200 | [diff] [blame] | 625 | dev->init = dm9000_init; |
| 626 | dev->halt = dm9000_halt; |
| 627 | dev->send = dm9000_send; |
| 628 | dev->recv = dm9000_rx; |
| 629 | sprintf(dev->name, "dm9000"); |
| 630 | |
| 631 | eth_register(dev); |
| 632 | |
| 633 | return 0; |
| 634 | } |