Taniwha Flight Computer V1.0 Assembly Instructions

(pronounced Tun-e-far)

Version 1.0 - This version of the documentation was last changed on Nov 1st.

Parts List:

Flight Computer V1.0:

B1	PC Board
U1	80C32			microprocessor
U2	27C256-12		32Kx8 ROM - 120nS
U3	74HC373
U4	LM340T-5		5v regulator (might be a 7805 part)
U5	43C256-15		32Kx8 RAM - 150nS
U6	74HC00
T1-T4	2N6045 or 2N6044	darlington output transistors
Y1	11MHz			crystal
S1	28-pin socket		ROM socket
R1	8k2			reset pullup
R2	91 or 100 ohms		charge reservoir fill rate
R3-R6	10k
C1-C2	30 or 33pF
C3	10uF	
C4	100uF			power decoupling
C5, C7	0.01uF			power decoupling
C6	1000uF			charge reservoir
P1	6 pin connector		main connector
P2	10 pin header socket	aux connector
P3	3 pin header socket	serial connector

RS232 interface:

U100		RS232 level converter - MAX232 or equiv.
C100-C104	10uF capacitors
P100		RS232 connector for your computer
P101		small connector to match P3 above (included in the FC kit)
Note that there should also be plugs to match all the connectors on the flight computer and a bag of pins for the plugs - they are very small so be careful you don't lose them. P1 is a 0.156 (really 4mm) pitch molex connector available at many local electronic supply places - P2, P3 are 2mm DF3 connectors by Hirose Electric available from DigiKey.

A number of the components - in particular the TO220 transistors and the crystal may have bent leads - straighten them out - they are intended to be placed vertically.

As usual you should observe care with static sensitive parts - only remove them from their tube just prior to using them and always gently ground yourself and your soldering iron tip prior to working with any parts.

This board is designed to work with any of the 40-pin 8051/8031/8052/8032 variants of microprocessors - I've chosen the 80C32 mostly because it's available and because it runs at a much lower power than the plain 8051/8031s that are more commonly available (15mA vs 160mA).

The PCB is double sided with plated through holes. It has rather fine traces - take great care not to bridge these use as little solder as you can - too much heat can cause them to lift or damage the thru-holes - try using a soldering iron with the finest tip you can find (1/32 for example).

The 11mHz crystal can be replaced with a 12MHz one, or even a 16MHz one (if you have an 80C32-1) - but I've used 11MHz because the serial baud rates work out right with the simple timers. In other words the supplied rom will stop working and you will have to provide your own.

The ROM is socketed, I'll provide already burnt ROMs containing a monitor, Basic and Forth that will talk to the serial port at 9600 baud - this monitor only works on 8032/8052 and variants (it uses the upper 128 bytes of on-board SRAM for a buffer).

I've tried to write this document so that it has information for people with a whole range of experience building electronic gear - you may find parts of it too wordy - or too difficult or confusing - I'd appreciate feedback to help me make it better. This page is rather long - I wanted to make it easy to print out a copy.

Construction

Assembly can be done in 1/2 an hour, I suggest you take your time and go as slowly as possible. A component placement diagram is located after the assembly instructions below.

