code:3b1emu

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
Last revisionBoth sides next revision
code:3b1emu [2020/01/26 14:36] – philpemcode:3b1emu [2020/09/11 21:54] – [FreeBee -- AT&T UNIX PC emulator] philpem
Line 1: Line 1:
 ====== FreeBee -- AT&T UNIX PC emulator ====== ====== FreeBee -- AT&T UNIX PC emulator ======
  
-:!: insert screenshot here+I'm developing an emulator for the AT&T UNIX PC. Currently it can boot the 3B1 UNIX operating system and run acceptably. 
 + 
 +{{code:3b1emu:freebee.png?direct&600|}} 
 + 
 +There are some documents and other items here which may be useful to 3B1 owners. 
 + 
 +The emulator currently boots 3B1 UNIX, and thanks to the hard efforts of many people, can run a wide variety of software (including, thanks to Jesse, the C compiler and MGR windowing system!). 
 + 
 +The serial ports, printer port and modem are not currently emulated. I'm currently looking for a good way to create a "virtual" serial port device on Linux, Windows and Mac OS X. 
 + 
 + 
 +===== Downloads ===== 
 + 
 +The source code is hosted on Github: [[https://github.com/philpem/freebee]] 
 + 
 +You will need the {{code:3b1emu:3b1_roms.zip|Boot ROMs}} to use this. 
 + 
 +To install, build the code as per the README. You will need to compile the emulator, create a hard drive image, then follow the instructions in the AT&T manuals (on www.bitsavers.org/pdf/att/3b1) to install the System Software (in Imagedisk format at http://www.bitsavers.org/bits/ATT/unixPC/). 
 + 
 +You will need to use Imagedisk's "IMDU" utility to convert the IMD images into binary disk image files before using them with FreeBee.
  
-I'm currently working on an emulator for the AT&T 3B1 Unix PC. I haven't released any stable code yet, though the Mercurial repository is publicly-accessible. There are some documents and other items here which may be useful to 3B1 owners... 
  
 ===== Thanks and Acknowledgements ===== ===== Thanks and Acknowledgements =====
Line 11: Line 29:
 Andrew Warkentin has contributed many significant patches which improve the quality of the emulation and allow UNIX to be booted inside the emulator. Andrew Warkentin has contributed many significant patches which improve the quality of the emulation and allow UNIX to be booted inside the emulator.
  
-===== Mercurial repository ===== 
  
-https://github.com/philpem/freebee+===== ROMs =====
  
-===== Current status =====+{{code:3b1emu:3b1_roms.zip|Boot ROMs}}.
  
-Boots 3B1 UNIX, with occasional errors. The C compiler causes memory paging errors, and seems to be a bit finicky.+This ZIP file contains binary and Intel Hex images of the two 3B1 Boot ROMs.
  
-I'd like to try and integrate FreeBee into MAME, which might help improve the CPU emulation.+These are fitted at board locations 14C and 15C, and carry part numbers 72-00616 and 72-00617 respectively.
  
-===== ROMs ===== 
  
-[[foo|AT&T 3B1 Boot ROMs / ROM set]]. Images (binary and Intel Hex) of the two 3B1 Boot ROMs. These are fitted at board locations 14C and 15C, and carry part numbers 72-00616 and 72-00617 respectively.+===== Other software and documentation resources ===== 
 + 
 +  * [[http://www.bitsavers.org/bits/ATT/unixPC/|Bitsavers 3B1 software archive]] -- 
 +    * AT&T System Software (Foundation Set) v3.0, v3.5 and v3.51 -- Diagnostics, Floppy/Hard Disk Boot, Communications Patch, Curses/Terminfo, EIA RAM Combo Board drivers, Encryption Add-on, Telephone manager. 
 +    * Electronic Mail 
 +    * Personal Calendar 
 +    * Tape Backup drivers 
 +    * Utilities (Development Set) 
 +      * Curses 3.51 
 +      * Development Kit 3.51 
 +      * Documentation 3.51 
 +      * Editors and Window System 3.51 
 +  * [[http://unixpc.taronga.com/|UNIX PC Information]] by Brian L. Stuart and Peter da Silva 
 +    * An absolute treasure trove of UNIX PC software, including -- 
 +      * A mirror of the STORE archive 
 +      * A mirror of the CalTech archive by Andy Fyfe 
 +      * Indexed pages of software packages, sorted into categories 
 +  * [[http://www.unixpc.org/|UNIXPC.org]] by Corey 
 +    * 3B1 FAQ Rev 3 (1995) in text format 
 +    * Software 
 +      * Mirrors of the AT&T STORE archive, OSU archive, Caltech archive, comp.sources.3b1 (MISC directory) 
 +      * AT&T floppy disk images 
 +        * Foundation set, Communication Patch, Curses, Terminfo, Encryption, Document Preparation, Virtual Device and Development Set
  
 ===== Technical documentation ===== ===== Technical documentation =====
  
-Steven Hirsch scanned the entire of the two-binder AT&T 3B1 Unix PC Technical Reference, and released them on the Classic Computers Mailing List. With his permission, the scans are mirrored here:+Steven Hirsch scanned the entire two-binder 3B1 UNIX PC Technical Reference and released them on the [[http://www.classiccmp.org|Classic Computers Mailing List]]. With his permission, his scans are mirrored here.
  
-==== UNIX PC Reference Manual ====+==== Reference Manual ====
  
-  *     AT&T UNIX PC Reference Manual (chapters 1 and 2) +  * {{ code:3b1emu:trm:3b1_hardware_ref_ch_1_2.pdf |AT&T UNIX PC Reference Manual (chapters 1 and 2)}} 
-  *     AT&T UNIX PC Reference Manual (chapters 3 and 4) +  * {{ code:3b1emu:trm:3b1_hardware_ref_ch_3_4.pdf |AT&T UNIX PC Reference Manual (chapters 3 and 4)}} 
-  *     AT&T UNIX PC Reference Manual (appendix A: PAL equations) +  * {{ code:3b1emu:trm:3b1_pal_eqns.pdf |AT&T UNIX PC Reference Manual (appendix A: PAL equations)}} 
-  *     AT&T UNIX PC Reference Manual (appendix B: Mnemonics) +  * {{ code:3b1emu:trm:3b1_mnemonics.pdf |AT&T UNIX PC Reference Manual (appendix B: Mnemonics)}} 
-  *     AT&T UNIX PC Reference Manual (appendix C: Expansion memory locations) +  * {{ code:3b1emu:trm:3b1_mem_exp.pdf |AT&T UNIX PC Reference Manual (appendix C: Expansion memory locations)}} 
-  *     AT&T UNIX PC Reference Manual (International Version Supplement)+  * {{ code:3b1emu:trm:3b1_intl_version.pdf |AT&T UNIX PC Reference Manual (International Version Supplement)}}
  
-==== Circuit diagrams / schematics ====+==== Circuit diagrams and schematics ====
  
-  *     AT&T UNIX PC Schematics: D-08-00222-00 "Schematic: S4, CPU"; alternate versions: 1, 2 +  * {{ code:3b1emu:trm:3b1_s4_cpu_ps.pdf |AT&T UNIX PC Schematics: D-08-00222-00 "Schematic: S4, CPU"}}; alternate versions: {{ code:3b1emu:trm:3b1_s4_cpu_ps_1mb.pdf |1}}, {{ code:3b1emu:trm:3b1_s4_cpu_ps_2mb.pdf |2}} 
-  *     AT&T UNIX PC Schematics: D-32-00379-00 "DMA Address I.C." +  * {{ code:3b1emu:trm:3b1_dma_addr_schem.pdf |AT&T UNIX PC Schematics: D-32-00379-00 "DMA Address I.C."}} 
-  *     AT&T UNIX PC Schematics: D-32-00381-00 "Video I.C."+  * {{ code:3b1emu:trm:3b1_video_schem.pdf |AT&T UNIX PC Schematics: D-32-00381-00 "Video I.C."}}
  
 ==== Peripherals ==== ==== Peripherals ====
  
-  *     DOS-73 Technical Reference (no schematics) +  * {{ code:3b1emu:trm:3b1_dos_73.pdf |DOS-73 Technical Reference}} (no schematics) 
-  *     Ethernet Expansion Board: Theory of Operation (includes schematics) +  * {{ code:3b1emu:trm:3b1_ethernet.pdf |Ethernet Expansion Board: Theory of Operation}} (includes schematics) 
-  *     Floppy Tape Interface: Theory of Operation (includes schematics) +  * {{ code:3b1emu:trm:3b1_floppy_tape.pdf |Floppy Tape Interface: Theory of Operation}} (includes schematics) 
-  *     RAM-COMM Expansion Board: Theory of Operation (includes schematics) +  * {{ code:3b1emu:trm:3b1_ram_comm.pdf |RAM-COMM Expansion Board: Theory of Operation}} (includes schematics)
- +
-==== System bus ====+
  
-  *     AT&T S4BUS -- UNIX PC Expansion Bus Specifications, Issue 1.3+==== System bus specification ====
  
 +  * {{ code:3b1emu:trm:3b1_specs.pdf |AT&T S4BUS -- UNIX PC Expansion Bus Specifications, Issue 1.3}}
  
Find me on Mastodon
  • Last modified: 2020/09/12 00:41
  • by philpem