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