Source Code
|
These source-code files are part of a reconstructed copy of Comanche 45/2 (AKA Manche45 revision 2),
the final, flown mission release of the Apollo 10 Command Module (CM) Apollo Guidance
Computer (AGC) software. Comanche 45/2 was preceded by Comanche 44 and Comanche 45. The
reconstruction is believed to be exactly accurate, but in the absence of an actual Apollo-era
listing of Comanche 45/2, some explanation of the reconstruction process is needed
to insure confidence in that accuracy.
The starting point was the source code of Comanche 45 (itself previously accurately
reconstructed). Comanche 45 source code was then modified by incorporating changes
known from contemporary documentation to have been made between revisions 45 and 45/2.
The now-reconstructed Comanche 45/2 source code was
verified by assembling it and checking that the assembled code had
the expected known-correct memory-bank checksums.
Note that page numbers in the reconstructed code tend to match those in the Comanche 55, the
most-similar revision of Comanche for which we have access to an actual non-reconstructed hardcopy;
the source code would likely have different page numbers in a contemporary
Comanche 45 listing.
Annotations that were not present in the contemporary source code have been added to the reconstructed
code to justify each change relative to Comanche 44. Here's a guide to the Apollo documentation referenced
in those annotations:
Comments expected to have been present in 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.
|
000020,000002: ## Copyright: Public domain.
000021,000003: ## Filename: CONTRACT_AND_APPROVALS.agc
000022,000004: ## Purpose: A section of Manche45 revision 2.
000023,000005: ## It is part of the reconstructed source code for the
000024,000006: ## final, flown release of the flight software for the Command
000025,000007: ## Module's (CM) Apollo Guidance Computer (AGC) for Apollo 10.
000026,000008: ## The code has been recreated from a copy of Comanche 055. It
000027,000009: ## has been adapted such that the resulting bugger words
000028,000010: ## exactly match those specified for Manche 45/2 in NASA drawing
000029,000011: ## 2021153D, which gives relatively high confidence that the
000030,000012: ## reconstruction is correct.
000031,000013: ## Assembler: yaYUL
000032,000014: ## Contact: Ron Burkey <info@sandroid.org>.
000033,000015: ## Website: www.ibiblio.org/apollo/index.html
000034,000016: ## Mod history: 2020-12-24 MAS Created from Comanche 45.
000035,000017: ## 2020-12-24 RSB Fixed reconstruction-justifying annotations.
000036,000018:
|
|
Page 1
|
000038,000020:
|
|
Reconstruction: We don't know of any surviving specific contemporary
documentation supporting the material in this log section, absent an
Apollo-era assembly listing of it. The section contains
only comments and no executable code. We have simply modeled the Comanche 45/2 version of it on the
corresponding log section of Comanche 45, but have changed a handful of
items in ways that seem sensible to us. The annotations below thus
provide our common-sense reasoning on the matter, rather than justification from
contemporary documentation.
|
000047,000029:
000048,000030: # ************************************************************************
000049,000031: # * *
000050,000032: # * THIS AGC PROGRAM SHALL ALSO BE REFERRED TO AS: *
000051,000033: # * *
000052,000034: # * *
000053,000035: # * COLOSSUS 2 *
000054,000036: # * *
000055,000037: # * *
000056,000038: # * THIS PROGRAM IS INTENDED FOR USE IN THE CM AS SPECIFIED *
000057,000039: # * IN REPORT R-577. THIS PROGRAM WAS PREPARED UNDER DSR *
000058,000040: # * PROJECT 55-23870, SPONSORED BY THE MANNED SPACECRAFT *
000059,000041: # * CENTER OF THE NATIONAL AERONAUTICS AND SPACE *
000060,000042: # * ADMINISTRATION THROUGH CONTRACT NAS 9-4065 WITH THE *
000061,000043: # * INSTRUMENTATION LABORATORY, MASSACHUSETTS INSTITUTE OF *
000062,000044: # * TECHNOLOGY, CAMBRIDGE, MASS. *
000063,000045: # * *
000064,000046: # ************************************************************************
000065,000047:
|
|
Reconstruction: The signature names and titles below are not
actually known for certain. Because Comanche 45 through 45/2 were separated by
less than 2 months in time (see below), we assume that personnel turnover
in that limited period of time would be unlikely. Hence we have retained the
same names and titles for Comanche 45/2 as for Comanche 45. Also, these are
the same names and titles as appear in Comanche 55.
On the other hand, the DATE fields below are more speculative,
and are very likely to be wrong but unlikely to be too wrong. In
an earlier reconstruction, Comanche 44, it was concluded as a
rule of thumb that the signoff dates listed in the CONTRACT AND APPROVALS
section should precede the date of release of the software to manufacturing
by about 3 weeks. To determine the date of release to manufacturing,
the best information we're aware of comes from
MIT's Role in Project Apollo, Final Report, Table 4-II, where
we find the Comanche 45 was released in March 1969, and that Comanche 45/2 was
released in April 1969. This is a bit non-specific, but if we interpret
Comanche 45/2's release date as April 15 and subtract 3 weeks,
we tentatively arrive at a signoff date of March 25. That happened to
be a Tuesday in 1969.
|
000088,000070: # SUBMITTED: MARGARET H. HAMILTON DATE: 25 March 69
000089,000071: # M.H.HAMILTON, COLOSSUS PROGRAMMING LEADER
000090,000072: # APOLLO GUIDANCE AND NAVIGATION
000091,000073:
000092,000074: # APPROVED: DANIEL J. LICKLY DATE: 25 March 69
000093,000075: # D.J.LICKLY, DIRECTOR, MISSION PROGRAM DEVELOPMENT
000094,000076: # APOLLO GUIDANCE AND NAVIGATION PROGRAM
000095,000077:
000096,000078: # APPROVED: FRED H. MARTIN DATE: 25 March 69
000097,000079: # FRED H. MARTIN, COLOSSUS PROJECT MANGER
000098,000080: # APOLLO GUIDANCE AND NAVIGATION PROGRAM
000099,000081:
000100,000082: # APPROVED: NORMAN E. SEARS DATE: 25 March 69
000101,000083: # N.E. SEARS, DIRECTOR, MISSION DEVELOPMENT
000102,000084: # APOLLO GUIDANCE AND NAVIGATION PROGRAM
000103,000085:
000104,000086: # APPROVED: RICHARD H. BATTIN DATE: 25 March 69
000105,000087: # R.H. BATTIN, DIRECTOR, MISSION DEVELOPMENT
000106,000088: # APOLLO GUIDANCE AND NAVIGATION PROGRAM
000107,000089:
000108,000090: # APPROVED: DAVID G. HOAG DATE: 25 March 69
000109,000091: # D.G. HOAG, DIRECTOR
000110,000092: # APOLLO GUIDANCE AND NAVIGATION PROGRAM
000111,000093:
000112,000094: # APPROVED: RALPH R. RAGAN DATE: 25 March 69
000113,000095: # R.R. RAGAN, DEPUTY DIRECTOR
000114,000096: # INSTRUMENTATION LABORATORY
000115,000097:
End of include-file CONTRACT_AND_APPROVALS.agc. Parent file is MAIN.agc