| 1 | Philipp Hachtmann's Honeywell H316 development kit |
| 2 | |
| 3 | This package is made by Philipp Hachtmann (hachti@hachti.de) |
| 4 | A fresh snapshot can always be found on http://h316.hachti.de |
| 5 | |
| 6 | |
| 7 | How to use: |
| 8 | =========== |
| 9 | |
| 10 | This is approved working on my two Linux PCs. |
| 11 | You need a "normal" gcc and gnumake etc. bla bla. |
| 12 | |
| 13 | Bob Supnik's SIMH simulator must be installed and the |
| 14 | h316 executable must be in the path. |
| 15 | SIMH from rev. 3.6 works fine. |
| 16 | Older versions have a severe bug, don't use them. |
| 17 | If you like SIMH consider compiling it with |
| 18 | libreadline support - see the SIMH makefile.... |
| 19 | You get SIMH at http://simh.trailing.edge.com |
| 20 | |
| 21 | What to do: |
| 22 | - Extract the archive (You have already done that...) |
| 23 | - Set following environment variables: |
| 24 | export H316=<full path to the directory containing this file> |
| 25 | export PATH=$PATH:$H316/bin |
| 26 | - Enter the $H316 directory and run make. |
| 27 | - If there's no error you can start to look around in the tree. |
| 28 | Everything is fine and ready to use. |
| 29 | |
| 30 | If there's an error try to correct it or feel free to ask me. |
| 31 | |
| 32 | All libraries are built when you run make. Precompiled (original) |
| 33 | stuff is found in directories called "original" or "obj". |
| 34 | Most other stuff is rebuilt by a make run. |
| 35 | The IO library works with my private line printer interface. |
| 36 | So don't get frustrated when you try the routines in SIMH - they |
| 37 | **won't** work! |
| 38 | If you have some original library routines from Honeywell - please |
| 39 | let me know! I am looking for tape drivers, the original line |
| 40 | printer driver etc. |
| 41 | |
| 42 | If you have set up everything look for the mandelbrot program. |
| 43 | It's somewhere out there.... |
| 44 | Try to compile it with the command "frtn <source-file>". |
| 45 | Then you have a Honeywell Object. Now exec it by calling |
| 46 | frun <object-file>. There is also an asm command. |
| 47 | Try it out and read the scripts in $H316/bin for enlightment! |
| 48 | |
| 49 | Libraries are built with some scripts contained in the appropriate |
| 50 | subdirectories. There's a kind of receipe file for every |
| 51 | library to build. Works fine, try it out! |
| 52 | |
| 53 | And don't forget to try out the ldc program. |
| 54 | ldc <obj-file>|<library-file> |
| 55 | It's an object checker. A bit like nm on unix machines. |
| 56 | If you have unknown or unchecked library or |
| 57 | object tapes - you will LOVE it!!! |
| 58 | |
| 59 | An important hint: There's a PAL-AP replacement flying around here. |
| 60 | It's called binal. The super3.slst contains binal, not PAL-AP. |
| 61 | Binal stores information in binary code, no silent code. |
| 62 | It also ONLY supports the PTR and PTP devices, no ASR booting! |
| 63 | |
| 64 | So, if there are questions, please ask me. |
| 65 | |
| 66 | Best regards, |
| 67 | |
| 68 | Philipp :-) |
| 69 | |
| 70 | |
| 71 | ... make clean works, too. |
| 72 | |
| 73 | |
| 74 | |
| 75 | |
| 76 | |
| 77 | |
| 78 | |
| 79 | |