Notes: pins on chips are numbered counter clockwise. If you look at the top of a chip (with the pins facing down one end will have a notch or a dot - the dot indicates pin number 1, the notch indicates the top, if you orient the chip with the notch up pin 1 is at the top left next to the edge with the notch. On this board pin 1 always goes into a square pad.

Assembly instructions:

  1. Inspect the board for any flaws or solder bridges.

  2. Now is the time to decide how you are going to mount it and to drill mounting holes - do this with care and make sure not to damage any of the traces. Space has been left at either end for this.

  3. Note that in this document we are going to refer to the side of the board that contains the bulk of the components as the "upper" side and the other side as the "bottom" side. Find the upper side of the board (labeled "Top") - for all the following descriptions the end containing the prototyping area (and also where the "Top" label is located) will be referred to as the "Top" of the board, the end with the connector (look for 6 holes rather larger than the rest) will be the "Bottom". At the end of this section are a pair of disgrams showing component placement

  4. First we will place components on the upper side of the board. Position and solder in place U1 the 80C32 - note that pin number 1 for each component on then board is a square pad. The 80C32 is the 40 pin device it is positioned with the notched end facing the top of the board.

  5. Next solder in the ROM socket - it's notched end also faces the top of the board, it is positioned above the 80C32, there are two sets of holes here (one for the RAM which will be soldered in underneath - make sure you get pin 1 of the ROM socket (on the top side to the left) in the square pad on the left - when correctly placed there should be a visible row of pads to the left of the socket for the SRAM and another hidden under the socket on the right.

  6. Next place U6 the 74HC00 - it is placed above the ROM socket and is oriented with its top facing the right.

  7. Now is a very good time to check the soldering of the parts you just placed - look for bad or missing solder joints, and shorted or lifted traces - the next two steps will make some of the solder joints hidden and unable to be accessed in the future.

  8. Next turn the board so that the lower side is facing upwards. Solder U3 the 74HC373 into it's location underneath the 80C32 - again it's top end faces the top of the board. Some of it's pins will be hidden by the 80C32 - they have to be soldered on the 74HC373's pins on the chip side of the board.

  9. And with the board still upside down solder in the 43256 SRAM chip, it goes underneath the ROM socket, again with the top end of the chip facing the top end of the board.

  10. Turn the board back up the other way (ie upper side up). Install the 11MHz crystal immediately below the 80C32. And install C1 and C2 the 30 or 33pF capacitors on either side of the crystal. Install R1 the 8k2 resistor (gray-red-red bands) next under the crystal.

  11. A little down and to the left are the locations for R3-R6 install the 4 10k (brown-black-orange) resistors there.

  12. Immediately to the right of those resistors are the locations for the 4 output pyro drive transistors T1-T4, solder these in place with the flat metal side (the one without lettering) facing the 80C32 and the top of the board, and the black side with the lettering facing the bottom of the board. You may want to carefully cut of the metal part of them that sticks up (with the hole through it) to save weight before installing them - the heat sink is not required. Be carefull these parts look the same as U4 (below) make sure you get the right ones before soldering them in place.

  13. Below the resistors is the location of the voltage regulator (U4 a 7805 or LM340-T) - install it around the other way from the transistors with the flat metalic side facing the bottom end of the board and the black side with writing facing the 80C32.

  14. Below the voltage regulator is the space for R2 - the 91 (white-brown-black) or 100 (brown-black-brown) resistor - this resistor charges the pyro charge reservoir (C6) from the supply voltage (not the 5V from the regulator).

  15. At the very bottom of the board install the 6-pin main connector. Note the holes are not quite big enough for the pins so it sits about 5mm above the board. You may want to install the mounting bolts if you drilled mounting holes prior to soldering this connector in place.

  16. To the right of the transistors install the 10-pin auxiliary header P2. Install the open side of the socket facing the transistors.

  17. Above this install C5 one of the 0.01uF decoupling capacitors.

  18. And above this install C3 the 10uF reset capacitor, IMPORTANT - make sure that the side marked "+" faces the top of the board - be carefull with this capacitor - there's a via (a hole slightly smaller than a normal component pad used to connect a trace on the top of the board with one on the bottom) in the middle of where this part should go - and the component is smaller than the distance between the pads .... make sure that it straddles this hole and that both the leads go in about the same distance apart as C5 (above).

  19. Above C3 install the 3-pin serial connector. Install the open side of the socket facing away from the CPU chip (ie facing outwards opposite to P2 above).

  20. At the top right of the board just to the right of the 74HC00 install C7 the other 0.01uF decoupling capacitor

  21. Now turn the board over again so that the lower side is facing up. Install C6 the 1000uF ignition charge reservoir capacitor - if you have an axial lead part the "+" end goes to the bottom and is soldered in just between the voltage regulator and the bottom most transistor. The negative lead goes into a pad underneath the 80C32 just above the crystal. If you have a non-axial part (the ones in the initial kit do) the negative lead goes just underneath the bottom most transistor. NOTE: if you want to up the oomph from your ignition system you can make this capacitor larger - it is charged directly from your supply voltage so make sure that you get a part with a higher rated voltage. When you are finally done and everything is working OK you may wish to drop a spot of epoxy to hold this part securely in place.

  22. Finally also install the other decoupling capacitor (C4 - 100uF) underneath the 80C32, it's positive end faces the top and sits next to the middle of the 74HC373, the negative lead is just above the negative lead of C6 (above - if you have an axial part). It may be a bit short for this space - carefully form the leads so that they don't short any of the other traces on the board.

  23. Turn the board again so that the upper side is up - insert the ROM in the ROM socket (again make sure that the notched end faces to top of the board).

You should have now inserted all the parts in the flight computer - very very carefully check the board for shorts or damage to pins or traces.

Before you continue you should check out the section below describing options you can make to the board.

Note the locations of the pads for the pins of C4 and C6 are shown rather than the component outline.

RS232 Converter

Next assemble the RS232 converter ..... if you need one - this inverts the serial signals and level shifts them to RS232 levels and is able to drive a wire long enough to get safely away from a launch pad :-) This whole area has lots of scope for you to do things your own way - I've explained how I did it - you get to choose one that's right for you.

