1.规划控制之轨迹拼接
2.分享Apollo全局规划（Routing）模块最全教程
3.终于把Apollo存储加密这件事搞定了 | 周末福利！源码阅读
4.Apollo 8.0 配置参数读取源码解析：以 Planning 模块为例
5.无人驾驶技术入门（十一）| 无人驾驶中的源码阅读CAN消息解析
6.Apollo OSQP路径规划

规划控制之轨迹拼接

       自动驾驶系统中，planning模块输出轨迹信息作为control模块输入。源码阅读这些信息包括一系列点的源码阅读位置（x, y, θ）、曲率（κ）、源码阅读时间（t）、源码阅读mpush源码解读速度（v）和加速度（a）。源码阅读control模块频率通常高于planning频率，源码阅读因此，源码阅读平滑的源码阅读轨迹转换至关重要以避免控制抖动。

       规划起点的源码阅读选取直接影响控制稳定性。通常，源码阅读一些同学可能直接使用当前车辆位置作为起点。源码阅读理论上，源码阅读如果控制跟踪和定位完美，源码阅读这种方法可行。然而，实践中，由于各种定位误差和控制误差/滞后问题的累积，使用当前位置作为起点会导致控制抖动。

       考虑如图所示的情况。pos_last为上一帧车辆的实际位置，红线为规划轨迹。在下一帧，车辆移动到pos_cur，若规划起点选择pos_cur，轨迹终点保持不变，规划的轨迹变为蓝色曲线。两条曲线在起点附近存在差异，这将引起控制抖动，导致轨迹不连续。

       此外，使用实际位置作为起点还可能导致车辆发散，跟踪误差逐渐增加，偏离初始参考线。以一维速度跟踪为例，假设当前为减速过程。如果使用上一帧的实际速度规划减速曲线，经过一帧，由于实际速度跟踪或解算存在误差，目标速度m/s变为m/s；使用实际速度作为起点，下一帧将按照m/s速度重规划轨迹；若目标速度进一步变为m/s，实际自车将加速，而非预期的减速效果。

       引入实际速度导致了这一问题，实际速度包含了跟踪误差和定位误差。如果以实际速度重规划，可能导致误差进一步发散，产生相反效果。因此，规划起点在允许的跟踪误差范围内不应选择实际位置。

       理想的实践方式是，在终点（参考线）不变的情况下，无障碍等场景下，规划输出的码支付fateqq源码轨迹线保持不变（至少位置不变）。在经过一帧后，从pos_last到pos_cur，为了保证轨迹连续性，当前帧规划起点应选择在last_traj与pos_cur最近的投影点上，一般需增加dt的向前预测量。得到投影点信息后，即可规划出与上一帧轨迹完全重合的cur_traj曲线。即使当前位置不在轨迹上，但连续性得到保证，使得控制连贯，避免了跳变。

       在设置pos_cur和投影点的偏差阈值时，若两者距离过大，说明控制难以跟上规划轨迹。此时，应考虑实际位置进行进一步规划。例如，设定阈值为cm，当车辆位置距离轨迹线cm时，可将起点设定为离投影点cm的位置。这样做主要是为了避免使用投影点规划导致的控制超调，从而产生更大的轨迹偏差。

       基于Python的简单实现展示了轨迹拼接算法。实际工程实现时，方法类似，可参考Apollo源码。轨迹规划使用样条曲线设计。初始时，设置起点和终点信息，计算三阶样条曲线系数，规划出S型曲线last_traj。经过一帧，车辆从pos_last移动到pos_cur，在红色last_traj曲线上求得最近点作为当前帧规划起点，终点仍为设定值，使用三阶样条曲线求系数，得到蓝色的cur_traj。last_traj和cur_traj高度重合，实现了上下帧轨迹间的无缝衔接。在实际应用中，需要考虑时间、速度等维度的信息，但该方法的思想保持一致。

       Python源码如下：

