diff options
Diffstat (limited to 'contrib/3c90xutil/cromutil.c')
| -rw-r--r-- | contrib/3c90xutil/cromutil.c | 274 |
1 files changed, 215 insertions, 59 deletions
diff --git a/contrib/3c90xutil/cromutil.c b/contrib/3c90xutil/cromutil.c index d4751fbf2..b86807801 100644 --- a/contrib/3c90xutil/cromutil.c +++ b/contrib/3c90xutil/cromutil.c @@ -1,101 +1,257 @@ -/* - * 3c905cutil.c - perform various control ops on the 3C905C bios rom - * which we assume to be an AT49BV512 +/* + * JLdL 21Jun04. + * + * cromutil.c + * + * Perform various control operations on the flash EEPROM of + * _ the 3COM models 3C905C or 3C905CX network cards, in order + * _ to write a boot program such as Etherboot into it. + * + * This program is meant for the Linux operating system only, + * _ and only for the i386 architecture. + * + * The flash EEPROM usually used in these cards is the AT49BV512 + * _ chip, which has 512 Kbit (64 KByte). Another possible chip, + * _ which is equivalent to this one, is the SST39VF512. + * + * Added alternative read128 and prog128 commands for cards with + * _ the SST29EE020 fast page-write (super-)flash EEPROM, which + * _ has 2 Mbit (256 KByte), and which has to be programmed in + * _ a 128-byte page mode. NOTE: it seems that the card can + * _ address only the first half of the memory in this chip, + * _ so only 128 Kbytes are actually available for use. + * + * Added a few informative messages and a detailed help message. * */ #ifndef __i386__ -# error "This program can't compile or run on non-intel computers" +# error "This program can't compile or run on non-Intel computers" #else #include <stdio.h> #include <stdlib.h> #include <unistd.h> #include <sys/io.h> +#include <string.h> int main(int argc, char **argv) { - unsigned int ioaddr, i, n; + /* Counters. */ + unsigned int i, j, n; + /* For ROM chips larger than 64 KB, a long integer + _ is needed for the global byte counter. */ + unsigned long k; + /* The I/O address of the card. */ + unsigned int ioaddr; + /* Storage for a byte. */ unsigned char b; + /* Storage for a page. */ + unsigned char buf[128]; + + /* Initialize a few things to avoid compiler warnings. */ + i=0; j=0; n=0; k=0; - setuid(0); /* if we're setuid, do it really */ + /* Verify the command-line parameters; write + _ out an usage message if needed. */ if (argc != 3) { - printf("Usage: romid ioaddr [erase|id|read >file|prog <file]\n"); + /* Exactly 2 command line parameters are needed. */ + printf("Usage: ./cromutil ioaddr command [(>|<) file]\n"); + printf(" (try './cromutil 0x0000 help' for details)\n"); exit(-1); } + + /* Set the UID to root if possible. */ + setuid(0); + + /* Get port-access permissions for in{blw}/out{blw}. */ if (iopl(3)) { perror("iopl()"); exit(1); } + + /* Pass the I/O address of the card to a variable. */ sscanf(argv[1],"%x",&ioaddr); - /* Set the register window to 0 for the 3C905C */ + /* Set the register window to 0. */ outw(0x800, ioaddr+0xe); - if (strcmp(argv[2], "erase") == 0) { - /* do the funky chicken to erase the rom contents */ - outl(0x5555, ioaddr+0x4); - outb(0xaa, ioaddr+0x8); - outl(0x2aaa, ioaddr+0x4); - outb(0x55, ioaddr+0x8); - outl(0x5555, ioaddr+0x4); - outb(0x80, ioaddr+0x8); - outl(0x5555, ioaddr+0x4); - outb(0xaa, ioaddr+0x8); - outl(0x2aaa, ioaddr+0x4); - outb(0x55, ioaddr+0x8); - outl(0x5555, ioaddr+0x4); - outb(0x10, ioaddr+0x8); - sleep (1); - printf("Bios ROM at %04x has been erased\n", ioaddr); - } else if (strcmp(argv[2], "id") == 0) { - outl(0x5555, ioaddr+0x4); - outb(0xaa, ioaddr+0x8); - outl(0x2aaa, ioaddr+0x4); - outb(0x55, ioaddr+0x8); - outl(0x5555, ioaddr+0x4); - outb(0x90, ioaddr+0x8); - /* 10ms delay needed */ - printf("Manufacturer ID - "); - /* manuf. id */ + /* + * Execute the requested command. + * + * "id": get and write out the ID numbers. + */ + if (strcmp(argv[2], "id") == 0) { + /* Software ID entry command sequence. */ + outl(0x5555, ioaddr+0x4); outb(0xaa, ioaddr+0x8); + outl(0x2aaa, ioaddr+0x4); outb(0x55, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0x90, ioaddr+0x8); + /* A 10 ms delay is needed. */ + usleep(10000); + /* Get the manufacturer id. */ outl(0x0000, ioaddr+0x4); - printf("%02x\n", inb(ioaddr+0x8)); - /* device id */ + printf("Manufacturer ID - %02x\n", inb(ioaddr+0x8)); + /* Get the device id. */ outl(0x0001, ioaddr+0x4); printf("Device ID - %02x\n", inb(ioaddr+0x8)); - /* undo the funky chicken */ - outl(0x5555, ioaddr+0x4); - outb(0xaa, ioaddr+0x8); - outl(0x2aaa, ioaddr+0x4); - outb(0x55, ioaddr+0x8); - outl(0x5555, ioaddr+0x4); - outb(0xf0, ioaddr+0x8); - } else if (strcmp(argv[2], "read") == 0) { - for (i = 0; i < 65536; i++) { - outl(i, ioaddr+0x4); + /* Software ID exit command sequence. */ + outl(0x5555, ioaddr+0x4); outb(0xaa, ioaddr+0x8); + outl(0x2aaa, ioaddr+0x4); outb(0x55, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0xf0, ioaddr+0x8); + } + /* + * "read": read data from the 512 Kbit ROM. + */ + else if (strcmp(argv[2], "read") == 0) { + /* Loop over the whole ROM. */ + for (k = 0; k < 65536; k++) { + outl(k, ioaddr+0x4); + b = inb(ioaddr+0x8); + write(1, &b, 1); + } + /* Write out an informative message. */ + perror("Read 65536 bytes from ROM"); + } + /* + * "read128": this alternative is for the 2 Mbit ROM. + */ + else if (strcmp(argv[2], "read128") == 0) { + /* Loop over the accessible part of the ROM. */ + for (k = 0; k < 131072; k++) { + outl(k, ioaddr+0x4); b = inb(ioaddr+0x8); write(1, &b, 1); } - } else if (strcmp(argv[2], "prog") == 0) { - for (i = 0; i < 65536; i++) { - n = read(0, &b, 1); + /* Write out an informative message. */ + perror("Read 131072 bytes from ROM"); + } + /* + * "erase": erase the ROM contents. + */ + else if (strcmp(argv[2], "erase") == 0) { + /* Software chip-erase command sequence. */ + outl(0x5555, ioaddr+0x4); outb(0xaa, ioaddr+0x8); + outl(0x2aaa, ioaddr+0x4); outb(0x55, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0x80, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0xaa, ioaddr+0x8); + outl(0x2aaa, ioaddr+0x4); outb(0x55, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0x10, ioaddr+0x8); + /* Wait a bit. */ + sleep(1); + /* Write out an informative message. */ + printf("Bios ROM at %04x has been erased: Success\n", ioaddr); + } + /* + * "prog": program the 512 Kbit ROM. + */ + else if (strcmp(argv[2], "prog") == 0) { + /* Loop over the bytes in pages, to + _ allow for a progress report. */ + for (j = 0; j < 512; j++) { + for (i = 0; i < 128; i++) { + /* If this program is to run on a diskless node, + _ must read in the byte _before_ changing the + _ mode of the chip, or NFS may block. */ + n = read(0, &b, 1); + /* At EOF exit the inner loop. */ + if (n == 0) + break; + if (n < 0) { + perror("Input File Error"); + exit(-3); + } + /* Disable SDP temporarily for programming a byte. */ + outl(0x5555, ioaddr+0x4); outb(0xaa, ioaddr+0x8); + outl(0x2aaa, ioaddr+0x4); outb(0x55, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0xA0, ioaddr+0x8); + /* Calculate the address of the byte. */ + k=i+128*j; + /* Program this byte. */ + outl(k, ioaddr+0x4); outb(b, ioaddr+0x8); + /* Wait for the programming of this byte to complete. */ + while (inb(ioaddr+0x8) != b) + ; + } + /* At EOF exit the outer loop. */ + if (n == 0) + break; + /* Write out a progress report. */ + printf("."); fflush(NULL); + } + /* Write out an informative message. */ + printf("\nWrote %ld bytes to ROM: Success\n", k); + } + /* + * "prog128": this alternative is for the 2 Mbit ROM. + */ + else if (strcmp(argv[2], "prog128") == 0) { + /* Loop over the accessible pages; the card can + _ access only the first half of the chip. */ + for (j = 0; j < 1024; j++) { + /* If this program is to run on a diskless node, + _ must read in the page _before_ changing the + _ mode of the chip, or NFS may block. */ + n = read(0, buf, 128); + /* At EOF exit the loop. */ if (n == 0) break; if (n < 0) { - perror("File Error"); + perror("Input File Error"); exit(-3); } - outl(0x5555, ioaddr+0x4); - outb(0xaa, ioaddr+0x8); - outl(0x2aaa, ioaddr+0x4); - outb(0x55, ioaddr+0x8); - outl(0x5555, ioaddr+0x4); - outb(0xA0, ioaddr+0x8); - outl(i, ioaddr+0x4); - outb(b, ioaddr+0x8); - while (inb(ioaddr+0x8) != b) + /* Disable SDP temporarily for programming a page. */ + outl(0x5555, ioaddr+0x4); outb(0xaa, ioaddr+0x8); + outl(0x2aaa, ioaddr+0x4); outb(0x55, ioaddr+0x8); + outl(0x5555, ioaddr+0x4); outb(0xA0, ioaddr+0x8); + /* Loop over the bytes in a page. */ + for (i = 0; i < n; i++) { + /* Calculate the address of the byte. */ + k=i+128*j; + /* Program this byte. */ + outl(k, ioaddr+0x4); outb(buf[i], ioaddr+0x8); + } + /* Wait for the programming of this page to complete. */ + while (inb(ioaddr+0x8) != buf[i-1]) ; + /* Write out a progress report. */ + printf("."); fflush(NULL); } + /* Write out an informative message. */ + printf("\nWrote %d pages to ROM: Success\n", j); + } + /* + * "help": write out a detailed help message. + */ + else if (strcmp(argv[2], "help") == 0) { + printf("This utility can be used to write data, usually boot loaders\n"); + printf(" such as Etherboot, to the flash EEPROM of the 3COM models\n"); + printf(" 3C905C and 3C905CX network cards. You use it like this:\n"); + printf(" ./cromutil ioaddr command [(>|<) file]\n"); + printf("Here ioaddr is the hexadecimal I/O address of the card, such\n"); + printf(" as 0xA123, in some cases you need input/output redirection\n"); + printf(" from/to a file, and the command can be one of these:\n"); + printf(" id get the ID numbers of the card;\n"); + printf(" read > file read the contents of the ROM into a file;\n"); + printf(" read128 > file read the contents of the ROM into a file;\n"); + printf(" erase erase the whole ROM to the 1 state;\n"); + printf(" prog < file write the contents of a file into the ROM;\n"); + printf(" prog128 < file write the contents of a file into the ROM.\n"); + printf("You can get the I/O address of the card using the commands\n"); + printf(" 'lspci -v', 'cat /proc/pci', or 'dmesg | grep -i 3C905C'.\n"); + printf("The read and prog commands are to be used if the card has a\n"); + printf(" traditional 512 Kb (64 KB) flash EEPROM chip, such as:\n"); + printf(" | AT49BV512 | SST39VF512 |\n"); + printf("The read128 and prog128 versions are for cards with a 2 Mb\n"); + printf(" (128 KB usable) page-write flash EEPROM chip, such as:\n"); + printf(" | SST29EE020 |\n"); + } + /* + * Write out the usage message if an unknown command is used. + */ + else { + printf("Usage: ./cromutil ioaddr command [(>|<) file]\n"); + printf("(try './cromutil 0x0000 help' for details)\n"); + exit(-1); } return 0; } |