Source Code
|
These source-code files are part of a reconstructed copy of Artemis 071, the
first release of the Apollo 15 through 17 Command Module (CM) Apollo Guidance
Computer (AGC) software.
The reconstruction began with source code of Artemis 072 previously transcribed
from a digitized copy of that program. The code was then updated by undoing
changes between the two versions. The reconstruction was verified by matching
memory-bank checksums to those listed in drawing 2021154-. Note that page
numbers in the reconstructed code match those on the Artemis 072 printout,
although the changed code would likely have changed page numbers for a real
Artemis 071 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.
|
063337,000002: ## Copyright: Public domain.
063338,000003: ## Filename: SERVICE_ROUTINES.agc
063339,000004: ## Purpose: A section of Artemis revision 071.
063340,000005: ## It is part of the reconstructed source code for the first
063341,000006: ## release of the flight software for the Command Module's
063342,000007: ## (CM) Apollo Guidance Computer (AGC) for Apollo 15 through
063343,000008: ## 17. The code has been recreated from a copy of Artemis 072.
063344,000009: ## It has been adapted such that the resulting bugger words
063345,000010: ## exactly match those specified for Artemis 071 in NASA
063346,000011: ## drawing 2021154-, which gives relatively high confidence
063347,000012: ## that the reconstruction is correct.
063348,000013: ## Reference: 1478
063349,000014: ## Assembler: yaYUL
063350,000015: ## Contact: Ron Burkey <info@sandroid.org>.
063351,000016: ## Website: www.ibiblio.org/apollo/index.html
063352,000017: ## Mod history: 2019-08-14 MAS Created from Artemis 072.
063353,000018:
|
|
Page 1478
|
063355,000020:
063356,000021: 10,2000 SETLOC DISPLAYS
063357,000022: 10,2000 BANK
063358,000023: 10,3755 COUNT* $$/DSPLA
063359,000024: 10,3755 54001 UPENT2 TS L
063360,000025: 10,3756 40100 CS FLAGWRD4
063361,000026: 10,3757 70001 MASK L
063362,000027: 10,3760 26100 ADS FLAGWRD4
063363,000028: 10,3761 00002 TC Q # RETURN
063364,000029:
063365,000030: 10,3762 40000 DOWNENT2 COM # START TO PROCESS INFORMATION
063366,000031: 10,3763 70100 MASK FLAGWRD4
063367,000032: 10,3764 54100 TS FLAGWRD4
063368,000033: 10,3765 00002 TC Q # RETURN
063369,000034:
063370,000035: 10,3766 4774 OCT7 EQUALS SEVEN
063371,000036:
|
|
Page 1479
|
063373,000038:
063374,000039: # UPFLAG AND DOWNFLAG ARE ENTIRELY GENERAL FLAG SETTING AND CLEARING SUBROUTINES. USING THEM, WHETHER OR
063375,000040: # NOT IN INTERRUPT, ONE MAY SET OR CLEAR ANY SINGLE, NAMED BIT IN ANY ERASABLE REGISTER, SUBJECT OF COURSE TO
063376,000041: # EBANK SETTING. A "NAMED" BIT, AS THE WORD IS USED HERE, IS ANY BIT WITH A NAME FORMALLY ASSIGNED BY THE YUL
063377,000042: # ASSEMBLER.
063378,000043:
063379,000044: # AT PRESENT THE ONLY NAMED BITS ARE THOSE IN THE FLAGWORDS. ASSEMBLER CHANGES WILL MAKE IT POSSIBLE TO
063380,000045: # NAME ANY BIT IN ERASABLE MEMORY.
063381,000046:
063382,000047: # CALLING SEQUENCES ARE AS FOLLOWS:-
063383,000048: # TC UPFLAG TC DOWNFLAG
063384,000049: # ADRES NAME OF FLAG ADRES NAME OF FLAG
063385,000050:
063386,000051: # RETURN IS TO THE LOCATION FOLLOWING THE "ADRES" ABOUT .58 MS AFTER THE "TC".
063387,000052: # UPON RETURN A CONTAINS THE CURRENT FLAGWRD SETTING.
063388,000053:
063389,000054: 4000 SETLOC FFTAG1
063390,000055: 4000 BANK
063391,000056: 5547 COUNT* $$/FLAG
063392,000057:
063393,000058: 5547 30002 UPFLAG CA Q
063394,000059: 5550 05565 TC DEBIT
063395,000060: 5551 40000 COM # +(15 - BIT)
063396,000061: 5552 00006 EXTEND
063397,000062: 5553 04001 ROR LCHAN # SET BIT
063398,000063: 5554 50061 COMFLAG INDEX ITEMP1
063399,000064: 5555 54074 TS FLAGWRD0
063400,000065: 5556 22063 LXCH ITEMP3
063401,000066: 5557 00003 RELINT
063402,000067: 5560 00001 TC L
063403,000068:
063404,000069: 5561 30002 DOWNFLAG CA Q
063405,000070: 5562 05565 TC DEBIT
063406,000071: 5563 70001 MASK L # RESET BIT
063407,000072: 5564 15554 TCF COMFLAG
063408,000073:
063409,000074: 5565 64770 DEBIT AD ONE # GET DE BITS
063410,000075: 5566 00004 INHINT
063411,000076: 5567 54063 TS ITEMP3
063412,000077: 5570 34777 CA LOW4 # DEC15
063413,000078: 5571 54061 TS ITEMP1
063414,000079: 5572 50063 INDEX ITEMP3
063415,000080: 5573 27777 CA 0 -1 # ADRES
063416,000081: 5574 54001 TS L
063417,000082: 5575 34772 CA ZERO
063418,000083: 5576 00006 EXTEND
|
|
Page 1480
|
063420,000085: 5577 10061 DV ITEMP1 # A = FLAGWRD, L = (15 - BIT)
063421,000086: 5600 52062 DXCH ITEMP1
063422,000087: 5601 50061 INDEX ITEMP1
063423,000088: 5602 30074 CA FLAGWRD0
063424,000089: 5603 54001 TS L # CURRENT STATE
063425,000090: 5604 50062 INDEX ITEMP2
063426,000091: 5605 44752 CS BIT15 # -(15 - BIT)
063427,000092: 5606 00002 TC Q
063428,000093:
|
|
Page 1481
|
063430,000095:
063431,000096: # DELAYJOB - A GENERAL ROUTINE TO DELAY A JOB A SPECIFIC AMOUNT OF TIME BEFORE PICKING UP AGAIN.
063432,000097:
063433,000098: # ENTRANCE REQUIREMENTS ...
063434,000099: # CAF DT DELAY JOB FOR DT CENTISECS
063435,000100: # TC BANKCALL
063436,000101: # CADR DELAYJOB
063437,000102:
063438,000103: 00,2000 SETLOC DLAYJOB
063439,000104: 00,2000 BANK
063440,000105:
063441,000106: # THIS MUST REMAIN IN BANK 0 *****************************************
063442,000107: 00,3730 COUNT* $$/DELAY
063443,000108: 00,3730 35016 1SECDELY CAF 1SEC
063444,000109: 00,3731 00004 DELAYJOB INHINT
063445,000110: 00,3732 54002 TS Q # STORE DELAY DT IN Q FOR DLY -1 IN
063446,000111:
063447,000112: 00,3733 36214 CAF DELAYNUM # WAITLIST
063448,000113: 00,3734 54070 DELLOOP TS RUPTREG1
063449,000114: 00,3735 50000 INDEX A
063450,000115: 00,3736 31000 CA DELAYLOC # IS THIS DELAYLOC AVAILABLE
063451,000116: 00,3737 00006 EXTEND
063452,000117: 00,3740 13745 BZF OK2DELAY # YES
063453,000118:
063454,000119: 00,3741 10070 CCS RUPTREG1 # NO, TRY NEXT DELAYLOC
063455,000120: 00,3742 13734 TCF DELLOOP
063456,000121:
063457,000122: 00,3743 07706 TC BAILOUT # NO AVAILABLE LOCS AVAILABLE.
063458,000123: 00,3744 31104 OCT 31104
063459,000124:
063460,000125: 00,3745 33765 OK2DELAY CA TCSLEEP # SET WAITLIST IMMEDIATE RETURN
063461,000126: 00,3746 54061 TS WAITEXIT
063462,000127:
063463,000128: 00,3747 30004 CA FBANK
063464,000129: 00,3750 60070 AD RUPTREG1 # STORE BBANK FOR TASK CALL
063465,000130: 00,3751 54001 TS L
063466,000131:
063467,000132: 00,3752 33766 CAF WAKECAD # STORE CADR FOR TASK CALL
063468,000133: 00,3753 15243 TCF DLY2 -1 # DLY IS IN WAITLIST ROUTINE
063469,000134:
063470,000135: 00,3754 04665 TCGETCAD TC MAKECADR # GET CALLERS FCADR
063471,000136:
063472,000137: 00,3755 50070 INDEX RUPTREG1
063473,000138: 00,3756 55000 TS DELAYLOC # SAVE DELAY CADRS
063474,000139:
063475,000140: 00,3757 05163 TC JOBSLEEP
063476,000141:
063477,000142: 00,3760 34772 WAKER CAF ZERO
063478,000143: 00,3761 50006 INDEX BBANK
063479,000144: 00,3762 57000 XCH DELAYLOC # MAKE DELAYLOC AVAILABLE
063480,000145: 00,3763 05167 TC JOBWAKE
|
|
Page 1482
|
063482,000147: 00,3764 05314 TC TASKOVER
063483,000148:
063484,000149: 00,3765 03752 TCSLEEP GENADR TCGETCAD -2
063485,000150: 00,3766 03760 WAKECAD GENADR WAKER
063486,000151:
|
|
Page 1483
|
063488,000153:
063489,000154: # GENTRAN, A BLOCK TRANSFER ROUTINE.
063490,000155:
063491,000156: # WRITTEN BY D. EYLES
063492,000157: # MOD 1 BY KERNAN UTILITYM REV 17 11/18/67
063493,000158:
063494,000159: # MOD 2 BY SCHULENBERG (REMOVE RELINT) SKIPPER REV 4 2/28/68
063495,000160:
063496,000161: # THIS ROUTINE IS USEFULL FOR TRANSFERING N CONSECUTIVE ERASABLE OR FIXED QUANTITIES TO SOME OTHER N
063497,000162: # CONSECUTIVE ERASABLE LOCATIONS. IF BOTH BLOCKS OF DATA ARE IN SWITCHABLE EBANKS, THEY MUST BE IN THE SAME ONE.
063498,000163:
063499,000164: # GENTRAN IS CALLABLE IN A JOB AS WELL AS A RUPT. THE CALLING SEQUENCE IS:
063500,000165:
063501,000166: # I CA N-1 # OF QUANTITIES MINUS ONE.
063502,000167: # I +1 TC GENTRAN IN FIXED-FIXED.
063503,000168: # I +2 ADRES L STARTING ADRES OF DATA TO BE MOVED.
063504,000169: # I +3 ADRES M STARTING ADRES OF DUPLICATION BLOCK.
063505,000170: # I +4 RETURNS HERE.
063506,000171:
063507,000172: # GENTRAN TAKES 25 MCT'S (300 MICROSECONDS) PER ITEM + 5 MCT'S (60 MICS) FOR ENTERING AND EXITING.
063508,000173:
063509,000174: # A, L AND ITEMP1 ARE NOT PRESERVED.
063510,000175:
063511,000176: 4000 SETLOC FFTAG4
063512,000177: 4000 BANK
063513,000178:
063514,000179: 5607 0061 EBANK= ITEMP1
063515,000180:
063516,000181: 5607 COUNT* $$/TRAN
063517,000182:
063518,000183: 5607 00004 GENTRAN INHINT
063519,000184: 5610 54061 +1 TS ITEMP1 # SAVE N-1
063520,000185: 5611 50002 INDEX Q # C(Q) = ADRES L.
063521,000186: 5612 60000 AD 0 # ADRES (L + N - 1).
063522,000187: 5613 50000 INDEX A
063523,000188: 5614 30000 CA 0 # C(ABOVE).
063524,000189: 5615 54001 TS L # SAVE DATA.
063525,000190: 5616 30061 CA ITEMP1
063526,000191: 5617 50002 INDEX Q
063527,000192: 5620 60001 AD 1 # ADRES (M + N - 1).
063528,000193: 5621 50000 INDEX A
063529,000194: 5622 22000 LXCH 0 # STUFF IT.
063530,000195: 5623 10061 CCS ITEMP1 # LOOP UNTIL N-1 = 0.
063531,000196: 5624 15610 TCF GENTRAN +1
063532,000197: 5625 16710 TCF Q+2 # RETURN TO CALLER.
063533,000198:
|
|
Page 1484
|
063535,000200:
063536,000201: # B5OFF ZERO BIT 5 OF EXTVBACT, WHICH IS SET BY TESTXACT.
063537,000202: # MAY BE USED AS NEEDED BY ANY EXTENDED VERB WHICH HAS DONE TESTXACT
063538,000203:
063539,000204: 5626 COUNT* $$/EXTVB
063540,000205:
063541,000206: 5626 44764 B5OFF CS BIT5
063542,000207: 5627 71247 MASK EXTVBACT
063543,000208: 5630 55247 TS EXTVBACT
063544,000209: 5631 05205 TC ENDOFJOB
063545,000210:
|
|
Page 1485
|
063547,000212:
063548,000213: # SUBROUTINES TO TURN OFF AND TURN ON TRACKER FAIL LIGHT.
063549,000214:
063550,000215: 5632 COUNT* $$/DSPLA
063551,000216: 5632 00004 TRFAILOF INHINT
063552,000217: 5633 47670 CS OCT40200 # TURN OFF TRACKER LIGHT
063553,000218: 5634 71241 MASK DSPTAB +11D
063554,000219: 5635 64752 AD BIT15
063555,000220: 5636 55241 TS DSPTAB +11D
063556,000221: 5637 41337 CS OPTMODES # TO INSURE THAT OCDU FAIL WILL GO ON
063557,000222: 5640 74762 MASK OCDUFBIT # AGAIN IF IT WAS ON IN ADDITION TO
063558,000223: 5641 27337 ADS OPTMODES # TRACKER FAIL.
063559,000224:
063560,000225: 5642 00003 REQ RELINT
063561,000226: 5643 00002 TC Q
063562,000227:
063563,000228: 5644 00004 TRFAILON INHINT
063564,000229: 5645 41241 CS DSPTAB +11D # TURN ON
063565,000230: 5646 77670 MASK OCT40200
063566,000231: 5647 27241 ADS DSPTAB +11D
063567,000232: 5650 15642 TCF REQ
063568,000233:
063569,000234: 5651 10000 INCRQCK CCS A
063570,000235: 5652 24002 INCR Q
063571,000236: 5653 00002 TC Q
063572,000237: 5654 COUNT* $$/CFAIL
063573,000238: 5654 54001 C31BTCHK TS L # SAVE MASK
063574,000239: 5655 30374 CA C31FLWRD
063575,000240: 5656 74346 MASK FAILBIT
063576,000241: 5657 10000 CCS A
063577,000242: 5660 15667 TCF USEFLBTS
063578,000243: 5661 00006 EXTEND
063579,000244: 5662 00031 READ CHAN31
063580,000245: 5663 70001 C31CMCHK MASK L
063581,000246: 5664 00006 EXTEND
063582,000247: 5665 16711 BZF TCQ # BITS SET
063583,000248: 5666 16706 TCF Q+1 # BITS NOT SET
063584,000249:
063585,000250: 5667 30374 USEFLBTS CA C31FLWRD
063586,000251: 5670 15663 TCF C31CMCHK
063587,000252:
063588,000253: 5671 4346 FAILBIT = PRIO30
063589,000254:
End of include-file SERVICE_ROUTINES.agc. Parent file is MAIN.agc