pciinit.library and x86emu.library for AmigaOS 3.x
================================================

Requirements
------------
68020 or later, AmigaOS 3.0 or later. PCIoprom needs
mathieeedoubbas.library from AmigaOS. Install a compatible openpci.library
separately; openpci 40.16.1 is the tested provider.

Hardware execution needs a PCI bus board that forwards legacy VGA memory
(PCI 0xA0000-0xBFFFF) through ObtainPCIRegion: Prometheus FireStorm,
Firebird, Mediator and AmigaPCI with current logic. On the original
Prometheus and the G-REX a video BIOS runs against an empty window and
PCIoprom prints a warning. The card must not be in use by another driver.
No Amiga system files, OpenPCI provider or graphics-card ROMs are included
in this archive.

Installation
------------
Copy Libs/pciinit.library and Libs/x86emu.library to LIBS:.
Libs/x86emu.library_nojit is an interpreter-only alternative: slower, but
it generates no 68k code and needs about 1 MiB less memory per card. Copy
it as LIBS:x86emu.library instead if the translating emulator misbehaves.
Copy C/PCIoprom to C:.

Reserve legacy VGA address space in ENVARC:PCI-Configuration:

ReserveMemSpace 0xC0000

PCIoprom --list-modes
PCIoprom --mode 0x111
PCIoprom --mode 0x111 --mode 0x114 --mode 0x111 --pattern
PCIoprom --trace

The scanner initializes supported cards from their onboard option ROM.
An optional final filename supplies a matching ROM instead. To keep a card
out of ROM execution, list it in ENVARC:PCIoprom-Configuration, one
"Ignore vendor:device" line per card in hexadecimal; "*" as the device
matches every device of that vendor, and ";" starts a comment. --no-post
performs only loader/preflight diagnostics, and --dump file saves the
first card ROM as read from the card. Direct-color modes show a centered
Boing Ball at about 80% of screen height. --pattern selects the
readback-verified color bars instead; it needs --mode and supports RGB
modes. Indexed modes are set without drawing. A ROM-advertised linear
framebuffer is drawn directly; a banked mode, which is all a VBE 1.2 ROM
offers, is drawn through the legacy VGA window when the bus board provides
one, and otherwise PCIoprom says why nothing was drawn. --trace adds the
last 128 I/O, VGA, BAR and interrupt accesses of each ROM run or failed
BIOS call to the CPU summary. Read docs/abi.md for the framebuffer lifetime
contract. POST and mode changes affect the display; exit leaves the last
mode active.

Contents
--------
Libs/          pciinit.library, x86emu.library and x86emu.library_nojit
C/             PCIoprom
SDK/include/   Public library headers for Amiga GCC
SDK/fd/        Library vector descriptions
ReadMe         Installation and usage notes
README.md      Project overview and source build instructions
docs/          ABI reference and architecture notes with diagrams
LICENSE        BSD 2-Clause license for original project code
third_party/   Vendored emulator license notices and revision information
BUILD.txt      Source revision and tracked-change status
SHA256SUMS     SHA256 hashes of the package files

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                  156     190  82.1% -lh5- 5069 Nov 14 23:38 pciinit-2.3?BUILD.txt
[generic]                30550   55172  55.4% -lh5- ff40 Nov 14 23:38 pciinit-2.3?C?PCIoprom
[generic]                 5033   11168  45.1% -lh5- ad5f Nov 14 23:32 pciinit-2.3?docs?abi.md
[generic]                 7765   18562  41.8% -lh5- 5bf7 Nov 14 23:32 pciinit-2.3?docs?ARCHITECTURE.md
[generic]                 1507    4195  35.9% -lh5- f06a Nov 14 23:32 pciinit-2.3?docs?diagrams?address-translation.svg
[generic]                 1144    2983  38.4% -lh5- c816 Nov 14 23:32 pciinit-2.3?docs?diagrams?framebuffer-lifetime.svg
[generic]                 1368    3540  38.6% -lh5- ebc7 Nov 14 23:32 pciinit-2.3?docs?diagrams?library-dependencies.svg
[generic]                 1481    4227  35.0% -lh5- 4857 Nov 14 23:32 pciinit-2.3?docs?diagrams?rom-lifecycle.svg
[generic]                 1174    2888  40.7% -lh5- 3dd4 Nov 14 23:32 pciinit-2.3?docs?diagrams?x86-backends.svg
[generic]                14185   23656  60.0% -lh5- f168 Nov 14 23:38 pciinit-2.3?Libs?pciinit.library
[generic]                49195  120620  40.8% -lh5- f497 Nov 14 23:38 pciinit-2.3?Libs?x86emu.library
[generic]                44032  110444  39.9% -lh5- 1108 Nov 14 23:38 pciinit-2.3?Libs?x86emu.library_nojit
[generic]                  698    1325  52.7% -lh5- 9181 Nov 14 23:32 pciinit-2.3?LICENSE
[generic]                 1560    3082  50.6% -lh5- 4c07 Nov 14 23:32 pciinit-2.3?ReadMe
[generic]                 2962    6188  47.9% -lh5- c362 Nov 14 23:32 pciinit-2.3?README.md
[generic]                  260     627  41.5% -lh5- a32b Nov 14 23:32 pciinit-2.3?SDK?fd?pciinit_lib.fd
[generic]                  135     233  57.9% -lh5- 98a8 Nov 14 23:32 pciinit-2.3?SDK?fd?x86emu_lib.fd
[generic]                  337    1190  28.3% -lh5- d99c Nov 14 23:32 pciinit-2.3?SDK?include?clib?pciinit_protos.h
[generic]                  257     569  45.2% -lh5- ea88 Nov 14 23:32 pciinit-2.3?SDK?include?clib?x86emu_protos.h
[generic]                  900    5085  17.7% -lh5- 5e3d Nov 14 23:32 pciinit-2.3?SDK?include?inline?pciinit.h
[generic]                  451    1711  26.4% -lh5- 6930 Nov 14 23:32 pciinit-2.3?SDK?include?inline?x86emu.h
[generic]                 1426    3352  42.5% -lh5- d9c6 Nov 14 23:32 pciinit-2.3?SDK?include?libraries?pciinit.h
[generic]                 2110    5014  42.1% -lh5- c451 Nov 14 23:32 pciinit-2.3?SDK?include?libraries?x86emu.h
[generic]                  139     219  63.5% -lh5- 9b26 Nov 14 23:32 pciinit-2.3?SDK?include?proto?pciinit.h
[generic]                  140     214  65.4% -lh5- af32 Nov 14 23:32 pciinit-2.3?SDK?include?proto?x86emu.h
[generic]                 1417    2558  55.4% -lh5- dd11 Nov 14 23:38 pciinit-2.3?SHA256SUMS
[generic]                  698    1239  56.3% -lh5- 03af Nov 14 23:32 pciinit-2.3?third_party?libx86emu?LICENSE
[generic]                  385     738  52.2% -lh5- 4f9b Nov 14 23:32 pciinit-2.3?third_party?libx86emu?LICENSE_INFO
[generic]                  709    1126  63.0% -lh5- 09a3 Nov 14 23:32 pciinit-2.3?third_party?libx86emu?README.amiga
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        29 files  172174  392115  43.9%            Nov 15 02:36