Source Code
|
These source-code files are part of a reconstructed copy of LUM69 Revision 2, the
flown Apollo 10 Lunar Module (LM) Apollo Guidance Computer (AGC) software.
The reconstruction began with source code of Luminary 69 revision 0 previously
transcribed from a digitized copy of that program. The code was then updated
by back-porting the R-2 lunar potential model from previously-transcribed source
code of Luminary 99. These required changes were described in the original
Luminary memos 75 and 78. The reconstructed code was verified by
matching memory-bank checksums to those listed in drawing 2021152G. Note that
page numbers in the reconstructed code match those on the Luminary 069 printout,
although the added code would likely have changed page numbers for a real LUM69
Revision 2 listing.
Comments from the original source code are prefixed with a single '#' symbol,
whereas comments added later are prefixed by "##" or "###". Report any errors
noted by creating an
issue report at the Virtual AGC
project's GitHub repository.
|
060308,000002: ## Copyright: Public domain.
060309,000003: ## Filename: DAP_INTERFACE_SUBROUTINES.agc
060310,000004: ## Purpose: A section of LUM69 revision 2.
060311,000005: ## It is part of the reconstructed source code for the flown
060312,000006: ## version of the flight software for the Lunar Module's (LM)
060313,000007: ## Apollo Guidance Computer (AGC) for Apollo 10. The code has
060314,000008: ## been recreated from a copy of Luminary revsion 069, using
060315,000009: ## changes present in Luminary 099 which were described in
060316,000010: ## Luminary memos 75 and 78. The code has been adapted such
060317,000011: ## that the resulting bugger words exactly match those specified
060318,000012: ## for LUM69 revision 2 in NASA drawing 2021152B, which gives
060319,000013: ## relatively high confidence that the reconstruction is correct.
060320,000014: ## Reference: pp. 1401-1404
060321,000015: ## Assembler: yaYUL
060322,000016: ## Contact: Ron Burkey <info@sandroid.org>.
060323,000017: ## Website: www.ibiblio.org/apollo/index.html
060324,000018: ## Mod history: 2019-07-27 MAS Created from Luminary 69.
060325,000019:
|
|
Page 1401
|
060327,000021: 20,2123 BANK 20
060328,000022: 20,2000 SETLOC DAPS3
060329,000023: 20,2000 BANK
060330,000024:
060331,000025: 20,2123 E6,1633 EBANK= CDUXD
060332,000026: 20,2123 COUNT* $$/DAPIF
060333,000027:
060334,000028: # MOD 0 DATE 11/15/66 BY GEORGE W. CHERRY
060335,000029: # MOD 1 1/23/67 MODIFICATION BY PETER ADLER
060336,000030:
060337,000031: # FUNCTIONAL DESCRIPTION
060338,000032: # HEREIN ARE A COLLECTION OF SUBROUTINES WHICH ALLOW MISSION CONTROL PROGRAMS TO CONTROL THE MODE
060339,000033: # AND INTERFACE WITH THE DAP.
060340,000034:
060341,000035: # CALLING SEQUENCES
060342,000036: # IN INTERRUPT OR WITH INTERRUPT INHIBITED
060343,000037: # TC IBNKCALL
060344,000038: # FCADR ROUTINE
060345,000039: # IN A JOB WITHOUT INTERRUPT INHIBITED
060346,000040: # INHINT
060347,000041: # TC IBNKCALL
060348,000042: # FCADR ROUTINE
060349,000043: # RELINT
060350,000044:
060351,000045: # OUTPUT
060352,000046: # SEE INDIVIDUAL ROUTINES BELOW
060353,000047:
060354,000048: # DEBRIS
060355,000049: # A, L, AND SOMETIMES MDUETEMP ODE NOT IN PULSES MODE
060356,000050:
|
|
Page 1402
|
060358,000052: # SUBROUTINE NAMES:
060359,000053: # SETMAXDB, SETMINDB, RESTORDB, PFLITEDB
060360,000054: # MODIFIED: 30 JANUARY 1968 BY P S WEISSMAN TO CREATE RESTORDB.
060361,000055: # MODIFIED: 1 MARCH 1968 BY P S WEISSMAN TO SAVE EBANK AND CREATE PFLITEDB
060362,000056:
060363,000057: # FUNCTIONAL DESCRIPTION:
060364,000058: # SETMAXDB - SET DEADBAND TO 5.0 DEGREES
060365,000059: # SETMINDB - SET DEADBAND TO 0.3 DEGREE
060366,000060: # RESTORDB - SET DEADBAND TO MAX OR MIN ACCORDING TO SETTING OF DBSELECT BIT OF DAPBOOLS
060367,000061: # PFLITEDB - SET DEADBAND TO 1.0 DEGREE AND ZERO THE COMMANDED ATTITUDE CHANGE AND COMMANDED RATE
060368,000062:
060369,000063: # ALL ENTRIES SET UP A NOVAC JOB TO DO 1/ACCS SO THAT THE TJETLAW SWITCH CURVES ARE POSITIONED TO
060370,000064: # REFLECT THE NEW DEADBAND. IT SHOULD BE NOTED THAT THE DEADBAND REFERS TO THE ATTITUDE IN THE P-, U-, AND V-AXES.
060371,000065:
060372,000066: # SUBROUTINE CALLED: NOVAC
060373,000067:
060374,000068: # CALLING SEQUENCE: SAME AS ABOVE
060375,000069: # OR TC RESTORDB +1 FROM ALLCOAST
060376,000070:
060377,000071: # DEBRIS: A, L, Q, RUPTREG1, (ITEMPS IN NOVAC)
060378,000072:
060379,000073: 20,2123 30111 RESTORDB CAE DAPBOOLS # DETERMINE CREW-SELECTED DEADBAND.
060380,000074: 20,2124 74750 MASK DBSELECT
060381,000075: 20,2125 00006 EXTEND
060382,000076: 20,2126 12140 BZF SETMINDB
060383,000077:
060384,000078: 20,2127 32151 SETMAXDB CAF WIDEDB # SET 5 DEGREE DEADBAND.
060385,000079: 20,2130 55346 +1 TS DB
060386,000080:
060387,000081: 20,2131 00006 EXTEND # SET UP JOB TO RE-POSITION SWITCH CURVES.
060388,000082: 20,2132 22070 QXCH RUPTREG1
060389,000083: 20,2133 37714 CALLACCS CAF PRIO27
060390,000084: 20,2134 05072 TC NOVAC
060391,000085: 20,2135 E6,1537 EBANK= AOSQ
060392,000086: 20,2135 02454 40106 2CADR 1/ACCJOB
060393,000087:
060394,000088: 20,2137 00070 TC RUPTREG1 # RETURN TO CALLER.
060395,000089:
060396,000090: 20,2140 32150 SETMINDB CAF NARROWDB # SET 0.3 DEGREE DEADBAND.
060397,000091: 20,2141 12130 TCF SETMAXDB +1
060398,000092:
060399,000093: 20,2142 00006 PFLITEDB EXTEND # THE RETURN FROM CALLACCS IS TO RUPTREG1.
060400,000094: 20,2143 22070 QXCH RUPTREG1
060401,000095: 20,2144 02153 TC ZATTEROR # ZERO THE ERRORS AND COMMANDED RATES.
060402,000096: 20,2145 32152 CAF POWERDB # SET DB TO 1.0 DEG.
060403,000097: 20,2146 55346 TS DB
060404,000098: 20,2147 12133 TCF CALLACCS # SET UP 1/ACCS AND RETURN TO CALLER.
060405,000099: 20,2150 00155 NARROWDB OCTAL 00155 # 0.3 DEGREE SCALED AT 45.
|
|
Page 1403
|
060407,000101: 20,2151 03434 WIDEDB OCTAL 03434 # 5.0 DEGREES SCALED AT 45.
060408,000102: 20,2152 00554 POWERDB DEC .02222 # 1.0 DEGREE SCALED AT 45.
060409,000103:
060410,000104: 20,2153 35015 ZATTEROR CAF EBANK6
060411,000105: 20,2154 56003 XCH EBANK
060412,000106: 20,2155 54001 TS L # SAVE CALLERS EBANK IN L.
060413,000107: 20,2156 30032 CAE CDUX
060414,000108: 20,2157 55633 TS CDUXD
060415,000109: 20,2160 30033 CAE CDUY
060416,000110: 20,2161 55634 TS CDUYD
060417,000111: 20,2162 30034 CAE CDUZ
060418,000112: 20,2163 55635 TS CDUZD
060419,000113: 20,2164 12170 TCF STOPRATE +3
060420,000114:
060421,000115: 20,2165 35015 STOPRATE CAF EBANK6
060422,000116: 20,2166 56003 XCH EBANK
060423,000117: 20,2167 54001 TS L # SAVE CALLERS EBANK IN L.
060424,000118: 20,2170 34755 +3 CAF ZERO
060425,000119: 20,2171 55641 TS OMEGAPD
060426,000120: 20,2172 55642 TS OMEGAQD
060427,000121: 20,2173 55643 TS OMEGARD
060428,000122: 20,2174 55636 TS DELCDUX
060429,000123: 20,2175 55637 TS DELCDUY
060430,000124: 20,2176 55640 TS DELCDUZ
060431,000125: 20,2177 55277 TS DELPEROR
060432,000126: 20,2200 55300 TS DELQEROR
060433,000127: 20,2201 55301 TS DELREROR
060434,000128: 20,2202 22003 LXCH EBANK # RESTORE CALLERS EBANK.
060435,000129: 20,2203 00002 TC Q
060436,000130:
060437,000131: # SUBROUTINE NAME: ALLCOAST
060438,000132: # WILL BE CALLED BY FRESH STARTS AND ENGINE OFF ROUTINES. .
060439,000133:
060440,000134: # CALLING SEQUENCE: (SAME AS ABOVE)
060441,000135:
060442,000136: # EXIT: RETURN TO Q.
060443,000137:
060444,000138: # SUBROUTINES CALLED: STOPRATE, RESTORDB, NOVAC
060445,000139:
060446,000140: # ZERO: (FOR ALL AXES) AOS, ALPHA, AOSTERM, OMEGAD, DELCDU, DELEROR
060447,000141:
060448,000142: # OUTPUT: DRIFTBIT/DAPBOOLS, DB, JOB TO DO 1/ACCS
060449,000143:
060450,000144: # DEBRIS: A, L, Q, RUPTREG1, RUPTREG2, (ITEMPS IN NOVAC)
060451,000145:
060452,000146: 20,2204 00006 ALLCOAST EXTEND # SAVE Q FOR RETURN
060453,000147: 20,2205 22071 QXCH RUPTREG2
|
|
Page 1404
|
060455,000149: 20,2206 02165 TC STOPRATE # CLEAR RATE INTERFACE. RETURN WITH A=0
060456,000150: 20,2207 22003 LXCH EBANK # AND L=EBANK6. SAVE CALLERS EBANK.
060457,000151: 20,2210 55537 TS AOSQ
060458,000152: 20,2211 55540 TS AOSQ +1
060459,000153: 20,2212 55541 TS AOSR
060460,000154: 20,2213 55542 TS AOSR +1
060461,000155: 20,2214 55422 TS ALPHAQ # FOR DOWNLIST.
060462,000156: 20,2215 55423 TS ALPHAR
060463,000157: 20,2216 55545 TS AOSQTERM
060464,000158: 20,2217 55546 TS AOSRTERM
060465,000159: 20,2220 22003 LXCH EBANK # RESTORE EBANK (EBANK6 NO LONGER NEEDED)
060466,000160:
060467,000161: 20,2221 40111 CS DAPBOOLS # SET UP DRIFTBIT
060468,000162: 20,2222 74744 MASK DRIFTBIT
060469,000163: 20,2223 26111 ADS DAPBOOLS
060470,000164: 20,2224 02124 TC RESTORDB +1 # RESTORE DEADBANK TO CREW-SELECTED VALUE.
060471,000165:
060472,000166: 20,2225 00071 TC RUPTREG2 # RETURN.
060473,000167:
End of include-file DAP_INTERFACE_SUBROUTINES.agc. Parent file is MAIN.agc