分享Apollo全局规划（Routing）模块最全教程

       本文提供Apollo全局规划（Routing）模块的全面解读，旨在帮助学习全局路径规划及理解Apollo框架。资料内容丰富，覆盖源代码注释（包含详尽代码注释）、流程图（使用思维导图及各种框架流程图）、核心算法解读（每个涉及算法均有解析及推导）、相关软件工具链学习（如C++、Python、ROS、Ubuntu、Git等）、mathml公式源码jupyter行业现状及报告等多个方面。此套资料颗粒度极高，总结整理不易。

       如需获取资料，请私聊或访问链接：mbd.pub/o/m/author-aWuU...

       获取资料后，后续有任何问题可随时咨询。

       以下是学习资料列表概览：

       资料数量众多，每份文档通常超过几十页，内容详细深入。部分资料截图如下：

       扩展学习资源：

       欲了解Apollo其他模块，推荐以下资源：

       分享Apollo决策规划（planning）模块最全教程 - 知乎 (zhihu.com)

       分享Apollo预测（prediction）模块最全教程 - 知乎 (zhihu.com)

       分享Apollo控制（control）模块最全教程 - 知乎 (zhihu.com)

终于把Apollo存储加密这件事搞定了 | 周末福利！

       作者：尹吉欢 转自：微信公众号“程序员私房菜”

       本文节选自《Spring Cloud微服务入门实战与进阶》

       敏感配置，如密码等，我们期望进行加密存储，确保其安全性。然而，Apollo框架并未提供数据加密功能。若想实现此功能，有两种方法：一是修改Apollo源码，添加加解密逻辑；二是利用第三方框架进行数据加密。

       jasypt-spring-boot是一款基于Spring Boot开发的框架，它可自动解密properties中加密的内容。在Apollo中，我们也可以利用jasypt-spring-boot实现数据的加解密操作。

       jasypt-spring-boot的GitHub地址：github.com/ulisesbocchi...

       使用jasypt-spring-boot提供的方法对需要加密的配置进行加密，然后将加密内容配置在Apollo中。项目启动时，jasypt-spring-boot会解密Apollo加密的配置，让使用者获取解密后的内容。

       创建一个新的Maven项目，并加入Apollo和jasypt的依赖。具体依赖信息如下：

       创建一个加密的工具类，用于加密配置。执行main方法后，可以得到如下输出：

       input就是hello加密后的内容，将input的值复制存储到Apollo中。存储格式需要遵循一定规则，即需要将加密内容用ENC包起来，这样jasypt才会解密这个值。

       使用时可以直接根据名称注入配置，例如：

       input的值就是解密后的值，使用者无需关心解密逻辑，jasypt框架在内部处理好了。

       jasypt整合Apollo也存在一些不足之处。目前，我只发现了以下两个问题：

       上述两个问题与jasypt实现方式有关，意味着这种加密方式可能仅适用于数据库密码等场景，启动时可以解密，且仅使用一次。对于需要加密的核心业务配置，jasypt无法支持实时更新。下章节我将讲解如何修改Apollo源码来解决这两个问题。

       扩展Apollo支持存储加解密

       前文介绍了如何使用jasypt为Apollo中的配置进行加解密操作，基本需求可实现。外部显卡透视源码但仍存在一些不足之处。

       jasypt仅在启动时解密带有ENC（xx）格式的配置，当配置发生修改时无法更新。由于Apollo框架本身不具备对配置加解密的功能，若想实现加解密并支持动态更新，就需要修改Apollo源码来满足需求。

       修改源码需要重新打包。这里介绍一种简单实现方法：创建一个与Apollo框架中相同类名的类进行覆盖，这样无需替换已使用的客户端。

       若配置中心存储的内容是加密的，意味着Apollo客户端从配置中心拉取下来的配置也是加密的。我们需要在配置拉取下来后对其进行解密，然后再执行后续流程，如绑定到Spring中。在业务点进行切入后，配置中心加密的内容可自动转换为解密后的明文，对使用者透明。

       通过分析Apollo源码，我找到了一个最合适的切入点来完成这项任务，即com.ctrip.framework.apollo.internals.DefaultConfig类。DefaultConfig是Config接口的实现类，配置的初始化和获取都会经过DefaultConfig的处理。

       在DefaultConfig内部有一个更新配置的方法updateConfig，可在该方法中对加密数据进行解密处理：

       这里使用AES进行解密，意味着配置中心的加密内容也需要使用相同的加密算法进行加密。至于格式，仍使用ENC(xx)格式来标识加密配置内容。解密后将明文内容重新赋值到Properties中，其他流程保持不变。

       创建一个加密测试类，加密配置内容，并将其复制存储到Apollo中。输出内容如下：

       Ke4LIPGOp3jCwbIHtmhmBA==

       存储到Apollo中时，需要用ENC将加密内容包起来，如下：

       test.input = ENC(Ke4LIPGOp3jCwbIHtmhmBA==)

       使用之前的代码进行测试，Config获取和Spring注入的方式可以成功获取到解密后的数据，并且在配置中心修改后也能实时推送到客户端并成功解密。

       本文摘自于《Spring Cloud微服务入门实战与进阶》一书。这是朋友写的一本新书，豆瓣评分8.2。

