小马智行的代码工程实践

原创 汽车电子与软件 2022-08-14 10:56
「Pony Tech」是小马智行Pony.ai推出的深度技术科普专栏,由专业的工程师总结归纳出自动驾驶领域的技术实践及研究成果。本期文章由小马智行基础架构团队总结,分享小马智行的代码工程实践。

自动驾驶至今依然是一个亟待解决的难题,并且需要大量实测验证支持,因此长期、持续、高效的研发迭代效率也是最终能实现全无人驾驶的保证。如何在保证安全的前提下,高效地进行研发迭代,是所有自动驾驶公司需要面临的一个重要挑战。
代码是自动驾驶软件的核心,代码的质量是安全的基石,代码的迭代效率也是研发效率的基础。
一套优秀的代码工程实践方式,可以做到保证代码质量,同时也提升了代码迭代效率。并且两者相辅相成,更高质量的、可维护性的代码质量将有利于长期的更新迭代,而更高的迭代效率带来的更良好的工程师开发体验必然也保证了最终系统的可靠性。
今天,我们将会分享小马智行的代码工程实践,向大家介绍小马智行如何在保证Safety First的前提下提升研发效率并维护良好的工程师开发体验。

代码库

小马智行的代码库包含了几十万个源代码文件(作为对比,我们熟知的Linux kernel库一共包含了七万多个文件),代码行数达到千万量级。在工作时间,平均每天有数百个提交被合入。如此的规模和频率也给代码库的管理,如外部依赖管理、编译、打包、发布等工具链提出了更高的要求。小马智行将代码库的管理视为提升研发效率和保证工程质量的基础,有专门的团队负责相关工具链和服务的开发和维护。小马智行使用bazel管理代码的构建,从而很好地支持了多语言、多平台、大规模的编译构建。我们针对所有代码使用同一套统一的编译环境和选项,减少了工程师重复工作的同时,杜绝了兼容性和依赖问题。我们还开发了一种内部的二进制打包格式,用于在单文件中包含所有所需的配置文件和依赖库等,极大简化了代码发布的工作。

开发环境

在小马智行,软件工程师统一使用Linux系统作为开发环境,同时我们维护了一套基于Ansible脚本的自动化配置用于安装配置编译环境和外部依赖等,保证每一位工程师开发环境的统一。此外,这一套自动化配置的开发环境和小马智行的自动驾驶车辆中的系统环境也是高度一致的,它们可以编译出完全一致的可执行文件并可以直接调试运行。因此,几乎所有自动驾驶车辆上的遇到问题,工程师都可以在本地复现,大大降低了工程师查找问题的难度。同时,行为的一致性也是保证自动驾驶安全的基础。统一完善的本地开发环境并不意味着工程师代码的编译测试受限于本地设备的性能:我们同时也使用分布式编译平台提供远程编译环境和缓存,使得个别文件的改动基本只需在秒级别内完成整体项目的构建;我们也在云端提供相同环境的系统用于运行各类测试和工具,小马智行的自有机房为这些功能提供了安全和可靠的支撑。可以说,在小马智行,开发环境是“开箱即用”的。
在小马智行,我们持续保持对新技术的采纳,防止日积月累的技术债。C++是我们的自动驾驶系统主要使用的开发语言,当前我们使用clang 10编译器以及C++17标准,并正在积极准备升级至C++20,这使得我们可以在代码库中充分使用语言新特性来优化可读性和性能。Python也是我们常用的脚本语言,我们使用的Python 3.8版本也是最新的几个稳定版本之一。在代码提交之前,我们要求使用clang-tidy, clang-format, iwyu, mypy等工具对代码进行前期的强制检查和格式化,确保代码风格的一致性并减少潜在的问题。

代码审阅(Code Review)

