mirror of
https://review.coreboot.org/flashrom.git
synced 2025-04-26 22:52:34 +02:00
00ec027368
For - chipsets - boards, and - chips Previously the chipset columns were not uniformly divided at all, which led to very odd table bottoms. This patches fixes this as far as wiki code can do (browser rendering can still create odd effects because we do not define cell heights). Corresponding to flashrom svn r1556. Signed-off-by: Stefan Tauner <stefan.tauner@alumni.tuwien.ac.at> Acked-by: Stefan Tauner <stefan.tauner@alumni.tuwien.ac.at>
373 lines
12 KiB
C
373 lines
12 KiB
C
/*
|
|
* This file is part of the flashrom project.
|
|
*
|
|
* Copyright (C) 2009 Uwe Hermann <uwe@hermann-uwe.de>
|
|
* Copyright (C) 2009 Carl-Daniel Hailfinger
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
#include <stdlib.h>
|
|
#include <time.h>
|
|
#include "flash.h"
|
|
#include "flashchips.h"
|
|
#include "programmer.h"
|
|
|
|
static const char wiki_header[] = "= Supported devices =\n\n\
|
|
<div style=\"margin-top:0.5em; padding:0.5em 0.5em 0.5em 0.5em; \
|
|
background-color:#eeeeee; text-align:right; border:1px solid #aabbcc;\">\
|
|
<small>\n\
|
|
Please do '''not''' edit these tables in the wiki directly, they are \
|
|
generated by pasting '''flashrom -z''' output.<br />\
|
|
'''Last update:''' %s(generated by flashrom %s)\n</small></div>\n";
|
|
|
|
static const char th_start[] = "| valign=\"top\"|\n\n\
|
|
{| border=\"0\" style=\"font-size: smaller\" valign=\"top\"\n\
|
|
|- bgcolor=\"#6699dd\"\n";
|
|
|
|
#if CONFIG_INTERNAL == 1
|
|
static const char chipset_th[] = "\
|
|
! align=\"left\" | Vendor\n\
|
|
! align=\"left\" | Southbridge\n\
|
|
! align=\"center\" | PCI IDs\n\
|
|
! align=\"center\" | Status\n\n";
|
|
|
|
static const char board_th[] = "\
|
|
! align=\"left\" | Vendor\n\
|
|
! align=\"left\" | Mainboard\n\
|
|
! align=\"left\" | Required option\n\
|
|
! align=\"center\" | Status\n\n";
|
|
|
|
static const char board_intro[] = "\
|
|
\n== Supported mainboards ==\n\n\
|
|
In general, it is very likely that flashrom works out of the box even if your \
|
|
mainboard is not listed below.\n\nThis is a list of mainboards where we have \
|
|
verified that they either do or do not need any special initialization to \
|
|
make flashrom work (given flashrom supports the respective chipset and flash \
|
|
chip), or that they do not yet work at all. If they do not work, support may \
|
|
or may not be added later.\n\n\
|
|
Mainboards (or individual revisions) which don't appear in the list may or may \
|
|
not work (we don't know, someone has to give it a try). Please report any \
|
|
further verified mainboards on the [[Mailinglist|mailing list]].\n";
|
|
#endif
|
|
|
|
static const char chip_th[] = "\
|
|
! align=\"left\" | Vendor\n\
|
|
! align=\"left\" | Device\n\
|
|
! align=\"center\" | Size [kB]\n\
|
|
! align=\"center\" | Type\n\
|
|
! align=\"center\" colspan=\"4\" | Status\n\
|
|
! align=\"center\" colspan=\"2\" | Voltage [V]\n\n\
|
|
|- bgcolor=\"#6699ff\"\n| colspan=\"4\" | \n\
|
|
| Probe\n| Read\n| Erase\n| Write\n\
|
|
| align=\"center\" | Min \n| align=\"center\" | Max\n\n";
|
|
|
|
static const char programmer_th[] = "\
|
|
! align=\"left\" | Vendor\n\
|
|
! align=\"left\" | Device\n\
|
|
! align=\"center\" | PCI IDs\n\
|
|
! align=\"center\" | Status\n\n";
|
|
|
|
static const char programmer_intro[] = "\
|
|
\n== Supported programmers ==\n\n\
|
|
This is a list of supported PCI devices flashrom can use as programmer:\n\n{";
|
|
|
|
#if CONFIG_INTERNAL == 1
|
|
static const char laptop_intro[] = "\n== Supported laptops/notebooks ==\n\n\
|
|
In general, flashing laptops is more difficult because laptops\n\n\
|
|
* often use the flash chip for stuff besides the BIOS,\n\
|
|
* often have special protection stuff which has to be handled by flashrom,\n\
|
|
* often use flash translation circuits which need drivers in flashrom.\n\n\
|
|
<div style=\"margin-top:0.5em; padding:0.5em 0.5em 0.5em 0.5em; \
|
|
background-color:#ff6666; align:right; border:1px solid #000000;\">\n\
|
|
'''IMPORTANT:''' At this point we recommend to '''not''' use flashrom on \
|
|
untested laptops unless you have a means to recover from a flashing that goes \
|
|
wrong (a working backup flash chip and/or good soldering skills).\n</div>\n";
|
|
|
|
static void print_supported_chipsets_wiki(int cols)
|
|
{
|
|
int i;
|
|
unsigned int lines_per_col;
|
|
const struct penable *e;
|
|
int enablescount = 0, color = 1;
|
|
|
|
for (e = chipset_enables; e->vendor_name != NULL; e++)
|
|
enablescount++;
|
|
|
|
/* +1 to force the resulting number of columns to be < cols */
|
|
lines_per_col = enablescount / cols + ((enablescount%cols) > 0 ? 1 : 0);
|
|
|
|
printf("\n== Supported chipsets ==\n\nTotal amount of supported chipsets: '''%d'''\n\n"
|
|
"{| border=\"0\" valign=\"top\"\n", enablescount);
|
|
|
|
e = chipset_enables;
|
|
for (i = 0; e[i].vendor_name != NULL; i++) {
|
|
if ((i % lines_per_col) == 0)
|
|
printf("%s%s", th_start, chipset_th);
|
|
|
|
/* Alternate colors if the vendor changes. */
|
|
if (i > 0 && strcmp(e[i].vendor_name, e[i - 1].vendor_name))
|
|
color = !color;
|
|
|
|
printf("|- bgcolor=\"#%s\"\n| %s || %s "
|
|
"|| %04x:%04x || %s\n", (color) ? "eeeeee" : "dddddd",
|
|
e[i].vendor_name, e[i].device_name,
|
|
e[i].vendor_id, e[i].device_id,
|
|
(e[i].status == OK) ? "{{OK}}" : "{{?3}}");
|
|
|
|
if (((i % lines_per_col) + 1) == lines_per_col)
|
|
printf("\n|}\n\n");
|
|
}
|
|
|
|
/* end inner table if it did not fill the last column fully */
|
|
if (((i % lines_per_col)) > 0)
|
|
printf("\n|}\n\n");
|
|
printf("\n\n|}\n");
|
|
}
|
|
|
|
static void wiki_helper(const char *devicetype, int cols, const struct board_info boards[])
|
|
{
|
|
int i, k;
|
|
unsigned int boardcount, lines_per_col;
|
|
unsigned int boardcount_good = 0, boardcount_bad = 0, boardcount_nt = 0;
|
|
int num_notes = 0, color = 1;
|
|
char *notes = calloc(1, 1);
|
|
char tmp[900 + 1];
|
|
const struct board_match *b = board_matches;
|
|
|
|
for (i = 0; boards[i].vendor != NULL; i++) {
|
|
if (boards[i].working == OK)
|
|
boardcount_good++;
|
|
else if (boards[i].working == NT)
|
|
boardcount_nt++;
|
|
else
|
|
boardcount_bad++;
|
|
}
|
|
boardcount = boardcount_good + boardcount_nt + boardcount_bad;
|
|
|
|
/* +1 to force the resulting number of columns to be < cols */
|
|
lines_per_col = boardcount / cols + ((boardcount%cols) > 0 ? 1 : 0);
|
|
|
|
printf("\n\nTotal amount of known good boards %s: '''%d'''; "
|
|
"Untested (e.g. user vanished before testing new code): '''%d'''; "
|
|
"Not yet supported (i.e. known-bad): '''%d'''.\n\n"
|
|
"{| border=\"0\" valign=\"top\"\n", devicetype, boardcount_good, boardcount_nt, boardcount_bad);
|
|
|
|
for (i = 0; boards[i].vendor != NULL; i++) {
|
|
if ((i % lines_per_col) == 0)
|
|
printf("%s%s", th_start, board_th);
|
|
|
|
/* Alternate colors if the vendor changes. */
|
|
if (i > 0 && strcmp(boards[i].vendor, boards[i - 1].vendor))
|
|
color = !color;
|
|
|
|
k = 0;
|
|
while ((b[k].vendor_name != NULL) &&
|
|
(strcmp(b[k].vendor_name, boards[i].vendor) ||
|
|
strcmp(b[k].board_name, boards[i].name))) {
|
|
k++;
|
|
}
|
|
|
|
printf("|- bgcolor=\"#%s\"\n| %s || %s%s %s%s || %s%s%s%s "
|
|
"|| {{%s}}", (color) ? "eeeeee" : "dddddd",
|
|
boards[i].vendor,
|
|
boards[i].url ? "[" : "",
|
|
boards[i].url ? boards[i].url : "",
|
|
boards[i].name,
|
|
boards[i].url ? "]" : "",
|
|
b[k].lb_vendor ? "-p internal:mainboard=" : "—",
|
|
b[k].lb_vendor ? b[k].lb_vendor : "",
|
|
b[k].lb_vendor ? ":" : "",
|
|
b[k].lb_vendor ? b[k].lb_part : "",
|
|
(boards[i].working == OK) ? "OK" :
|
|
(boards[i].working == NT) ? "?3" : "No");
|
|
|
|
if (boards[i].note) {
|
|
printf("<sup>%d</sup>\n", num_notes + 1);
|
|
snprintf(tmp, sizeof(tmp), "<sup>%d</sup> %s<br />\n",
|
|
1 + num_notes++, boards[i].note);
|
|
notes = strcat_realloc(notes, tmp);
|
|
} else {
|
|
printf("\n");
|
|
}
|
|
|
|
if (((i % lines_per_col) + 1) == lines_per_col)
|
|
printf("\n|}\n\n");
|
|
}
|
|
|
|
/* end inner table if it did not fill the last column fully */
|
|
if (((i % lines_per_col)) > 0)
|
|
printf("\n|}\n\n");
|
|
printf("\n\n|}\n");
|
|
|
|
if (num_notes > 0)
|
|
printf("\n<small>\n%s</small>\n", notes);
|
|
free(notes);
|
|
}
|
|
|
|
static void print_supported_boards_wiki(void)
|
|
{
|
|
printf("%s", board_intro);
|
|
wiki_helper("boards", 2, boards_known);
|
|
|
|
printf("%s", laptop_intro);
|
|
wiki_helper("laptops", 1, laptops_known);
|
|
}
|
|
#endif
|
|
|
|
static void print_supported_chips_wiki(int cols)
|
|
{
|
|
unsigned int lines_per_col;
|
|
uint32_t t;
|
|
char *s;
|
|
char vmax[6];
|
|
char vmin[6];
|
|
const struct flashchip *f, *old = NULL;
|
|
int i = 0, c = 1, chipcount = 0;
|
|
|
|
for (f = flashchips; f->name != NULL; f++) {
|
|
/* Don't count generic entries. */
|
|
if (!strncmp(f->vendor, "Unknown", 7) ||
|
|
!strncmp(f->vendor, "Programmer", 10) ||
|
|
!strncmp(f->name, "unknown", 7))
|
|
continue;
|
|
chipcount++;
|
|
}
|
|
|
|
/* +1 to force the resulting number of columns to be < cols */
|
|
lines_per_col = chipcount / cols + ((chipcount%cols) > 0 ? 1 : 0);
|
|
|
|
printf("\n== Supported chips ==\n\nTotal amount of supported chips: '''%d'''\n\n"
|
|
"{| border=\"0\" valign=\"top\"\n", chipcount);
|
|
|
|
for (f = flashchips; f->name != NULL; f++) {
|
|
/* Don't print generic entries. */
|
|
if (!strncmp(f->vendor, "Unknown", 7) ||
|
|
!strncmp(f->vendor, "Programmer", 10) ||
|
|
!strncmp(f->name, "unknown", 7))
|
|
continue;
|
|
|
|
if ((i % lines_per_col) == 0)
|
|
printf("%s%s", th_start, chip_th);
|
|
|
|
/* Alternate colors if the vendor changes. */
|
|
if (old != NULL && strcmp(old->vendor, f->vendor))
|
|
c = !c;
|
|
|
|
old = f;
|
|
t = f->tested;
|
|
s = flashbuses_to_text(f->bustype);
|
|
sprintf(vmin, "%0.03f", f->voltage.min / (double)1000);
|
|
sprintf(vmax, "%0.03f", f->voltage.max / (double)1000);
|
|
/* '{{%s}}' is used in combination with 'OK', 'No' and '?3' to
|
|
* select special formatting templates for the bg color. */
|
|
printf("|- bgcolor=\"#%s\"\n| %s || %s || align=\"right\" | %d "
|
|
"|| %s || {{%s}} || {{%s}} || {{%s}} || {{%s}}"
|
|
"|| %s || %s \n",
|
|
(c == 1) ? "eeeeee" : "dddddd", f->vendor, f->name,
|
|
f->total_size, s,
|
|
(t & TEST_OK_PROBE) ? "OK" :
|
|
(t & TEST_BAD_PROBE) ? "No" : "?3",
|
|
(t & TEST_OK_READ) ? "OK" :
|
|
(t & TEST_BAD_READ) ? "No" : "?3",
|
|
(t & TEST_OK_ERASE) ? "OK" :
|
|
(t & TEST_BAD_ERASE) ? "No" : "?3",
|
|
(t & TEST_OK_WRITE) ? "OK" :
|
|
(t & TEST_BAD_WRITE) ? "No" : "?3",
|
|
f->voltage.min ? vmin : "N/A",
|
|
f->voltage.min ? vmax : "N/A");
|
|
free(s);
|
|
|
|
if (((i % lines_per_col) + 1) == lines_per_col)
|
|
printf("\n|}\n\n");
|
|
i++;
|
|
}
|
|
/* end inner table if it did not fill the last column fully */
|
|
if (((i % lines_per_col)) > 0)
|
|
printf("\n|}\n\n");
|
|
printf("|}\n\n");
|
|
}
|
|
|
|
/* Not needed for CONFIG_INTERNAL, but for all other PCI-based programmers. */
|
|
#if CONFIG_NIC3COM+CONFIG_NICREALTEK+CONFIG_NICNATSEMI+CONFIG_GFXNVIDIA+CONFIG_DRKAISER+CONFIG_SATASII+CONFIG_ATAHPT+CONFIG_NICINTEL+CONFIG_NICINTEL_SPI+CONFIG_OGP_SPI+CONFIG_SATAMV >= 1
|
|
static void print_supported_pcidevs_wiki(const struct pcidev_status *devs)
|
|
{
|
|
int i = 0;
|
|
static int c = 0;
|
|
|
|
/* Alternate colors if the vendor changes. */
|
|
c = !c;
|
|
|
|
for (i = 0; devs[i].vendor_name != NULL; i++) {
|
|
printf("|- bgcolor=\"#%s\"\n| %s || %s || "
|
|
"%04x:%04x || {{%s}}\n", (c) ? "eeeeee" : "dddddd",
|
|
devs[i].vendor_name, devs[i].device_name,
|
|
devs[i].vendor_id, devs[i].device_id,
|
|
(devs[i].status == NT) ? "?3" : "OK");
|
|
}
|
|
}
|
|
#endif
|
|
|
|
void print_supported_wiki(void)
|
|
{
|
|
time_t t = time(NULL);
|
|
|
|
printf(wiki_header, ctime(&t), flashrom_version);
|
|
print_supported_chips_wiki(2);
|
|
#if CONFIG_INTERNAL == 1
|
|
print_supported_chipsets_wiki(3);
|
|
print_supported_boards_wiki();
|
|
#endif
|
|
printf("%s%s%s", programmer_intro, th_start, programmer_th);
|
|
|
|
#if CONFIG_NIC3COM == 1
|
|
print_supported_pcidevs_wiki(nics_3com);
|
|
#endif
|
|
#if CONFIG_NICREALTEK == 1
|
|
print_supported_pcidevs_wiki(nics_realtek);
|
|
#endif
|
|
#if CONFIG_NICNATSEMI == 1
|
|
print_supported_pcidevs_wiki(nics_natsemi);
|
|
#endif
|
|
#if CONFIG_GFXNVIDIA == 1
|
|
print_supported_pcidevs_wiki(gfx_nvidia);
|
|
#endif
|
|
#if CONFIG_DRKAISER == 1
|
|
print_supported_pcidevs_wiki(drkaiser_pcidev);
|
|
#endif
|
|
#if CONFIG_SATASII == 1
|
|
print_supported_pcidevs_wiki(satas_sii);
|
|
#endif
|
|
#if CONFIG_ATAHPT == 1
|
|
print_supported_pcidevs_wiki(ata_hpt);
|
|
#endif
|
|
#if CONFIG_NICINTEL == 1
|
|
print_supported_pcidevs_wiki(nics_intel);
|
|
#endif
|
|
#if CONFIG_NICINTEL_SPI == 1
|
|
print_supported_pcidevs_wiki(nics_intel_spi);
|
|
#endif
|
|
#if CONFIG_OGP_SPI == 1
|
|
print_supported_pcidevs_wiki(ogp_spi);
|
|
#endif
|
|
#if CONFIG_SATAMV == 1
|
|
print_supported_pcidevs_wiki(satas_mv);
|
|
#endif
|
|
printf("\n|}\n\n|}\n");
|
|
}
|
|
|