EBTKS Downloads¶
Standard File Set for the SD card¶
Note
Definition:
A LIF disk image is a file on the MicroSD Card, typically in
the /disks directory, and with a file extension of .dsk
It represents either
a floppy disk (size is 264 kB) or a 5 MB Winchester disk (size is 4743 kB).
When you read or write to disks that are emulated by EBTKS, these are the files
that represent those disks. Internally, these files have a directory and the
files you see with a CAT command. For example, if the CONFIG.TXT file contains
the following section:
{
"Comment": "msus$ 300",
"unit": 0,
"filepath": "/disks/EBTKS_1.0_85.dsk",
"writeProtect": false,
"enable": true
},
EBTKS_1.0_85.dsk is the LIF disk image that is seen as :D300 , which is the default mass storage device with EBTKS. When you type CAT, you are getting the catalog (directory listing) from inside this file. When you load a program from this “disk”, you are actually reading the program from somewhere within this file, as indicated by the internal directory information. Similarly, if you are saving a program or writing data to :D300 (the default mass storage device) you are actually modifying this file.
Note
Warning:
If you have been developing program and/or writing data to LIF disk images on your
MicroSD Card, these should be saved before overwriting with these downloaded MicroSD Card file sets.
See above definition.
Update V1.0.2: Do I need it?¶
The primary purpose of release V1.0.2 is to fix a bug that affects some HP86 and HP87 computers. The bug is due to an unintended interaction between EBTKS and the Graphics ROM (001) in these systems. The HP85A/B do not have this ROM.
If you are not running programs that display text on CRT when in Graphics mode, the bug will not be seen. If you run such programs, you may still not see the bug, depending on the version of the Graphics ROM. Here is a trivial test program:
GRAPH @ MOVE 50,50 @ LABEL "HELLO WORLD!"
If the text is displayed correctly, your system is not affected by the bug.
Regardless of whether this bug affects your computer, this release contains some other updates that you might find useful. See below
If your HP86/87 displays the bug, and you don’t want to do a full update of the SD Card, See below for instructions to just do the minimal update.
Update V1.0.2¶
There are 2 MicroSD Card file sets available for download. One for HP85A/B, and the other for HP86/87. These are a complete distribution file set, equivalent to the SD Card contents when you originally received your EBTKS. The contents of the two file sets are close to identical, with the following differences:
The CONFIG.TXT file in the root directory is copied from a different file, that is also in the root directory
For HP85A, it is a copy of CONFIG.TXT_for_HP85A_Tape_Drive_disabled
For HP87, it is a copy of CONFIG.TXT_for_HP87-32KB
The pre-configured LIF disk images for :D300, :D301 and :D320 are different.
For HP85A/B
:D300 is associated with /disks/EBTKS_1.0_85.dsk
:D301 is associated with /disks/85Games1.dsk
:D320 is associated with /disks/85Games2.dsk
For HP86/87
:D300 is associated with /disks/EBTKS_1.0_87.dsk
:D301 is associated with /disks/87_Action_Games.dsk
:D320 is associated with /disks/87_Galaxy_Patrol.dsk
Please don’t just download and start editing the CONFIG.TXT file. Spend a little time reading the documentation, and save a whole lot of frustration Working with CONFIG.TXT
The normal way to use an update like this is as follows:
Consider making a backup of your current SD Card, just in case you have any issues.
Unzip the downloaded update in to a temporary directory on your PC/MAC/etc
Make any needed changes to the CONFIG.TXT file
From your existing SD Card, copy any LIF disk images that you have modified to the /disks directory within the temporary directory on your PC/MAC/etc
Make any other needed changes.
Copy all the files in the temporary directory to an SD Card. If you have more than one SD Card, maybe use a different one from your existing SD Card for EBTKS.
Put the newly created SD Card in to EBTKS.
The downloaded .ZIP file should be un-zipped into a temporary directory. There are 8 CONFIG.TXT files provided, with the rest of each file name indicating its specific pre-configuration. Copy the appropriate one to CONFIG.TXT (you will need to delete or rename the default CONFIG.TXT that is provided)
The CONFIG.TXT file should be inspected to make sure that it matches your Series80 computer, and your desired ROMs and LIF disk images that are configured in the “hpib” section are what you want.
On your existing SD Card, if you have been STORE-ing programs or data, then you have modified the related LIF files in the /disks directory. You should make a copy of these files, and add them to the /disks directory in the temporary directory where you are building the new SD Card file set for your system.
The complete set of files in the temporary directory should be copied to a blank MicroSD Card, or the existing one (which hopefully you have made a backup).
What has changed in microSD Card version 1.0.2¶
Updated all CONFIG.TXT files in the root directory to be more specific to each model of Series80 computer, and some minor errors related to default ROMs and RAM size for HP86B. There are now 8 example CONFIG.TXT files.
For HP86 and 87, virtual disks :D301 and :D320 now point to disk images of HP86/87 games, some/all authored by Everett Kaser.
Note: These games have not been tested by the author of this page. If you find that to run them you need to follow some setup, like changing the MASS STORAGE IS setting, etc…, please email Philip so this page can be updated.
Major improvement to the HELP system for HP85A/B, thanks to Martin Hepperle. He has authored 192 help articles that cover the ROM keywords for
I/O ROM
Advanced Programming ROM
Matrix ROM
Printer/Plotter ROM
You too can see your name here by adding to the HELP system by writing additional pages. They are easy to do, and given the limits of the 32 character wide screen and maximum of 64 lines of text, terse prose is an advantage. If you feel inspired, co-ordinate with Everett to avoid duplicated effort
Although not previously documented, in the directory tree starting at /EK_Disks , there are about 100 LIF floppy disk images (any file that is 264 kB) that cover most of the PACs published by HP, and some other assorted material. To use these LIF disk images
Make a copy of the file and place it in the /disks/ directory
Add a file name extension of .dsk
Edit your CONFIG.TXT file to assign it to one of the existing MSUS definitions, or add a new one
In the directory /other_disks_85/ is:
Waveform Analysis PAC for HP85
In the directory /other_disks_86_87/
Waveform Analysis PAC for HP86 and 87
Circuit Analysis PAC for HP86 and 87
Math PAC for HP86 and 87
The above two directories have a subdirectory with some documentation PDFs.
MicroSD Card file set as a ZIP for HP85A like computers¶
- This SD Card File Set is intended to work with the following Series80 Computers
HP83
HP9915A
HP85A
HP85AEMC
HP85B
HP9915B
SD_Card_Image_V1.0.2_for_HP85A_and_B_2022_01_21.zip
Release 1.0.2 , January 21th 2022
MicroSD Card file set as a ZIP for HP86A/B and HP87 and 87XM computers¶
- This SD Card File Set is intended to work with the following Series80 Computers
HP86A
HP86B
HP87
HP87XM
SD_Card_Image_V1.0.2_for_HP86_and_87_2022_01_21.zip
Release 1.0.2 , January 21th 2022
Minimal update for for Graphics Text bug¶
If your HP86/87 displays the Text bug described above, the minimum update is to download the file set for HP86/87 and copy the following 8 files from the /roms87 directory of the download to the same named directory on your SD Card.
rom361
rom361.lst
rom362
rom362.lst
rom363
rom363.lst
rom364
rom364.lst
Update V1.0.3: Do I need it?¶
The primary purpose of release V1.0.3 is to fix a minor bug that affects the new keyword SDGET.
Unlike prior updates, this update is just some patch files. Thus, for the most recent file set (if you are creating a new SD card), download V1.0.2 and copy to the SD card, then apply the V1.0.3 minor update.
The V1.0.3 update is a single .ZIP file that contains 2 directories, and each has 8 files.
Download Minor_Update_1.0.3.zip
Unpack it to a temporary directory.
Copy the 8 files in roms85 to the same named directory on your SD card, overwriting the existing same named files.
Copy the 8 files in roms87 to the same named directory on your SD card, overwriting the existing same named files.
If you have been developing software or collecting data, maybe now would be a convenient time to copy the /disks/ directory to your PC/MAC and save the files in a directory with today’s date. Something like:
EBTKS_Backup_2023_09_27
Or make a copy of the complete SD card (about 70 MB)
Return the SD card to your EBTKS. Start your Series 80 computer and enter the keyword AUXREV. The displayed value should be 29.
That’s it.
Firmware for Teensy 4.1¶
Release 1.0.0 , July 12th 2021
EBTKS_Firmware_2021_07_12_V1.0.0.hex
This firmware is intended to work with all Series80 Computers
After downloading the EBTKS Firmware, proceed to Updating the EBTKS Firmware
CONFIG.TXT¶
If you are downloading one of the SD Card images, it already has all of the following example CONFIG.TXT files in the root directory.
The following downloads are if you have messed things up and you need a clean copy to get something that works.
All of these are from the V1.0.2 update released of 21 January 2022
CONFIG.TXT_for_HP85A_Tape_Drive_disabled
CONFIG.TXT_for_HP85A_with_Tape_Drive
CONFIG.TXT_for_HP85B_Tape_Drive_disabled
CONFIG.TXT_for_HP85B_with_Tape_Drive
After downloading one of these CONFIG files, rename it to CONFIG.TXT . Depending on your system configuration, make any necessary edits to match your requirements, then copy it to the root directory of the SD Card. Detailed instruction for editing CONFIG.TXT can be found here Working with CONFIG.TXT
EBTKS Quick Reference Guide (QRG)¶
Martin Hepperle has created a compact guide to all the new keywords that are implemented by the AUXROMS on EBTKS.
EBTKS Documentation Website as printable PDF¶
Some people have their Series 80 computer located away from their PC/MAC, and so when working with EBTKS, all the online documentation is not easily accessable.
Thanks to the efforts EBTKS owner 07-024 & 07-025 we now have a PDF of the web site, suitable for printing. It is a snapshot of the site in early June 2023. The PDF contains page numbers at the bottom of each page, and the table of contents has each title and subtitle with the appropriate page number. If you are viewing the PDF on a computer, clicking a section title will open the appropriate page in a browser.
Download the PDF version of this website
The PDF can of course have the viewing size easily adjusted, so this may also be helpful, if the fonts used in the online website are too small.
Suggestion: Print the table of contents and the relevant section for what you are working on, or just print all 161 pages.
SanDisk Brand SD Card Datasheet¶
Github¶
EBTKS Schematic¶
V2.0 Schematic (Used for development and Beta Test)
All EBTKS with Serial numbers of the form 01-0xx, 02-0xx, 03-0xx, 04-0xx, 05-0xx, 06-0xx, 07-0xx, 08-0xx, 09-0xx, 10-0xx are V3.0 Schematic, with no rework or modifications. All are ROHS compliant. All are a mix of automated assembly for surface mounted parts and hand assembly both at the factory, and by Philip (the Teensy 4.1 sockets and pins)