Source Code
|
These source-code files are part of a reconstructed copy of Luminary 69/2,
the flown, final release of the Apollo 10 Lunar Module (LM) Apollo Guidance Computer (AGC) software.
The reconstruction is based on the source code of Luminary 69 — i.e., the
initial, unflown version, "revision 0" — of which
a contemporary listing was available. The code was then updated by incorporating the
differences between Luminary 69 and Luminary 69/2, known from other contemporary
documentation. The only such difference is the implementation in
Luminary 69/2 of the "R-2 Lunar Potential Model", the source code for which was taken
from program Luminary 99/1 (Apollo 11 LM), of which a contemporary listing was also available.
Finally, the now-reconstructed Luminary 69/2 was then validated by assembling it to
executable form and verifying that its memory banks had the correct checksums,
known from still other contemporary documentation.
Note that page numbers in the reconstructed code match those in the original Luminary 69
program listing, or in the ORBITAL INTEGRATION log section, in Luminary 99/1. Page numbers
would certainly differ somewhat in a contemporary Luminary 69/2 listing.
Moreover, annotations that were not present in the contemporary source code have been added
to the reconstructed code to justify each change in Luminary 69/2 relative to
Luminary 69. Here's a guide to the Apollo documentation referenced in those annotations:
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.
|
011003,000002: ## Copyright: Public domain.
011004,000003: ## Filename: RESTART_TABLES.agc
011005,000004: ## Purpose: A section of LUM69 revision 2.
011006,000005: ## It is part of the reconstructed source code for the flown
011007,000006: ## version of the flight software for the Lunar Module's (LM)
011008,000007: ## Apollo Guidance Computer (AGC) for Apollo 10. The code has
011009,000008: ## been recreated from a copy of Luminary revsion 069, using
011010,000009: ## changes present in Luminary 099 which were described in
011011,000010: ## Luminary memos 75 and 78. The code has been adapted such
011012,000011: ## that the resulting bugger words exactly match those specified
011013,000012: ## for LUM69 revision 2 in NASA drawing 2021152B, which gives
011014,000013: ## relatively high confidence that the reconstruction is correct.
011015,000014: ## Reference: pp. 253-258
011016,000015: ## Assembler: yaYUL
011017,000016: ## Contact: Ron Burkey <info@sandroid.org>.
011018,000017: ## Website: www.ibiblio.org/apollo/index.html
011019,000018: ## Mod history: 2019-07-27 MAS Created from Luminary 69.
011020,000019:
|
|
Page 253
|
011022,000021: # RESTART TABLES
011023,000022:
011024,000023: # ------------------
011025,000024:
011026,000025: # THERE ARE TWO FORMS OF RESTART TABLES FOR EACH GROUP. THEY ARE KNOWN AS THE EVEN RESTART TABLES AND THE ODD
011027,000026: # RESTART TABLES. THE ODD TABLES HAVE ONLY ONE ENTRY OF THREE LOCATIONS WHILE THE EVEN TABLES HAVE TWO ENTRIES
011028,000027: # EACH USING THREE LOCATIONS. THE INFORMATION AS TO WHETHER IT IS A JOB, WAITLIST, OR A LONGCALL IS GIVEN BY THE
011029,000028: # WAY THINGS ARE PUT INTO THE TABLES.
011030,000029: # A JOB HAS ITS PRIORITY STORED IN PRDTTAB OF THE CORRECT PHASE SPOT - A POSITIVE PRIORITY INDICATES A
011031,000030: # FINDVAC JOB, A NEGATIVE PRIORITY A NOVAC. THE 2CADR OF THE JOB IS STORED IN THE CADRTAB.
011032,000031: # FOR EXAMPLE,
011033,000032:
011034,000033: # 5.7SPOT OCT 23000
011035,000034: # 2CADR SOMEJOB
011036,000035:
011037,000036: # A RESTART OF GROUP 5 WITH PHASE SEVEN WOULD THEN CAUSE SOMEJOB TO BE RESTARTED AS A FINDVAC WITH PRIORITY 23.
011038,000037:
011039,000038: # 5.5SPOT OCT -23000
011040,000039: # 2CADR ANYJOB
011041,000040:
011042,000041: # HERE A RESTART OF GROUP 5 WITH PHASE 7 WOULD CAUSE ANYJOB TO BE RESTARTED AS A NOVAC WITH PRIORITY 23.
011043,000042: # A LONGCALL HAS ITS GENADR OF ITS 2CADR STORED NEGATIVELY AND ITS BBCON STORED POSITIVELY. IN ITS PRDTTAB IS
011044,000043: # PLACED THE LOCATION OF A DP REGISTER THAT CONTAINS THE DELTA TIME THAT LONGCALL HAD BEEN ORIGINALLY STARTED
011045,000044: # WITH. EXAMPLE,
011046,000045:
011047,000046: # 3.6SPOT GENADR DELTAT
011048,000047: # -GENADR LONGTASK
011049,000048: # BBCON LONGTASK
011050,000049:
011051,000050: # OCT 31000
011052,000051: # 2CADR JOBAGAIN
011053,000052:
011054,000053: # THIS WOULD START UP LONGTASK AT THE APPROPRIATE TIME, OR IMMEDIATELY IF THE TIME HAD ALREADY PASSED. IT SHOULD
011055,000054: # BE NOTED THAT IF DELTAT IS IN A SWITCHED E BANK, THIS INFORMATOIN SHOULD BE IN THE BBCON OFTHE 2CADR OF THE
011056,000055: # TASK. FROM ABOVE, WE SEE THAT THE SECOND PART OF THIS PHASE WOULD BE STARTED AS A JOB WITH A PRIORITY OF 31.
011057,000056:
011058,000057: # WAITLIST CALLS ARE IDENTIFIED BY THE FACT THAT THEIR 2CADR IS STORED NEGATIVELY. IF PRDTTAB OF THE PHASE SPOT
011059,000058: # IS POSITIVE, THEN IT CONTAINS THE DELTA TIME, IF PRDTTAB IS NEGATIVE THEN IT IS THE -GENADR OF AN ERASABLE
011060,000059: # LOCATION CONTAINING THE DELTA TIME, THAT IS, THE TIME IS STORED INDIRECTLY. IT SHOULD BE NOTED AS ABOVE, THAT
011061,000060: # IF THE TIME IS STORED INDIRECTLY, THE BBCON MUST CONTAIN THE NECESSARY E BANK INFORMATION IF APPLICABLE. WITH
011062,000061: # WAITLIST WE HAVE ONE FURTHER OPTION, IF -0 IS STORED IN PRDTTAB, IT WILL CAUSE AN IMMEDIATE RESTART OF THE
011063,000062: # TASK. EXAMPLES,
011064,000063:
011065,000064: # OCT 77777 THIS WILL CAUSE AN IMMEDIATE RESTART
011066,000065: # -2CADR ATASK OF THE TASK :ATASK:
011067,000066:
011068,000067: # DEC 200 IF THE TIME OF THE 2 SECONDS SINCE DUMMY
011069,000068: # -2CADR DUMMY WAS PUT ON WAITLIST IS UP, IT WILL BEGIN
011070,000069: # IN 10 MS, OTHERWISE IT WILL BEGIN WHEN
011071,000070: # IT NORMALLY WOULD HAVE BEGUN.
011072,000071:
|
|
Page 254
|
011074,000073: # -GENADR DTIME WHERE DTIME CONTAINS THE DELTA TIME
011075,000074: # -2CADR TASKTASK OTHERWISE THIS IS AS ABOVE
011076,000075:
011077,000076: # ***** NOW THE TABLES THEMSELVES *****
011078,000077:
011079,000078: 01,2002 BANK 01
011080,000079: 01,2000 SETLOC RESTART
011081,000080: 01,2000 BANK
011082,000081:
011083,000082: 01,2002 PRDTTAB EQUALS 12000 # USED TO FIND THE PRIORITY OR DELTATIME
011084,000083: 01,2002 CADRTAB EQUALS 12001 # THIS AND THE NEXT RELATIVE LOC CONTAIN
011085,000084: # RESTART 2CADR
011086,000085:
011087,000086: 01,2002 COUNT* $$/RSTAB # TABLES IN BANK 1.
011088,000087: 01,2002 00010 SIZETAB TC 1.2SPOT -12006
011089,000088: 01,2003 00020 TC 1.3SPOT -12004
011090,000089: 01,2004 00010 TC 2.2SPOT -12006
011091,000090: 01,2005 00023 TC 2.3SPOT -12004
011092,000091: 01,2006 00010 TC 3.2SPOT -12006
011093,000092: 01,2007 00053 TC 3.3SPOT -12004
011094,000093: 01,2010 00054 TC 4.2SPOT -12006
011095,000094: 01,2011 00064 TC 4.3SPOT -12004
011096,000095: 01,2012 00137 TC 5.2SPOT -12006
011097,000096: 01,2013 00155 TC 5.3SPOT -12004
011098,000097: 01,2014 00010 TC 6.2SPOT -12006
011099,000098: 01,2015 00166 TC 6.3SPOT -12004
011100,000099: 01,2016 21000 1.2SPOT OCT 21000 # A DUMMY EXAMPLE TO BE REPLACED AS SOON
011101,000100: 01,2017 0074 EBANK= STATE
011102,000101: 01,2017 05155 04060 2CADR ENDOFJOB # AS THERE IS A LEGITIMATE 1.2SPOT
011103,000102: 01,2021 00144 DEC 100 B-14
011104,000103: 01,2022 0074 EBANK= STATE
011105,000104: 01,2022 05261 04060 2CADR TASKOVER
011106,000105:
011107,000106: # ANY MORE GROUP 1.EVEN RESTART VALUES SHOULD GO HERE
011108,000107:
011109,000108: 01,2024 76302 1.3SPOT -GENADR SAVET-30
011110,000109: 01,2025 E7,1513 EBANK= DVCNTR
011111,000110: 01,2025 75440 03710 -2CADR ULLGTASK
011112,000111: # ANY MORE GROUP 1.ODD RESTART VALUES SHOULD GO HERE
011113,000112:
011114,000113: 01,2027 01,2016 2.2SPOT EQUALS 1.2SPOT
011115,000114: # ANY MORE GROUP 2.EVEN RESTART VALUES SHOULD GO HERE
011116,000115:
011117,000116: 01,2027 02630 2.3SPOT GENADR 600SECS
011118,000117: 01,2030 75173 -GENADR STATEINT
011119,000118: 01,2031 E3,1554 EBANK= RRECTCSM
011120,000119: 01,2031 26063 BBCON STATEINT
011121,000120:
|
|
Page 255
|
011123,000122: 01,2032 05000 2.5SPOT OCT 05000
011124,000123: 01,2033 E3,1554 EBANK= RRECTCSM
011125,000124: 01,2033 02613 26063 2CADR STATINT1
011126,000125: 01,2035 02734 2.7SPOT DEC 1500 B-14
011127,000126: 01,2036 E7,1454 EBANK= LOSCOUNT
011128,000127: 01,2036 75502 27710 -2CADR P20LEMC1
011129,000128:
011130,000129: 01,2040 14000 2.11SPOT OCT 14000
011131,000130: 01,2041 E7,1756 EBANK= P21TIME
011132,000131: 01,2041 02441 50067 2CADR P25LEM1
011133,000132: 01,2043 10000 2.13SPOT OCT 10000
011134,000133: 01,2044 E7,1454 EBANK= LOSCOUNT
011135,000134: 01,2044 02175 54067 2CADR RELINUS
011136,000135: 01,2046 26000 2.15SPOT OCT 26000
011137,000136: 01,2047 E7,1454 EBANK= LOSCOUNT
011138,000137: 01,2047 02677 50067 2CADR R22RSTRT
011139,000138: 01,2051 77777 2.17SPOT OCT 77777
011140,000139: 01,2052 E7,1704 EBANK= VGPREV
011141,000140: 01,2052 75447 03710 -2CADR REDO2.17
011142,000141: 01,2054 00031 2.21SPOT DEC 25 B-14
011143,000142: 01,2055 E7,1513 EBANK= DVCNTR
011144,000143: 01,2055 75675 35710 -2CADR R10,R11
011145,000144: # ANY MORE GROUP 2.ODD RESTART VALUES SHOULD GO HERE.
011146,000145:
011147,000146: 01,2057 01,2016 3.2SPOT EQUALS 1.2SPOT
011148,000147: # ANY MORE GROUP 3.EVEN RESTART VALUES SHOULD GO HERE
011149,000148:
011150,000149: 01,2057 76353 3.3SPOT -GENADR ZOOMTIME
011151,000150: 01,2060 E7,1513 EBANK= DVCNTR
011152,000151: 01,2060 75223 03710 -2CADR ZOOM
011153,000152: # ANY MORE GROUP 3.ODD RESTART VALUES SHOULD GO HERE
011154,000153:
011155,000154: 01,2062 04704 4.2SPOT DEC 2500 B-14
011156,000155: 01,2063 E7,1451 EBANK= TTOGO
011157,000156: 01,2063 75434 03710 -2CADR TIG-5
011158,000157: 01,2065 77777 OCT 77777
011159,000158: 01,2066 E7,1451 EBANK= TTOGO
011160,000159: 01,2066 75444 03710 -2CADR REDO4.2
011161,000160: # ANY MORE GROUP 4.EVEN RESTART VALUES SHOULD GO HERE
011162,000161:
|
|
Page 256
|
011164,000163: 01,2070 25000 4.3SPOT OCT 25000
011165,000164: 01,2071 E7,1513 EBANK= DVCNTR
011166,000165: 01,2071 03257 64067 2CADR GOABORT
011167,000166: 01,2073 00062 4.5SPOT DEC 50 B-14
011168,000167: 01,2074 E7,1451 EBANK= TTOGO
011169,000168: 01,2074 75237 03710 -2CADR ULLAGOFF
011170,000169: 01,2076 00764 4.7SPOT DEC 500 B-14
011171,000170: 01,2077 E7,1513 EBANK= DVCNTR
011172,000171: 01,2077 75410 03710 -2CADR TIG-0
011173,000172: 01,2101 76262 4.11SPOT -GENADR TGO +1
011174,000173: 01,2102 E7,1513 EBANK= DVCNTR
011175,000174: 01,2102 74235 03710 -2CADR ENGOFTSK
011176,000175: 01,2104 12000 4.13SPOT OCT 12000
011177,000176: 01,2105 E7,1460 EBANK= TRKMKCNT
011178,000177: 01,2105 03223 74067 2CADR POSTBURN
011179,000178:
011180,000179: 01,2107 00764 4.15SPOT DEC 500 B-14
011181,000180: 01,2110 E7,1451 EBANK= TTOGO
011182,000181: 01,2110 75503 03710 -2CADR TIG-30
011183,000182: 01,2112 77777 4.17SPOT OCT 77777
011184,000183: 01,2113 E7,1513 EBANK= DVCNTR
011185,000184: 01,2113 75434 03710 -2CADR TIG-5
011186,000185: 01,2115 13000 4.21SPOT OCT 13000
011187,000186: 01,2116 E5,1730 EBANK= STAR
011188,000187: 01,2116 02661 30065 2CADR R51.1 +1
011189,000188: 01,2120 77777 4.23SPOT OCT 77777
011190,000189: 01,2121 E7,1513 EBANK= DVCNTR
011191,000190: 01,2121 75366 03710 -2CADR IGNITION
011192,000191: 01,2123 01475 4.25SPOT GENADR SAVET-30
011193,000192: 01,2124 75541 -GENADR TIG-35
011194,000193: 01,2125 E7,1475 EBANK= SAVET-30
011195,000194: 01,2125 74067 BBCON TIG-35
011196,000195:
011197,000196: 01,2126 52777 4.27SPOT OCT 52777
011198,000197: 01,2127 E7,1513 EBANK= DVCNTR
011199,000198: 01,2127 02167 42067 2CADR P70A
011200,000199: 01,2131 52777 4.31SPOT OCT 52777
011201,000200: 01,2132 E7,1513 EBANK= DVCNTR
011202,000201: 01,2132 02172 42067 2CADR P71A
011203,000202:
|
|
Page 257
|
011205,000204: 01,2134 46777 4.33SPOT OCT 46777
011206,000205: 01,2135 E7,1513 EBANK= DVCNTR
011207,000206: 01,2135 02024 10067 2CADR GOPOOFIX
011208,000207: 01,2137 46777 4.35SPOT OCT 46777
011209,000208: 01,2140 E7,1513 EBANK= DVCNTR
011210,000209: 01,2140 05665 04067 2CADR GOPOODOO
011211,000210: 01,2142 52777 4.37SPOT OCT 52777
011212,000211: 01,2143 E7,1453 EBANK= WHICH
011213,000212: 01,2143 02574 74067 2CADR COMFAIL
011214,000213: # ANY MORE 4.ODD RESTART VALUES SHOULD GO HERE.
011215,000214:
011216,000215: 01,2145 22000 5.2SPOT OCT 22000
011217,000216: 01,2146 E7,1513 EBANK= DVCNTR
011218,000217: 01,2146 02421 66067 2CADR NORMLIZE
011219,000218: 01,2150 00310 DEC 200 B-14
011220,000219: 01,2151 E7,1513 EBANK= DVCNTR
011221,000220: 01,2151 74177 01710 -2CADR REREADAC
011222,000221:
011223,000222: 01,2153 00310 5.4SPOT DEC 200 B-14
011224,000223: 01,2154 E7,1513 EBANK= DVCNTR
011225,000224: 01,2154 74177 01710 -2CADR REREADAC
011226,000225:
011227,000226: 01,2156 20000 OCT 20000
011228,000227: 01,2157 E7,1513 EBANK= DVCNTR
011229,000228: 01,2157 02200 66067 2CADR SERVICER
011230,000229: # ANY MORE GROUP 5.EVEN RESTART VALUES SHOULD GO HERE
011231,000230:
011232,000231: 01,2161 00310 5.3SPOT DEC 200 B-14
011233,000232: 01,2162 E7,1513 EBANK= DVCNTR
011234,000233: 01,2162 74177 01710 -2CADR REREADAC
011235,000234:
011236,000235: 01,2164 77777 5.5SPOT OCT 77777
011237,000236: 01,2165 E7,1513 EBANK= DVCNTR
011238,000237: 01,2165 74340 01710 -2CADR REDO5.5
011239,000238:
011240,000239: 01,2167 77777 5.7SPOT OCT 77777
011241,000240: 01,2170 E7,1513 EBANK= DVCNTR
011242,000241: 01,2170 74375 01710 -2CADR BIBIBIAS
011243,000242: # ANY MORE GROUP 5.ODD RESTART VALUES SHOULD GO HERE
011244,000243:
|
|
Page 258
|
011246,000245: 01,2172 01,2016 6.2SPOT EQUALS 1.2SPOT
011247,000246: 01,2172 00144 6.3SPOT DEC 100 B-14
011248,000247: 01,2173 E7,1437 EBANK= TIG
011249,000248: 01,2173 75055 03710 -2CADR CLOKTASK
011250,000249: 01,2175 30000 6.5SPOT OCT 30000 # PROTECT INCREMENTING OF TIME2,TIME1 BY
011251,000250: 01,2176 E3,1706 EBANK= TEPHEM # P27(UPDATE PROGRAM) VIA V70 OR V73.
011252,000251: 01,2176 03522 10063 2CADR TIMEDIDR
011253,000252: 01,2200 17000 6.7SPOT OCT 17000
011254,000253: 01,2201 E7,1704 EBANK= VGPREV
011255,000254: 01,2201 03350 74067 2CADR REDO6.7
End of include-file RESTART_TABLES.agc. Parent file is MAIN.agc