Code::Blocks 整合 MSP430-GCC 工具鏈開發指南

1. 設定編譯器路徑

選單 Settings → Compiler → Toolchain executables：

• Compiler's installation directory：指向 MSP430-GCC 安裝根目錄（含 bin/、include/、lib/）
• Additional paths：加入裝置支援檔目錄（如 msp430-elf/include）
• Search directories → Compiler：加入標頭檔搜尋路徑
• Search directories → Linker：加入連結腳本搜尋路徑

2. 建立專案

File → New → Project → Empty project，選擇 MSP430-GCC 編譯器。

3. 專案建置選項設定

Project → Build options → [專案名稱]（非 Debug/Release 子目標）：

3.1 一般選項

• 優化等級：-Os（體積優化）或 -O2
• MCU 型號：-mmcu=msp430g2553（若清單無所需型號，手動輸入如 -mmcu=msp430afe253）

3.2 連結器設定

• Linker settings → Other linker options：-Wl,-Map=output.map 產出映射檔
• Search directories → Linker：加入 C:\HighTec\MSP430\msp430\lib\ldscripts\msp430afe253（對應 MCU 的連結腳本目錄）

3.3 建置後步驟（Post-build steps）

# 產生 Intel HEX 檔案供燒錄器使用
msp430-objcopy -O ihex $(TARGET_OUTPUT_FILE) $(TARGET_OUTPUT_DIR)$(TARGET_OUTPUT_BASENAME).hex

# 顯示程式碼/資料/總大小
msp430-size $(TARGET_OUTPUT_FILE)

4. 專案屬性 → 建置目標

確認輸出檔名、輸出目錄、型別（Executable）。

5. 常見問題排查

• 找不到標頭檔：檢查 Compiler search directories 是否包含裝置專屬 include 路徑。
• 連結錯誤 undefined reference：確認連結腳本路徑正確、-mmcu 與腳本匹配。
• HEX 檔未產生：檢查 Post-build steps 命令拼寫、工具路徑是否在 PATH 中。

此配置可在 Code::Blocks 內完成 MSP430 專案的編輯、編譯、連結、HEX 產出與大小檢視全流程。