FreeMaster 驱动文件说明

当FreeMaster软件安装完成后，可以在驱动安装文件夹中找到驱动源代码，细分为几个子文件夹。

• src_platforms 平台特定文件夹，针对每个所支持的平台(56F8xxx, HC08, HC12, MPC55xx, MPC56xx, MPC57xx, S32xx, KEAxx, Kxx, 等等). 均存在一个freemaster.h的主头文件和基于平台的c文件和头文件，c文件必须添加到项目中进行编译和链接，freemaster.h 文件必须包含在你程序中所有需要调用FreeMASTER API的地方。

— freemaster.h—主驱动头文件，用于声明通用的数据类型、宏和FreeMASTER API的函数原型。

— freemaster_XXX.c (XXX用于标识平台)—该文件包含平台特定的函数，如内存访问、通信缓存、串口中断、以及其他平台特定的代码。

— freemaster_XXX.h (XXX用于标识平台)—该文件定义了平台特定的SCI/CAN 访问宏，内存访问内联函数，以及其他平台特定的声明。

— freemaster_fastrec.c—针对给定平台的高速记录仪的实现。

— freemaster_fastrec.h—当高速记录器被启用时，快速记录器头文件被间接包含在最终应用程序中。 此文件包含用于组成高速采样代码的内联汇编代码和宏。  

 

— freemaster_cfg.h.example— 这个文件可以作为FreeMASTER驱动程序的一个例子 配置文件。 将此文件保存到项目源代码文件夹中，并将其重命名为freemaster_cfg.h。 FreeMASTER驱动程序代码包含这个文件，以获得特定于项目的配置选项，并优化驱动程序的编译。

• src_common 文件夹—包含所有支持平台的驱动程序共享的通用驱动程序源文件。 所有的.c文件必须添加到项目中，进行编译，并与应用程序链接在一起。  

— freemaster_serial.c—实现串行通信缓冲区、FIFO排队等通信相关操作。 该文件使用来自于平台相关头文件的SCI或JTAG模块访问宏(参见上面的内容)。

— freemaster_can.c— 实现FlexCAN/MSCAN/MCAN通信等 有关通讯业务。 该文件使用FlexCAN、MSCAN或MCAN模块 从平台相关的头文件中访问宏(见上面)。  

— freemaster_lin.c—实现LIN通信使用标准LIN传输层API，定义为LIN诊断类III。  

— freemaster_bdm.c—实现了分组驱动的BDM通信缓冲区等  

— freemaster_protocol.c—实现FreeMASTER协议解码器，处理基本的内存读或内存写命令。

— freemaster_rec.c—处理记录器特定的命令并实现记录器采样例程。 当记录器被FreeMASTER驱动程序配置文件禁用时，该文件只编译为空的API函数。  

— freemaster_scope.c—handles the Oscilloscope-specific commands. In case the Oscilloscope is

disabled by the FreeMASTER driver configuration file, this file compiles void.

— freemaster_pipes.c—implements the Pipes functionality when the Pipes feature is enabled.

— freemaster_appcmd.c—handles the communication commands used to deliver and execute the

Application Commands within the context of the embedded application. See FreeMASTER for

Embedded Applications (document FMSTERUG) for more details on this feature. When the

Application Commands are disabled by the FreeMASTER driver configuration file, this file

only compiles to empty API functions.

— freemaster_tsa.c—handles the commands specific to the TSA feature. This feature enables the

FreeMASTER host tool to obtain the TSA memory descriptors declared in the embedded

application. In case the TSA is disabled by the FreeMASTER driver configuration file, this file

compiles void.

— freemaster_private.h—contains the declarations of functions and data types used internally in

the driver. Based on the platform-identification macro declared in freemaster.h, this file

includes a platform-dependent header file (freemaster_XXX.h). The freemaster_private.h file

also contains the C pre-processor statements to perform intensive compile-time verification of

the driver configuration.

— freemaster_defcfg.h—defines all FreeMASTER options to the default value when the option is

not set in the freemaster_cfg.h file.

— freemaster_protocol.h—defines the FreeMASTER protocol constants used internally by the

driver.DESCRIPTION

FreeMASTER Serial Communication Driver, User’s Guide, Rev. 3.0, 08/2016

NXP Semiconductors

9

— freemaster_tsa.h—contains the declaration of the macros used to define the TSA memory

descriptors. This file is indirectly included into the user application code (from freemaster.h).

— freemaster_rec.h—exports the global variables of the Recorder module. It is used internally by

the Fast Recorder implementation, if this is enabled.

NOTE

The header files from the src_common folder are private to the driver and

must not be included anywhere in your application. Similarly to the

platform-dependent folder, add the src_common folder to your compiler’s

“include” search path.