RL78F24 LIN使用指导手册
主机（Master）
一.RLIN3介绍
在汽车电子领域，LIN总线是RL78F24系列微控制器的核心外设之一。为简化LIN通信的配置流程，瑞萨电子提供了专用的RLIN3配置工具，该工具能够高效定义LIN信号帧的格式与内容。本文将重点阐述此工具的具体使用方法。
二.RL78/F24介绍
RL78/F24新一代超低功耗汽车微控制器，非常适用于实现未来高可靠性的智能执行器和传感器，是低端车身ECU的理想之选。作为对现有RL78/F1x MCU的创新扩展，RL78/F24可满足未来市场的多种需求。RL78/F24具有更高的CPU性能、耐高温能力和更强的外设功能集，非常适合各种应用。
RL78/F2x系列产品按ISO 26262标准设计而成，支持高达ASIL B的功能安全（FuSa）。可支持高达EVITA-Light或更高的安全标准。AES加密模块可处理高达256位的密钥长度，并支持安全启动和身份验证功能。为了进一步提高BLDC（FOC）电机控制DC/DC控制系统的计算性能，RL78/F2x配备了独特的应用加速器IP，以减轻复杂的三角函数和其它计算处理所带来的负荷。
三.开发平台
硬件：
如前面所提到的，本文介绍以RL78/F24为主控MCU，对应板子为RL78/F24（R7F124FPJ） Target Board。
软件环境：
CS+ for CC V8.12.00
Renesas CC-RL Compiler v1.14.00
Smart configurator for RL78 V1.12.0:
Board Support Packages. -v1.80（r_bsp）
Ports v1.6.0
RLIN3 V1.00
Interval Timer V1.6.0（仅主机需要）
四.实现步骤
由于LIN总线是一主多从的架构，其配置将分为主机和从机两部分进行介绍，本文介绍的是主机配置。主机配置如下：把P53设为输出模式，其目的是控制LIN transceiver的使能信号。可以直接通过Smart Configurator图形化界面进行配置。
添加TAU0_1，用于主机的tick。Tick是主机LIN通信的基准时间信号，必须用定时器实现。在中断中调用l_sch_tick函数实现LIN信号帧的发送和接收。
添加r_lin3：
接下来是关于配置工具—LIN Configurator的介绍与设置。LIN Configurator包含在r_lin3的模块中，通过Smart Configurator添加完r_lin3组件后，可以在生成的文件夹中找到。
解压“LINConfigurator_RL78F23_F24_E_V100.zip”文件，安装LIN Configurator。打开“LIN Configurator for RL78/F23 and RL78/F24”，
点击
图标，
打开r_rlin3_config.h，该文件位于srcsmc_gen _rlin3_lib，生成的配置都会保存在这个头文件中。
接下来就是对Device、Channel以及波特率的设置。
在消息配置界面中，为用户提供了3种类型的消息帧可供设置，分别是无条件帧（Unconditional frames）、事件帧（Event frames）、偶发帧（Sporadic frames）。本文主要介绍无条件帧的设置。在LIN Configurator配置工具中，无条件帧必须包含唯一的名称（unique name）、发布/订阅（publish/subscribe）方向、帧ID、校验（check sum）类型（默认是增强型校验和）、数据长度和每个帧的数据初始值。在所有的设置完成后，点击“Register”，该无条件帧方可生效。如下图：
创建完这个无条件帧后，点击“Signal Edit“进行信号的编辑。每个帧必须包含至少一个信号，每个信号必须要有一个单独的名字，后续的LIN数据的发送和接收都需要用到这个名字。本例中，My_signal_test是一个长度为8字节的信号，Signal Size为64bit。如果需要每个帧设置多个信号，对应的offsets也需要做相应的设置。
RLIN3驱动通过“schedule table”里的特定帧来接收和发送数据。用户可以创建多个schedule，但是同一个时间只能有一个schedule是工作的。Schedule也必须有一个单独的名字。本例中只用到一个schedule。
保存配置：
在上述所有配置完成后，用户可以把整个配置保存成一个xml文件，方便下次使用。保存方法是点击上拉菜单中“File” → “Save”。
生成源代码：
点击红色的“GO”图标，该工具会自动生成一个新的CS+/IAR的lib工程，该工程路径会放在r_lin_drv → ChannelX → liblin2。
编译库文件：
打开上述步骤生成的CS+工程，右键“CC-RL（Build Tool）”选择“Property”，“Memory Model”选择“ Small model”，然后编译。Lib的Memory model需要和应用工程保持一致，由于这次的sample project用的是Small model，所以lib工程也用small model。
编译完成后，会生成一个“liblin21m_CCRL_0.lib”。该lib位于 _lin_drvChannel0liblin2DefaultBuild。
添加库文件：
在上述步骤中已经生成了一个库文件。接下来需要把这个库文件添加到自己的应用工程中，添加的方法有很多种，这里推荐其中一种，添加方法如下图：
五.API使用
在“main.c”文件中：
通过调用l_sys_init()初始化LIN
调用l_ifc_init（LIN_CHANNEL0）初始化接口
P53唤醒F24 FPB板子上的LIN收发器：P5_bit.no3=1;
设置schedule：l_sch_set（LIN_CHANNEL0，SCH0，1）；
使能定时器&定时器开始计时：R_Config_TAU0_1_Create(); R_Config_TAU0_1_Start();
调用发送函数：l_bytes_wr（My_signal_test，0，8，data）；
在“Config_TAU0_1_user.c”中：
启动schedule：uint8_t tick_status = l_sch_tick（LIN_CHANNEL0）；
六.测试结果
RL78F24 FPB板子LIN收发器和LIN总线分析控制器LINTest-M连线图如下：
在电脑上打开LINTest-M上位机，选择从机模式、COM口、波特率、校验类型，参数设置的位置选择ID为08，长度为8，显示模式选择动态显示，最后点击开始。通过界面可以看到LINTest-M成功接收收到由RL78F24发出来的数据，并且ID为08。说明通信成功。
七.使用提示
用户需要自己添加RLIN3 Module SIS。有两种方法。
第一：
打开Smart Configurator，选择“Components”，点击“Add Component”，点击“Download RL78 Software Integration System modules”，选择对应的module来下载。
第二种方法是：
在瑞萨官网上下载“r01an6334xx0100-rl78f24-sis”，并把其中的内容拷贝到Module Download文件夹。
下载链接：
RL78/F2x RLIN3 Module Software Integration System Rev.1.00 - Sample Code | Renesas瑞萨电子
https://www.renesas.cn/zh/document/scd/rl78f2x-rlin3-module-software-integration-system-sample-code?queryID=284f95b010231ecbece7b7671343fe2a
可以根据下面的方法找到Module Download文件夹。
最后，关于LIN Configurator配置工具的详细使用方法，您可通过以下路径查阅其用户手册。该手册包含了RL78/F24系列LIN功能的详尽说明，建议您在配置过程中多加参考。
八.总结
RL78F24具有汽车产品不可或缺的LIN模块，瑞萨推出针对LIN模块的配置工具LIN Configurator，方便用户配置自己的LIN信号帧，不再需要考虑如何繁琐的使用寄存器来收发数据，用户可以基于该工具做应用开发。