Apollo 8.0 配置参数读取源码解析：以 Planning 模块为例

       目录

       在本篇讨论中，我们将剖析 Apollo 8.0 配置参数的读取过程，以 Planning 模块为例进行深入探讨。

       1. 配置参数分类

       了解 Apollo 中各模块的启动机制，主要通过主文件 mainboard 编译生成的可执行文件以及动态链接库的加载实现。Planning 模块的 DAG 文件 (apollo/modules/planning/dag/planning.dag) 指定了模块的动态链接库和单个组件 PlanningComponent 的配置。

       配置参数分为两类：基于 ProtoBuf 的参数和 gflags 命令行参数。Planning 模块的 ProtoBuf 配置文件为 (apollo/modules/planning/conf/planning_config.pb.txt)，与之对应的 ProtoBuf 接口文件为 (apollo/modules/planning/proto/planning_config.proto)。而 gflags 命令行参数配置文件为 (apollo/modules/planning/conf/planning.conf)。

       1.1 ProtoBuf 参数

       ProtoBuf 参数通过 module_config.components.config.config_file_path 指定配置文件路径，文件中的参数在组件初始化时被读入 ProtoBuf 对象。

       1.2 gflags 命令行参数

       gflags 参数通过 module_config.components.config.flag_file_path 指定，文件中的tomcat自带ha源码命令行参数在初始化时由 gflags 解析。

       2. 配置参数读取流程

       主入口文件 (apollo/cyber/mainboard/mainboard.cc) 的 main 函数负责加载 DAG 文件并启动模块。解析命令行参数、读取 DAG 文件、执行模块加载逻辑。

       2.1 加载 DAG 文件

       解析命令行参数形成 ModuleArgument，用于存储参数信息。执行主流程时，ModuleController 负责加载所有模块，并处理模块组件的注册、实例化和初始化。

       2.2 读取配置参数

       ModuleController 通过 LoadModule 方法读取模块配置，具体步骤涉及读取 ProtoBuf 参数和 gflags 命令行参数。

       3. 总结

       本文通过分析 Planning 模块的配置读取过程，清晰展示了 Apollo 8.0 中配置参数的完整读取流程。通过理解这一过程，开发者能够更深入地掌握 Apollo 的模块启动和配置机制。

