Source Code
|
These source-code files are part of a reconstructed copy of Comanche 72/3 (AKA Manche72 revision 3),
the final, flown mission release of the Apollo Guidance Computer (AGC) Command Module (CM) software
for Apollo 13.
The starting point was the source code of Comanche 72 (itself previously reconstructed). Comanche 72
source code was then modified by incorporating changes known from contemporary documentation to have
been made between revisions 72 and 72/3. The resulting code assembles to have identical
memory-bank checksums as those specified in NASA drawing 2021153G; this gives reasonably
high confidence that the changes that have been made are correct. In places where
ambiguity exists, this ambiguity is discussed in "## Reconstruction:" comments.
Since no contemporary listings of Comanche 72/3 are available as source material,
all comments and labels are approximate.
They have been taken from other AGC programs where possible, or, in some places, written
from scratch to match what we believe would have been in the original listing.
|
047020,000002: ## Copyright: Public domain.
047021,000003: ## Filename: INTER-BANK_COMMUNICATION.agc
047022,000004: ## Purpose: A section of Manche72 revision 3.
047023,000005: ## It is part of the reconstructed source code for the final, flown
047024,000006: ## release of the software for the Command Module's (CM) Apollo
047025,000007: ## Guidance Computer (AGC) for Apollo 13. No original listings
047026,000008: ## of this program are available; instead, this file was recreated
047027,000009: ## from a reconstructed copy of Comanche 072. It has been adapted
047028,000010: ## such that the resulting bugger words exactly match those
047029,000011: ## specified for Manche72 revision 3 in NASA drawing 2021153G,
047030,000012: ## which gives relatively high confidence that the reconstruction
047031,000013: ## is correct.
047032,000014: ## Assembler: yaYUL
047033,000015: ## Contact: Ron Burkey <info@sandroid.org>.
047034,000016: ## Website: www.ibiblio.org/apollo/index.html
047035,000017: ## Mod history: 2024-05-19 MAS Created from Comanche 072.
047036,000018:
047037,000019: # THE FOLLOWING ROUTINE CAN BE USED TO CALL A SUBROUTINE IN ANOTHER BANK. IN THE BANKCALL VERSION, THE
047038,000020: # CADR OF THE SUBROUTINE IMMEDIATELY FOLLOWS THE TC BANKCALL INSTRUCTION, WITH C(A) AND C(L) PRESERVED.
047039,000021:
047040,000022: 4676 BLOCK 02
047041,000023: 4676 COUNT 02/BANK
047042,000024:
047043,000025: 4676 52134 BANKCALL DXCH BUF2 # SAVE INCOMING A,L.
047044,000026: 4677 50002 INDEX Q # PICK UP CADR.
047045,000027: 4700 30000 CA 0
047046,000028: 4701 24002 INCR Q # SO WE RETURN TO THE LOC. AFTER THE CADR.
047047,000029:
047048,000030: # SWCALL IS IDENTICAL TO BANKCALL, EXCEPT THAT THE CADR ARRIVES IN A.
047049,000031:
047050,000032: 4702 54001 SWCALL TS L
047051,000033: 4703 22004 LXCH FBANK # SWITCH BANKS, SAVING RETURN.
047052,000034: 4704 75070 MASK LOW10 # GET SUB-ADDRESS OF CADR.
047053,000035: 4705 56002 XCH Q # A,L NOW CONTAINS DP RETURN.
047054,000036: 4706 52134 DXCH BUF2 # RESTORING INPUTS IF THIS IS A BANKCALL.
047055,000037: 4707 50002 INDEX Q
047056,000038: 4710 02000 TC 10000 # SETTING Q TO SWRETURN.
047057,000039:
047058,000040: 4711 56134 SWRETURN XCH BUF2 +1 # COMES HERE TO RETURN TO CALLER. C(A,L)
047059,000041: 4712 56004 XCH FBANK # ARE PRESERVED FOR RETURN.
047060,000042: 4713 56134 XCH BUF2 +1
047061,000043: 4714 00133 TC BUF2
047062,000044:
047063,000045: # THE FOLLOWING ROUTINE CAN BE USED AS A UNILATERAL JUMP WITH C(A,L) PRESERVED AND THE CADR IMMEDIATELY
047064,000046: # FOLLOWING THE TC POSTJUMP INSTRUCTION.
047065,000047:
047066,000048: 4715 56002 POSTJUMP XCH Q # SAVE INCOMING C(A).
047067,000049: 4716 50000 INDEX A # GET CADR.
047068,000050: 4717 30000 CA 0
047069,000051:
047070,000052: # BANKJUMP IS THE SAME AS POSTJUMP, EXCEPT THAT THE CADR ARRIVES IN A.
047071,000053:
047072,000054: 4720 54004 BANKJUMP TS FBANK
047073,000055: 4721 75070 MASK LOW10
047074,000056: 4722 56002 XCH Q # RESTORING INPUT C(A) IF THIS WAS A
047075,000057: 4723 50002 Q+10000 INDEX Q # POSTJUMP.
047076,000058: 4724 12000 PRIO12 TCF 10000 # PRIO12 = TCF 10000 = 12000
047077,000059:
047078,000060: # THE FOLLOWING ROUTINE GETS THE RETURN CADR SAVED BY SWCALL OR BANKCALL AND LEAVES IT IN A.
047079,000061:
047080,000062: 4725 35070 MAKECADR CAF LOW10
047081,000063: 4726 70133 MASK BUF2
047082,000064: 4727 60134 AD BUF2 +1
047083,000065: 4730 00002 TC Q
047084,000066:
047085,000067: 4731 54135 SUPDACAL TS MPTEMP
047086,000068: 4732 56004 XCH FBANK # SET FBANK FOR DATA.
047087,000069: 4733 00006 EXTEND
047088,000070: 4734 04007 ROR SUPERBNK # SAVE FBANK IN BITS 15-11, AND
047089,000071: 4735 56135 XCH MPTEMP # SUPERBANK IN BITS 7-5.
047090,000072: 4736 75070 MASK LOW10
047091,000073: 4737 56001 XCH L # SAVE REL. ADR. IN BANK, FETCH SUPERBITS.
047092,000074: 4740 00004 INHINT # BECAUSE RUPT DOES NOT SAVE SUPERBANK.
047093,000075: 4741 00006 EXTEND
047094,000076: 4742 01007 WRITE SUPERBNK # SET SUPERBANK FOR DATA.
047095,000077: 4743 50001 INDEX L
047096,000078: 4744 32000 CA 10000 # PINBALL (FIX MEM DISP) PREVENTS DCA HERE
047097,000079: 4745 56135 XCH MPTEMP # SAVE 1ST WD, FETCH OLD FBANK AND SBANK.
047098,000080: 4746 00006 EXTEND
047099,000081: 4747 01007 WRITE SUPERBNK # RESTORE SUPERBANK.
047100,000082: 4750 00003 RELINT
047101,000083: 4751 54004 TS FBANK # RESTORE FBANK.
047102,000084: 4752 30135 CA MPTEMP # RECOVER FIRST WORD OF DATA.
047103,000085: 4753 00002 RETURN # 24 WDS. DATACALL 516 MU, SUPDACAL 432 MU
047104,000086:
047105,000087: # THE FOLLOWING ROUTINES ARE IDENTICAL TO BANKCALL AND SWCALL EXCEPT THAT THEY ARE USED IN INTERRUPT.
047106,000088:
047107,000089: 4754 52073 IBNKCALL DXCH RUPTREG3 # USES RUPTREG3,4 FOR DP RETURN ADDRESS.
047108,000090: 4755 50002 INDEX Q
047109,000091: 4756 30000 CAF 0
047110,000092: 4757 24002 INCR Q
047111,000093:
047112,000094: 4760 54001 ISWCALL TS L
047113,000095: 4761 22004 LXCH FBANK
047114,000096: 4762 75070 MASK LOW10
047115,000097: 4763 56002 XCH Q
047116,000098: 4764 52073 DXCH RUPTREG3
047117,000099: 4765 50002 INDEX Q
047118,000100: 4766 02000 TC 10000
047119,000101:
047120,000102: 4767 56073 ISWRETRN XCH RUPTREG4
047121,000103: 4770 56004 XCH FBANK
047122,000104: 4771 56073 XCH RUPTREG4
047123,000105: 4772 00072 TC RUPTREG3
047124,000106:
047125,000107: # 2. USPRCADR ACCESSES INTERPRETIVE CODING IN OTHER THAN THE USER'S FBANK. THE CALLING SEQUENCE IS AS FOLLOWS:
047126,000108: # L TC USPRCADR
047127,000109: # L+1 CADR INTPRETX INTPRETX IS THE INTERPRETIVE CODING
047128,000110: # RETURN IS TO L+2
047129,000111:
047130,000112: 4773 54164 USPRCADR TS LOC # SAVE A
047131,000113: 4774 35024 CA BIT8
047132,000114: 4775 54023 TS EDOP # EXIT INSTRUCTION TO EDOP
047133,000115: 4776 30006 CA BBANK
047134,000116: 4777 54165 TS BANKSET # USER'S BBANK TO BANKSET
047135,000117: 5000 50002 INDEX Q
047136,000118: 5001 30000 CA 0
047137,000119: 5002 54004 TS FBANK # INTERPRETIVE BANK TO FBANK
047138,000120: 5003 75070 MASK LOW10 # YIELDS INTERPRETIVE RELATIVE ADDRESS
047139,000121: 5004 56002 XCH Q # INTERPRETIVE ADDRESS TO Q, FETCHING L+1
047140,000122: 5005 56164 XCH LOC # L+1 TO LOC, RETRIEVING ORIGINAL A
047141,000123: 5006 14723 TCF Q+10000
047142,000124:
047143,000125: # THERE ARE FOUR POSSIBLE SETTINGS FOR CHANNEL 07. (CHANNEL 07 CONTAINS THE SUPERBANK SETTING.)
047144,000126:
047145,000127: # PSEUDO-FIXED OCTAL PSEUDO
047146,000128: # SUPERBANK SETTING S-REG. VALUE BANK NUMBERS ADDRESSES
047147,000129: # ---------- ------- ------------ ------------ ------------
047148,000130: # SUPERBANK 3 0XX 2000 - 3777 30 - 37 70000 - 107777 (WHERE XX CAN BE ANYTHING AND
047149,000131: # WILL USUALLY BE SEEN AS 11)
047150,000132: # SUPERBANK 4 100 2000 - 3777 40 - 47 110000 - 127777 (AS FAR AS IT CAN BE SEEN,
047151,000133: # ONLY BANKS 40-43 WILL EVER BE
047152,000134: # AND ARE PRESENTLY AVAILABLE)
047153,000135: # SUPERBANK 5 101 2000 - 3777 50 - 57 130000 - 147777 (PRESENTLY NOT AVAILABLE TO
047154,000136: # THE USER)
047155,000137: # SUPERBANK 6 110 2000 - 3777 60 - 67 150000 - 167777 (PRESENTLY NOT AVAILABLE TO
047156,000138: # THE USER)
047157,000139: # *** THIS ROUTINE MAY BE CALLED BY ANY PROGRAM LOCATED IN BANKS 00 - 27. I.E., NO PROGRAM LIVING IN ANY
047158,000140: # SUPERBANK SHOULD USE SUPERSW. ***
047159,000141:
047160,000142: # SUPERSW MAY BE CALLED IN THIS FASHION:
047161,000143: # CAF ABBCON WHERE -- ABBCON BBCON SOMETHIN --
047162,000144: # TCR SUPERSW (THE SUPERBNK BITS ARE IN THE BBCON)
047163,000145: # ... ...
047164,000146: # . .
047165,000147: # . .
047166,000148: # OR IN THIS FASHION:
047167,000149: # CAF SUPERSET WHERE SUPERSET IS ONE OF THE FOUR AVAILABLE
047168,000150: # TCR SUPERSW SUPERBANK BIT CONSTANTS:
047169,000151: # ... ... SUPER011 OCTAL 60
047170,000152: # . . SUPER100 OCTAL 100
047171,000153: # . . SUPER101 OCTAL 120
047172,000154: # SUPER110 OCTAL 140
047173,000155:
047174,000156: 5007 00006 SUPERSW EXTEND
047175,000157: 5010 01007 WRITE SUPERBNK # WRITE BITS 7-6-5 OF THE ACCUMULATOR INTO
047176,000158: # CHANNEL 07
047177,000159: 5011 00002 TC Q # TC TO INSTRUCTION FOLLOWING
047178,000160: # TC SUPERSW
047179,000161:
047180,000162:
047181,000163:
End of include-file INTER-BANK_COMMUNICATION.agc. Parent file is MAIN.agc