1 Ostatnio edytowany przez artik-wroc (Dzisiaj 19:30:17)

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.
Było miło :) Do widzenia.