Source Code
|
These source-code files are part of a reconstructed copy of Comanche 051, the
original release of the Apollo 11 Command Module (CM) Apollo Guidance Computer
(AGC) software.
The reconstruction began with source code of Comanche 055 previously transcribed
from a digitized copy of that program. The code was then updated by undoing
changes related to the R-2 lunar potential model, using hints from program
comments and change-indicating asterisks in the Comanche 055 listing as a guide.
The reconstruction was verified by matching memory-bank checksums to those listed
in drawing 2021153D. Note that page numbers in the reconstructed code match those
on the Comanche 055 printout, although the added code would likely have changed page
numbers for a real Comanche 051 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.
|
042722,000002: ## Copyright: Public domain.
042723,000003: ## Filename: TVCSTROKETEST.agc
042724,000004: ## Purpose: A section of Comanche revision 051.
042725,000005: ## It is part of the reconstructed source code for the
042726,000006: ## original release of the flight software for the Command
042727,000007: ## Module's (CM) Apollo Guidance Computer (AGC) for Apollo 11.
042728,000008: ## The code has been recreated from a copy of Comanche 055. It
042729,000009: ## has been adapted such that the resulting bugger words
042730,000010: ## exactly match those specified for Comanche 51 in NASA drawing
042731,000011: ## 2021153D, which gives relatively high confidence that the
042732,000012: ## reconstruction is correct.
042733,000013: ## Reference: pp. 979-983
042734,000014: ## Assembler: yaYUL
042735,000015: ## Contact: Ron Burkey <info@sandroid.org>.
042736,000016: ## Website: www.ibiblio.org/apollo/index.html
042737,000017: ## Mod history: 2019-07-30 MAS Created from Comanche 55.
042738,000018:
|
|
Page 979
|
042740,000020: # NAME STROKE TEST PACKAGE (INCLUDING INITIALIZATION PACKAGE)
042741,000021: # LOG SECTION...TVCSTROKETEST SUBROUTINE...DAPCSM
042742,000022: # MODIFIED BY SCHLUNDT 21 OCTOBER 1968
042743,000023:
042744,000024: # FUNCTIONAL DESCRIPTION....
042745,000025: # STROKE TEST PACKAGE GENERATES A WAVEFORM DESIGNED TO EXCITE BENDING
042746,000026: # STRKTSTI (STROKE TEST INITIALIZATION) IS CALLED AS A JOB BY VB68.
042747,000027: # IT INITIALIZES ALL ERASABLES REQD FOR A STROKE TEST, AND
042748,000028: # THEN TESTS FOR CSM/LM (BIT 13 OF DAPDATR1). IF CSM/LM,
042749,000029: # IN EITHER HIGH OR LOW-BANDWIDTH MODE, THE TEST IS STARTED
042750,000030: # IMMEDIATELY. IF NOT CSM/LM, PROGRAM EXITS WITH NO ACTION.
042751,000031: # HACK (STROKE TEST) GENERATES THE WAVEFORM BY DUMPING PULSE BURSTS
042752,000032: # OF PROPER SIGN AND IN PROPER SEQUENCE DIRECTLY INTO
042753,000033: # TVCPITCH, WORKING IN CONJUNCITON WITH BOTH PITCH AND YAW
042754,000034: # TVC DAPS, WITH INTERMEDIATE WAITLIST CALLS. NOTE, HOWEVER
042755,000035: # THAT THE STROKE TEST IS PERFORMED ONLY IN THE PITCH AXIS.
042756,000036: # AN EXAMPLE WAVEFORM IS GIVEN BELOW, TO DEMONSTRATE STROKE-
042757,000037: # TEST PARAMETER SELECTION
042758,000038: # RESTARTS CAUSE TEST TO BE TERMINATED. ANOTHER V68 REQD IF TEST
042759,000039: # IS TO BE RE-RUN.
042760,000040: # PULSE BURST SIZE IS PAD-LOADED (ESTROKER) SO THAT AMPLITUDE OF
042761,000041: # WAVEFORM CAN BE CHANGED. THERE ARE TEN PULSE BURSTS IN
042762,000042: # THE HALF-AMPLITUDE OF THE FIRST FREQUENCY SET IN THE
042763,000043: # STANDARD WAVEFORM. AMPLITUDE IS 10(ESTROKER)(1/42.15),
042764,000044: # NOMINALLY 50/42.15 = 1.185 DEG
042765,000045:
042766,000046: # CALLING SEQUENCE....
042767,000047: # EXTENDED VERB 68 SETS UP STRKTSTI JOB
042768,000048: # PITCH AND YAW TVCDAPS, FINDING STROKER NON-ZERO, DO A ..TC HACK..
042769,000049: # AN INTERNALLY-GENERATED WAITLIST CALL ENTERS AT ..HACKWLST..
042770,000050:
042771,000051: # NORMAL EXIT MODES....
042772,000052: # TC BUNKER (..Q.. IF ENTRY FROM DAP, ..TCTSKOVR.. IF FROM WAITLIST) LIST
042773,000053:
042774,000054: # SUBROUTINES CALLED....
042775,000055: # WAITLIST
042776,000056:
042777,000057: # ALARM OR ABORT EXIT MODES....
042778,000058: # NONE
042779,000059:
042780,000060: # ERASABLE INITIALIZATION REQUIRED....
042781,000061: # ESTROKER (PAD-LOAD)
042782,000062: # STROKER, CADDY, REVS, CARD, N
042783,000063:
042784,000064: # OUTPUT....
042785,000065: # STRKTSTI...INITIALIZATION FOR STROKE TEST
042786,000066: # HACK, HACKWLST...PULSE BURSTS INTO TVCPITCH VIA ..ADS..
042787,000067: # RESETS STROKER = +0 WHEN TEST COMPLETED
042788,000068:
042789,000069: # DEBRIS....
042790,000070: # N = CADDY = +0, CARD = -0, REVS = -1
042791,000071: # BUNKER
|
|
Page 980
|
042793,000073:
042794,000074: # EXAMPLE STROKE TEST WAVE FORM, DEMONSTRATING PARAMETER SELECTION
042795,000075:
042796,000076: # NOTE....THIS IS NOT THE OFFICIAL WAVEFORM....
042797,000077:
042798,000078: # ** **
042799,000079: # ** **
042800,000080: # ** ** EXAMPLE WAVEFORM (EACH * REPRESENTS
042801,000081: # * * * * 85.41 ARCSEC OF ACTUATOR CMND)
042802,000082: # * * * *
042803,000083: # * * * *
042804,000084: # * * * * ** ** ** ** **
042805,000085: # * * * * ** ** ** ** **
042806,000086: # * * * * ** ** ** ** **
042807,000087: # * * * * * * * * * * * * * * ** ** ** ** **
042808,000088: # * * * * * * * * * * * * * * ** ** ** ** **
042809,000089: # * * * * * * * * * * * * * * ** ** ** ** **
042810,000090: # -----------------------------------------------------------------------------------------------------
042811,000091: # * * * * * * * * * * * * * * ** ** ** ** **
042812,000092: # * * * * * * * * * * * * * * ** ** ** ** **
042813,000093: # * * * * * * * * * * * * * * ** ** ** ** **
042814,000094: # * * * * ** ** ** ** **
042815,000095: # * * * * ** ** ** ** **
042816,000096: # * * * * ** ** ** ** **
042817,000097: # * * * *
042818,000098: # * * * *
042819,000099: # * * * *
042820,000100: # ** **
042821,000101: # ** **
042822,000102: # ** **
042823,000103:
042824,000104: # FOR THIS (UNOFFICIAL, EXAMPLE) WAVEFORM, THE REQUIRED PARAMETERS ARE AS FOLLOWS....
042825,000105:
042826,000106: # FCARD = +3 (NUMBER OF SETS)
042827,000107: # ESTROKER = +3 (PULSE BURST SIZE, SC.AT 85.41 ARCSEC/BIT)
042828,000108:
042829,000109: # SET1..
042830,000110: # FREVS = +3 (NUMBER REVERSALS MINUS 1)
042831,000111: # FCADDY = +4 (NUMBER OF PULSE BURSTS IN 1/2 AMPLITUDE)
042832,000112: # SET2..
042833,000113: # FCARD1 = +9 (NUMBER REVERSALS MINUS 1)
042834,000114: # FCARD4 = +2 (NUMBER OF PULSE BURSTS IN 1/2 AMPLITUDE)
042835,000115: # SET3..
042836,000116: # FCARD2 = +9 (NUMBER REVERSALS MINUS 1)
042837,000117: # FCARD5 = +1 (NUMBER OF PULSE BURSTS IN 1/2 AMPLITUDE)
042838,000118: # SET4..
042839,000119: # FCARD3 = +0 (NUMBER REVERSALS MINUS 1)
042840,000120: # FCARD6 = +0 (NUMBER OF PULSE BURSTS IN 1/2 AMPLITUDE)
042841,000121:
|
|
Page 981
|
042843,000123: # STROKE TEST INITIALIZATION PACKAGE (AS A JOB, FROM VERB 68)
042844,000124:
042845,000125: 17,2552 BANK 17
042846,000126: 20,2000 SETLOC DAPS2
042847,000127: 20,2000 BANK
042848,000128:
042849,000129: 20,3501 COUNT* $$/STRK
042850,000130: 20,3501 E6,1655 EBANK= CADDY
042851,000131:
042852,000132: 20,3501 03512 STRKTSTI TCR TSTINIT # STROKE TEST INITIALIZATION PKG (CALLED
042853,000133: # AS A JOB BY VERB68)
042854,000134:
042855,000135: 20,3502 00004 STRKCHK INHINT
042856,000136:
042857,000137: 20,3503 31466 CAE DAPDATR1 # CHECK FOR CSM/LM CONFIGURATION
042858,000138: 20,3504 75002 MASK BIT14
042859,000139: 20,3505 00006 EXTEND
042860,000140: 20,3506 13511 BZF +3
042861,000141:
042862,000142: 20,3507 31413 CAE ESTROKER # BEGIN ON NEXT DAP PASS (PITCH OR YAW)
042863,000143: 20,3510 55574 TS STROKER # (STROKING DONE IN PITCH ONLY, HOWEVER)
042864,000144:
042865,000145: 20,3511 15217 TCF ENDOFJOB
042866,000146:
042867,000147: 20,3512 43522 TSTINIT CS FCADDY # NORMAL ENTRY FROM STRKTSTI
042868,000148: 20,3513 55655 TS CADDY
042869,000149: 20,3514 55656 TS N # NOTE SGN CHNG FCADDY(+) TO CADDY(-)
042870,000150:
042871,000151: 20,3515 33523 CAF FREVS
042872,000152: 20,3516 55660 TS REVS
042873,000153:
042874,000154: 20,3517 43524 CS FCARD # NOTE SGN CHNG FCARD(+) TO CARD(-)
042875,000155: 20,3520 55661 TS CARD
042876,000156:
042877,000157: 20,3521 00002 TC Q # RETURN TO STRKTSTI+1 (OR CHKSTRK+2 OR +4)
042878,000158:
|
|
Page 982
|
042880,000160: # THE OFFICIAL STROKE TEST WAVEFORM (3 JAN, 1967) CONSISTS OF FOUR STROKE SETS, AS FOLLOWS....
042881,000161:
042882,000162: # SET 1...10 BURSTS IN 1/2 AMP, 4 REVERSALS
042883,000163: # SET 2... 6 BURSTS IN 1/2 AMP, 6 REVERSALS
042884,000164: # SET 3... 5 BURSTS IN 1/2 AMP, 10 REVERSALS
042885,000165: # SET 4... 4 BURSTS IN 1/2 AMP, 14 REVERSALS
042886,000166:
042887,000167: # THE PULSE BURST SIZE (ESTROKER) IS PAD-LOADED (5 BITS AS OF 3 JAN, 1967)
042888,000168: # THE REMAINING WAVEFORM-GENERATING PARAMETERS ARE AS FOLLOWS....
042889,000169:
042890,000170: 20,3522 00012 FCADDY DEC 10 B-14 # NO. PULSE BURSTS IN 1/2 AMP, SET1..(+10)
042891,000171: 20,3523 00003 FREVS DEC 3 B-14 # NO. REVERSALS MINUS 1, SET1........( 3)
042892,000172:
042893,000173: 20,3524 00004 FCARD DEC 4 B-14 # NO. STROKE SETS....................(+ 4)
042894,000174:
042895,000175: 20,3525 00005 FCARD1 DEC 5 B-14 # NO. REVERSALS MINUS 1, SET2........( 5)
042896,000176:
042897,000177: 20,3526 00011 FCARD2 DEC 9 B-14 # 3........( 9)
042898,000178: 20,3527 00015 FCARD3 DEC 13 B-14 # 4........( 13)
042899,000179:
042900,000180: 20,3530 00006 FCARD4 DEC 6 B-14 # NO. PULSE BURSTS IN 1/2 AMP, SET2..(+ 6)
042901,000181: 20,3531 00005 FCARD5 DEC 5 B-14 # SET3..(+ 5)
042902,000182: 20,3532 00004 FCARD6 DEC 4 B-14 # SET4..(+ 4)
042903,000183:
042904,000184: 20,3533 5016 20MS = BIT2
042905,000185:
042906,000186: # STROKE TEST PACKAGE PROPER....
042907,000187:
042908,000188: 20,3533 E6,1657 EBANK= BUNKER
042909,000189:
042910,000190: 20,3533 00006 HACK EXTEND # ENTRY (IN T5 RUPT) FROM TVCDAPS
042911,000191: 20,3534 23657 QXCH BUNKER # SAVE Q FOR DAP RETURN
042912,000192:
042913,000193: 20,3535 35016 CAF 20MS # 2DAPSX2(PASSES/DAP)X2(CS/PASS)=8CS=TVCDT
042914,000194: 20,3536 05245 TC WAITLIST
042915,000195: 20,3537 E6,1657 EBANK= BUNKER
042916,000196: 20,3537 03542 40066 2CADR HACKWLST
042917,000197:
042918,000198: 20,3541 13544 TCF +3
042919,000199:
042920,000200: 20,3542 34367 HACKWLST CAF TCTSKOVR # ENTRY FROM WAITLIST
042921,000201: 20,3543 55657 TS BUNKER # BUNKER IS TC TASKOVER
042922,000202:
042923,000203: 20,3544 31574 CA STROKER # STROKE
042924,000204: 20,3545 26054 ADS TVCPITCH
042925,000205:
042926,000206: 20,3546 35005 CAF BIT11 # RELEASE THE ERROR COUNTERS
042927,000207: 20,3547 00006 EXTEND
042928,000208: 20,3550 05014 WOR CHAN14
042929,000209: 20,3551 25655 INCR CADDY # COUNT DOWN THE NO. BURSTS, THIS SLOPE
|
|
Page 983
|
042931,000211: 20,3552 41655 CS CADDY
042932,000212: 20,3553 00006 EXTEND
042933,000213: 20,3554 63556 BZMF +2
042934,000214: 20,3555 01657 TC BUNKER # EXIT, WHILE ON A SLOPE
042935,000215:
042936,000216: 20,3556 11660 CCS REVS
042937,000217: 20,3557 13577 TCF REVUP # POSITIVE REVS
042938,000218: 20,3560 13603 TCF REVUP +4 # FINAL REVERSAL, THIS SET
042939,000219:
042940,000220: 20,3561 25661 INCR CARD # NEGATIVE REVS SET LAST PASS, READY FOR
042941,000221: 20,3562 41661 CS CARD # THE NEXT SET. CHECK IF NO MORE SETS
042942,000222: 20,3563 00006 EXTEND
042943,000223: 20,3564 13575 BZF STROKILL # ALL SETS COMPLETED
042944,000224:
042945,000225: 20,3565 51661 INDEX CARD
042946,000226: 20,3566 33530 CAF FCARD +4 # PICK UP NO. REVERSALS (-), NEXT SET
042947,000227: 20,3567 55660 TS REVS # REINITIALIZE
042948,000228: 20,3570 51661 INDEX CARD
042949,000229: 20,3571 43533 CS FCARD +7 # PICK UP NO. BURSTS IN 1/2AMP, NEXT SET
042950,000230: 20,3572 55656 TS N # REINITIALIZE
042951,000231: 20,3573 55655 TS CADDY
042952,000232: 20,3574 01657 TC BUNKER # EXIT, AT END OF SET
042953,000233:
042954,000234: 20,3575 55574 STROKILL TS STROKER # RESET (TO +0) TO END TEST
042955,000235: 20,3576 01657 TC BUNKER # EXIT, STROKE TEST FINIS
042956,000236:
042957,000237: 20,3577 55660 REVUP TS REVS # ALL REVERSALS EXCEPT LAST OF SET
042958,000238: 20,3600 31656 CA N
042959,000239: 20,3601 60000 DOUBLE # 2 X 1/2AMP
042960,000240: 20,3602 13606 TCF +4
042961,000241:
042962,000242: 20,3603 45017 +4 CS ONE # FINAL REVERSAL, THIS SET
042963,000243: 20,3604 55660 TS REVS # PREPARE TO BRANCH TO NEW BURST
042964,000244: 20,3605 31656 CA N # JUST RETURN TO ZERO, FINAL SLOPE OF SET
042965,000245: 20,3606 55655 TS CADDY # CADUP
042966,000246:
042967,000247: 20,3607 41574 CS STROKER # CHANGE SIGN OF SLOPE
042968,000248: 20,3610 55574 TS STROKER
042969,000249: 20,3611 01657 TC BUNKER # EXIT AT A REVERSAL (SLOPE CHANGE)
042970,000250:
End of include-file TVCSTROKETEST.agc. Parent file is MAIN.agc