Ciekawostka, dla zainteresowanych tematem Hadesa.
Ostatnio sporo czasu poświęciłem tej maszynie, głównie testom nowego oprogramowania.
Najważniejsze to nowy PCI BIOS z poprawkami i obsługą kart wielofunkcyjnych (jak choćby kontroler USB).
Do tego uruchomienie kilku kart które albo nie działały, bo nie było sterownika, albo sterownik był, a i tak nie działały (ES1373).
Wspomniana karta dźwiękowa ruszyła po wymianie układu RAMROM na płycie (GSXB jest niewinne i działa).
Kontroler NEC USB z nowym PCI-BIOS działa (wszystkie porty) zarówno pod TOS jak i MiNT
ATI Radeon też działa, a po przeprogramowaniu pamięci flash na karcie, startuje razem z Hadesem (logo, test pamięci). Potem sterownik fVDI i są kolory.
Wszystkie sterowniki wrzucę na stronę, jak tylko się trochę ogarnę z tym wszystkim.
Specyfikacja biosu 2.0:
HADES PCI-BIOS - SPECYFIKACJA INTERFEJSU I PLAN NOWEJ WERSJI
=================================================================
Stan: 17.11.2026 (wersja BIOS-u 2.0 stage 2d)
=================================================================
1. COOKIE _PCI
=================================================================
Wartosc cookie "_PCI" = adres struktury: [KOD]
+$00 long wskaznik "subcookie" - stary BIOS sam: 0; PCI_CONF:
wskaznik na liste znacznikow (punkt 9)
+$04 long wersja interfejsu = $00010000 (1.00)
+$08 long funkcja 0 (find_pci_device)
... po 4 bajty
+$B0 long funkcja 42 (phys_to_virt)
43 funkcje, numer XBIOS w stylu CTPCI = 300 + numer funkcji.
Stary BIOS NIE instaluje XBIOS 300+ (robi to dzis PCIXB.PRG).
Inne cookie, ktorych uzywa: "hade" (wymagane - bez niego "not
installed"), "_PCI" (gdy jest i wersja != 0 -> "already installed";
gdy +$00 != 0 -> tryb PCI_CONF). Przy pelnym Cookie Jar komunikat
"Please increase the size of the CookieJar". [KOD]
=================================================================
2. KONWENCJA WYWOLAN
=================================================================
Rejestry (konwencja Pure C): [KOD]
d0 = uchwyt (handle), d1 = numer rejestru / adres PCI,
d2 = wartosc do zapisu, a0 = wskaznik na wynik (wersje "nie-fast")
lub argument, a1 = drugi argument (hook_interrupt).
Wynik w d0 (kod bledu albo wartosc).
Niszczone: d0-d2/a0-a1. Zachowane: d3-d7/a2-a6.
Funkcje "fast_*" nie sprawdzaja nic i zwracaja wartosc w d0.
Funkcje zwykle zwracaja kod bledu, wartosc przez (a0).
Stary BIOS nie przelacza trybu procesora - na Hadesie bez MMU
dostep do PCI dziala tez w trybie uzytkownika (skanowanie przy
starcie idzie w trybie uzytkownika). [KOD][HIP]
[NOWY] Zakladac wywolanie w trybie supervisor (jak CTPCI); XBIOS
300+ przelacza tryb sam.
Uchwyt w 1.13d = numer slotu: [KOD]
0 -> PCI1, konfiguracja $A008'0000
1 -> PCI2, $A004'0000
2 -> PCI3, $A002'0000
3 -> PCI4, $A001'0000
(tablica w DATA, wpisy $A0080000/$A0040000/$A0020000/$A0010000)
Poza 0..3 -> -9. Tylko funkcja 0 kazdego slotu.
Kody bledow (zgodne ze specyfikacja PCI-BIOS):
0 PCI_SUCCESSFUL
-2 PCI_FUNC_NOT_SUPPORTED
-3 PCI_BAD_VENDOR_ID (nieuzywany w 1.13d)
-4 PCI_DEVICE_NOT_FOUND
-5 PCI_BAD_REGISTER_NUMBER (rejestr konfiguracji niewyrownany)
-6 PCI_SET_FAILED (nieuzywany)
-7 PCI_BUFFER_TOO_SMALL (nieuzywany)
-8 PCI_GENERAL_ERROR (adres pamieci/IO niewyrownany,
przerwanie juz zajete)
-9 PCI_BAD_HANDLE
=================================================================
3. LISTA FUNKCJI
=================================================================
nr off XBIOS nazwa TEXT argumenty -> wynik
-- --- ----- ----------------------- ----- ------------------
0 $08 300 find_pci_device $1592 d0=id, d1=indeks
-> uchwyt / -4
1 $0C 301 find_pci_classcode $15F2 d0=klasa, d1=indeks
-> uchwyt / -4
2 $10 302 read_config_byte $167C d0,d1,a0 -> blad
3 $14 303 read_config_word $16AA d0,d1,a0 -> blad
4 $18 304 read_config_longword $16FE d0,d1,a0 -> blad
5 $1C 305 fast_read_config_byte $1E14 d0,d1 -> wartosc
6 $20 306 fast_read_config_word $1E32 d0,d1 -> wartosc
7 $24 307 fast_read_config_longword $1E6C d0,d1 -> wartosc
8 $28 308 write_config_byte $1758 d0,d1,d2 -> blad
9 $2C 309 write_config_word $178A d0,d1,d2 -> blad
10 $30 310 write_config_longword $17DA d0,d1,d2 -> blad
11 $34 311 hook_interrupt $1830 d0,a0=proc,a1=param
12 $38 312 unhook_interrupt $18C0 d0 -> blad
13 $3C 313 special_cycle $190C -> -2 zawsze
14 $40 314 get_routing $1910 -> -9 / -2
15 $44 315 set_interrupt $1922 -> -9 / -2
16 $48 316 get_resource $1934 d0 -> wskaznik / -9
17 $4C 317 get_card_used $195C d0,a0 -> status
18 $50 318 set_card_used $1996 d0,a0 -> blad
19 $54 319 read_mem_byte $1A00 d0,d1=adres,a0
20 $58 320 read_mem_word $1A22 d0,d1,a0
21 $5C 321 read_mem_longword $1A6A d0,d1,a0
22 $60 322 fast_read_mem_byte $1EA8 d1 -> wartosc
23 $64 323 fast_read_mem_word $1EBA d1 -> wartosc
24 $68 324 fast_read_mem_longword $1EE8 d1 -> wartosc
25 $6C 325 write_mem_byte $1AB4 d0,d1,d2
26 $70 326 write_mem_word $1ADA d0,d1,d2
27 $74 327 write_mem_longword $1B22 d0,d1,d2
28 $78 328 read_io_byte $1B6C jak read_mem_*
29 $7C 329 read_io_word $1B8E
30 $80 330 read_io_longword $1BD6
31 $84 331 fast_read_io_byte $1F14
32 $88 332 fast_read_io_word $1F26
33 $8C 333 fast_read_io_longword $1F54
34 $90 334 write_io_byte $1C20 jak write_mem_*
35 $94 335 write_io_word $1C46
36 $98 336 write_io_longword $1C8E
37 $9C 337 get_machine_id $1CD8 -> id
38 $A0 338 get_pagesize $1CE0 -> 0
39 $A4 339 virt_to_bus $1CE4 d0,d1=adres,a0
40 $A8 340 bus_to_virt $1CFA d0,d1=adres,a0
41 $AC 341 virt_to_phys $1D10 -> -2
42 $B0 342 phys_to_virt $1D14 -> -2
[KOD]
=================================================================
4. SZCZEGOLY FUNKCJI (zachowanie 1.13d)
=================================================================
find_pci_device(d0 = (device << 16) | vendor, d1 = indeks) [KOD]
- vendor $FFFF = dowolna karta (device ignorowane); liczy sloty, w
ktorych vendor != $FFFF.
- inaczej porownuje caly long konfiguracji $00 (wartosc PCI, juz
po zamianie bajtow) z d0.
- indeks = ktora z pasujacych (0 = pierwsza). Wynik: uchwyt albo -4.
find_pci_classcode(d0, d1 = indeks) [KOD]
- d0 bity 0-7 = prog-if (rej. $09), 8-15 = podklasa ($0A),
16-23 = klasa ($0B).
- bit 24 = ignoruj prog-if, bit 25 = ignoruj podklase,
bit 26 = ignoruj klase.
- pomija sloty z vendor $FFFF.
read/write_config_* [KOD]
- adres = baza slotu + d1 (d1 traktowany jako bajt 0..255).
- byte: bez sprawdzania wyrownania; word: d1 & 1 -> -5;
long: d1 & 3 -> -5.
- byte: dostep bajtowy pod prostym adresem;
word/long: dostep 16/32-bit + odwrocenie kolejnosci bajtow.
Zgodne z trybem 'swap' i poprawne na sprzecie. [KOD][KOMP]
- BRAK przechwytywania bus error (pusty slot: wartosc z szyny po
ok. 125 us). [KOD]
Uwaga: kompendium (punkt 8) pisze, ze funkcje PCI-BIOS-u
przechwytuja blad I/O - w 1.13d tego kodu nie ma. [?]
read/write_mem_* i *_io_* [KOD]
- d1 = adres PCI; CPU = d1 + $8000'0000 (pamiec) / + $B000'0000 (I/O).
- uchwyt sprawdzany tylko co do zakresu 0..3, adres NIE jest
sprawdzany wzgledem zasobow karty.
- word: d1 & 1 -> -8, long: d1 & 3 -> -8.
- byte: adres ^ 3; word: adres ^ 2 + odwrocenie bajtow;
long: odwrocenie bajtow bez zmiany adresu.
To jest model 'xor' (Intel AS) dla bajtow/slow, a 'swap' dla
longow - niespojne. Sprzet dziala w trybie 'swap': poprawne sa
tylko longi. [KOD][KOMP]
Deskryptory zasobow podaja przy tym flage ORD_INTEL_LS (=swap).
Starszy wynik z punktu 8 kompendium (slowo pod +2 = mlodsza
polowa) to najpewniej skutek ^2 w read_io_word, nie sprzetu.[HIP]
- miejsca z XOR (TEXT): ^3 $1A12 $1AC8 $1B7E $1C34 $1EB0 $1F1C,
^2 $1A3C $1B08 $1BA8 $1C74 $1EC4 $1F30.
hook_interrupt(d0 = uchwyt, a0 = procedura, a1 = parametr) [KOD]
- -8, gdy slot ma juz procedure. Zapisuje procedure i parametr,
wlacza bit w TT-MFP: IERB i IMRB (albo wola procedure z PCI_CONF).
- linie: PCI1 GPIP0, PCI2 GPIP1, PCI3 GPIP2, PCI4 GPIP5;
bity IERB/IMRB/IPRB/ISRB: 0, 1, 2, 7.
Wektor = ((VR TT-MFP $FFFF'FA97) & $F0) + bit, adres = wektor*4.
- przy starcie: AER i DDR TT-MFP dla tych linii kasowane (zbocze
opadajace, wejscie), IMRB/IERB kasowane.
- obsluga przerwania (XBRA "_PCI", po jednej na slot):
zachowuje d0-d7/a0-a6, wola procedure: d0 = 0, a0 = parametr;
procedura zwraca w d0 bit 0 = 1, jesli przerwanie bylo jej.
Gdy nie bylo (bit 0 = 0): przerwanie slotu WYLACZANE (IMRB, IERB,
IPRB) - zabezpieczenie przed zawieszeniem na przerwaniu
poziomowym. Gdy bylo: wola procedure DRUGI raz (blad - w kazdym
obiegu procedura jest wolana dwa razy), kasuje IPRB i powtarza,
dopoki linia GPIP jest w stanie aktywnym (0). Na koniec kasuje
bit ISRB, RTE.
[NOWY] jedno wywolanie na obieg.
- procedury obslugi instalowane przy starcie tylko dla kart
NIE-graficznych z Interrupt Pin ($3D) != 0.
- unhook_interrupt: kasuje IMRB, IERB, IPRB, ISRB, zeruje wpis.
get_resource(d0) -> d0 = wskaznik na pierwszy deskryptor [KOD]
Deskryptor zasobu, 20 bajtow:
+$00 word next odstep do nastepnego (zawsze $14)
+$02 word flags $8000 FLG_LAST, $4000 FLG_IO, $2000 FLG_ROM,
$0400 32 bit, $0200 16 bit, $0100 8 bit,
bity 0-3 kolejnosc: 0 Motorola, 1 Intel AS
('xor'), 2 Intel LS ('swap'), $F nieznana
+$04 long start adres PCI
+$08 long length rozmiar
+$0C long offset CPU = PCI + offset ($8000'0000 / $B000'0000)
+$10 long dmaoffset adres RAM z punktu widzenia karty = RAM +
dmaoffset ($8000'0000)
Wartosci flags w 1.13d: pamiec $0702, I/O $4702, ostatni +$8000.
Do 6 deskryptorow na slot (tablica $78 B na slot).
ROM ($30) nigdy nie jest podawany.
Bledy: karta bez BAR-ow -> flaga LAST trafia w poprzedni wpis
(poza tablice slotu); pusty slot -> deskryptory zerowe, bez
FLG_LAST. [KOD]
get_card_used(d0, a0) -> d0 = status, (a0) = wskaznik callback [KOD]
set_card_used(d0, a0)
- a0 == 0, 1 albo 3 (liczone tylko z MLODSZEGO SLOWA a0!) ->
status = a0, callback = 0; inaczej status = 2, callback = a0.
- status: 0 wolna, 1 zajeta, 2 zajeta z callback, 3 zajeta przez
system (przy starcie: kazda karta klasy $03 - grafika),
-4 pusty slot.
get_machine_id -> long z DATA [KOD]
- bez PCI_CONF: 4 cyfry ASCII spod $7FE4'9007 (ROM TOS-u) jako
liczba 16-bit BCD (np. "1234" -> $1234).
- z PCI_CONF: wartosc ze znacznika (punkt 9).
Co jest pod $7FE4'9007 w E55 - prawdopodobnie numer seryjny
"sn:xxxxxxxx" (kompendium, punkt 2). [HIP][?]
get_pagesize -> 0. [KOD]
virt_to_bus(d0, d1 = adres, a0 -> {long adres, long dlugosc}):
adres | $8000'0000, dlugosc $3FFF'FFFF, wynik 0.
bus_to_virt: adres & $7FFF'FFFF, dlugosc $3FFF'FFFF.
Bez uwzglednienia MMU (mapowanie 1:1 zakladane). [KOD]
=================================================================
5. START I PRZYDZIAL ZASOBOW (1.13d bez PCI_CONF)
=================================================================
Dla kazdego slotu 0..3, tylko funkcja 0: [KOD]
1. ID ($00); vendor $FFFF -> "no device", status -4.
2. Klasa ($08) - opis na ekranie; klasa $03 -> status 3, inaczej 0.
3. BAR-y $10..$24: odczyt, zapis $FFFFFFFF, odczyt rozmiaru,
przywrocenie; 0 -> brak BAR-u.
- grafika Tseng 100C:32x0 (ET4000/W32p): BAR0 = 0 (16 MB),
BAR1 = 0 (I/O 4 KB) - na stale, koniec.
- I/O: maska $FFFFFFFC, rozmiar = najmlodszy ustawiony bit,
wyrownanie do rozmiaru, od $1000, limit $0FFF'FFFF.
- pamiec: maska $FFFFFFF0, od $0100'0000, limit $1FFF'FFFF
(512 MB, a okno Hadesa ma 256 MB - KOMP punkt 8).
Typ 01 (ponizej 1 MB) - blad; typ 10 (64-bit) - gorna polowa
musi czytac $FFFFFFFF, zapisywana 0; inny - blad.
Prefetchable ignorowane. Bez sortowania wg rozmiaru.
- brak miejsca/blad: Command &= ~$000F (karta wylaczona),
"this device will be shut down now".
Blad 64-bit: po przydziale petla przechodzi do gornej polowy
jak do zwyklego BAR-u (zapis $FFFFFFFF -> odczyt $FFFFFFFF ->
"I/O, 1 bajt") i zapisuje tam adres I/O. [KOD][HIP]
4. Command NIE jest ustawiany (bity 0-2 zostaja jak po resecie). [KOD]
5. Karta nie-graficzna z Interrupt Pin != 0: procedura przerwania
wpisana do wektora TT-MFP.
6. Interrupt Line ($3C) = $FF.
7. Latency Timer ($0D): Min_Gnt=Max_Lat=0 -> $20; inaczej
Max_Lat*8, a gdy > $40 -> Min_Gnt*8.
Cache Line Size ($0C) nieruszany.
8. Cookie _PCI, Ptermres (calosc z BSS).
=================================================================
6. ZGODNOSC Z PCI_CONF (1.13d)
=================================================================
Gdy _PCI istnieje i +$00 != 0, BIOS bierze opis z PCI_CONF: [KOD]
lista 8-bajtowych wpisow {long znacznik, long wartosc}, koniec = 0.
Znacznik: bity 0-3 = slot (> 3 -> komunikat o braku obslugi kart
wielofunkcyjnych), slowo +2 & $FFF0: $4930 zasob/baza konfiguracji,
$5230 machine id, $5430 przerwania/slot grafiki.
[NOWY] Tego trybu nie odtwarzamy. Nowy BIOS sam przydziela zasoby;
przy wykryciu PCI_CONF (cookie _PCI z +$00 != 0) - komunikat
"usun PCI_CONF.PRG z AUTO" i bez instalacji.
=================================================================
7. NOWY BIOS - CO ZOSTAJE ZGODNE [NOWY]
=================================================================
- struktura cookie _PCI (punkt 1), wersja $00010000, 43 funkcje
w tej samej kolejnosci, rejestry jak w punkcie 2,
- kody bledow, format deskryptora (20 B, flagi), statusy card_used,
- uchwyty 0..3 = funkcja 0 slotow PCI1..PCI4 (jak dzis),
- konwencja procedur przerwan (d0 = 0, a0 = param, bit 0 wyniku),
- get_machine_id: ta sama wartosc co 1.13d,
- virt_to_bus/bus_to_virt: te same wyniki przy MMU wylaczonym.
=================================================================
8. NOWY BIOS - ZMIANY (etap 1) [NOWY]
=================================================================
1. Kolejnosc bajtow mem/io: bajt pod prostym adresem, slowo pod
prostym adresem + odwrocenie (tryb 'swap'), long bez zmian.
Flaga ORD_INTEL_LS w deskryptorach staje sie prawdziwa.
Opcja INF: stary tryb ('xor' dla bajtow/slow) dla programow,
ktore obchodza blad.
2. Karty wielofunkcyjne: bit 7 Header Type ($0E) -> funkcje 1..7
pod baza + N*$100 (KOMP punkt 10). Uchwyty 4.. dla funkcji 1-7
(kolejno slot/funkcja), 0..3 bez zmian.
3. Command: pamiec/I/O wlaczane dla przydzielonych zasobow; bus
master - patrz decyzje (punkt 10).
4. Przydzial pamieci: wszystkie BAR-y wszystkich kart, sortowane
malejaco wg rozmiaru, w oknie 0x0000'0000-0x0FFF'FFFF.
Karta, ktora juz ma wlaczone dekodowanie i poprawne BAR-y
w oknie (Radeon po starcie z ROM-u / RADINIT, Mach64 po TOS-ie)
- BAR-y zostaja, obszar oznaczony jako zajety.
5. BAR-y 64-bit poprawnie (gorna polowa = 0, pominieta w petli).
6. ROM BAR ($30): wylaczony (bit 0 = 0); rozmiar i deskryptor
z FLG_ROM tylko jako informacja [?].
7. Odczyt konfiguracji z ponowieniem (ID != $FFFF i spojny dwa
razy) - zle odczyty po wlaczeniu zasilania (KOMP pytanie 29).
8. Bus error przechwytywany przy skanowaniu (start). W funkcjach
wywolywanych pozniej - nie: wymagaloby trybu supervisor (wektor
$8, rejestr SR), a 1.13d tez tego nie robi.
9. Karta bez BAR-ow / pusty slot: poprawne FLG_LAST (pusty wpis
z length 0 i FLG_LAST).
10. Latency Timer i Cache Line Size wg INF (domyslne - punkt 10).
11. set_card_used: rozpoznanie 0/1/3 po calym a0, nie po slowie.
12. Raport na konsoli (slot.funkcja, ID, klasa, BAR-y, Command,
przerwanie) - widoczny przez CON2AUX.
Etap 2: XBIOS 300+ i cookie "XPCI" (zamiast PCIXB), opcje INF.
Etap 3: przerwania do ohci (RHSC), virt_to_bus z MMU (PTEST).
=================================================================
9. PLIK INF (stan 2c) [NOWY]
=================================================================
\AUTO\PCI_BIOS.INF albo \PCI_BIOS.INF, linie tekstu, '#' komentarz.
Kolejnosc linii dowolna; ta sama opcja dwa razy - wygrywa nizsza.
byteorder swap|xor (domyslnie swap)
xbios on|off XBIOS 300..342 + XPCI (domyslnie on)
multifunction on|off funkcje 1..7 kart (domyslnie on)
powerup on|off karty D1-D3 -> D0 (domyslnie on)
memstart <adres> poczatek nowych BAR-ow pamieci
reserve <adres> <rozmiar> zakres pamieci PCI wolny
bar vvvv:dddd <nr> <adres> staly adres BAR-u (0 = automatycznie)
latency vvvv:dddd|* <n> Latency Timer
intline vvvv:dddd|* <n>|gpip Interrupt Line (domyslnie $FF; gpip = bit
GPIP TT-MFP slotu 0/1/2/5 - 2d)
master vvvv:dddd|* on|off bus master (PCI3/PCI4 zawsze off)
enable vvvv:dddd|* on|off BIOS wlacza dekodowanie w Command
verbose 0|1
("skip <slot>" z projektu nie zostal zrobiony.)
=================================================================
10. DECYZJE (podjete 12.11.2026) [NOWY]
=================================================================
a) Bus master: tylko USB (0C03), audio (0400/0401), siec (0200),
SCSI (0100) i karty z tabeli; nigdy w PCI3/PCI4 (KOMP pkt 10).
b) Latency: 0 tylko dla NEC (1033:0035, 1033:00E0); reszta jak
1.13d (Max_Lat*8, > $40 -> Min_Gnt*8, oba 0 -> $20); INF zmienia.
c) Obszar 0x0000'0000-0x01FF'FFFF wolny (VGA A0000 Radeona/Mach64,
stare okno Mach64 0x0100'0000). Nowe BAR-y od 0x0200'0000.
d) Kolejnosc bajtow domyslnie 'swap'; 'byteorder xor' w INF.
ES1371.PRG nie uzywa funkcji BIOS-u do rejestrow (14.11.2026,
punkt 2c) - pytanie zamkniete dla niego. [KOD]
e) Toolchain: gcc bez biblioteki C (wlasny start, wywolania GEMDOS
w asemblerze): m68k-atari-mint-gcc (Makefile) albo
m68k-linux-gnu-gcc + tools/elf2prg.py (build.sh).
Tabela kart (wbudowana):
1002:5159 Radeon 7000 master off, zostaje, jesli juz dziala
1002:4758 Mach64 GX master off, jw.
1033:0035 NEC OHCI master on, latency 0
1033:00E0 NEC EHCI master on, latency 0
1274:1371 ES1371/ES1373 Command zostaje wylaczony (noenable)
1274:5880 Creative 5880 jw.
125D:1969 ESS Solo-1 master on
10EC:8029 RTL8029 master off
Karta "juz dziala" = Command ma wlaczone dekodowanie pamieci/I/O
i wszystkie BAR-y sa niezerowe, wyrownane i w oknie (pamiec do
0x0FFF'FFFF, I/O do 0xFFFF) - jej adresy nie sa zmieniane.
=================================================================
11. TESTY REGRESJI (kazda wersja)
=================================================================
- PCIDIAG.TTP (lista), PCIDIAG -t (kolejnosc bajtow przez BIOS i
bezposrednio - po zmianie 1 oba wyniki 'swap'),
- start z Radeonem z ROM-u, RADINIT, fVDI/radeon.sys (8/16/32),
- ohci.prg/storage.prg pod TOS i ohci.ucd pod MiNT: kopiowanie ZIP,
- (ES1373 - temat zamkniety 14.11.2026, karta poza uzyciem),
- MagiC,
- zimny start i cieply reset; log przez CON2AUX.
=================================================================
12. ETAP 1 - STAN (12.11.2026) [NOWY]
=================================================================
Pliki (hades_pcibios_stage1.zip):
src/start.S start programu, 41 stubow rejestrowych (stara
konwencja -> C), obsluga przerwan TT-MFP (XBRA
"HPCI"), odczyt z przechwyceniem bus error,
wywolania GEMDOS
src/pcibios.c cala reszta (bez biblioteki C)
src/pcibios.h struktury i stale interfejsu
test/sim.c symulacja szyny PCI tego Hadesa na PC
tools/elf2prg.py, tools/hpci.ld, build.sh, Makefile
PCI_BIOS.INF przyklad z opisem
build/PCI_BIOS.PRG zbudowany m68k-linux-gnu-gcc 13 (-mcpu=68060)
Sprawdzone na PC (NIE na Hadesie):
- tablica cookie: 43 wskazniki w kolejnosci 1.13d, wersja $00010000,
- PRG: naglowek $601A, 559 relokacji; obraz po relokacji pod
$0010'0000 = obraz linkowany pod ten adres (bajt w bajt),
- symulacja (test/sim.c): ES1373 w PCI1, NEC (3 funkcje) w PCI2,
PCI3 pusty (bus error / $FFFFFFFF / echo ostatniej wartosci),
Radeon w PCI4 (uruchomiony z ROM-u albo nie), niestabilne
odczyty ID, INF, pelny Cookie Jar, PCI-BIOS juz zainstalowany.
Wynik dla obecnego ukladu:
PCI1.0 h0 ES1373 io 1100/64 cmd 0005 lat 60 master
PCI2.0 h1 NEC OHCI mem 02000000/4K cmd 0006 lat 00 master
PCI2.1 h4 NEC OHCI mem 02001000/4K cmd 0006 lat 00 master
PCI2.2 h5 NEC EHCI mem 02002000/256 cmd 0006 lat 00 master
PCI4.0 h3 Radeon mem 08000000/128M io 1000/256
mem 02010000/64K (kept) cmd 0083
(latency ES1373 = $60 przy Min_Gnt $0C, Max_Lat $80 w modelu -
prawdziwe wartosci karty moga byc inne)
Instalacja (zamiast PCI_CONF + PCI_BIOS + PCIFIX):
... RADINIT (przed XBOOT) ... CACHEON2 -> PCI_BIOS (nowy) ->
PCIXB -> USB / FVDI ...
PCI_CONF.PRG i PCIFIX.PRG z AUTO usunac (wylaczyc: .PRX).
Nowy BIOS odmawia instalacji, gdy PCI_CONF jest zaladowany.
Rezydentnie ok. 39 KB (stos 8 KB i bufor INF 4 KB zostaja -
do zmniejszenia w etapie 2).
Testy na Hadesie (kolejnosc):
1. Zimny start, log przez CON2AUX: lista kart jak wyzej.
2. PCIDIAG.TTP: zasoby; PCIDIAG -t: przez BIOS i bezposrednio
ten sam tryb 'swap' (z 1.13d bajty przez BIOS dawaly 'xor').
3. fVDI/radeon.sys (PCIXB): 8/16/32 bity.
4. USB pod TOS i pod MiNT: kopiowanie ZIP. Uwaga: druga funkcja
OHCI (h4) ma teraz wlasny BAR - ohci.ucd moze ja znalezc
(find_pci_device 1033:0035 indeks 1). Sprawdzic, czy ja
wylacza, czy probuje uruchomic (porty 2 i 4). [?]
5. ES1373: MP3PCI, ANIPLAYR (GSXB). Jesli dzwiek zle - byteorder
xor w INF (pytanie 10d).
6. Cieply reset, MagiC.
Powrot: stary PCI_CONF + PCI_BIOS + PCIFIX z powrotem do AUTO.
=================================================================
13. WERSJA 1b (13.11.2026) - po pierwszym starcie na Hadesie
=================================================================
Pierwszy start: lista kart poprawna (jak w symulacji), potem
"Illegal instruction", PC=$03FFFFCE, tryb uzytkownika, USP=$000530EA
- najpewniej w programie uruchamianym PO PCI_BIOS (bez jego
naglowka na ekranie). [HIP]
Zmiany:
- stuby zachowuja wszystkie rejestry poza d0 (1.13d zachowywal d1;
program wywolujacy mogl na tym polegac),
- wektory TT-MFP instalowane dopiero przy pierwszym hook_interrupt
(jak 1.13d tylko dla potrzebnych slotow); gdy na linii nie ma
procedur z BIOS-u - skok do poprzedniego wektora,
- INF "multifunction off" - tylko funkcja 0, uchwyty 0..3 jak w
1.13d (program, ktory zaklada uchwyty 0..3, moze wyjsc poza
tablice przy uchwytach 4 i 5). [HIP]
Do ustalenia: ktory program startuje po PCI_BIOS i czy pada takze
z "multifunction off".
WERSJA 1c (13.11.2026) - PRZYCZYNA WYJATKU
- Blad w start.S: wrappery GEMDOS (Cconws, Super, Fopen, Fread...)
nie zachowywaly d2. GEMDOS moze zmienic d0-d2/a0-a2, a gcc trzyma
w d2 zmienne miedzy wywolaniami (np. zachowany SSP dla Super albo
liczniki petli w raporcie). Po ostatnim Cconws wywolanie
Super(ssp) / powrot dostawaly smieci -> skok pod $03FFFFCE w
trybie uzytkownika (USP i A1/A3/A4 wskazywaly na obraz PCI_BIOS,
PCIXB nie zdazyl wypisac naglowka).
- Poprawka: kazdy wrapper zapisuje d2/a2 (movem).
- Zmiany z 1b (rejestry w stubach, wektory przy hook_interrupt,
multifunction off) zostaja.
WERSJA 1e (13.11.2026) - ES1373 cisza
- Z 1.13d + PCI_CONF ES1373 gra (przy wlaczonym cache), z 1d cisza.
- 1.13d w trybie PCI_CONF (zwykly uklad Hadesa) NIE wylaczal linii
przerwania, gdy procedura sterownika nie zwrocila bitu 0 = 1 -
wolal ja i zawsze przekazywal dalej do PCI_CONF. Nowy BIOS (jak
1.13d bez PCI_CONF) wylaczal linie po pierwszym takim przerwaniu.
Jesli ES1371.PRG nie ustawia bitu 0 - jedno przerwanie i cisza. [HIP]
- 1e: linia zostaje wlaczona; wylaczenie dopiero po 50000 kolejnych
przerwaniach bez obslugi (zablokowany poziom).
- Jesli nadal cisza, kolejne proby tylko w INF (bez kompilacji):
latency 1274:1371 0 / $20, master 1274:1371 off, byteorder xor.
WERSJA 1f (13.11.2026) - ES1373 pod I/O $1000
- 1e i INF (byteorder xor, master off) - nadal cisza; MP3PCI:
bufor pelny, karta nic nie pobiera (silnik DMA nie startuje).
- PCIDIAG na starym zestawie (gra): ES1373 I/O $1000, Radeon I/O
$1100, MMIO $02000000 (PCI_CONF przestawil adresy z RADINIT).
Nowy BIOS dawal ES1373 $1100 (Radeon trzymal $1000 z RADINIT).
- 1f: stale adresy BAR-ow - domyslnie ES1373 BAR0 = $1000;
INF: "bar vvvv:dddd <nr> <adres>" (0 = automatycznie).
Karta "juz skonfigurowana" (Radeon) zachowuje BAR-y, ktore nie
koliduja; kolidujacy (I/O Radeona) dostaje nowy adres ($1100).
- Jesli ES1373 zagra pod $1000: ES1371.PRG zaklada I/O $1000 (albo
zle liczy adres) - do potwierdzenia: "bar 1274:1371 0 $1040"
powinno dac znowu cisze. [?]
WERSJA 1g (13.11.2026) - decyzja
- ES1373 z nowym BIOS-em nadal cisza (sprawdzone: byteorder xor,
master off, I/O $1000, multifunction off; mikser OK). Ze starym
1.13d + PCI_CONF + PCIFIX gra (przy wlaczonym cache). USB dziala.
- Decyzja uzytkownika: wielofunkcyjnosc zostaje (EHCI ma sterownik),
ES1373 schodzi na dalszy plan (dzwiek: Tahiti).
- Domyslny staly adres ES1373 ($1000) usuniety - Radeon znow
zachowuje I/O z RADINIT. Opcja INF "bar" zostaje.
- Otwarte: dlaczego ES1371.PRG nie startuje DMA. Nastepny krok, gdy
wrocimy: zrzut rejestrow ES1373 (CONTROL, SERIAL, ramka DAC2/DAC1,
status przerwan) w trakcie proby odtwarzania - stary vs nowy BIOS. [?]
=================================================================
14. ETAP 2 (13.11.2026) [NOWY]
=================================================================
- XBIOS 300..342 wbudowane: trap #14, XBRA "HPCI", cookie "XPCI"
(wartosc = _PCI). Uklad argumentow jak w PCIXB.C / bibliotece
Mandina (pci_xpci.c), ktory dziala z radeon.sys:
300/301 L(2) id/klasa, W(6) indeks
302-304 L(2) uchwyt, W(6) rejestr, L(8) wskaznik
305-307 L(2) uchwyt, W(6) rejestr
308/309 L(2), W(6) rejestr, W(8) wartosc; 310: L(8) wartosc
311 L(2) uchwyt, L(6) procedura, L(10) parametr
312/316 L(2) uchwyt
317/318 L(2) uchwyt, L(6) wskaznik / callback
319-336 L(2) uchwyt, L(6) adres PCI, L(10) wskaznik/wartosc
(zapis bajtu/slowa: W(10))
337/338 bez argumentow
339/340 L(2) uchwyt, L(6) adres, L(10) wskaznik {adres, dlugosc}
313-315, 341, 342 -> -2
Inne numery XBIOS -> poprzedni wektor. Gdy XPCI juz jest (PCIXB
przed PCI_BIOS) - XBIOS zostaje tamtemu programowi.
PCIXB po PCI_BIOS: wypisze "XPCI cookie already present - not
installed" i zakonczy sie - mozna go zostawic albo usunac z AUTO.
INF: "xbios off" - bez trap #14 (jak etap 1).
- Pamiec: stos startowy 8 KB, bufor INF 4 KB i tablica przydzialu
w initbss.S, linkowanym jako ostatni -> koniec BSS; Ptermres
zatrzymuje tylko do hpci_resident_end. MAX_DEV 32 -> 20.
Rezydentnie ok. 26 KB (etap 1: ok. 39 KB, 1.13d: ok. 14 KB).
- Hook_interrupt przez XBIOS: parametr z L(10) trafia tam, gdzie
1.13d mial a1 (biblioteka Mandina przy wywolaniu przez cookie
podaje go w d1 - wtedy 1.13d i nowy BIOS dostaja smieci;
przez XBIOS jest poprawnie). [KOD][?]
- Test na PC: symulacja + wywolania XBIOS (300, 301, 302, 304, 307,
308, 313, 316, 319, 324, 339, 341), XPCI juz obecne.
Testy na Hadesie: start (linia "XBIOS 300..342 installed"), fVDI
z radeon.sys bez PCIXB, PCIDIAG (XPCI = _PCI), USB, MagiC.
WERSJA 2a/2b (14.11.2026) - ES1373 dalej
- ESREGS: SRC ES1373 wylaczony (bit 22) juz po starcie ES1371.PRG
(stary zestaw: DA07..., nowy: DA47...). Po wyrownaniu w INF calej
konfiguracji (latency $30, Interrupt Line $D1 - 2a: opcja intline,
byteorder xor, xbios off) - nadal wylaczony.
- Karta jest w D2, raz w D3 (PMCSR zmienny miedzy startami).
- 2b: BIOS przelacza karty z D1-D3 w D0 przed przydzialem BAR-ow
(jak BIOS PC); INF "powerup off" wylacza. Raport: "D2->D0".
WERSJA 2c (14.11.2026) - PRZYCZYNA CISZY ES1373 ZNALEZIONA
- Deasemblacja ES1371.PRG (AssemSoft 2000): sterownik NIE uzywa
funkcji PCI-BIOS do rejestrow - konfiguracje i I/O czyta sam
(wlasne procedury z zamiana bajtow, tryb 'swap'). [KOD]
- Przy starcie odczytuje Command ($04). Jesli bit 0 (I/O) JUZ jest
wlaczony, pomija inicjalizacje SRC (procedura $424: SRC disable
$400000 -> programowanie pamieci SRC -> SRC enable 0). 1.13d nigdy
nie wlaczal Command, wiec sterownik zawsze inicjalizowal SRC.
Nowy BIOS wlaczal I/O + bus master -> SRC zostawal wylaczony
(rejestr SRC $DA47...), DAC nie pobieral probek - cisza. [KOD]
- Sterownik sam ustawia I/O + bus master (Command |= 5) i latency
>= $20. [KOD]
- 2c: w tabeli kart ES1371/ES1373 (1274:1371) i 5880 (1274:5880)
"noenable": BIOS ustawia BAR-y, Command zostaje wylaczony.
INF: "enable vvvv:dddd on|off".
- Wnioski z testow 2a/2b (intline, powerup) pozostaja jako opcje.
=================================================================
15. STAN AKTUALNY (14.11.2026, wersja 2.0 stage 2c)
=================================================================
AUTO: ... RADINIT ... CACHEON2 -> PCI_BIOS (nowy) -> USB / FVDI ...
bez PCI_CONF, PCIFIX i PCIXB (XBIOS 300+ jest w BIOS-ie).
Rezydentnie ok. 26 KB. Cookie: _PCI i XPCI (ta sama wartosc).
Dziala na Hadesie: skan (tez funkcje 1/2 NEC), przydzial, Command,
PCIDIAG -t ('swap' przez BIOS i bezposrednio), fVDI/radeon.sys przez
wbudowane XBIOS, USB (TOS, MiNT), MagiC.
ES1373: przyczyna ciszy znaleziona i poprawiona (2c, noenable) - gra,
ale po czasie wyjatek w programie odtwarzajacym (Line F, skok przez
zepsuty wskaznik); karta odstawiona (dzwiek: Tahiti). [HIP: DMA/F3]
Narzedzia: PCICHK.TOS (Cookie Jar, _PCI), ESREGS.TTP (rejestry
ES1373 wokol odtwarzania GSXB) - zrodla w tools/.
EHCI (15.11.2026): funkcja skonfigurowana poprawnie, ale pierwszy
transfer -> Host System Error / master abort (dluzsze bursty, PCIMAIN
max 4 longwordy bez STOP#). Zamkniete - docelowo dwie OHCI. [TEST]
IRQTEST.TTP (tools/irqtest, 15.11.2026): test sciezki przerwan
(hook_interrupt, OHCI Start-of-Frame, wspolna linia slotu). [?]
Dalej (etap 3): przerwania w ohci (RHSC), virt_to_bus z MMU.
=================================================================
16. WERSJA 2d (17.11.2026) - BUS ERROR W FUNKCJACH API
=================================================================
Przyczyna: 16.11 ohci.prg po cieplym resecie dostal Access fault w
PCI-BIOS-ie (PC w obszarze rezydentnym, adres $A0040208): probe czytal
konfiguracje funkcji 2 karty NEC (EHCI, uchwyt 5) juz po tym, jak
pierwsza instancja ohci ustawila Ehci_mask (EXT2 bit 0) - zamaskowana
funkcja zwykle odpowiada FFFFFFFF po 125 us, ale po cieplym resecie
dala bus error. 1.13d tez nie chronil funkcji po starcie (pkt 4).
Obejscie w ohci.prg (probe konczy po 2 OHCI) zostalo, ale przyczyna
byla w BIOS-ie.
Zmiana (start.S, pcibios.c):
- read_config_* / fast_read_config_* / write_config_* korzystaja z
safe_acc(): dostep bajt/slowo/long w jednym obszarze kodu
(safe_region_start..end), bez zmiany SR i bez zmiennych - dziala w
trybie uzytkownika, z przerwania i reentrantnie.
- Staly handler bus error (wektor $8, XBRA "HPCI", instalowany przed
Ptermres): gdy PC z ramki wyjatku lezy w safe_region, ustawia d0 = -1,
przestawia PC w ramce na safe_fault i RTE; inne bus errory ida do
starego wektora z nietknieta ramka. nop po kazdym dostepie: 68060
zglasza blad zapisu, zanim PC opusci obszar (obszar PCI i tak jest
"serialized" przez DTT1).
- Wynik przy bledzie: read/write -> -4 (PCI_DEVICE_NOT_FOUND),
fast_read -> $FF / $FFFF / -1. Uchwyt pozostaje wazny (karta jest,
tylko nie odpowiada).
- Funkcje mem/io (319-336) NIE sa chronione (jak 1.13d) - adresy BAR-ow
sa sprawdzone przy przydziale, a narzut na kazdym dostepie do pamieci
karty bylby niepotrzebny.
- Ograniczenie: pod FreeMiNT jadro wpina sie w wektor $8 po BIOS-ie, wiec
bus error w trybie uzytkownika trafia najpierw do MiNT-a (SIGBUS);
ochrona dziala w pelni pod TOS/MagiC i w trybie supervisor.
- Opcja INF "intline vvvv:dddd|* gpip": Interrupt Line = bit GPIP TT-MFP
slotu (PCI1 0, PCI2 1, PCI3 2, PCI4 5) zamiast $FF - tylko informacja
dla sterownikow/diagnostyki; domyslnie nadal $FF.
- test/sim.c: funkcja "masked" (bus error po starcie), test API na
uchwycie 5 i sasiednich; test intline gpip. make test: OK.
Budowanie: m68k-linux-gnu-gcc 13 (build.sh), text 20352 B.
Test na Hadesie: PCICHK/PCIDIAG jak dotad; ohci.prg bez obejscia w
probe (lub PCIDIAG po zaladowaniu ohci) - odczyt uchwytu 5 ma dac -4,
nie wyjatek; cieply reset x3; IRQTEST (wektor $8 nie przeszkadza).
virt_to_bus / bus_to_virt z MMU (2d, 17.11.2026):
- cookie _CPU = 40 lub 60 i TC bit 15 (MMU wlaczone): adres fizyczny
przez PLPAR (060) albo PTESTR + MMUSR (040); dlugosc = ciagly obszar
fizyczny od adresu (kolejne strony 4/8 KB, max 256 stron = 1 MB).
Niezmapowany adres albo poza RAM ($0-$3FFFFFFF) -> -8
(PCI_GENERAL_ERROR). bus_to_virt: tylko strony mapowane 1:1, inaczej -8.
- MMU wylaczone, 030, albo wywolanie z TRYBU UZYTKOWNIKA: dokladnie jak
1.13d (| $80000000, dlugosc $3FFFFFFF). Tryb uzytkownika wykrywany
przez przechwycenie privilege violation (wektor $20, XBRA HPCI, ten
sam mechanizm obszaru kodu co bus error) - zadnych zmian dla
programow, ktore wolaja te funkcje bez Super.
- PLPAR na niezmapowanej stronie = access error -> handler $8 -> -1.
- virt_to_phys/phys_to_virt (341/342) nadal -2 (ES1371.PRG traktuje -2
jako 1:1; zmiana nie jest potrzebna).
- Test: PCICHK.TOS wypisuje virt_to_bus/bus_to_virt dla bufora w BSS,
z Supexec i z trybu uzytkownika. Oczekiwane: bez MMU (CACHEON) oba
"len 3FFFFFFF"; z HADES_B6 (MMU on, 1:1) supervisor: fizyczny =
logiczny, len = do konca ciaglego obszaru (<= 1 MB); user mode:
3FFFFFFF. Pod MiNT (MMU jadra): fizyczny moze sie roznic od
logicznego - to jest wlasnie przypadek, dla ktorego to powstalo.