基于自动驾驶系统对安全的追求,小马智行在合并新代码之前有严格的规范:每一个提交(Pull Request)的合并需要一位代码可读性(Readability)审阅人以及一位代码所有者(Owner)的检查和通过。不同的开发语言有不同的可读性审阅人(比如C++ readability reviewer, Python readability reviewer),这些审阅人将确保提交中的代码具有相当的可读性,易于理解,同时遵循了相应语言的代码规范的最佳实践。而当一位工程师提交的代码可读性持续达到标准后,这位工程师自己也可以申请成为可读性审阅人。代码的所有者根据代码所属的模块等灵活设置,他们均是非常熟悉相关代码的优秀工程师,他们需要对提交中代码的设计方案、功能以及正确性负责。一次代码合并前,代码所有者经常还会邀请所有与被修改的代码相关的工程师共同审阅代码。为了保证代码质量,一个提交花费数周时间进行审阅、各审阅人提出多达百条建议并多次修改的情况,在小马智行是非常常见的。
对于一些涉及复杂功能的代码,很多时候仅仅是代码的审阅是不够的。在这些时候,我们还要求工程师先进行设计文档的编写、审阅甚至答辩。只有相应的设计文档被通过后,工程师的代码提交才会被开始审阅,以此来避免虽然代码正确但是整体设计不符合要求的情况。

代码测试

仅仅是代码审阅的通过还不足以允许代码的合入。在审阅人审阅通过之后,提交的代码还需要通过一系列的自动化测试。
小马智行维护了大量的代码测试以保证代码的质量。包括常见的以文件为单位,测试特定代码功能的单元测试(Unit Test)、以代码的模块为单位,测试模块功能的集成测试(Integration Test),还包括了专门针对自动驾驶软件的模拟硬件输入,测试车载系统行为的硬件回路测试(Hardware In Loop Test)、测试车辆行为,与特定的历史版本代码对比的回归测试(Regression Test)、以及用于行为验证的大规模仿真评估(Large Scale Simulation Evaluation)等。
小马智行的代码仓库中有近万份单元测试用例,核心模块基本保证了100%的单元测试覆盖率。高密度的单元测试保证了代码的正确性,也防止其行为因为其他相关代码的意外修改被破坏。此外,小马智行研发了一套功能极为强大的仿真工具,用以测试代码在近似实际运行的环境中的行为。小马智行的仿真工具可以以一段车辆运行记录(可能来自真实的道路测试,也可能通过工具产生)为输入,测试自动驾驶软件的行为。这套仿真系统在硬件回路测试、回归测试和大规模仿真评估等过程中被大量使用。这些所有测试都可以由工程师在代码提交后,输入一行命令来在云端触发运行。
除此之外,我们还会使用多种代码检查工具来查找代码中可能的问题。在小马智行,我们会以每天一次的频率,使用ASAN (Address sanitizer)、TSAN(Thread sanitizer)、UBSAN(Undefined-behavior sanitizer)模式分别运行和检查所有的单元测试和仿真测试并确保他们通过,基本能消除代码中的各类内存访问、线程安全、未定义行为等问题。

工程师培养

除了上文中介绍到的工具和规范,工程的质量和效率归根结底还是依赖每一位优秀的工程师的努力,源自于每一位Ponies心中对Safety first的执着。在小马智行,每年都有大量的新人加入我们的工程师团队,我们会为每一位工程师设置一位导师,并为其设计量身定做的上手培训项目(onboard training program)。上手培训项目会包括从代码规范、系统架构介绍到训练代码开发等,耗时将近一个月。除此之外,每周一篇的Coding Tips、每周五的技术大牛分享(TGIAF)、各个团队几乎每天都有的技术沙龙,都为每一位工程师学习和提升提供了丰富的资源。对于每一个项目,我们坚持准备完善的设计文档、上线文档、维护文档等,并可能在必要的时候总结复盘文档用于反思和提高,这些不仅在项目进行过程中保证了工程质量,也为未来留下了宝贵的经验材料,供所有其他工程师学习。

总结

在小马智行,我们相信工程实践的每一步,从代码开发环境、代码规范到审阅流程、测试验证,都是奠定更安全高效的自动驾驶软件的基础。我们将工程师文化践行在日常工作中的每个细节,坚信用代码改变人类出行方式的愿景。


