Nimmake 厂商型号系统 — 一句话搞定芯片编译配置**告别翻阅数据手册查编译参数只需指定厂商和型号Nimmake 自动帮你配好一切。**你是否曾为以下问题头疼过❓ STM32F407 的 CPU 是 Cortex-M4 还是 M3FPU 用 hard 还是 softfp❓ GD32VF103 是 RISC-V 架构编译参数和 ARM 完全不同怎么配❓ ESP32C3 是 RISC-VESP32S3 是 Xtensa同一份代码如何优雅切换❓ 每次换芯片都要重新查-mcpu、-march、-mabi、-mfpuNimmake 的VENDOR_MODEL_OF系统就是为了解决这些痛点而生。你只需要记住芯片的厂商和型号剩下的事情交给 Nimmake。 原理一句话Nimmake 内置了一个芯片配置数据库将常见 MCU 的厂商、型号、CPU 内核、FPU、ABI 等参数预先关联好好厂商 (Vendor) 型号 (Model) → 完整编译配置 (FlagsConfig)以 STM32F407 为例查找路径: Vendor.ST “STM32F407”→ CORTEX_M4_CFG (cpucortex-m4, fpuhard)→ 设置 vendor“STMicroelectronics”→ 设置 model“STM32F407”→ FlagsConfig 完整就绪就绪--- 下面是整个查找与匹配过程的流程图 mermaid flowchart TD A[输入: Vendor.ST STM32F407] -- B[查询芯片配置数据库] B -- C{匹配 vendor model} C -- 匹配成功 -- D[返回 FlagsConfig 实例] C -- 未找到 -- E[抛出提示 / 手动创建配置] D -- F[设置 vendor / model / cpu / fpu / abi] F -- G[FlagsConfig 完整就绪] 快速使用最简用法 — 一行代码出配置fromnimmake.datasetsimportVENDOR_MODEL_OF,Vendorfromnimmake.HelperimportHelper hlpHelper()# ★ 核心只需指定厂商和型号CFGVENDOR_MODEL_OF(Vendor.ST,STM32F407)hlp.Config(CFG)# 后续配置工具链...hlp.Update({TOOLPATH:rD:\LLVM\arm-none-eabi-gcc14\bin,TOOL:gcc,TOOL_PREFIX:arm-none-eabi-})hlp.Refresh()# 查看自动生成的编译标志print(hlp.Flags)输出示例-mcpucortex-m4 -mfpufpv4-sp-d16 -mfloat-abihard -mthumb -O2 -g -Wall -fdata-sections -ffunction-sections -DSTM32F407 -DSTM32F4 -DSTM32 ## 内置芯片支持一览配置 | 厂商 | Vendor 枚举 | 支持的型号 | 架构 | | ---------------------- | --------------- | -------------------------------------------------- | ----------------------------- | | **STMicroelectronics** | Vendor.ST | STM32F407, STM32F103, STM32H743, STM32G474 | ARM Cortex-M4/M3/M7 | | **GigaDevice** | Vendor.GD | GD32F407, GD32VF103 | ARM Cortex-M4 / **RISC-V** | | **Espressif** | Vendor.ESP | ESP32C3, ESP32S3 | **RISC-V** / Xtensa | | **Nordic** | Vendor.NORDIC | NRF52840, NRF5340 | ARM Cortex-M4/M33 | | **NXP** | Vendor.NXP | MIMXRT1062 | ARM Cortex-M7 | | **TI** | Vendor.TI | TM4C129 | ARM Cortex-M4 | **RISC-V 特别支持**GD32VF103RISC-V、ESP32C3RISC-V均已内置自动生成 -marchrv32imac / -mabiilp32 等参数无需手动配置。 下面是快速使用的完整调用链路 mermaid flowchart LR A[VENDOR_MODEL_OF(Vendor.ST, STM32F407)] -- B[hlp.Config(CFG)] B -- C[hlp.Update(工具链路径)] C -- D[hlp.Refresh()] D -- E[print(hlp.Flags)] E -- F[输出完整编译标志] ### 传统方式需要 makefilemakefileSTM32F407 的编译参数CPU -mcpucortex-m4FPU -mfpufpv4-sp-d16 -mfloat-abihardFLAGS $(CPU) $(FPU) -mthumb -O2 -g -WallGD32VF103 (RISC-V) 的编译参数完全不同ARCH -marchrv32imac -mabiilp32 -mcmodelmedanyFLAGS $(ARCH) -O2 -g -WallESP32C3 (RISC-V) 又是另一套ARCH -marchrv32imac -mabiilp32FLAGS $(ARCH) -Os -g -Wall每次换芯片都得翻 datasheet而且很容易搞错。2️⃣ 在预设基础上自定义覆盖# 获取 STM32F407 的基础配置CFGVENDOR_MODEL_OF(Vendor.ST,STM32F407)# 在预设基础上自定义修改CFG.set(opt,O0)# 关闭优化方便调试CFG.set(dbg,True)# 开启调试信息CFG.set(linkscript,custom/stm32f4.ld)# 自定义链接脚本hlp.Config(CFG)3️⃣ 通过厂商获取基础架构配置不指定型号# 获取 STM32F4 系列的基础配置不锁定具体型号CFGVENDOR_MODEL_OF(Vendor.ST,)# 返回 STM_F4_CFG# 此时 cfg.cpu cortex-m4, cfg.vendor STMicroelectronics# 你可以在后续动态设置型号4️⃣ 与 Party 系统联动CFGVENDOR_MODEL_OF(Vendor.ST,STM32F407)hlp.Config(CFG)hlp.Refresh()# 将芯片参数传递给 Party 模块PARTY_PARAM{CPU:hlp._cfg.cpu,# cortex-m4ABI:hlp._cfg.abi,# hardFPU:hlp._cfg.fpu,# fpv4-sp-d16MODEL:hlp._cfg.model,# STM32F407}corehlp.Parties(CORE,Core,paramsPARTY_PARAM) 下面是传统方式与 Nimmake 方式的对比流程 mermaid flowchart TB subgraph TRAD[传统方式]T1[翻阅数据手册]--T2[手动查 -mcpu / -march / -mabi / -mfpu]T2--T3[手写 Makefile 编译参数]T3--T4[换芯片需重新查一遍]end subgraph NIMM[Nimmake 方式]N1[只记厂商 型号]--N2[VENDOR_MODEL_OF 自动匹配]N2--N3[自动生成完整编译参数]N3--N4[换芯片只需换一行代码]end TRAD--|对比|N️ 完整工作流程VENDOR_MODEL_OF(Vendor.ST, STM32F407) │ ▼ ┌─ FLAGS_CFG_VENDOR_MODEL 列表 ──────────────────────┐ │ [STM32F407, STM32F103, GD32VF103, ESP32C3, ...] │ │ 逐个匹配 vendor model │ └─────────────────────────────────────────────────────┘ │ 匹配成功 ▼ FlagsConfig 实例: cpu: cortex-m4 fpu: fpv4-sp-d16 abi: hard vendor: STMicroelectronics model: STM32F407 │ ▼ hlp.Config(CFG) hlp.Refresh() │ ▼ 自动生成完整编译参数: -mcpucortex-m4 -mfpufpv4-sp-d16 -mfloat-abihard -mthumb -O2 -g -Wall -fdata-sections -ffunction-## 配置对照表匹配正确的架构参数匹配正确的架构参数 | 芯片 | 架构 | CPU | ABI | FPU | 来源 | | ---------- | ------------- | --------- | ------ | ----------- | ------------------- | | STM32F407 | ARM | cortex-m4 | hard | fpv4-sp-d16 | CORTEX_M4_CFG | | STM32F103 | ARM | cortex-m3 | softfp | - | CORTEX_M3_CFG | | STM32H743 | ARM | cortex-m7 | hard | fpv5-d16 | CORTEX_M7_CFG | | GD32VF103 | **RISC-V** | rv32imac | ilp32 | - | RISCV_32_IMAC_CFG | | ESP32C3 | **RISC-V** | rv32imac | ilp32 | - | RISCV_32_IMAC_CFG | | ESP32S3 | Xtensa | xtensa | - | - | 自定义 | | NRF52840 | ARM | cortex-m4 | softfp | - | CORTEX_M4_CFG | | MIMXRT1062 | ARM | cortex-m7 | hard | fpv5-d16 | CORTEX_M7_CFG | --- ## 常见问题 ### Q: 找不到我的芯片怎么办 A: 你可以手动创建配置。VENDOR_MODEL_OF 本质上是返回 FlagsConfig 对象你可以手动构建 python from nimmake.datasets import CORTEX_M4_CFG # 手动组装自定义芯片配置 CFG CORTEX_M4_CFG.clone() CFG.set(vendor, MyVendor) CFG.set(model, MyChip) CFG.set(cpu, cortex-m4) CFG.set(fpu, fpv4-sp-d16) CFG.set(abi, hard) hlp.Config(CFG)Q: 如何查看当前芯片自动生成了哪些编译标志hlp.Config(CFG)hlp.Refresh()print(hlp.Flags)# 打印完整的编译标志Q: 厂商简写有哪些Vendor.ST# STMicroelectronicsVendor.GD# GigaDeviceVendor.ESP# EspressifVendor.NORDIC# NordicVendor.NXP# NXPVendor.TI#下面是完整工作流程的 Mermaid 版本 mermaid flowchart TD A[VENDOR_MODEL_OF(Vendor.ST, STM32F407)]--B[FLAGS_CFG_VENDOR_MODEL 列表]B--C[逐个匹配 vendor model]C--匹配成功--D[FlagsConfig 实例]D--E[hlp.Config(CFG)]E--F[hlp.Refresh()]F--G[自动生成完整编译参数]G--H[-mcpucortex-m4 -mfpufpv4-sp-dVendor.TI # TI..]TI--- ## 一句话总结 **VENDOR_MODEL_OF(厂商, 型号) → 用芯片型号说话让 Nimmake 处理剩下的编译参数。** bash pip install nimmakefromnimmake.datasetsimportVENDOR_MODEL_OF,Vendorfromnimmake.HelperimportHelper hlpHelper()hlp.Config(VENDOR_MODEL_OF(Vendor.ST,STM32F407))hlp.Update({TOOLPATH:rD:\tools\arm-gcc\bin,TOOL:gcc,TOOL_PREFIX:arm-none-eabi-})hlp.下面是整个系统的核心思想总结图 mermaid flowchart LR A[厂商 (Vendor)]--C[VENDOR_MODEL_OF]B[型号 (Model)]--C C--D[完整编译配置 (FlagsConfig)]D--E[自动生成编译参数]Refresh()# 编译参数已就绪
)
