# Toshiba T100: sources Every source the package was built from, labelled **spec** (manuals, datasheets, magazine articles: what the machine does) or **implementation** (someone else's emulator or firmware code). The clean-room rule: the code here was written from spec sources only. No emulator source (MAME `pasopia*.cpp` and `bus/pasopia`, EmuPIA / the Common Source Code Project, `beijingduckx` `*.z80`) was read, and the ROM was run, never disassembled. Where a fact came from **observing** the running ROM, it says so. ## Spec | Source | Used for | | --- | --- | | Toshiba T100 Technical Reference (Toshiba Australia, 1985, handwritten, 79 pp.; IA `toshiba-t100-tech-ref-eng_202309`) | memory map and bank switch (pp.10–13); the I/O map (pp.14–17); keyboard and speaker interface, PIO scan signals, the scan every 16 ms (pp.18–22); speaker control and the T-BASIC frequency table (pp.25–26); the screen and the VRAM access protocol (pp.27–43); the CPU board block diagram (p.8); the clock (pp.6–8) | | T100 (Pasopia) Maintenance Manual PAD8120-1 (IA `toshiba-t-100-maintenance-manual`) | the colour test `COLOR 0,1 … 7,0` and its expected colours (§3, step 8); 3.993 MHz | | T100 Owner's Manuals (IA `toshiba-t-100-owners-manual`, `toshiba-t-100-manuals`) | boot behaviour (disk in drive 1, RESET) | | T100 Owner's Manual (US, PAD8110-1 in the set PAD8111-1) p. 2-53 and its section on inserting a disk (Figure 2.5); 5-1/4 Inch Floppy Disk Drive Unit Owner's Guide (PA7200U), PAD8142-1, p. 1 "Components", Front View (bound into the same set) | the drive unit's lamps: one "Select lamp" per drive, red ("the red busy indicator light"), on while the drive is in use (the status line's access lights, #1286) | | T100 Programmer's Reference PAD8111-1 (IA `toshiba-t-100-manuals`) | SCREEN 0/1/2 and its two examples; the Appendix C character table (video) | | ASCII Technical Bank "Pasopia no naibu kouzou" (1983; IA `ArchitectureOfPASOPIA`), hardware chapter 1 only: §1-2-3 bank switch, §1-2-4 keyboard (fig. 1-2-7 PIO wiring, fig. 1-2-8 key matrix, fig. 1-2-9 socket), §1-2-5 interrupts (fig. 1-2-10 vector table, fig. 1-2-11 CTC channel use, fig. 1-2-12 CTC wiring, the 64 Hz system timer); and the opening text of §5-3 (the scan example "KSB, EFh = M") | key matrix positions, daisy-chain order, CTC wiring (CLK/TRG0–2 high, CLK/TRG3 = ZC/TO2, ZC/TO1 → ÷2 → NAND with PIO A7 → speaker), IM 2 vectors | | Zilog Z80 CTC and Z80 PIO datasheets; Intel 8255A datasheet; Hitachi HD46505S datasheet | the device models (control words, prescalers, time constants, mode 3 bit control and its interrupt logic, the daisy chain, 8255 mode 0 and bit set/reset; CRTC timing for the stub display) | | Creative Computing 9/11, November 1983: the T100 review (p.10) and "Benchmark Comparison Test" (p.259), IA `creativecomputing-1983-11` and atarimagazines.com | Ahl's Simple Benchmark listing; the T100's 1:09; the CES 1982 date for the catalogue entry | | The exploration report and the project decisions (`documentation/t100/`) | the plan, the source register, the 68–72 s owner measurements (VCFed) | ### The printer port (`src/machine/periph/printer.ts`, `src/machine/ui/printer/`) All spec. No printer emulator and no other machine emulator's printer code was read; the printers themselves are `@calculator-sim/printers` (its own SOURCES.md). | Label | Source | Used for | | --- | --- | --- | | spec | Toshiba T100 Technical Reference (IA `toshiba-t100-tech-ref-eng_202309`), pp.50–53 "Printer Interface", read as page images (IA leaves n49–n52; the OCR is empty) | p.50: the block diagram (LS373 data latch at 38H clocked by IORQ·WR; PA7 → /PRIME, PA6 → /STROBE; /FAULT → PB7, BUSY → PB6; no other status line wired). p.51: the signal table (PA7 INPUT PRIME and PA6 STROBE active H at the PPI, "inverted to low level to the printer control"; PB7 /FAULT active L for paper end, offline/deselect, error, cover open; PB6 BUSY active H "the printer cannot receive data"; 38H "latched data for printer: 8 bits"; PRIME "the printer controller is initialized and the print buffer is cleared"). pp.52–53: the timing of Toshiba's PA7251 (strobe 1–90 µs, BUSY after ≥ 30 µs, ≥ 60 µs busy) and PA7252 (BUSY within 400 ns, 100 µs – 2 ms per byte, "longer when the printer buffer is full", T6 ≤ 5.5 µs) | | spec | T100 Programmer's Reference PAD8111-1 (IA `toshiba-t-100-manuals`), error table (OCR text) | "PO 28 — Printer offline: Printer is not ready." | | spec | C. Itoh *8510A Users Manual* E1-1645H, Feb 1982 (IA `bitsavers_citohprint45HCItoh8510UserManualFeb1982_12825996`): §1-2 (OCR text), §3-4 to §3-8 (OCR text, and p.22 Fig. 23/24 as a page image, leaf n26) | "120 CPS (10CPI)", "63 LPM", "Line Feed Speed Max. 100ms (1/6\" pitch)"; the data buffer "1K (Option 3K bytes)"; the parallel signals: data clocked in when DATA STB goes LOW, INPUT PRIME prints the buffer then returns to the initial state and needs 5 ms before new data, BUSY conditions; Fig. 23: per-byte INPUT BUSY T5 ≤ 2 ms, ACK 5.5 µs; pin 11 is INPUT BUSY by default (jumper J12/J13) | | spec | *ST Magazin* 6/1988 (the printers package's source) | NEC P6 plus: 265 cps draft, 75 cps LQ, 80 KB buffer | **Inferences (no document states them)**: with nothing on the cable the status inputs float, and TTL inputs float high: BUSY high and /FAULT high (no fault), so LPRINT waits out the ROM's time-out and reports ?PO Error. The per-byte BUSY takes the Tech Ref's lower bound (100 µs). The P6 plus's line-feed and eject times, and the 8510's form-feed time, are estimates. **Observed on the running ROM** (behaviour only, no disassembly listing kept): T-BASIC's LPRINT output routine reads port 21 and reports ?PO Error at once when /FAULT is low, polls BUSY for (FFF0h) × 65,536 rounds (about 8 s) before ?PO Error, writes the byte to 38 and pulses PA6 high and low (`printer.test.ts` measures both paths). ### The cassette (`src/machine/periph/cassette.ts`, `tape.ts`, `tapeCodec.ts`, `wav.ts`, `pacBin.ts`) All spec or observation. No emulator's cassette code was read (MAME's, EmuPIA's or any other); MAME's `hash/pasopia_cass.xml` software list (CC0) was read as data only. | Label | Source | Used for | | --- | --- | --- | | spec | Toshiba T100 Technical Reference (IA `toshiba-t100-tech-ref-eng_202309`), p.47 "Audio Cassette Interface", read as a page image (IA leaf n46) | 8255-3 PA5 motor on/off, active L; PA4 write data; PB5 read data; "The modulation method used is F-2F"; bits 0–7 of each byte recorded LSB first; the 8-pin DIN socket | | spec | ASCII Technical Bank "Pasopia no naibu kouzou" (IA `ArchitectureOfPASOPIA`), §1-3 "Audio cassette interface" (book pp.29–31, IA leaves n34–n36, page images) | fig. 1-3-1: PA5 through a NAND and a transistor to the REMOTE relay, PA4 through 6.8 kΩ / 120 Ω / 0.33 µF to REC, PLAY through 0.1 µF, 100 Ω, a 27 kΩ load, a 3.9 V zener and an LM311 with hysteresis to PB5; fig. 1-3-2: 1600 bps = 1/((1/1200 + 1/2400)/2); fig. 1-3-3: logic 0 = one 1/2400 s cycle (208 µs halves), logic 1 = one 1/1200 s cycle (416 µs halves); fig. 1-3-4: start bit, data, stop bit, the 94h example, the 1/4800 s interrupt grid; fig. 1-3-5: the decision 320 µs after an edge; the text: writing is timed by timer interrupts, reading measures edge to edge with the CTC, 20 % speed tolerance; fig. 1-3-6: the DIN pins | | spec | the same book, chapter 4 (I/O devices: file formats), §4-1-1 to §4-1-3 (book pp.115–119, IA leaves n120–n124) and §4-3 (RAM PACK) (OCR text) | fig. 4-1-1: the CSAVE file: 10 × D3h, a 6-byte name padded with 00h, the tokenised program, 9 × 00h (12 with the program's own three), read until ten 00h; fig. 4-1-2: the physical record: block header, preamble, data size, data (256 bytes), checksum, postamble, block trailer; "CLOAD? is the same as CLOAD PRINT"; ±10 % tape speed; §4-3: RAM PACK sectors, the 16-byte directory entry (name 9, attribute 1, cluster 1) and the FAT values (as on disk, §4-2-4) | | spec | T100 Maintenance Manual PAD8120-1 (IA `toshiba-t-100-maintenance-manual`), OCR text: the specification table and §2.4 | "1,600 bits/second. For audio cassette tape recorders with remote control"; the cable (MIC, EAR, REMOTE plugs) | | spec | T100 Programmer's Reference PAD8111-1 (IA `toshiba-t-100-manuals`), OCR text | CSAVE, CLOAD, CLOAD?, MOTOR, BLOAD/BSAVE (device −1 is the cassette), "Tape read ERROR", "any key-touch during program loading from cassette causes Tape-Read Error" | | observation | the real ROM running on this emulator, CSAVE into the emulated deck (`cassette.test.ts`) | the half cycles (832 and 1664 T-states), the leader (2560 ones) and trailer (5120 zeros), the preamble (10 × AAh), the size field (u16 LE), the check byte (XOR of the size bytes and the data), the postamble (AAh), the 16 ms relay pause between blocks, the program address 846Fh, `CLOAD?` → `Bad`, the extra 00h after a CLOAD | | data | the Internet Archive's `toshiba-pasopia-wav` tape dumps (see `library/t100/SOURCES.md`) | the same block layout and checksum on real tapes; decoder test material; the library | | data | the Internet Archive's `toshiba-pasopia-bin` files | that they are RAM PACK images (the directory, FAT and program layout as read from the files), for the BIN import | **Not documented, our own choices**: the WAV decoder's filter constants (2.5 ms DC window, 25 % hysteresis, 20 ms envelope, 1 % floor), the reel-counter model (C-60 hub and tape thickness, 2:3 gearing), the wind speed (30×), a blank tape of 15 minutes, and the T100TAPE container. ### The on-screen keyboard (`src/machine/ui/keyboard/`) | Source | Used for | | --- | --- | | Maintenance Manual PAD8120-1, Fig. 1.1.4 "Layout of the Keyboard" (p.1-6, IA leaf n11), read as a page image | the key array to scale (positions measured at a 75 px key pitch, rounded to ¼ unit), the shifted legends, and the "Graphic Shift" drawing the GRAPH legends were checked against | | Owner's Manual, Fig. 2.12 "Keyboard" (p.2-38, IA leaf n69) and pp.2-39 to 2-46 | the same arrangement; the L-shaped RETURN key; the blank key left of LABEL; "The off-white keys contain uppercase and lowercase characters, numeric characters and special symbols"; the descriptions of GRAPH, ESC, LABEL, COPY, BREAK and the PF keys | | the same Figure 1.1.4 of the Maintenance Manual, read again on 15 Nov 2026 from the held copy (pack `t100.collection.t100-hardware`, `toshiba-t100-maintenance-manual-pad8120-1.pdf`, PDF page 12) | the full keyboard of the on-screen keyboard's third view (#1291) is this layout; the numeric pad has the digits, the point, a minus key and RETURN beside the cursor keys, and no plus, times or divide key, so the "PF · cursor · pad" view got none | | Photographs on Wikimedia Commons: "Toshiba Pasopia PA7010 Toshiba Science Museum.jpg" and "Pasopia with monitor.jpg" (the Japanese twin, not a T100) | **visual reference only, never shipped**: the colours the documents do not give (dark charcoal control keys with white legends, a green GRAPH key, a red STOP/BREAK key, the dark deck in a silver frame) | ### The Pasopia PA7010 machine (`src/machine/models.ts`, `pasopiaKeys.ts`, `src/video/chargen/pasopiaKana.ts`, `ui/keyboard/layout.ts`) | Label | Source | Used for | | --- | --- | --- | | spec | ASCII book (IA `ArchitectureOfPASOPIA`), fig. 1-2-8 "キーマトリックス" (p.26, IA leaf n31) and fig. 1-2-7 (p.25, n30), read as page images | every key's matrix position (KS0–KSB × KR0–KR7) and its printed legends: the Latin legend, the shifted one, the kana and the small kana; KANA at KS0/KR5, KANJI at KS4/KR1; transcribed in `pasopiaKeys.test.ts` | | spec | the same book, chapter 5 §5-3-1, fig. 5-3-1 (p.148, n153) and fig. 5-3-2 "スキャン信号とビットデータ" (p.149, n154), page images | the same matrix again (it has two kana typos, D ツ and X ナ; fig. 1-2-8 and the ROM agree on シ and サ) | | spec | the same book, §1-2-4 (OCR text, p.21) | CAPS LOCK and the カナ key are not mechanical locks; the software switches them | | spec | the same book, ch.3 §3-1 (p.91, n96) | the CG holds 247 characters of 8 × 8 dots; no character table in the book (its contents and OCR were searched) | | spec | JIS X 0201 (JIS C 6220), the 8-bit Katakana code | the codes A1–DF and their characters, ¥ at 5C, the overline at 7E; our 5 × 7 dot patterns of those characters (`pasopiaKana.ts`), now only the fallback when the CG-ROM does not load | | data | IA `toshibapasopiabiosroms`, `tbasic.rom` (CRC-32 f53774ff) | the Pasopia's ROM; run, never disassembled | | data | IA `toshibapasopiabiosroms`, `font.rom` (CRC-32 a91c45a9) | the Pasopia's character generator, used as it is (project decision 2.11.2026); its layout read from the bytes (256 glyphs × 8 rows at code × 8, bit 7 the leftmost dot, the JIS X 0201 set); the archive's `kanji.rom` is not used | | visual reference | the two Wikimedia Commons photographs of the Pasopia below | where the Pasopia's keys sit where they differ from the T100 (TAB beside ESC, CAPS LOCK left of Q, the one-row RETURN, the カナ key after "]", the ロ key before the right SHIFT, GRAPH left of the space bar, KANJI between LABEL and COPY); nothing is copied from them | ## Observation (the real ROM running on this emulator, behaviour only) - The T100 legend of every punctuation key (`keymap.observe.test.ts` presses each matrix position plain and with SHIFT and records the echo). - The GRAPH legends of the keyboard (`ui/keyboard/graphLegends.ts`): GRAPH plus each data key pressed in T-BASIC, the character code read back from VRAM; the glyphs are this package's own Appendix C character generator. - The Pasopia's Japanese T-BASIC 1.1: what every typewriter key types plain, with SHIFT and in kana mode (KANA pressed once), read back from VRAM (`pasopiaKeys.test.ts`); that its kana codes are JIS X 0201; that kana mode ends with a reset; that it boots to the same "How many files(0-15)?" and `Toshiba T-BASIC Ver 1.1` banner with 29066 Bytes free. - That T-BASIC boots into a 36-column screen whose rows are 37 VRAM words (the hidden attribute cell first), the text layout `screen.ts` reads. ## Implementation None was read for this package's machine code. **One disclosure.** While locating chapter 5 of the ASCII book, a low-resolution contact sheet of its pages 160–176 was rendered, which includes the start of chapter 7 (OA-BASIC internals: memory map and token table pictures, implementation-grade for OA-BASIC, not for T-BASIC or the T100's hardware). Nothing from it was used, and no path-B code was written. ## Test data - The T100 system ROM dump (Santo Nucifora, 2021/2026) and the three IA T100 floppies; provenance, terms and SHA-256 are in `documentation/t100/manifest.json`.