移植鸿蒙系统到STM32L476RG_NUCLEO开发板的一点小经验

小嵌

移植鸿蒙系统到STM32L476RG_NUCLEO开发板的一点小经验,   
本帖最后由 死龙 于 2020-11-12 14:51 编辑

• https://gitee.com/walker2048/hmos_iot
  

复制代码 目前移植STM32L476的相关代码已上传在gitee，有兴趣的同学可以自行下载研究。

编译命令为 python build.py stm32l476rg_nucleo



移植鸿蒙的建议：

一步一步来，别想一口吃成胖子，给自己定计划。   

多看源码以及编译日志，多想，多动手 。

源码既是文档，别想着百度或者google能帮你直接解决问题。

修改完代码后，完成了小部分功能的，也要及时提交git。



1、第一步肯定是创建厂商文件夹

      首先按移植LiteOS教程里的说明，使用CubeMX工具生成makefile格式的项目（包含了stm32l4xx标准hal库和ll库实现代码及makefile），并把项目文件复制到vendor/st/stm32l4xx目录里。

这就是2020-11-06日  dbbaf5f  这个提交所包含的内容

然后在该目录执行命令  make > build.log，这样一是测试代码是否能正常编译，二是可以把stm官方提供的makefile实际执行指令信息存储到build.log文件里，方便以后修改gn系统的编译配置时做参考用。



2、第二步，配置编译环境及组件。

       根据以往阅读makefile和嵌入式开发经验，应该先确定编译工具链。不同硬件架构，需要的编译工具链并不一样，哪怕是一个最简单的helloworld，也没办法实现同一个bin文件，能在不同架构的硬件上直接运行。目前鸿蒙2.0配置好的两套编译工具（主要是gcc），并不能完成stm32的编译工作。

      打开build/lite/toolchain/目录，复制gcc.gni文件的内容到arm_none_eabi_gcc.gni，并将第14行的ohos_kernel_type （内核类型） 修改成liteos_m，并将15行的ohos_build_compiler_prefix 设置为正确的gcc工具前缀arm-none-eabi。其他内容暂时没动，然后根据其他开发板的设置，又复制粘贴了一遍各种配置，例如

• build/lite/config/boards/stm32l476rg_nucleo.gni
    
  
• 
  

复制代码 等等配置先抄一遍hi3861的，期间各种尝试使用编译命令python build.py stm32l476rg_nucleo，直到不再提示找不到stm32l476rg_nucleo目标板，进入下一个确认工具链环节为止。

这一环节中，比较重要的应该是build/lite/product/stm32l476rg_nucleo.json文件，该文件定义了目标板名称，编译工具链，内核等等重要信息。



当编译命令提示arm-none-eabi-gcc不是OHOS的编译器时，我也楞了一会儿。翻了build目录下各种配置也找不到对应配置时，我就放弃找配置了。直接在VScode中全局搜索包含not OHOS compiler字段的文件，最终在build/lite/config.py的124行和158行找到了对应判断语句，并增加了arm-none-eabi-gcc的判断语句。



随后测试编译时，又发现编译脚本会针对ohos_kernel_type 进行各种优化和设置。没办法，就只能搜索ohos_kernel_type == “liteos_riscv“，并将对应脚本一一修改

。涉及到的文件也很多，详细请看gitee上的变更记录。



最终各组件的配置判断语句没问题了，能顺利进入到编译状态，出现类似以下信息了