无人驾驶技术入门（十一）| 无人驾驶中的CAN消息解析

       前言

       本文聚焦于无人驾驶技术中至关重要的CAN总线机制。在无人驾驶系统中，CAN总线扮演着不可或缺的角色，不仅用于传输VCU信号，还涉及雷达、Mobileye等传感器的数据交换。

       实现一个完整的无人驾驶系统需涉及感知、融合、规划与控制等多个层级。在这篇分享中，重点探讨了“驱动层”相关的CAN总线内容。

       正文

       作为高效可靠的通信机制，CAN总线在汽车电子领域广泛应用。本文着重于解释在无人驾驶系统接收到CAN消息后，如何利用CAN协议解析出所需数据，解析传感器信息是自动驾驶工程师的核心技能。

       认识CAN消息

       以Apollo开源代码为例，剖析CAN消息结构，包括ID号、长度、数据和时间戳。ID号用于确认节点间通信，扩展帧和普通帧的区分依据于此。长度表示数据量，最多8个无符号整数或8*8个bool类型数据。数据部分是消息的核心，通过8*8方格可视化，解析变得直观。时间戳记录接收时刻，用于判断通信状态。

       认识CAN协议

       业界使用后缀为dbc的文件存储CAN协议，Vector公司的CANdb++ Editor软件专门用于解析dbc文件。Mobileye的车道线信息通过dbc文件格式传递，以ID号0x的LKA_Left_Lane_A为例，解析信号包括类型、质量、曲率等物理量。通过软件界面直接关联彩色图与data，解析过程变得清晰。

       解析CAN信号

       解析过程基于彩色图与data的一一对应关系，通过叠加图表，揭示数据结构。对于Factor为1的物理量，解析直接。Factor为小数的物理量则需运用位移运算。以Apollo源码为例，通过移位和位运算解析出完整物理量。

       与CAN类似的通信协议

       虽然传感器采用不同通信方式，如雷达、激光雷达、GPS和惯导，但解析方法保持一致。解析的关键在于理解信号的类型、值和单位。

       结语

       本篇分享全面解析了CAN总线消息的解析过程，涵盖了无人驾驶系统驱动层的基本理论。解析ID不同的CAN消息结构要求高度细致，避免后续处理中的意外错误。如有疑问，欢迎在评论区互动。赞赏与关注是对文章价值的直接体现。

       获取相关软件和文件的方法，请关注公众号：自动驾驶干货铺，后台回复“CAN”获取。更多Mobileye资料和技术支持，值乎平台提问。

Apollo OSQP路径规划

       探索高效优化之路：OSQP在Apollo路径规划中的应用

       在追求自动驾驶车辆动态控制的极致平滑性和安全性时，路径规划算法扮演了关键角色。其中，Piecewise Jerk Path Optimizer（PJP）方法通过优化成本函数，为我们提供了理想的轨迹设计。在这个过程中，OSQP作为一种高效且鲁棒的二次规划求解器，凭借其C语言实现和多语言接口，成为了一种不可或缺的工具。

       理解矩阵世界：PD/PSD的数学基础

       在优化领域，正定矩阵（PD，Positive Definite）在实数域内是关键概念，它要求对称且所有特征值均为正。这意味着它不仅主元和主子式皆为正，而且对于任何非零向量，其内积总是正的。在复数域中，我们关注的是厄米特矩阵（PSD，Positive Semidefinite），它允许非正特征值，但满足上述对称性和内积非负的条件。

       Matlab中的强大工具：quadprog与OSQP对比

       Matlab的quadprog函数专为处理有线性约束的二次优化问题，它支持'interior-point-convex'算法，提供了直观的问题描述和prob结构体的使用。然而，对于更高效和现代化的解决方案，OSQP以其C++接口的易用性和依赖于Eigen库的优势脱颖而出，osqp-eigen成为了推荐的首选。

       深入实践：osqp-eigen的使用与实例

       要开始使用osqp-eigen，首先需要从OSQP官网或GitHub下载源代码，并通过git clone --recurse-submodules或GitHub Desktop完成安装，别忘了安装TDM-GCC作为编译工具。在osqp-matlab/examples目录中，你可以找到丰富的实例来实践OSQP在路径规划中的应用。

       扩展学习：走向更广阔的优化天地

       为了深入理解OSQP在Apollo路径规划中的应用，掌握正定和半正定矩阵的特性至关重要。查阅OSQP官网和GitHub文档，同时参考知乎、CSDN博客和Apollo开发者社区的专业资源，将帮助你更好地理解和利用OSQP的强大功能。

       在自动驾驶的征途上，每一步优化都关乎安全与效率。OSQP与PJP的结合，正在推动智能车辆在复杂道路上的稳健前行。

