18e3fabb |
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 | |
adbca57e |
13 | Bob Supnik's SIMH simulator must be installed and the |
14 | h316 executable must be in the path. |
18e3fabb |
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 | |
adbca57e |
21 | What to do: |
18e3fabb |
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 |
18e3fabb |
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) |
adbca57e |
33 | stuff is found in directories called "original" or "obj". |
34 | Most other stuff is rebuilt by a make run. |
18e3fabb |
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 |
adbca57e |
37 | **won't** work! |
18e3fabb |
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.... |
adbca57e |
44 | Try to compile it with the command "frtn <source-file>". |
18e3fabb |
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 | |
e8baeca7 |
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 | |
adbca57e |
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 | |
18e3fabb |
64 | So, if there are questions, please ask me. |
65 | |
66 | Best regards, |
67 | |
68 | Philipp :-) |
69 | |
70 | |
e8baeca7 |
71 | ... make clean works, too. |
18e3fabb |
72 | |
73 | |
74 | |
75 | |
76 | |
77 | |
78 | |
79 | |