I haven't included a circuit board for this piece of logic ... just buy a simple prototyping board from Radio Shack, or rats-nest it in place, the basic circuit is:

Notice that all the capacitors are polarized and it's important you get them the right way around. Be careful you connect the correct contacts to the flight computer - you WILL damage it if you wire up the RS232 side to the flight computer.

I packaged mine in a small box containing a battery holder for 4 C cells, a slide switch and an LED

The side marked "Serial to Flight Computer" should be connected to the 3-pin plug in the order shown on the above diagram and plugged in to the 3-pin header on the right hand side of the computer - see the section on connector P3 about how to wire this end correctly. The RS232 pins have to be connected to your host computer - how this happens depends on how your computer is wired you should have told me what sort of connector you wanted when you ordered the RS232 kit. In my box I put a mini telephone connector on the side so I can use a normal telephone extension cord to extend the distance from the box by several hundred feet if I want to. I wired the GND to the yellow line, TXD to the black line and RXD to the red line. I bought a 3ft telephone extension, chopped one end off and wired a plug for my computer onto it. (You have to be careful - telephone connectors gaily swap black-yellow, red-green so follow it through). If you do this don't plug it into the wall telephone socket you'll blow something up :-).

Here's how to wire some familiar types of computer, if your's is not here get in touch and I'll try and talk you through making a cable for yours:

Mac

Macs use a mini-DIN 8 connector (the plug) - these have to be one of the most annoying, fiddly god-forsaken pieces of hardware to solder ever designed ..... you only have to do one. Look closely at the plug and how it goes together - don't forget to put the outer connector sleeve over the cable you are soldering before you start, the connector (viewed from the side you are soldering) looks like:

Be careful soldering the back of this connector the plastic it's made of is pretty easy to melt. When you are done wrap some tape around the wires before you put the shield back on so it can't short out.

PCs

I only know how to wire the 9-pin DB9 connectors (connectors usually have the pin numbers molded in them):

General RS232 Connectors

Here's how to wire your generic DB25 connector (connectors usually have the pin numbers molded in them):

Note that for almost every machine there's something different - the usual thing to do if something doesn't work is to swap the RXD and TXD wires and see if that fixes it.

Bring up

