1. 從一段匯編代碼說(shuō)起Apollo-11 制導(dǎo)計(jì)算機(jī)源碼的現(xiàn)代復(fù)現(xiàn)價(jià)值第一次看到 Apollo-11 這個(gè)項(xiàng)目標(biāo)題很多人會(huì)以為又是哪個(gè)航天科普的圖文合集。但真正打開(kāi)倉(cāng)庫(kù)你會(huì)發(fā)現(xiàn)里面躺著的是當(dāng)年阿波羅計(jì)劃中制導(dǎo)計(jì)算機(jī)AGCApollo Guidance Computer的完整飛行軟件源碼——不是偽代碼不是教學(xué)簡(jiǎn)化版而是當(dāng)年真正燒進(jìn)硬件、送上太空的那套匯編程序。這個(gè)項(xiàng)目做的事情是把這套歷史代碼完整保存、注釋、并讓它能在現(xiàn)代環(huán)境里被編譯、被理解、被運(yùn)行。它解決的核心問(wèn)題其實(shí)很樸素一段五十多年前的匯編代碼指令集冷門、注釋稀少、硬件早已停產(chǎn)普通人根本無(wú)從下手。Apollo-11 項(xiàng)目通過(guò)整理源碼、提供匯編器、補(bǔ)充文檔把這段代碼從博物館展品變成了可以動(dòng)手跑起來(lái)的學(xué)習(xí)材料。適合誰(shuí)來(lái)參考嵌入式開(kāi)發(fā)者可以看極端資源約束下的工程取舍計(jì)算機(jī)歷史愛(ài)好者可以看早期實(shí)時(shí)系統(tǒng)的設(shè)計(jì)思路匯編語(yǔ)言學(xué)習(xí)者可以拿它當(dāng)真實(shí)案例練手甚至對(duì)航天軟件流程感興趣的人也能從中窺見(jiàn)當(dāng)年軟件工程的嚴(yán)謹(jǐn)程度。我之所以想認(rèn)真拆解這個(gè)項(xiàng)目是因?yàn)樗砩嫌幸粋€(gè)很稀缺的特質(zhì)它不教你怎么寫代碼而是讓你看到在 2KB 內(nèi)存、每秒幾萬(wàn)次運(yùn)算的機(jī)器上人類是怎么把兩個(gè)人送上月球的。這種極端約束下的工程智慧放到今天任何一個(gè)做嵌入式、做實(shí)時(shí)系統(tǒng)、做性能優(yōu)化的人面前都依然有沖擊力。下面我會(huì)從整體設(shè)計(jì)、核心細(xì)節(jié)、實(shí)操?gòu)?fù)現(xiàn)、問(wèn)題排查幾個(gè)角度把這段代碼背后的東西一層層剝開(kāi)。2. 項(xiàng)目整體設(shè)計(jì)與思路拆解2.1 為什么是保存可運(yùn)行而不是單純歸檔很多歷史代碼項(xiàng)目的做法是掃描、拍照、上傳然后就沒(méi)有然后了。Apollo-11 項(xiàng)目的思路明顯不同它追求的是可編譯、可運(yùn)行、可驗(yàn)證。這個(gè)選擇背后有很實(shí)際的考量一段代碼如果只能看不能跑那它和一張照片沒(méi)有本質(zhì)區(qū)別你無(wú)法確認(rèn)自己的理解是否正確也無(wú)法通過(guò)修改和觀察來(lái)學(xué)習(xí)。要做到可運(yùn)行就必須解決幾個(gè)硬骨頭。第一是匯編器AGC 用的指令集和現(xiàn)代任何主流匯編器都不兼容必須專門實(shí)現(xiàn)一個(gè)。第二是硬件模擬代碼原本跑在 AGC 上現(xiàn)代機(jī)器沒(méi)有這個(gè)硬件需要一個(gè)能解釋執(zhí)行 AGC 指令的模擬器。第三是輸入輸出AGC 的顯示和鍵盤DSKYDisplay and Keyboard需要被模擬出來(lái)否則程序跑起來(lái)你也不知道它在干什么。項(xiàng)目選擇把這幾塊都做出來(lái)代價(jià)是工作量大收益是學(xué)習(xí)者可以真正上手。我個(gè)人非常認(rèn)同這個(gè)取舍因?yàn)閷W(xué)習(xí)匯編和實(shí)時(shí)系統(tǒng)光看是學(xué)不會(huì)的必須能改一行、跑一次、看結(jié)果。2.2 匯編器與模擬器的分工邏輯這里要講清楚一個(gè)容易混淆的點(diǎn)匯編器和模擬器是兩回事各管一段。匯編器負(fù)責(zé)把人類可讀的 AGC 匯編源碼比如TC、CCS、INDEX這些助記符翻譯成 AGC 能執(zhí)行的機(jī)器碼。它解決的是從源碼到二進(jìn)制的問(wèn)題。模擬器負(fù)責(zé)在現(xiàn)代 CPU 上模擬 AGC 的運(yùn)算、內(nèi)存、寄存器和外設(shè)它解決的是從二進(jìn)制到運(yùn)行的問(wèn)題。為什么必須分開(kāi)因?yàn)檫@兩件事的驗(yàn)證目標(biāo)不同。匯編器要保證翻譯結(jié)果和當(dāng)年一致模擬器要保證執(zhí)行行為和歷史一致。分開(kāi)之后你可以單獨(dú)驗(yàn)證匯編器輸出的機(jī)器碼是否和原始二進(jìn)制吻合也可以單獨(dú)測(cè)試模擬器跑其他 AGC 程序是否正確。這種模塊化思路在今天看依然是標(biāo)準(zhǔn)做法但放在一個(gè)歷史代碼復(fù)現(xiàn)項(xiàng)目里說(shuō)明作者是真的按工程標(biāo)準(zhǔn)在做而不是玩票。2.3 資源約束倒逼出的設(shè)計(jì)哲學(xué)AGC 的硬件規(guī)格放到今天看簡(jiǎn)直寒酸大約 2KB 的 RAM實(shí)際是 2048 個(gè) 16 位字36KB 左右的 ROM核心 rope memory主頻約 2MHz 級(jí)別運(yùn)算速度以今天的標(biāo)準(zhǔn)慢得離譜。但就是這樣的機(jī)器要完成制導(dǎo)、導(dǎo)航、控制、顯示、報(bào)警等一系列任務(wù)。這種約束直接決定了代碼的設(shè)計(jì)哲學(xué)。第一內(nèi)存復(fù)用到了極致同一個(gè)存儲(chǔ)位置在不同階段承擔(dān)不同角色變量命名和注釋必須極其精確否則維護(hù)就是災(zāi)難。第二中斷和優(yōu)先級(jí)設(shè)計(jì)極其克制因?yàn)槿魏味嘤嗟拈_(kāi)銷都是奢侈。第三代碼體積被反復(fù)壓縮很多在今天看來(lái)理所當(dāng)然的抽象和封裝當(dāng)年根本不敢用。理解這一點(diǎn)你再看源碼里那些看似繞的寫法就不會(huì)覺(jué)得是古人水平不行而是他們?cè)跇O端約束下做出的最優(yōu)解。這也是我認(rèn)為這個(gè)項(xiàng)目對(duì)現(xiàn)代嵌入式開(kāi)發(fā)者最有價(jià)值的地方當(dāng)你抱怨單片機(jī)內(nèi)存不夠時(shí)想想人家用 2KB 把飛船送上了月球。3. 核心細(xì)節(jié)解析與實(shí)操要點(diǎn)3.1 AGC 匯編的幾個(gè)關(guān)鍵指令與陷阱AGC 匯編和現(xiàn)代 x86、ARM 匯編差異很大有幾個(gè)點(diǎn)新手特別容易踩坑。首先是累加器架構(gòu)。AGC 只有一個(gè)主累加器 A很多運(yùn)算都要圍繞它轉(zhuǎn)寫代碼時(shí)腦子里要始終清楚當(dāng)前 A 里是什么。這和現(xiàn)代多寄存器架構(gòu)的思維習(xí)慣完全不同。其次是指令的隱式行為。比如CCSCount, Compare, and Skip這條指令它會(huì)根據(jù)累加器的值做一系列判斷并可能跳過(guò)下一條指令行為比較復(fù)雜源碼里大量用它來(lái)做分支。如果不理解它的完整語(yǔ)義讀代碼會(huì)非常痛苦。再就是內(nèi)存尋址。AGC 的尋址方式和現(xiàn)代匯編不同有直接尋址、間接尋址還有通過(guò)INDEX寄存器做變址。源碼里INDEX用得很多讀的時(shí)候要時(shí)刻跟蹤當(dāng)前索引值。提示讀 AGC 匯編時(shí)建議手邊放一份指令集速查表遇到不熟悉的指令先查語(yǔ)義再往下讀不要靠猜。猜錯(cuò)一次后面整段邏輯都會(huì)理解偏。3.2 源碼目錄結(jié)構(gòu)與閱讀順序建議項(xiàng)目里的源碼不是一坨而是按功能模塊組織的。常見(jiàn)的劃分包括執(zhí)行控制、制導(dǎo)、導(dǎo)航、顯示與鍵盤、報(bào)警與重啟等。新手最容易犯的錯(cuò)是從第一個(gè)文件開(kāi)始順序讀結(jié)果讀到一半就迷失了。我的建議是從顯示與鍵盤模塊入手。原因很簡(jiǎn)單這部分邏輯相對(duì)獨(dú)立輸入輸出直觀你能很快看到按一個(gè)鍵程序怎么響應(yīng)建立信心和基本認(rèn)知。然后再看執(zhí)行控制理解程序的主循環(huán)和任務(wù)調(diào)度。最后再啃制導(dǎo)和導(dǎo)航這兩塊數(shù)學(xué)和邏輯最重需要前面打好的基礎(chǔ)。閱讀時(shí)建議配合模擬器邊讀邊跑看到某個(gè)分支就手動(dòng)觸發(fā)一下觀察結(jié)果。這種讀-跑-驗(yàn)證的循環(huán)比純讀效率高得多。3.3 匯編器與模擬器的獲取和構(gòu)建要點(diǎn)實(shí)操層面你需要先把工具鏈跑起來(lái)。通常的流程是獲取項(xiàng)目源碼構(gòu)建匯編器用匯編器把 AGC 源碼匯編成二進(jìn)制再構(gòu)建模擬器用模擬器加載二進(jìn)制運(yùn)行。構(gòu)建過(guò)程中有幾個(gè)注意點(diǎn)。第一編譯環(huán)境要匹配這類項(xiàng)目往往對(duì)編譯器版本、依賴庫(kù)有要求太新或太舊的工具鏈都可能出問(wèn)題。第二匯編器的輸出要和參考二進(jìn)制比對(duì)如果項(xiàng)目提供了校驗(yàn)機(jī)制一定要用上這是確認(rèn)你構(gòu)建正確的關(guān)鍵。第三模擬器的輸入輸出配置要搞清楚DSKY 的按鍵映射、顯示格式都需要熟悉否則跑起來(lái)你也不知道怎么操作。注意構(gòu)建失敗時(shí)先看錯(cuò)誤是出在依賴缺失、版本不匹配還是源碼本身。不要一上來(lái)就改源碼絕大多數(shù)問(wèn)題出在環(huán)境上。4. 實(shí)操過(guò)程與核心環(huán)節(jié)實(shí)現(xiàn)4.1 環(huán)境準(zhǔn)備與工具鏈搭建假設(shè)你在一臺(tái)常見(jiàn)的開(kāi)發(fā)機(jī)上操作整體流程可以拆成幾步。第一步是準(zhǔn)備基礎(chǔ)環(huán)境包括合適的編譯器和構(gòu)建工具。第二步是獲取項(xiàng)目源碼注意選擇穩(wěn)定的版本。第三步是構(gòu)建匯編器這一步通常會(huì)產(chǎn)出一個(gè)可執(zhí)行文件。第四步是用匯編器處理 AGC 源碼生成二進(jìn)制。第五步是構(gòu)建模擬器并加載二進(jìn)制。這里我強(qiáng)調(diào)一個(gè)細(xì)節(jié)每一步都要單獨(dú)驗(yàn)證。匯編器構(gòu)建完先拿一個(gè)最簡(jiǎn)單的測(cè)試匯編文件跑一下確認(rèn)它能正確輸出。不要等全部搭完再一起調(diào)試那樣出問(wèn)題很難定位。4.2 匯編流程與參數(shù)說(shuō)明匯編階段的核心是把源碼翻譯成機(jī)器碼。通常命令形式是匯編器接收源碼文件輸出二進(jìn)制文件可能還需要指定輸出格式或目標(biāo)配置。參數(shù)不多但每個(gè)都要理解含義。比如輸出格式參數(shù)決定了二進(jìn)制是按什么布局組織的這直接影響模擬器能否正確加載。再比如某些項(xiàng)目支持生成列表文件listing里面會(huì)標(biāo)注每條源碼對(duì)應(yīng)的機(jī)器碼和地址這個(gè)文件對(duì)調(diào)試極其有用強(qiáng)烈建議開(kāi)啟。匯編完成后如果項(xiàng)目提供了參考二進(jìn)制用比對(duì)工具如校驗(yàn)和或逐字節(jié)比較確認(rèn)輸出一致。這一步是信任基石比對(duì)通過(guò)說(shuō)明你的工具鏈?zhǔn)菍?duì)的后面模擬器跑出來(lái)的結(jié)果才可信。4.3 模擬器運(yùn)行與 DSKY 操作模擬器跑起來(lái)后你會(huì)看到一個(gè)模擬的 DSKY 界面包括數(shù)字顯示和按鍵區(qū)。AGC 的程序通過(guò) DSKY 和宇航員交互比如輸入指令、查看狀態(tài)、觸發(fā)特定功能。操作時(shí)要注意AGC 的輸入是有格式和時(shí)序要求的。比如輸入一個(gè)動(dòng)詞Verb和一個(gè)名詞Noun來(lái)指定要執(zhí)行的操作順序和確認(rèn)方式都有講究。剛開(kāi)始建議照著項(xiàng)目文檔里的示例一步步來(lái)熟悉之后再自己探索。運(yùn)行過(guò)程中模擬器通常會(huì)輸出一些狀態(tài)信息比如當(dāng)前執(zhí)行的指令地址、寄存器值等。這些信息是理解程序行為的關(guān)鍵建議開(kāi)一個(gè)終端專門看日志邊操作邊觀察。4.4 一個(gè)可復(fù)現(xiàn)的最小驗(yàn)證案例為了讓你有明確的成功標(biāo)準(zhǔn)我給一個(gè)最小驗(yàn)證路徑構(gòu)建好工具鏈后匯編一份源碼加載進(jìn)模擬器然后通過(guò) DSKY 輸入一個(gè)簡(jiǎn)單的查看指令觀察顯示是否和預(yù)期一致。如果顯示正確說(shuō)明整條鏈路是通的。這個(gè)案例看似簡(jiǎn)單但它覆蓋了匯編、加載、運(yùn)行、交互全流程。很多人卡在中間某一步卻不自知用這個(gè)最小案例可以快速定位問(wèn)題出在哪一環(huán)。我實(shí)測(cè)下來(lái)只要環(huán)境沒(méi)問(wèn)題這條路徑通常能在較短時(shí)間內(nèi)跑通。5. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 構(gòu)建與匯編階段的典型問(wèn)題這個(gè)階段最常見(jiàn)的問(wèn)題是依賴缺失和版本不匹配。表現(xiàn)是編譯報(bào)錯(cuò)提示找不到某個(gè)頭文件或庫(kù)。解決思路是先確認(rèn)依賴是否安裝再確認(rèn)版本是否符合要求。如果項(xiàng)目文檔給了推薦版本盡量照做不要自作主張用最新版。另一個(gè)常見(jiàn)問(wèn)題是匯編輸出和參考不一致。這時(shí)候要檢查源碼版本是否對(duì)應(yīng)、匯編器參數(shù)是否正確、是否有平臺(tái)相關(guān)的差異。逐項(xiàng)排除通常能定位到原因。5.2 模擬器運(yùn)行階段的典型問(wèn)題模擬器跑不起來(lái)常見(jiàn)原因有幾個(gè)。一是二進(jìn)制格式不對(duì)模擬器加載失敗。二是模擬器配置錯(cuò)誤比如內(nèi)存大小、時(shí)鐘頻率設(shè)置不對(duì)。三是 DSKY 交互沒(méi)反應(yīng)可能是按鍵映射沒(méi)配對(duì)或者程序本身在等待某個(gè)條件。排查時(shí)建議先看模擬器的日志輸出大多數(shù)模擬器會(huì)打印加載地址、執(zhí)行狀態(tài)等信息。日志是定位問(wèn)題的第一手材料比盲目改配置有效得多。5.3 常見(jiàn)問(wèn)題速查表問(wèn)題現(xiàn)象可能原因排查方向編譯報(bào)錯(cuò)找不到依賴依賴未安裝或版本不符檢查依賴列表按推薦版本安裝匯編輸出與參考不一致源碼版本或參數(shù)錯(cuò)誤核對(duì)版本檢查匯編參數(shù)模擬器加載二進(jìn)制失敗格式或路徑問(wèn)題確認(rèn)輸出格式檢查文件路徑DSKY 按鍵無(wú)響應(yīng)映射錯(cuò)誤或程序等待檢查按鍵映射觀察程序狀態(tài)運(yùn)行結(jié)果與預(yù)期不符工具鏈或源碼問(wèn)題回到最小驗(yàn)證案例逐步排查5.4 獨(dú)家避坑經(jīng)驗(yàn)踩過(guò)幾次之后我總結(jié)了幾條經(jīng)驗(yàn)。第一不要跳過(guò)最小驗(yàn)證案例它能幫你快速區(qū)分是環(huán)境問(wèn)題還是理解問(wèn)題。第二保留每一步的中間產(chǎn)物匯編輸出的二進(jìn)制、列表文件都留著出問(wèn)題時(shí)可以回溯。第三善用列表文件它把源碼、地址、機(jī)器碼對(duì)應(yīng)起來(lái)是理解程序行為的最佳工具。第四遇到不懂的指令先查再讀AGC 匯編的隱式行為多靠猜必翻車。還有一點(diǎn)很重要這個(gè)項(xiàng)目的價(jià)值不在于跑通而在于讀懂。跑通只是入場(chǎng)券真正花時(shí)間的地方是理解每一段代碼為什么這么寫。我個(gè)人的做法是每讀一個(gè)模塊就用自己的話把它的邏輯寫一遍寫不出來(lái)說(shuō)明還沒(méi)真懂。6. 這段代碼對(duì)現(xiàn)代開(kāi)發(fā)者的實(shí)際啟發(fā)6.1 極端約束下的工程取舍思維AGC 的代碼里到處是取舍。內(nèi)存不夠就復(fù)用速度不夠就精簡(jiǎn)算法可靠性要求高就設(shè)計(jì)多重校驗(yàn)和重啟機(jī)制。這些取舍背后是一套清晰的優(yōu)先級(jí)安全第一功能第二效率第三。現(xiàn)代開(kāi)發(fā)環(huán)境寬松得多但這種取舍思維依然有用。當(dāng)你做嵌入式、做實(shí)時(shí)系統(tǒng)、做性能敏感的應(yīng)用時(shí)資源永遠(yuǎn)是有限的如何在有限資源下保證核心功能可靠AGC 給出了一個(gè)教科書級(jí)的答案。6.2 實(shí)時(shí)系統(tǒng)設(shè)計(jì)的早期范本AGC 是一個(gè)典型的實(shí)時(shí)系統(tǒng)它要在嚴(yán)格的時(shí)間約束下響應(yīng)外部事件完成任務(wù)調(diào)度。源碼里的任務(wù)優(yōu)先級(jí)、中斷處理、看門狗機(jī)制雖然實(shí)現(xiàn)方式古老但設(shè)計(jì)思想至今通用。我建議做實(shí)時(shí)系統(tǒng)的朋友認(rèn)真看看它的調(diào)度邏輯尤其是它如何在資源極度緊張的情況下保證關(guān)鍵任務(wù)不被耽誤。這種把好鋼用在刀刃上的思路比很多現(xiàn)代框架的默認(rèn)配置更值得琢磨。6.3 歷史代碼復(fù)現(xiàn)項(xiàng)目的通用方法論最后說(shuō)點(diǎn)方法論層面的東西。Apollo-11 這個(gè)項(xiàng)目展示了一套復(fù)現(xiàn)歷史代碼的通用做法先保證可編譯再保證可運(yùn)行最后保證可驗(yàn)證。這個(gè)順序很重要每一步都建立在前一步可信的基礎(chǔ)上。如果你以后遇到類似的歷史代碼項(xiàng)目不管是哪個(gè)年代的都可以套用這個(gè)思路。先搭工具鏈再跑最小案例再逐步深入。不要一上來(lái)就想讀懂全部那不現(xiàn)實(shí)也沒(méi)必要。我個(gè)人在實(shí)際操作中的體會(huì)是這類項(xiàng)目的真正門檻不在技術(shù)而在耐心。工具鏈搭建會(huì)煩指令集陌生會(huì)累但只要按部就班每一步都驗(yàn)證最后一定能把這段五十多年前的代碼跑起來(lái)、讀明白。而當(dāng)你真的看到模擬器里 DSKY 亮起、程序按預(yù)期響應(yīng)時(shí)那種跨越半個(gè)多世紀(jì)和前輩工程師對(duì)話的感覺(jué)是任何現(xiàn)代教程都給不了的。