.. include:: header.txt .. comment Heading levels: *** top and bottom , === bottom , --- bottom, +++ bottom *************** EBTKS Downloads *************** Standard File Set for the SD card ================================= .. note:: **Definition:** |br| A **LIF disk image** is a file on the MicroSD Card, typically in the /disks directory, and with a file extension of .dsk |br| 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:** |br| 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: |_5| 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: .. code-block:: text 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. :ref:`See below ` If your HP86/87 displays the bug, and you don't want to do a full update of the SD Card, :ref:`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 |clearer| - 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 |clearer| * 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* :ref:`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 about LIF 100 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 |br| HP9915A |br| HP85A |br| HP85AEMC |br| HP85B |br| HP9915B :download:`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 |br| HP86B |br| HP87 |br| HP87XM :download:`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: |_5| 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:`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 :download:`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 :ref:`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 :download:`CONFIG.TXT_for_HP85A_Tape_Drive_disabled ` :download:`CONFIG.TXT_for_HP85A_with_Tape_Drive ` :download:`CONFIG.TXT_for_HP85B_Tape_Drive_disabled ` :download:`CONFIG.TXT_for_HP85B_with_Tape_Drive ` :download:`CONFIG.TXT_for_HP86A-64KB ` :download:`CONFIG.TXT_for_HP86B-128KB ` :download:`CONFIG.TXT_for_HP87-32KB ` :download:`CONFIG.TXT_for_HP87XM-128KB ` 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 :ref:`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. :download:`Download the QRG ` 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:`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 =============================== :download:`SDCard Datasheet ` Github ====== |EBTKS Teensy 4.1 Source Code on Github| .. |EBTKS Teensy 4.1 Source Code on Github| raw:: html EBTKS Teensy 4.1 Source Code on Github EBTKS Schematic =============== :download:`V2.0 Schematic (Used for development and Beta Test) ` :download:`V3.0 Schematic (Production) ` 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)