Hook up the flight computer to a 9V battery (make sure you get it the right way around - the positive terminal should be wired to the left hand pin on the bottom connector, the negative terminal should be wired to the right-most pin of the same connector - with a multi-meter quickly measure the current draw - it should be ~40mA - if it isn't disconnect it quickly. Gently touch each of the chips or transistors on the board - if any of them are hot to the touch - disconnect quickly - if either of these problems happen inspect the board - are there any solder shorts? open connections? chips in backwards?

If you have a 'scope check out pin 39 on U1 (the 80C32) you should see data moving here.

Now hook up the serial connector and plug in the host - run a terminal program and set it up for use with a direct connection (no modem) through the serial port you connected to. Set the baud rate to 9600 baud - 8 bits, no parity, 1 stop bit. Turn on the flight computer - you should see a startup message followed by a prompt (yes that is the prompt :-). Type '?' you'll get a list of the commands the monitor can respond to.

If nothing happens disconnect the RS232 converter - short the RXD and TXD pins going to the flight computer - try typing in your terminal emulator on your host - what you type should get echoed - if not there's something wrong with the converter. Unshort them - echoing should stop.

Again now is a good time to look for solder shorts, opens or components that are in the wrong place or backwards.

Connectors

P1 the main connector

Note: in the following docs P3.0-7 and P1.0-7 refer to bits in the parallel ports on the CPU that you can set or read from software. There are 4 8-bit ports P0-P3 and individual bits in them are refered to by their bit index.

This connector is the main one at the bottom of the board it has 6 pins, looking from the upper side of the board:

You connect +V to the positive terminal of a 6V-12V battery, GND is the ground, +VIg is the common wire for all the igniters and CH1, CH2 and CH3 are individual igniter (ie flashbulbs or electric matches) wires. CH1 is driven by P3.3, Ch2 by P3.5 and CH3 by P3.4

Or a wiring harness with more stuff (an on/off switch and an arm/safe switch):

The actual circuit for each igniter looks more like:

When P3.X is turned on the internal pullup and the 10K resistor drive the transistor that sinks the contents of the capacitor through the flashbulb/electric match. If you want more reliable ignition you can use a bigger capacitor. The capacitor is shared by all the igniter circuits so you should only fire one at a time and let it have enough time to recharge (say 1/2 sec) between uses. The 91 or 100 ohm resistor is so that the instantaneous short of firing an igniter doesn't deprive the CPU of power. Notice that the capacitor is charged to the full voltage of the supply battery, not the lower regulated supply of the CPU - for this reason a 9v or 12V supply is better than a 6V one.

IMPORTANT: One thing to look out for - when the 80C32 goes into reset all it's outputs turn off and are pulled high - this means that until the processor comes out of reset at power-on ALL the pyro devices are activated at once !!! This is a bad thing - for this reason I recommend that you short the fourth transistor (that's only brought out on P2) to +VIg - this keeps the capacitor shorted to GND during this period (but makes it unusable as a pyro driver at anyother time - you can however use it as a electronic safe/arm).

A quick note about wiring harnesses - you make soldered or crimped connections for one purpose only - to make electrical contact - they should never be used to support the weight of wiring or any other component especially under G loadings - always use strain relief (epoxy the wiring to the body tube or something).

P2 - the auxillary connector

This connector provides access to +5V, +VIg, all 4 pyro channels, 3 input channels and GND. The pins are (from the TOP of the board):

P3 - the serial connector

This socket is for connecting the serial cable to the RS232 converter - it has 3 pins, the one closest to the TOP of the board is the GND the middle one is connected to P3.0 and is for incoming data (RXD), the lower one is connected to P3.1 and is for outgoing data (TXD).

Options

There are a number of options on the board - you may see stray pads or traces and wonder about their purpose - here are as many as I can remember ....

Proto area

The proto area at the top is not wired to anything except for the pads in the center of the IC area - the ones with the traces on the upper side of the board are +5V, the ones connected to the shorter traces on the bottom are GND.

Reset switch

If you are doing software development having a reset switch is very useful - you can add one by connecting a SPST switch between pin 9 on U1 (there's a free pad sitting there) and +5V on the board (there's a via just to the left midway between pins 4 and 5 of U1 that you can use). Or you can connect the switch across C6.

On/Off switch

At the bottom of the board is a pair of pads that can be used to wire up an on/off switch - just cut the thin trace on the bottom then wire a slide switch between the pads. Or you can install the on/off switch into the wiring harness connected to P1 as described above.

Diode protection

If you didn't install the above switch you can still cut the trace and install a small power diode (1N4001 or equivalent) between these two pads (put the banded end of the diode to the right) to protect the flight computer from you wiring it up backwards.

Arm Switch

There a 3 pads at the bottom which can be used to wire a safe/arm switch into the circuit - it shorts the igniters in one position and arms them in the other.

Parallel ports