• 
    
  
• === start build ===
    
  
• 
    
  
• Done. Made 39 targets from 41 files in 648ms
    
  
• ninja: Entering directory `/mnt/out/stm32l476rg_nucleo\“
    
  
• [1/112] cross compiler obj/applications/sample/wifi-iot/app/demolink/helloworld.o
    
  
• [2/112] AR libs/libdemolink.a
  

复制代码 也就是说能出现[1/112]之类的，恭喜你，编译配置已经完成了80%了。期间还删除了大量容易出现问题的组件，例如wifi功能等等一堆组件。



3、调整头文件配置

     为了减少以后找文件找目录头疼，我在源码目录新建了一个include文件夹，并将疑似应该从厂商目录中提取出来的头文件放在该目录的hal目录下，并将难以解决的头文件错误组件去掉，不编译对应组件。

      最终编译命令都顺利通过了，只差最后一步生成elf和bin文件了。



4、根据原厂makefile修改和调整编译细节

      重头戏是此文件build/lite/toolchain/arm_none_eabi_gcc.gni

      查看原厂makefile的build.log文件，可以看出编译过程为

      .c文件=>.o文件，然后.S文件=>.o文件，然后将所有的.o文件以及

STM32L476RGTx_FLASH.ld文件一起链接成elf文件。最后再由elf文件生成bin和hex。

      多次尝试修改后，最终调整为以下内容

• template（“gcc_toolchain“） {
    
  
•     toolchain（target_name） {
    
  
•         assert（defined（invoker.cc）, “gcc toolchain must specify a \“cc\“ value“）
    
  
•         assert（defined（invoker.cxx）, “gcc toolchain must specify a \“cxx\“ value“）
    
  
•         assert（defined（invoker.ld）, “gcc toolchain must specify a \“ld\“ value“）
    
  
•         assert（defined（invoker.ar）, “gcc toolchain must specify a \“ar\“ value“）
    
  
•         assert（defined（invoker.as）, “clang toolchain must specify a \“as\“ value“）
    
  
•         assert（defined（invoker.cp）, “clang toolchain must specify a \“cp\“ value“）
    
  
•         
    
  
•         ar = invoker.ar
    
  
•         as = invoker.as
    
  
•         cc = invoker.cc
    
  
•         cxx = invoker.cxx
    
  
•         ld = invoker.ld
    
  
•         cp = invoker.cp
    
  
• 
    
  
•         need_strip = false
    
  
•         if（defined（invoker.strip）） {
    
  
•             strip = invoker.strip
    
  
•             need_strip = true
    
  
•         }
    
  
• 
    
  
•         if （defined（invoker.extra_ldflags） && invoker.extra_ldflags != ““） {
    
  
•           extra_ldflags = ““
    
  
•         } else {
    
  
•           extra_ldflags = ““
    
  
•         }
    
  
• 
    
  
•         tool（“cc“） {
    
  
•             command = “$cc -c {{cflags}} {{defines}} {{include_dirs}} {{cflags_c}} “ +
    
  
•                      # “-MMD -MP -MF‘{{source_out_dir}}/{{source_name_part}}.d’ “ +
    
  
•                      # “-Wa,-a,-ad,-alms={{source_out_dir}}/{{source_name_part}}.lst “ +
    
  
•                       “{{source}} -o {{output}}“
    
  
•             depsformat = “gcc“
    
  
•             description = “cross compiler {{output}}“
    
  
•             outputs = [
    
  
•                 “{{source_out_dir}}/{{source_name_part}}.o“,
    
  
•             ]
    
  
•         }
    
  
•         tool（“cxx“） {
    
  
•             depfile = “{{output}}.d“
    
  
•             command = “$cxx -c {{cflags}} {{defines}} {{include_dirs}} {{cflags_c}} “ +
    
  
•                      # “-MMD -MP -MF‘{{source_out_dir}}/{{source_name_part}}.d’ “ +
    
  
•                      # “-Wa,-a,-ad,-alms={{source_out_dir}}/{{source_name_part}}.lst “ +
    
  
•                       “{{source}} -o {{output}}“
    
  
•             depsformat = “gcc“
    
  
•             description = “CXX {{output}}“
    
  
•             outputs = [
    
  
•                 “{{source_out_dir}}/{{target_output_name}}.{{source_name_part}}.o“,
    
  
•             ]
    
  
•         }
    
  
•         tool（“asm“） {
    
  
•             depfile = “{{output}}.d“
    
  
•             command = “$as -c {{cflags}} {{defines}} {{include_dirs}} {{asmflags}} {{source}} {{cflags_c}} “ +
    
  
•                       “-o {{output}}“
    
  
•             depsformat = “gcc“
    
  
•             description = “cross compiler {{output}}“
    
  
•             outputs = [
    
  
•                 “{{source_out_dir}}/{{source_name_part}}.o“
    
  
•             ]
    
  
•         }
    
  
•         tool（“alink“） {
    
  
•             outfile = “{{output_dir}}/{{target_output_name}}{{output_extension}}“
    
  
•             rspfile = “{{output}}.rsp“
    
  
•             rspfile_content = “{{inputs}}“
    
  
•             command = “$ar cr {{output}} @\“$rspfile\““
    
  
• 
    
  
•             description = “AR {{output}}“
    
  
•             outputs = [
    
  
•                 outfile
    
  
•             ]
    
  
• 
    
  
•             default_output_dir = “{{root_out_dir}}/libs“
    
  
•             default_output_extension = “.a“
    
  
•             output_prefix = “lib“
    
  
•         }
    
  
•         tool（“link“） {
    
  
•             outfile = “{{output_dir}}/bin/{{target_output_name}}.elf“
    
  
•             rspfile = “$outfile.rsp“
    
  
•             command = “$ld {{inputs}} {{ldflags}} $extra_ldflags -specs=nano.specs “ +
    
  
•             # set ld file patch in vendor path
    
  
•                       “-lc -lm -lnosys {{libs}} -Wl,-Map={{target_output_name}}.map,--cref “ +
    
  
•                       “-Wl,--gc-sections -o $outfile “
    
  
•             if（need_strip） {
    
  
•                 command += “&& $cp -O binary -S $outfile {{output_dir}}/bin/{{target_output_name}}.bin“
    
  
•             }
    
  
• 
    
  
•             description = “LINK $outfile“
    
  
•             default_output_dir = “{{root_out_dir}}“
    
  
•             rspfile_content = “{{inputs}}“
    
  
•             outputs = [
    
  
•                 outfile
    
  
•             ]
    
  
•         }
    
  
•         tool（“stamp“） {
    
  
•             if （host_os == “win“） {
    
  
•                 command = “cmd /c type nul > \“{{output}}\““
    
  
•             } else {
    
  
•                 command = “/usr/bin/touch {{output}}“
    
  
•             }
    
  
•             description = “STAMP {{output}}“
    
  
•         }
    
  
•         tool（“copy“） {
    
  
•             command = “$cp -O binary -S {{source}} {{output}}.bin && echo $strip“
    
  
•             description = “COPY {{source}} {{output}}“
    
  
•         }
    
  
•     }
  

复制代码

同时在stm32l4xx/Src/BUILD.gn文件中添加ldflags，实现ld文件在厂商文件内设置。

•     ldflags = [
    
  
•       “-T“,
    
  
•       “../../vendor/st/stm32l4xx/STM32L476RGTx_FLASH.ld“
    
  
•     ]
  

复制代码

最终，顺利生成了elf文件，bin文件以及hex文件。

其实gn配置相对来说，命令行的提示，以及配置的可读性都是相当不错的。还是建议大家多动手，多看，多想。