Apollo 11 Guidance Computer Source Code: Mã AGC Của NASA
/Apollo-11
Apollo-11 Guidance Computer Source Code, publicly readable on GitHub, is the actual assembly software that flew on Comanche055 (command module) and Luminary099 (lunar module) in 1969, re-versioned from MIT Museum scans and released into the public domain. It is recommended for those interested in real flight software, though the repository only points to Virtual AGC.
Giới Thiệu Mã Nguồn AGC Của Apollo 11
Apollo 11 Guidance Computer Source Code là repository chrislgarry/Apollo-11 trên GitHub, lưu các chương trình hợp ngữ gốc cho hai máy tính dùng trong nhiệm vụ Apollo 11: Comanche055 cho khoang chỉ huy và Luminary099 cho khoang đổ bộ. Các tệp được số hóa bởi Virtual AGC và MIT Museum từ bản quét giấy gốc, và mục tiêu mà README nêu ra là giữ cho bản phiên âm này trung thực với các trang gốc, hoan nghênh PR mỗi khi phát hiện sai lệch.
Nội Dung Chính Của Repository
- ✓Comanche055, chương trình AGC của khoang chỉ huy, thuộc Colossus 2A, được bảng ghi công liệt kê là revision 055 do NASA lắp ráp vào tháng 4 năm 1969.
- ✓Luminary099, chương trình AGC của khoang đổ bộ, thuộc Luminary 1A, được liệt kê là revision 001 do NASA lắp ráp vào tháng 7 năm 1969.
- ✓Tệp CONTRACT_AND_APPROVALS.agc tái hiện trang ký duyệt gốc, nêu tên Margaret H. Hamilton là Colossus Programming Leader cùng năm người phê duyệt thuộc chương trình Apollo Guidance and Navigation.
- ✓Mã được định dạng cho yaYUL, trình hợp dịch được nêu tên trong chính bảng ghi công của repository.
- ✓Các bản dịch README sang hàng chục ngôn ngữ, từ tiếng Việt, tiếng Nhật đến tiếng Ả Rập và tiếng Nga, được lưu trong thư mục Translations.
- ✓Tệp CONTRIBUTING.md nêu rõ cách gửi bản sửa lỗi so với các bản quét gốc của Luminary 099 và Comanche055.
Cách Khám Phá Mã Nguồn Lịch Sử Này
- •Đọc Comanche055 và Luminary099 như những hiện vật lịch sử đã số hóa, chứ không phải mã để chạy.
- •Đối chiếu một tệp đã phiên âm với bản quét gốc được dẫn link trong README, rồi mở PR nếu phát hiện sai lệch.
- •Mở tệp CONTRACT_AND_APPROVALS.agc để xem trang ký duyệt thật năm 1969, gồm cả vai trò Colossus Programming Leader của Margaret Hamilton.
- •Đọc dự án bằng ngôn ngữ của bạn qua một bản dịch README nếu các ghi chú hợp ngữ bằng tiếng Anh gây khó khăn.
- •Chuyển sang Virtual AGC, dự án mà README dẫn người đọc tới, khi bạn thực sự muốn build và chạy mã.
Điểm Mạnh
- ✓Số hóa từ nguồn gốc: Paul Fjeld phiên âm mã từ bản quét giấy của MIT Museum do Deborah Douglas sắp xếp, không phải đánh máy lại qua trung gian.
- ✓Nguồn gốc có thể truy vết, tới tận tệp CONTRACT_AND_APPROVALS.agc tái hiện trang ký duyệt thật năm 1969 với tên kỹ sư và ngày tháng cụ thể.
- ✓Ở dạng phạm vi công cộng nên không có rào cản nào khi đọc, trích dẫn, hay tái sử dụng cho nghiên cứu và giảng dạy.
- ✓Được sửa lỗi tích cực: README công khai mời PR để sửa mọi sai lệch giữa bản phiên âm này với bản quét gốc.
- ✓Được dịch sang hàng chục ngôn ngữ, một độ phủ hiếm thấy với một repository kỹ thuật như thế này.
Những Điều Cần Lưu Ý Khi Nghiên Cứu Mã
- △Repository này không có hệ thống build. Mục Compiling trong README chỉ dẫn sang Virtual AGC thay vì nêu các bước build ngay trong repo.
- △Mã nhắm tới một máy tính của thập niên 1960 không còn tương đương hiện đại, nên để đọc được cần quen với tập lệnh riêng của AGC, không chỉ kinh nghiệm hợp ngữ thông thường.
- △GitHub không hiển thị định danh giấy phép chuẩn nào cho repository. Bảng ghi công gọi tài liệu này là phạm vi công cộng, nhưng đó không phải một tệp giấy phép máy đọc được.
- △Ngoài CONTRIBUTING.md, không có quy trình nghiên cứu mã nào được ghi lại, nên bạn gần như tự xoay xở với hai codebase hợp ngữ lớn.
Dự Án Và Tài Nguyên Liên Quan
Câu Hỏi Thường Gặp
Bảng ghi công của repository liệt kê bản quyền của mã là phạm vi công cộng. GitHub không hiển thị định danh giấy phép SPDX riêng cho Apollo 11 Guidance Computer Source Code.
Apollo 11 Guidance Computer Source Code được viết bằng hợp ngữ (Assembly), định dạng cho trình hợp dịch yaYUL theo bảng ghi công của repository.
Không thể biên dịch trực tiếp từ repository này. README dẫn những ai muốn build và chạy mã sang dự án Virtual AGC riêng biệt.
Instrumentation Laboratory của MIT, theo hợp đồng với NASA, đã viết phần mềm này. Hồ sơ hợp đồng của repository liệt kê Margaret H. Hamilton là Colossus Programming Leader.
README có link tới các bản dịch sang hàng chục ngôn ngữ, gồm tiếng Việt, tiếng Nhật, tiếng Ả Rập và tiếng Nga, lưu trong thư mục Translations.
Apollo 11 Guidance Computer Source Code gồm hai module: Comanche055 cho khoang chỉ huy và Luminary099 cho khoang đổ bộ.
Ai nên dùng — và ai nên bỏ qua
Hãy thử nếu bạn tò mò về phần mềm bay thật từ thời Apollo, đang dạy một lớp lịch sử máy tính, hoặc muốn xem mã và hồ sơ giấy tờ thật của đội Margaret Hamilton. Bỏ qua nếu bạn kỳ vọng một dự án chạy được ngay hoặc tài liệu hiện đại: ở đây chỉ có mã nguồn và một đường dẫn sang Virtual AGC cho ai muốn biên dịch nó.
Repo liên quan
Apollo-11 có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về Apollo-11.