All the pins on P0 and P3 are brought out to pads on the LHS of the board, there are a number of power and ground pins hanging around there too if you want to use them (the power pins are directly above and below the parallel port pins, the grounds are indented a little near U1's pin 1).

Leaving things out .....

One or any of the transistors and their pullup resistors can be left off the board.You can also cut off the metal tab at the top of the transistors or the voltage regulator to save weight.

If you have a 6V supply you should replace the voltage regulator with a small power diode (1N4001 or eqv.) with the positive end in the rightmost pad of the regulator and the negative end in the leftmost (leave the middle one alone) this diode provides the required voltage drop and also provides protection against plugging the battery in the wrong way around. Don't try this if you have a supply of more than 6V.

You can leave of the ROM if you have an 8052 or 8051 etc with internal ROM, if you do this there is a small ground trace next to U1 pin #31 which should be cut and a pad underneath the 80CXX that should be tied to +V.

You can leave off the RAM - if you do you can also leave off the 74HC00 - but you must jumper pin 1 of the 74HC00 to pin 11.

You can (carefully) cut off the proto area at the top, after you do so make sure that none of the power or ground traces that go up there are shorted.

Memory Map

The processor has 3 separate memory spaces:

Internal RAM - there are 256 bytes of this and most instructions can reference it directly, the upper 128 bytes of it are overlaid by the processor registers - check out an 8051 reference manual for more information about this.

Program memory - there's 64K of this - some of it can be on-chip in some 805X variants - our 80C32 has none on-board. Data can be read from this using a movc instruction.

External data memory - there's 64K of this too - data can be read and written from this memory using a movx instruction.

In this design the program and external data memory spaces have been unified, the lower 32K is the ROM, the upper 32K is the RAM, instructions can be executed from the ROM or RAM and data can be read from either or written to the RAM. Just over 3/4 of the ROM is actually used for the software you are free to drop whatever you like in the rest - but remember that future versions may use more of this space. A Unified space means tha the movc and movx instructions access the same memory - and that you can execute code out of SRAM.

The interrupt vectors in low ROM are vectored through locations in internal RAM so you can locate interrupt service routines in externalRAM.

If you program in assembly then all of the external RAM is available to you, the ROM monitor uses none of it. If you use Forth or Basic they take care of allocating RAM space.

Peripheral Ports

The processor has a large number of peripheral ports (32 of them) however many are used already in this design:

This means that bits 0,1,6 and 7 in port 3 must always be 1s.

The remaining 12 bits are available for use - P3.2-P3.5 are wired to the pyro circuits (but don't have to be used for this purpose), P1.6-P1.7 are also wired to the aux. connector P2.

To read a bit in a port you must have written a 1 to it. All ports have active pull downs and weak pull ups. The value read is the external logic level, if you have a 1 written into a port but there is a large external load (for example one of the pyro driver transisters) you will still read it back as a 0.

I expect that P1.2-P1.5 will be used to communicate with serial A/D and NVRAM circuits in the very near future - if you want to use something please use other pins.

In assembler you can read or write all 8-bits of a port using a move instruction:

		mov	P3, abcd
		mov	P3, #0x56
		mov	a, P3
Or you can read or write a single bit:

		mov	c, P3.4
		setb	P3.5		; this one fires a pyro charge
		clr	P3.6
		jb	P1.6, label
		mov	P1.0, c
		mov	c, P1.0
In Basic you can change a port by:
	LET P3 = 56			; sets a whole port
	LET P1B(4) = 1			; sets bit 4 in port 1
	LET B = P1			; reads a whole port
	LET B = P3B(4)			; reads a bit in port 3
In Forth you can read the contents of a port or register or a bit in port or register using:

	?P3		returns port P3
	?P1_6		returns bit 6 of P1
and you can write a port:
	P3!		writes the value at the top of stack to P3
	P1_6!		write the value at top of stack to bit 6 of P1
So you can use the following code to fire a pyro charge:
In assembly

	setb	p3.5				; fire it
L1:						; set the timer
	mov	tcountl, #1000&0xff
	mov	tcounth, #1000>>8
	mov	a, tcountl
	cjne	a, #1000&0xff, L1
	mov	a, tcounth
	cjne	a, #1000>>8, L1
L2:	mov	a, tcounth			; timeout
	jnz	L2
L3:	mov	a, tcountl
	jnz	L3
	clr	p3.5				; clear it

In Basic

100	LET P3(5) = 1				fire it
101	FOR I=1 TO 100				wait some time
102	NEXT I
103	LET P3(5) = 0				clear it

In Forth

	1 P3_5!					fire it
	1000 IWAIT1MS				wait 1000mS (ie 1S)
	0 P3_5!					clear it

Software

There's quite a lot of software I'm shipping with the board, some of it is designed to go in ROM, some of it's development software etc etc. All the sources are included you are welcome to hack on them to your heart's content. Some software contains my copyrights, I always do this to protect myself should I wish to sell the software in the future. Some of the other software (the Basic and Forth) are from public domain sources on the net - they contain information about their authors in their source.

There are 4 main pieces of software I'm currently shipping - sources and/or binaries are on the sources page:

ROM Monitor

This is what you see whenever the flight computer is reset, it prompts ":-) " and accepts the following commands:

	DC	addr		display program memory 
	DM	addr		display external memory
	DR	addr		display internal memory
	SM	addr ...	set external memory
	SR	addr ...	set internal memory
	G 	addr		make a subroutine call to that address
	I 	addr		disassemble the code at that address
	IL	addr		disassemble a page of code at that address
	R			dump the registers
	:	data		download an Intel hex record (they all start with ':')
	T			enter Basic
	F			enter Forth
				repeats the last display command
There's also a number of very basic system services provided to environment, including setting up some basic registers (the serial port and timer 1 as a baud rate generator for it), a timer (timer #2) providing a 24-bit real-time clock that is always running in internal SRAM, interrupt call backs etc.

What follows is only of interest to those who want to program the computer in assembler.

You can always write code that takes over the machine and ignores the monitor, if you want to coexist with it then you have to keep out of it's way (Tiny Basic and Forth do this the only way to get back from them is to power cycle them or reset the CPU).

Here's a list of internal SRAM locations are used by the monitor -

The following addresses contain pointers to interrupt service routines, the ROM ISRs always vector through these addresses:

vint0 		0x30		interrupt 0 vector
vint1		0x32		interrupt 1 vector 
vtint0		0x34		timer interrupt 0 vector
vtint1		0x36		timer interrupt 1 vector
vtint2		0x38		timer interrupt 1 vector
vser		0x3a		serial interrupt vector

 
timel 		0x3c		time counter - this 24-bit counter is incremented every clock tick
timem		0x3d		(millisecond) to sample this copy (in order) timeh, timem, and timel
timeh		0x3e		to somewhere else then check that timeh and timem haven't 
				changed, if they have start again repeat until you get it (remember 
				you are synchronizing with an asynchronous interrupt
 
buffp		0x3f		used internally

tcountl		0x40		counts down every tick and stops at 0 - set it and wait
tcounth	0x41			until it hits 0 to wait for a known amount of time.
				the correct way to write this is to write 0xff to tcountl,
				write the upper bits of the number you want to tcounth, then
				write the lower bits of the number you want to tcountl.
The following can only be accessed via @Ri - they are vectors for call back to the monitor, you can use code like the following to call through them:


 	mov     r0, #poll_vector
	mov     a, @r0
	mov     dpl, a
	inc     r0
	mov     a, @r0
	mov     dph, a
	clr     a
	jmp     @a+dptr

poll_vector	0x80		pointer to serial poll routine - when called returns a character in
				A if one is available or 0 if not
 
idle_vector	0x82		pointer to idle routine - you can install something here if you want
				to do stuff while the monitor is waiting for characters
 
cli_vector	0x84 		pointer to cli routine - this routine is called with characters in the
				buffer when  is typed - you can add your own if you like
				or use it to add more commands (hacking a ROM might be easier)
 
send_vector	0x86		pointer to send routine - calling this sends the character in A out the
				serial port
 
prompt_vector	0x88		pointer to prompt routine - prints the prompt
 
utility_vector	0x8a		pointer to utility routine - how we will add ROM-based drivers in the future
 
old_addr	0x8c  		used internally 	
old_type	0x8e  		used internally 
buff		0x8f 		used internally 

Once we standardize on NVRAM and A/D interfaces I'll probably add internal service routines that will provide access to these.

The monitor runs with Timer 2 interrupts enabled and all others disabled.

Basic

The Basic is simple and slow all math is done in floating point ... it's comes from Intel - much of it is intended for a particular hardware environment that is different from ours - I've removed most of the commands for that environment.

I'm still hoping to track down a manual for it, so far I've had no luck.

Strings in this variant of Basic are a little wierd - before you can use them you have to allocate space using "string NNN, MMM" where NNN is the amount of space you are allocating to all the strings and MMM is the size of each string. " The "string" command also does an implicit clear - so do it first before loading in your program. Strings are not named "a$" etc instead they are numbered as "$(0)", "$(1)" etc etc.

Other built-ins include commands "PH0." and "PH1." for printing things in hexadecimal - for example "ph0. p3" prints out port 3 in hex.

I've added the following things for accessing the hardware:

Forth

Enter Forth by typeing "f" at the ROM monitor's smily prompt.

The Forth is pretty simple - it's all 16-bit. I've made the following enhancements:

Be carefull - it is totally unforgiving of underflowing stacks.

A copy Of Julian Noble's Forth primer is available here. And a Forth home page is also available.

Assembler

The assembler is something I wrote a few years ago it's in vanilla C/yacc source and has been ported to various machines - I'll make sources, as well as Mac and PC binaries available.

Sources and binaries will be available on the flight computer sources page at http://www.taniwha.com/~paul/fc/srcs.

The assembler accepts pretty normal 8051 assembler syntax with a few wierdities:

The compiler works as a normal applicatioon from a Unix or MPW (Mac) shell, or DOS prompt. It takes commands in the format:

	
	asm51	[-Bm] [-o output] input

If you omit the output filename it takes the input file name and changes the extension to '.51' which contains an Intel Hex formatted download image - suitable for sending to the onboard monitor. The -m flag is used it creates a link map/symbol table, if the -B flag is included it outputs a Perl program to stderr that will convert all the ajmp/ljmps to the correct types to same the most space (you may have to do this several times before it converges).

To create downloadable code you need to start the code at somewhere that will actually have sram at it (ie >= 0x8000). What follows is a simple piece of code that calls back to the monitor to send characters:

        .=0x8000
send_vector     = 0x86                  ;; pointer to send routine
entry:  mov     r7, #str>>8		; string base address
        mov     r6, #str&0xff
loop:           mov     dph, r7		; get the next char from the string
                mov     dpl, r6
                movx    a, @dptr
                mov     r1, a		
                jz      done		; if it's the terminating 0 character quit
                inc     r6		; inc the pointer
                acall   send		; send the char
                sjmp    loop
done:   ret				; return to the monitor
 
send:   mov     r0, #send_vector	; get the address of the send vector into dptr
        mov     a, @r0
        inc     r0
        mov     dpl, a
        mov     a, @r0
        mov     dph, a
        clr     a
        jmp     @a+dptr			; and jump to it
 
str:    db      "Hello World!\r\n"
Assemble it with "asm51 test.s" and then simply copy the test.51 file to the flight computer - how you do this depends on which program you are using to talk to it, for example on my Mac I copy the text to the clipboard in an editor and paste it into the terminal emulator window to send it. You will see a single ':' followed by another prompt when it's done .... now type "g 8000" to the monitor to run it.

There are a couple of other examples available - firstly the code for the box I use to sequence the hybrid launchers - it's at http://www.taniwha.com/~paul/fc/srcs/hybrid.s and the monitor/basic/forth source for the ROM which is at http://www.taniwha.com/~paul/fc/v2.0/ostbef.s.

References

Required reading in order to program an 805X in assembler is the Intel data book '8-bit Embedded Controller Handbook' 1991 or later (ISBN 1-555-12-121-7, Intel #270645) - you can probably get it from your local electronics supplier or call Intel at (800)548-4725. The latest ones come in two volumes make sure you get the one that contains just the 805X programming info.

8051 documentation on the Web

Class notes for a community college class that uses 8051s for teaching oriented around a Phillips variant:

http://www.cit.ac.nz/smac/cbt/hwsys/i8051/default.htm

A set of pages referencing stuff all over:

http://livewire.ee.latrobe.edu.au/~sjm/

Pinouts

Here are the pinouts for the 3 main chips: