1. 為什么要在 Ubuntu 上折騰 nRF Connect SDK如果你手里有一塊 nRF52、nRF53 或者 nRF91 系列的開發(fā)板想在 Ubuntu 上把開發(fā)環(huán)境一次性搭好那 nRF Connect SDK 基本是繞不開的選擇。它底層是 Zephyr RTOSNordic 在上面封裝了自己的協(xié)議棧、驅(qū)動(dòng)和例程藍(lán)牙、Thread、Zigbee、蜂窩、Wi-Fi 這些都能用同一套構(gòu)建系統(tǒng)跑起來(lái)。對(duì)嵌入式工程師來(lái)說(shuō)好處是工程結(jié)構(gòu)統(tǒng)一壞處是初次安裝的依賴鏈條比較長(zhǎng)VS Code 插件、Toolchain、SDK 本體、west 多倉(cāng)庫(kù)管理、J-Link 燒錄工具任何一環(huán)版本對(duì)不上都會(huì)卡住。這篇是「第0篇」目標(biāo)很明確在 Ubuntu 上從零把 nRF Connect SDK 裝進(jìn) VS Code能編譯、能燒錄同時(shí)把 TaoToken 的統(tǒng)一 Key 通道接進(jìn)來(lái)方便后面用 AI 輔助寫代碼、查報(bào)錯(cuò)、生成 Devicetree 片段。我試過(guò)在 Ubuntu 22.04 和 24.04 上各裝一遍踩過(guò)的坑主要集中在 Toolchain 下載慢、west update 網(wǎng)絡(luò)中斷、以及 VS Code 找不到 SDK 路徑這三處下面會(huì)逐個(gè)給可復(fù)制的命令和檢查動(dòng)作。適合誰(shuí)看剛拿到 Nordic 開發(fā)板、第一次在 Linux 下搭 Zephyr 環(huán)境的嵌入式工程師或者之前用 Windows 裝過(guò)現(xiàn)在想遷到 Ubuntu 的人。全程不需要特殊網(wǎng)絡(luò)手段按步驟走即可。2. TaoToken 前置準(zhǔn)備統(tǒng)一 Key 與 API 通道nRF Connect SDK 本身是本地編譯工具鏈和 AI 通道沒有強(qiáng)綁定。但實(shí)際開發(fā)里你經(jīng)常需要讓 AI 幫你讀 Kconfig、解釋 Devicetree 報(bào)錯(cuò)、生成 CMake 片段這時(shí)候如果每個(gè)工具都單獨(dú)配 Key 就很煩。TaoToken 的思路是提供一個(gè)統(tǒng)一的 Key 和 API 入口兼容 OpenAI 風(fēng)格的調(diào)用方式VS Code 里的 AI 插件、命令行工具、Coding Agent 都能指向同一個(gè)地址。你需要先拿到兩樣?xùn)|西一個(gè) API Key以及確認(rèn) API 基地址。注冊(cè)和創(chuàng)建 Key 的入口在控制臺(tái)地址是 https://taotoken.net/console 登錄后在 API Keys 頁(yè)面新建一個(gè) Key復(fù)制出來(lái)保存好后面配置里會(huì)用到。API 基地址統(tǒng)一用 https://taotoken.net/api 注意這個(gè)地址不帶任何查詢參數(shù)直接作為 base_url 填進(jìn)去。如果你后面打算長(zhǎng)期用 AI 做編碼輔助比如讓 Agent 自動(dòng)改代碼、跑構(gòu)建可以了解一下 Coding Plan入口在 https://taotoken.net/coding-plan 。它更適合高頻、長(zhǎng)會(huì)話的編碼場(chǎng)景比單次對(duì)話更劃算。只是想驗(yàn)證模型通不通用模型對(duì)話頁(yè)面就夠了https://taotoken.net/models 。這里要強(qiáng)調(diào)一點(diǎn)TaoToken 是正常的 API 服務(wù)通道配置時(shí)只填 base_url 和 Key不要引入任何額外的網(wǎng)絡(luò)層工具。所有請(qǐng)求走標(biāo)準(zhǔn) HTTPSUbuntu 下用 curl 就能直接驗(yàn)證。3. 可復(fù)制配置VS Code settings.json 與 config.toml 骨架這一節(jié)給兩份可直接粘貼的配置。第一份是 VS Code 的 settings.json用來(lái)讓 nRF Connect 插件知道 SDK 和 Toolchain 的位置第二份是給命令行 AI 工具用的 config.toml把 TaoToken 的 Key 和地址寫進(jìn)去。先說(shuō) VS Code。安裝擴(kuò)展包「nRF Connect for VS Code Extension Pack」之后插件默認(rèn)會(huì)把 SDK 和 Toolchain 放在~/ncs和~/.nrfutil下。如果你按默認(rèn)路徑裝settings.json 里其實(shí)不用寫太多但如果你像我一樣把 SDK 放到別的盤就要顯式指定。打開 VS Code 的 settings.jsonCtrlShiftP 輸入 Open User Settings JSON加入下面這段{ nrf-connect.toolchain.path: /home/yourname/.nrfutil/toolchains, nrf-connect.sdk.path: /home/yourname/ncs/v2.7.0, nrf-connect.west.path: /home/yourname/.local/bin/west, nrf-connect.topdir: /home/yourname/ncs/v2.7.0, nrf-connect.defaultBoard: nrf52840dk_nrf52840, C_Cpp.default.compilerPath: /home/yourname/.nrfutil/toolchains/*/bin/arm-zephyr-eabi-gcc }把yourname換成你的實(shí)際用戶名。nrf-connect.topdir指向 SDK 根目錄插件靠它找west.yml。defaultBoard按你手上的板子改nRF52840 DK 就是nrf52840dk_nrf52840nRF5340 DK 是nrf5340dk_nrf5340_cpuapp。再說(shuō) config.toml。很多命令行 AI 工具包括一些 Coding Agent用 TOML 存配置。在~/.config/taotoken/config.toml下建文件內(nèi)容如下[api] base_url https://taotoken.net/api api_key sk-你的Key model gpt-4o-mini timeout 60 [workspace] project_root /home/yourname/ncs/v2.7.0base_url一定不要加尾部斜杠也不要加/v1之外的多余路徑標(biāo)準(zhǔn) OpenAI 兼容接口會(huì)自動(dòng)補(bǔ)/v1/chat/completions。Key 從控制臺(tái)復(fù)制別寫進(jìn) Git 倉(cāng)庫(kù)建議這個(gè)文件權(quán)限設(shè)成 600chmod 600 ~/.config/taotoken/config.toml4. 驗(yàn)證請(qǐng)求SDK 工具鏈與 TaoToken 通道連通性配置寫完必須驗(yàn)證不然編譯報(bào)錯(cuò)你分不清是 SDK 問(wèn)題還是 Key 問(wèn)題。分兩步走。第一步驗(yàn)證 nRF 工具鏈。先確認(rèn) west 裝好了pip3 install --user west west --version正常會(huì)輸出West version: v1.2.0之類的版本號(hào)。如果提示 command not found把~/.local/bin加進(jìn) PATHecho export PATH$HOME/.local/bin:$PATH ~/.bashrc source ~/.bashrc然后進(jìn) SDK 目錄做一次 west update 和 zephyr-exportcd ~/ncs/v2.7.0 west update west zephyr-exportwest update會(huì)拉一堆倉(cāng)庫(kù)網(wǎng)絡(luò)不穩(wěn)就多跑幾次它支持?jǐn)帱c(diǎn)續(xù)傳。完成后驗(yàn)證工具鏈west build -b nrf52840dk_nrf52840 zephyr/samples/hello_world能走到Building C object并最終生成zephyr.hex就說(shuō)明工具鏈沒問(wèn)題。產(chǎn)物在build/zephyr/zephyr.hex。第二步驗(yàn)證 TaoToken 通道。用 curl 直接打 APIcurl -s https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: gpt-4o-mini, messages: [{role: user, content: 回復(fù) ok}] }返回 JSON 里choices[0].message.content有內(nèi)容就說(shuō)明 Key 和地址都對(duì)。如果返回 401檢查 Key 有沒有多余空格返回 404檢查 base_url 是不是寫成了帶路徑的形式。這一步通了后面 VS Code 里的 AI 插件、命令行 Agent 都能復(fù)用同一份配置。燒錄驗(yàn)證也順手做掉。裝 J-Link 和 nRF 命令行工具sudo dpkg -i JLink_Linux_V788m_x86_64.deb sudo dpkg -i nrf-command-line-tools_10.24.0_amd64.deb插上開發(fā)板執(zhí)行nrfjprog --ids能列出板子序列號(hào)就說(shuō)明燒錄鏈路通了。然后west flash把 hello_world 燒進(jìn)去串口終端應(yīng)該能看到輸出。5. 本篇常見錯(cuò)排查裝 nRF Connect SDK 最容易卡在幾個(gè)固定位置這里按報(bào)錯(cuò)現(xiàn)象給排查路徑。Toolchain 下載卡住或超時(shí)。VS Code 插件里點(diǎn)安裝 Toolchain 后進(jìn)度條不動(dòng)多半是下載源慢?？梢愿挠?nrfutil 命令行裝nrfutil toolchain-manager install --ncs-version v2.7.0裝完用nrfutil toolchain-manager list確認(rèn)。如果還是慢就換時(shí)間段重試或者用離線包。west update 報(bào)錯(cuò)unknown host或中途斷開。這是倉(cāng)庫(kù)多、單次拉取量大導(dǎo)致的。先git config --global http.postBuffer 524288000加大緩沖再重跑west update。已經(jīng)拉下來(lái)的倉(cāng)庫(kù)不會(huì)重復(fù)下載。VS Code 提示找不到 SDK。檢查 settings.json 里nrf-connect.sdk.path是否指向含west.yml的那一層。注意 SDK 根目錄下應(yīng)該有nrf、zephyr、modules這些文件夾如果指到了上一層就會(huì)報(bào)錯(cuò)。編譯報(bào)arm-zephyr-eabi-gcc not found。說(shuō)明 Toolchain 沒被 CMake 識(shí)別。在 VS Code 里按 CtrlShiftP 執(zhí)行nRF Connect: Build插件會(huì)重新掃描 Toolchain。或者手動(dòng)確認(rèn)~/.nrfutil/toolchains下有對(duì)應(yīng)版本目錄。TaoToken 返回 401 或 403。先確認(rèn) Key 沒寫錯(cuò)再用 curl 單獨(dú)測(cè)。如果 curl 通、插件不通檢查插件里 base_url 是否被自動(dòng)加了/v1導(dǎo)致重復(fù)。標(biāo)準(zhǔn)填法是https://taotoken.net/api讓客戶端自己補(bǔ)路徑。燒錄報(bào)No J-Link found。Ubuntu 下需要 udev 規(guī)則把 SEGGER 的規(guī)則文件拷過(guò)去sudo cp /opt/SEGGER/JLink_Linux_V788m_x86_64/99-jlink.rules /etc/udev/rules.d/ sudo udevadm control --reload-rules重新插拔開發(fā)板即可。6. 后續(xù)怎么用這套環(huán)境環(huán)境搭好之后日常開發(fā)流程就是VS Code 里用 nRF Connect 插件建工程、選板子、編譯、燒錄遇到 Kconfig 或 Devicetree 報(bào)錯(cuò)時(shí)把報(bào)錯(cuò)貼給接了 TaoToken 的 AI 工具讓它結(jié)合 SDK 版本給修改建議。因?yàn)?Key 是統(tǒng)一的你在 VS Code 插件、命令行、Coding Agent 里不用重復(fù)配置換工具只改一處。需要新建 Key 或者查看用量去控制臺(tái)https://taotoken.net/console 。API 接入細(xì)節(jié)和參數(shù)說(shuō)明看文檔https://taotoken.net/doc 。如果你主要用 Claude Code 這類 Agent 做長(zhǎng)期編碼Anthropic 兼容入口在 https://taotoken.net/claudecode-anthropic 配置方式類似把 base_url 換成對(duì)應(yīng)地址即可。模型對(duì)話驗(yàn)證還是用 https://taotoken.net/models 快速確認(rèn)某個(gè)模型能不能調(diào)通。下一篇會(huì)講怎么在 nRF Connect SDK 里建第一個(gè)自定義工程把 Devicetree overlay 和 Kconfig 片段接進(jìn)構(gòu)建系統(tǒng)并用 AI 輔助生成板級(jí)配置。