summaryrefslogtreecommitdiffstats
path: root/contrib/3c90xutil/cromutil.c
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/3c90xutil/cromutil.c')
-rw-r--r--contrib/3c90xutil/cromutil.c274
1 files changed, 215 insertions, 59 deletions
diff --git a/contrib/3c90xutil/cromutil.c b/contrib/3c90xutil/cromutil.c
index d4751fbf..b8680780 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;
}
generated by cgit v1.2.3-55-g7522 (git 2.39.0) at 2024-05-17 08:39:22 +0200