Apollo6.0安装文档教程——环境搭建、安装、编译、测试

       一、环境搭建

       为了安装Apollo 6.0，您需要以下环境准备：

       Ubuntu .，安装教程参阅相关资源。

       NVIDIA显卡驱动，根据官方指南进行安装。

       Docker引擎，Apollo安装步骤中完成。

       NVIDIA容器工具，Apollo安装步骤中完成。

       安装过程中，请确保禁用nouveau驱动，操作步骤如下：

       在终端中添加指定内容至文件末尾并保存，然后重启系统。重启后执行命令，检查禁用状态。

       二、下载源码

       前往Apollo下载地址，选择对应版本。

       三、安装

       安装Docker：进入Apollo 6.0的docker目录，执行安装命令。安装完成后，重启电脑。

       安装NVIDIA容器工具：与Docker安装同步进行。

       创建Apollo容器：下载所需image，此过程可能耗时较长。成功后，会显示“[OK], Enjoy!”。

       进入容器：执行相关命令。

       四、编译与测试

       编译Apollo：根据容器中的GPU状态（有或无）进行编译。可能遇到的warning如“DimsNCHW”被标记为过时，这是正常现象，不会影响后续使用。

       启动Dreamview：可能遇到权限问题，使用chmod进行授权。如果问题仍未解决，授权整个Scripts目录并执行。

       Dreamview查看：在浏览器中输入坐标系相互转换

       自动驾驶中的车辆运动在笛卡尔坐标系和Frenet坐标系之间转换是关键。在笛卡尔系统中，车辆运动通过航向角[公式]和曲率[公式]描述，而在Frenet坐标（S-L坐标）下，车辆运动则用[公式]表示，其中下标[公式]和[公式]分别代表车辆和参考点，对时间求导用点表示，对自变量求导用撇表示。

       Frenet坐标系常用于路径规划，通过先在S-L坐标系规划轨迹得到[公式]关系，再在S-T图规划速度得到[公式]。参考线通常用散点表示，包含位置[公式]、切线方向[公式]、曲率[公式]等信息。在Apollo源码中，涉及如下转换：

       从笛卡尔的[公式]和[公式]转换到S-L的[公式]和[公式]

       从S-L的[公式]到笛卡尔的[公式]

       例如，从笛卡尔到S-L，首先找到最近的参考点，通过向量关系推导出[公式]，然后利用速度关系式[公式]，结合向心力类比的Frenet公式推导出[公式]。整个过程涉及速度的定义、链式求导法则和Frenet公式的应用。

       在S-L坐标到笛卡尔坐标转换时，通过参考点的几何位置和车辆与参考线的关系，可以计算速度、加速度等参数，从而完成坐标间的转换。这些转换公式确保了自动驾驶系统在不同坐标系间的运动描述和控制的灵活性和准确性。