END

「Pony Tech」是小马智行Pony.ai推出的深度技术科普专栏,由专业的工程师总结归纳出自动驾驶领域的技术实践及研究成果,分享主题涉及自动驾驶研发的方方面面,从系统基础架构、高精度地图与定位到大数据、感知、路径规划等。阅读原文,关注「Pony Tech」


汽车电子与软件 主要介绍汽车电子软件设计相关内容,每天分享一篇技术文章!
评论
  • 本文介绍瑞芯微开发板/主板Android配置APK默认开启性能模式方法,开启性能模式后,APK的CPU使用优先级会有所提高。触觉智能RK3562开发板演示,搭载4核A53处理器,主频高达2.0GHz;内置独立1Tops算力NPU,可应用于物联网网关、平板电脑、智能家居、教育电子、工业显示与控制等行业。源码修改修改源码根目录下文件device/rockchip/rk3562/package_performance.xml并添加以下内容,注意"+"号为添加内容,"com.tencent.mm"为AP
    Industio_触觉智能 2025-01-17 14:09 161浏览
  • 2024年是很平淡的一年,能保住饭碗就是万幸了,公司业绩不好,跳槽又不敢跳,还有一个原因就是老板对我们这些员工还是很好的,碍于人情也不能在公司困难时去雪上加霜。在工作其间遇到的大问题没有,小问题还是有不少,这里就举一两个来说一下。第一个就是,先看下下面的这个封装,你能猜出它的引脚间距是多少吗?这种排线座比较常规的是0.6mm间距(即排线是0.3mm间距)的,而这个规格也是我们用得最多的,所以我们按惯性思维来看的话,就会认为这个座子就是0.6mm间距的,这样往往就不会去细看规格书了,所以这次的运气
    wuliangu 2025-01-21 00:15 181浏览
  • Ubuntu20.04默认情况下为root账号自动登录,本文介绍如何取消root账号自动登录,改为通过输入账号密码登录,使用触觉智能EVB3568鸿蒙开发板演示,搭载瑞芯微RK3568,四核A55处理器,主频2.0Ghz,1T算力NPU;支持OpenHarmony5.0及Linux、Android等操作系统,接口丰富,开发评估快人一步!添加新账号1、使用adduser命令来添加新用户,用户名以industio为例,系统会提示设置密码以及其他信息,您可以根据需要填写或跳过,命令如下:root@id
    Industio_触觉智能 2025-01-17 14:14 121浏览
  • 嘿,咱来聊聊RISC-V MCU技术哈。 这RISC-V MCU技术呢,简单来说就是基于一个叫RISC-V的指令集架构做出的微控制器技术。RISC-V这个啊,2010年的时候,是加州大学伯克利分校的研究团队弄出来的,目的就是想搞个新的、开放的指令集架构,能跟上现代计算的需要。到了2015年,专门成立了个RISC-V基金会,让这个架构更标准,也更好地推广开了。这几年啊,这个RISC-V的生态系统发展得可快了,好多公司和机构都加入了RISC-V International,还推出了不少RISC-V
    丙丁先生 2025-01-21 12:10 111浏览
  •  万万没想到!科幻电影中的人形机器人,正在一步步走进我们人类的日常生活中来了。1月17日,乐聚将第100台全尺寸人形机器人交付北汽越野车,再次吹响了人形机器人疯狂进厂打工的号角。无独有尔,银河通用机器人作为一家成立不到两年时间的创业公司,在短短一年多时间内推出革命性的第一代产品Galbot G1,这是一款轮式、双臂、身体可折叠的人形机器人,得到了美团战投、经纬创投、IDG资本等众多投资方的认可。作为一家成立仅仅只有两年多时间的企业,智元机器人也把机器人从梦想带进了现实。2024年8月1
    刘旷 2025-01-21 11:15 340浏览
  •     IPC-2581是基于ODB++标准、结合PCB行业特点而指定的PCB加工文件规范。    IPC-2581旨在替代CAM350格式,成为PCB加工行业的新的工业规范。    有一些免费软件,可以查看(不可修改)IPC-2581数据文件。这些软件典型用途是工艺校核。    1. Vu2581        出品:Downstream     
    电子知识打边炉 2025-01-22 11:12 46浏览
  • 现在为止,我们已经完成了Purple Pi OH主板的串口调试和部分配件的连接,接下来,让我们趁热打铁,完成剩余配件的连接!注:配件连接前请断开主板所有供电,避免敏感电路损坏!1.1 耳机接口主板有一路OTMP 标准四节耳机座J6,具备进行音频输出及录音功能,接入耳机后声音将优先从耳机输出,如下图所示:1.21.2 相机接口MIPI CSI 接口如上图所示,支持OV5648 和OV8858 摄像头模组。接入摄像头模组后,使用系统相机软件打开相机拍照和录像,如下图所示:1.3 以太网接口主板有一路
    Industio_触觉智能 2025-01-20 11:04 150浏览
  •  光伏及击穿,都可视之为 复合的逆过程,但是,复合、光伏与击穿,不单是进程的方向相反,偏置状态也不一样,复合的工况,是正偏,光伏是零偏,击穿与漂移则是反偏,光伏的能源是外来的,而击穿消耗的是结区自身和电源的能量,漂移的载流子是 客席载流子,须借外延层才能引入,客席载流子 不受反偏PN结的空乏区阻碍,能漂不能漂,只取决于反偏PN结是否处于外延层的「射程」范围,而穿通的成因,则是因耗尽层的过度扩张,致使跟 端子、外延层或其他空乏区 碰触,当耗尽层融通,耐压 (反向阻断能力) 即告彻底丧失,
    MrCU204 2025-01-17 11:30 179浏览
  • 高速先生成员--黄刚这不马上就要过年了嘛,高速先生就不打算给大家上难度了,整一篇简单但很实用的文章给大伙瞧瞧好了。相信这个标题一出来,尤其对于PCB设计工程师来说,心就立马凉了半截。他们辛辛苦苦进行PCB的过孔设计,高速先生居然说设计多大的过孔他们不关心!另外估计这时候就跳出很多“挑刺”的粉丝了哈,因为翻看很多以往的文章,高速先生都表达了过孔孔径对高速性能的影响是很大的哦!咋滴,今天居然说孔径不关心了?别,别急哈,听高速先生在这篇文章中娓娓道来。首先还是要对各位设计工程师的设计表示肯定,毕竟像我
    一博科技 2025-01-21 16:17 95浏览
  • 临近春节,各方社交及应酬也变得多起来了,甚至一月份就排满了各式约见。有的是关系好的专业朋友的周末“恳谈会”,基本是关于2025年经济预判的话题,以及如何稳定工作等话题;但更多的预约是来自几个客户老板及副总裁们的见面,他们为今年的经济预判与企业发展焦虑而来。在聊天过程中,我发现今年的聊天有个很有意思的“点”,挺多人尤其关心我到底是怎么成长成现在的多领域风格的,还能掌握一些经济趋势的分析能力,到底学过哪些专业、在企业管过哪些具体事情?单单就这个一个月内,我就重复了数次“为什么”,再辅以我上次写的:《
    牛言喵语 2025-01-22 17:10 27浏览
  • 数字隔离芯片是一种实现电气隔离功能的集成电路,在工业自动化、汽车电子、光伏储能与电力通信等领域的电气系统中发挥着至关重要的作用。其不仅可令高、低压系统之间相互独立,提高低压系统的抗干扰能力,同时还可确保高、低压系统之间的安全交互,使系统稳定工作,并避免操作者遭受来自高压系统的电击伤害。典型数字隔离芯片的简化原理图值得一提的是,数字隔离芯片历经多年发展,其应用范围已十分广泛,凡涉及到在高、低压系统之间进行信号传输的场景中基本都需要应用到此种芯片。那么,电气工程师在进行电路设计时到底该如何评估选择一
    华普微HOPERF 2025-01-20 16:50 73浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