Apollo EM中path_assesment_task相关细节的讨论

       网上已有关于本task流程的详细注释，本文主要探讨Apollo EM中path_assesment task的内部算法细节。

       首先，我们来看SetPathPointType函数。函数中，ego_center_shift_distance代表车体几何中心距离后轴中心的距离。初始化过程中，以车体后轴中心点为基准获取整个车体Box。ego_box所调用的Shift函数将后轴中心点前移至车体几何中心点并计算box四个角的位置。这样做的原因是，Control使用后轴中心点跟踪每一个pathpoint，而本车SLboundary依据其几何中心点在参考线上进行投影，因此这一步转化是必不可少的。

       Shift函数内所调用的InitCorners()如上图所示，其中cos_heading,sin_heading_,half_length_,half_width_,center_,是在Box2d初始化时进行赋值。简单用图示介绍一下含义：X-Y用于表示地图坐标系，x-y用于表示将地图坐标系平移至车体几何中心点之后的坐标系，[公式] 用于表示heading。特别解释一下：此处的使用 [公式] 来表示长度half_width x[公式]。

       获取到本车box的四个角的坐标之后，再将依靠参考线将box转化到SL坐标系下的boundary。之后遍历SL坐标系下每个pathpoint，计算自车位于每个pathpoint的时候所对应的车体的边界。将边界与车道线比较，判断每个pathpoint的类型（在lane_borrow/lane_change决策下是在旁车道还是本车道）。此处不粘贴源码，直接用图示进行说明各种情况。

       需要注意：由于要在统一的坐标系下进行比较，所以，采用-right_width。所以对应上图的情况，即处于车道边界之外还没换道的情况：start_l>lane_left_width || end_1<-lane_right_width此时type为IN_LANE。对应上图情况，即严格处于本车边界之内的车辆，需要考虑将车道边界添加buffer：所以本车实际处于虚线之内，此时的type为IN_LANE，表示已经换道完成。其它状态下为lane_change的过渡状态，type为OUT_ON_FORWARD_LANE。

       需要注意的是：由于借道其实是拐入别的车道一点点之后再拐回来，所以需要添加动态的迟滞边界in_and_out_lane_hysteresis_buffer，来对pathpoint进行严格地区分。类似的做法在量产ADAS功能中也用到，主要用于对前方动态Target的识别，目的是为了防止障碍车辆沿车道线来回画龙或压线行驶的情况。扯远了~

       如上述，因为借道只是占据旁车道一点点，所以判断条件与lane_change略有不同，此处的判断条件使用end_l与lane_left_width相比较，start_l与-lane_right_width相比较。

       如上图所示，当前一个路径点在车道内（is_prev_point_out_lane = false），即绿点所在位置，则判断lane_borrow的条件：此时，in_and_out_lane_hysteresis_buffer = 0.2；当前一个路径点在车道内（is_prev_point_out_lane = true），即红点所在位置，此时，in_and_out_lane_hysteresis_buffer = 0；

       接下来讨论path与静态障碍物collision的问题：具体流程图参见下图：IsCollidingWithStaticObstacles中流程概述：过滤掉虚拟障碍物，高速运动障碍物等，按照固定距离的pathpoint建立VehBox，所有点转化为Frenet坐标系，调用函数IsPointIn检验所有点是否处于障碍物的内部。

       下面开始详细讲解IsPointIn函数：首先判断本车的Corner点是否在障碍物边界上，如果不在，则进行下一步取Corner点在与轴方向异侧的两个点，分别于Corner点构成向量，之后做叉乘，叉乘结果若大于0，则比较两个点的y值，若y值结果小于0，则看向量正旋转到目标向量的实际角度是否小于度，若小于，则c由零变为1；若y值结果为大于，则看向量正旋转到目标的实际角度是否大于度，若大于，则c由零变为1。同理再构建另外两个向量，若与上述情况相同，则c由1变为2。最后判断C为奇数还是偶数，如果为奇数，则返回true，表示Corner点处于Obstacle内部。如果为偶数，则表示Corner点在Obstacle外部。

       下面举个栗子：对于左图A点的这种情况，0点与3点在Y轴方向上位于A点异侧，0.y<3.y，side>0（即比较向量A-0正旋转到目标向量A-3是否小于度），实际大于度（蓝色箭头），结果为否，则c值仍为0；2点与1点在Y轴方向上位于A点异侧，side<0（即比较向量A-2正旋转到目标向量A-1是否大于度），实际大于度（红色箭头），结果为是，则c值变为1。最终c&1为奇数，表示A点在obstacle之内。

       对于右图A点情况，0点与3点在Y轴方向上位于A点异侧，0.y<3.y，side>0（即比较向量A-0正旋转到目标向量A-3是否小于度），实际小于度（红色箭头），结果为是，c值由0变为1；2点与1点在Y轴方向上位于A点异侧，side<0（即比较向量A-2正旋转到目标向量A-1是否大于度），实际大于度（蓝色箭头），结果为是，则c值变为2。最终c&1为偶数，表示A点在obstacle之外。

       正旋转相关的知识：叉乘几何含义：须注意：本算法所有的坐标系为上图所示，所以正旋转方向为X轴沿绿三色箭头转到Y轴。

       最后依旧借用M星云男神女神镇楼。。