S32K1xx SDK（版本：S32_SDK_S32K1xx_RTM_4.0.3 ）详细介绍

news2024/11/25 18:41:26

前言

在学习一款MCU之前，一般我的习惯是先下载官方提供的SDK包进行学习。然后学习了解SDK提供的资源、框架、以及各目录结构文件作用等，下面边学边做笔记记录。

S32K1系列SDK我们可以到下面的NXP官网去获取：

https://www.nxp.com.cn/design/software/development-software/s32-sdk/s32-software-development-kit-for-s32k1:S32SDK-ARMK1

1. S32K1系列SDK概述

下面是引用自NXP官网对S32K1xx SDK的介绍：

S32K1的S32软件开发工具包(SDK)提供了性价比高且使用便捷的完整解决方案，可与S32K1整个系列微控制器的连接、电机控制和安全库堆栈相匹配。S32K1系列的S32SDK非常适合汽车领域的所有应用。

特征：

  • 包含在S32 Design Studio中
  • Processor Expert图形配置
  • 集成的恩智浦软件：电机控制库(AMMCLib)、结构核心自检(sCST)、SBC中间件
  • 支持5类编译器：GCC、GreenHills、Arm编译器、IAR和WindRiver DIAB
  • 带有操作系统接口层的FreeRTOS或裸机
  • 符合MISRA C 2012的量产级驱动程序
  • 以太网(TCP/IP+LWIP+WOLFSSL)
  • LIN堆栈

2. S32K1xx SDK软件架构

下图是 S32K1xx SDK 的软件架构：

在这里插入图片描述

从这幅图片我们可以了解到，S32K1xx SDK编程有分层的思想，包含有：

底层

  • 各系列MCU芯片支持
  • Low-level Drivers，底层驱动程序。包括PD（Peripheral Driver，外设驱动层）驱动和PAL（Peripheral Abstract Layer，外设抽象层）驱动
  • 各个编译器平台的Start-up（启动文件）、Linker files 支持

实时操作系统层

  • SDK提供移植好的 FreeRTOS
  • 还有OSIF（操作系统接口层），OSIF层提供了统一的操作系统API接口，是基于 FreeRTOS 或者裸机代码封装而来（如果不使用FreeRTOS，那么OSIF层，就是裸机接口实现的）。

中间件（Middleware）

  • 在 Low-level Drivers 上面，就是中间件层。主要包含有：
  • 一些静态库。如AMMCLib（电机驱动库）、Touch sensing（触摸感应库）、安全相关的库（SCST、SPTLib），这类库是不开源的，只提供编译好的 .a 文件。
  • 移植好的通信协议栈。如 TCP/IP、LIN、USB和文件系统等。
  • SCB（System Basis Chip）驱动程序。这部分就是NXP移植好了的一些外围芯片的驱动程序。

应用层

  • 一些demo应用程序
  • 驱动程序的示例程序（包括PD和PAL驱动）
  • 辅助工具。如Processor Expert UI config file（处理器专家配置文件），根据图形化配置界面生成初始化代码。

3. S32K1xx SDK各目录结构

从官网下载了 S32K1xx SDK 后安装到本地目录，SDK的根目录包含的内容如下：

在这里插入图片描述

下面对各个子目录结构简单介绍。

3.1 doc

该目录存放的就算各系列芯片SDK的帮助文档，如快速入门指南、各系列芯片的html格式的帮助文档等等。比如打开S32K144的html帮助文档，如下：

在这里插入图片描述

可以看到对SDK的各个组件还要Example，还有代码的变量、结构体定义都有介绍。

我们对SDK哪部分内容不了解，首先可以在这里找找有没有对应的介绍。

3.2 examples

该目录存放的是各系列芯片的示例程序，包括demo应用的综合示例程序，以及外设驱动代码的使用示例程序。以 S32K144 为例：

在这里插入图片描述

3.3 lib

该目录存放的是前面介绍的，编译好的中间件文件。比如电机驱动库、SCST安全库。还有触摸驱动库、NFC等这些 lib 也是不开源的，而且在这个目录还找不到，看网上的介绍说是需要找 NXP 的 FAE 才能拿到。

在这里插入图片描述

3.4 middleware

该目录存放的就是中间件的一些代码。比如lin总线协议栈、tcp/ip协议栈、sbc驱动代码。

在这里插入图片描述

3.5 platform

该目录是最重要的一个目录，是存放平台相关代码的目录。其中包含有devices、drivers、pal三个子目录。如下：

在这里插入图片描述

这个目录非常重要，下面对各子目录详细介绍。

3.5.1 platform/devices目录

devices目录包含各个MCU系列的设备头文件（如S32K144.h）、链接文件、启动文件、内核文件、还要一些公共的类型声明、断言的定义等等。

下面是该目录的截图：

在这里插入图片描述

下面对该目录的部分文件介绍：

1）common子目录

该目录 s32_core_cm4.h/s32_core_cm0.h 主要是 cm0/4 内核定义相关的操作。比如全局中断的开启和关闭、进入低功耗、获取内核ID等相关的宏定义，这些定义都是使用汇编指令操作的。

2）S32K1xx 各系列型号的子目录

这些目录主要是各系列的 S32K1xx.h ，属性头文件、各个编译器平台的启动文件和链接文件、xxx.svd 仿真文件等等。

比如以 S32K144 子目录为例：

  • S32K144.h 这个文件是对应芯片型号的寄存器结构体定义、寄存器位域的宏定义、各个外设中断号的定义、一些公共操作的宏定义等等。

  • S32K144_features.h 这个文件定义的是对应芯片型号外设的属性，特点全是 FEATURE_xxxxxx 这样的宏定义。另外还定义了芯片勘误表的信息，以 ERRATA 开头。部分勘误表的宏定义如下：

    /* @brief ARM Errata 838869: Store immediate overlapping exception return operation might vector to
 * incorrect interrupt. */
#define ERRATA_E9005

/* @brief ARM Errata 709718: VDIV or VSQRT instructions might not complete correctly when very
 * short ISRs are used. */
#define ERRATA_E6940

/* @brief E10655: When using LPSPI in master mode and the SR[MBF] bit is read as a one, then, the
 * flag is set. If it is read as a zero, it must be read second time and this second read will be
 * the correct state of the bit. */
#define ERRATA_E10655

    ERRATA_E9005 这个E9005就是勘误表的编号，上面有注释说明该勘误编号修正了什么内容。如果在这个头文件定义了这个勘误码，那么会使能对应勘误码的错误修正代码。

3）startup子目录

很明显就是包含各个编译器平台的汇编启动文件，还有一个system_S32K144.c/h文件，下面主要介绍下 system 文件，汇编的启动文件到时研究启动过程时再学习记录。

system_S32K144.c 文件是ARM公司规定的 Cortex M 系列MCU的软件接口标准(CMSIS)规定的系统和时钟初始化API函数。主要有3个函数：

  • SystemInit ：系统的初始化函数。该函数主要作用是使能 FPU、关闭 WatchDog、使能 I-Cache （CPU内部指令高速缓存）。
  • SystemCoreClockUpdate ：系统内核时钟更新函数，不过在 SDK 中并没有调用这个函数。但是用户可以调用这个函数对MCU时钟进行初始化，当然 PD 层外设驱动代码也有系统时钟的初始化函数。
  • SystemSoftwareReset ：MCU的软件复位函数，操作的是内核 SCB 寄存器实现的MCU软件复位。

4）devices子目录的其他文件

  • startup.c/h ：里面实现了一个 init_data_bss() 函数，下面列出 __ARM_CC 编译器的部分代码：

    /* Copy initialized data from ROM to RAM */
while (data_rom_end != data_rom)
{
    *data_ram = *data_rom;
    data_ram++;
    data_rom++;
}

/* Copy functions from ROM to RAM */
while (code_rom_end != code_rom)
{
    *code_ram = *code_rom;
    code_ram++;
    code_rom++;
}

/* Clear the zero-initialized data section */
while(bss_end != bss_start)
{
    *bss_start = 0;
    bss_start++;
}

/* Copy customsection rom to ram */
while(custom_rom_end != custom_rom)
{
    *custom_ram = *custom_rom;
    custom_rom++;
    custom_ram++;
}

/* Copy the vector table from ROM to RAM */
/* Workaround */
for (n = 0; n < (((uint32_t)(vector_table_size))/sizeof(uint32_t)); n++)
{
    vector_ram[n] = vector_rom[n];
}
/* Point the VTOR to the position of vector table */
*s_vectors[coreId] = (uint32_t) __VECTOR_RAM;

    从这个代码内容可以看出，主要完成的工作是：

    1. 初始化 .data 段。其实就是把已经初始化的全局变量或者静态局部变量从 Flash 复制到 RAM 中
    2. 初始化 .code_ram 段。就是用户写的代码，声明需要在RAM中运行的代码，那么就把那部分代码从 FLASH 复制到 RAM 中。
    3. 清除 .bss 段。目的就是把初值为0的全局变量，或者静态局部变量，所占用的那一段RAM空间清0.
    4. 初始化 .custom_ram 。就是用户自定义的数据段，然后这些数据是有初始值的（初值不是0），然后把这段数据，从Flash复制到RAM中。
    5. 把外设的中断向量表从Flash复制到RAM中，并且把新的中断向量表地址赋值给CPU内部的中断向量基地址寄存器。

上面复制数据的过程中，都需要知道从哪里复制、复制到哪里去、复制的长度这3条信息。这些其实都可以通过链接文件获取到。

疑问：这里有点点疑问，为什么要把中断向量表复制到RAM？程序又没有在RAM中运行，除非程序被搬运到了RAM运行才需要重定向中断向量表吧？后面估计需要研究下启动过程才能了解清楚。

  • callbacks.h ：定义了全局的中断事件类型、中断回调函数类型。

    /* UART 外设的事件类型定义 */
/*!
 * @brief Define the enum of the events which can trigger UART callback
 *
 * This enum should include the events for all platforms
 *
 * Implements : uart_event_t_Class
 */
typedef enum
{
    UART_EVENT_RX_FULL      = 0x00U,    /*!< Rx buffer is full */
    UART_EVENT_TX_EMPTY     = 0x01U,    /*!< Tx buffer is empty */
    UART_EVENT_END_TRANSFER = 0x02U,    /*!< The current transfer is ending */
    UART_EVENT_ERROR        = 0x03U,    /*!< An error occured during transfer */
} uart_event_t;

/* UART 外设的回调函数类型定义 */
/*!
 * @brief Callback for all peripherals which support UART features
 *
 * Implements : uart_callback_t_Class
 */
typedef void (*uart_callback_t)(void *driverState, uart_event_t event, void *userData);

    可以看出每个外设的类型定义 xxx_event_t ，然后回调函数类型是 xxx_callback_t ，其中 xxx 就是外设的名称。

  • devassert.h ：S32 SDK 内部所有函数都使用了断言的机制，用于检查用户输入的参数是否合法。这个文件就是断言宏的定义，用户可以定义自己的断言函数，又或者使用SDK定义的默认的断言函数。

  • device_registers.h ：该文件包含所有系列MCU的外设头文件，然后通过定义某个芯片的宏定义，具体包含哪个芯片的头文件。

  • status.h ：该文件定义了全局的状态码，主要是指示外设驱动代码的API函数操作成功还是其他什么错误状态。

3.5.2 platform/drivers目录

该目录存放的就算 PD （外设驱动层）的驱动代码，包含了所有MCU外设的驱动。每个外设就是一个子文件夹。下面以edma外设为例，介绍下文件的作用。

1、edma 外设的源文件目录：

在这里插入图片描述

  • edma_driver.c 就是对用户开放的外设驱动层 API 函数的定义和实现，用户可以调用这些函数编写应用程序。
  • edma_hw_access.c/.h 文件，外设寄存器访问函数的实现。这些函数大部分都是 inline （内联函数），会被 edma_driver.c 文件实现的驱动封装函数所调用。这些函数是不对用户开放的函数。
  • edma_irq.c/.h 文件，这些函数都是 .s 启动文件中断向量表定义的函数，然后在这些文件实现了。这些函数的函数名一定是要和中断向量表的函数名一致的，不然发生了中断就找不到中断的入口了。函数内部调用的是 driver 层实现的中断处理函数，比如 EDMA_DRV_IRQHandler() 函数。

2、drivers/inc目录：

在这里插入图片描述

就是对用户开放的函数声明，以及结构体、宏定义、枚举等数据类型的声明和定义。每一个外设都有一个 xxx_driver.h 的头文件。

3.5.3 platform/pal目录

这个目录放的就是 PAL（外设抽象层）驱动代码了。外设抽象层其实就是外设驱动层代码的进一步封装，PAL的函数实现是调用了PD层的函数的。

下面是PAL层的软件架构：

在这里插入图片描述

PAL层的主要特性有：

  • 一系列外设的接口抽象（例如 LPUART + LINFlexD_UART + eSCI + FlexIO_UART + 等）
  • 每个 SDK 单层
  • 多个平台上的相同通用 API，可以具有跨平台的特性。

PAL层代码开发适用的场景：

  • 每当应用程序需要一个简化的通用接口来尽可能多地抽象底层芯片功能时。
  • 每当开发可移植的更高级别通用代码时，这些代码都旨在在不同的 NXP 平台上运行。这可能包括从低级控制台实用程序库到 TCP/IP 等通信堆栈的任何内容。

3.6 rtos

该目录存放的是已经适配了 S32K1xx 系列芯片的 FreeRTOS 源码（FreeRTOS_S32K子目录）以及 rtos 接口层代码的实现（osif子目录）。下面介绍下 osif 子目录。

在这里插入图片描述

  • osif_freertos.c 基于 FreeRTOS 实现的 os 接口层API函数，比如信号量、互斥量、任务创建等等和RTOS有关的接口。
  • osif_baremetal.c 基于裸机实现的操作系统接口层。没有任务相关的接口函数，但是有互斥量、信号量、嘀嗒心跳等一些API接口。

3.7 tools

这个目录存放的应该是一些工具文件，但是我还不了解文件怎么使用。后面再探索。

4. 总结

到这里，就对 S32K1xx SDK 做了基本的介绍，可以说是大致了解了这个SDK了。但是怎么去使用这个SDK，它的各个外设编程思路又是怎么样的，各个外设又有哪些数据结构，SDK的中断的处理机制是怎么样的…等等。这些都是我到目前为止的一些疑问，后面的学习中慢慢了解这些内容吧。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/782524.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

数据库备份还原-mysqldump、mydumper、xtrabackup、压缩

数据库备份还原-mysqldump、mydumper、xtrabackup、压缩

数据库备份&#xff0c;数据库为school&#xff0c;素材如下 一、创建student和score表 CREATE TABLE student ( id INT(10) NOT NULL UNIQUE PRIMARY KEY , name VARCHAR(20) NOT NULL , sex VARCHAR(4) , birth YEAR, department VARCHAR(20) , address VARC…
阅读更多...
Windows bat 查找文件被哪个进程占用，并终止该进程

Windows bat 查找文件被哪个进程占用，并终止该进程

一、背景 我有个批处理脚本如下&#xff1a; echo off chcp 936 & cls cd /D F:\Chen\python3\ExciseC set fdate%date:~0,4%%date:~5,2%%date:~8,2% python main.py >> crawl_record_%fdate%.log 2>&1 for /F %%f in (dir crawl_record_*.log /B ^| find /…
阅读更多...
关于Swift中闭包和OC中block对局部变量基本数据类型值的捕获

关于Swift中闭包和OC中block对局部变量基本数据类型值的捕获

翻了很多文章&#xff0c;发现关于Swift闭包关于上下文变量捕获这块&#xff0c;都没有说的很详细&#xff0c;或者Swift2这样的老版本已经不适用了&#xff0c;问了GPT也是和自己实验的结果不一样&#xff0c;记录下来。 一&#xff1a;OC的block 首先&#xff0c;回顾一下O…
阅读更多...
varnish入门

varnish入门

b站视频 官网 docker安装varnish 某位博客园的varnish系列 varnish04-varnish如何使用VCL 3varnish的原理 varnish是什么 varnish的安装 VCL基础 Varnish Configuration Language (VCL)是一种特定于领域的语言&#xff0c;可以用于描述Varnish Cache服务如何处理请求和缓存…
阅读更多...
ONE-PEACE论文解读

ONE-PEACE论文解读

文章目录 1. 摘要2. 引言3. 算法3.1 结构模态自适应器3.2 模态融合编码器3.3 任务 4. 实验4.1 视觉任务4.2 音频任务4.3 视觉语言任务4.4 消融实验4.5 zero-shot检索 5. 结论 论文&#xff1a; 《ONE-PEACE: EXPLORING ONE GENERAL REPRESENTATION MODEL TOWARD UNLIMITED MOD…
阅读更多...
Mysql最左匹配原则和索引下堆

Mysql最左匹配原则和索引下堆

前言&#xff1a; 最左匹配的基础是联合索引 联合索引 联合索引也称为符合索引&#xff0c;适用于多条件查询。 简单说&#xff0c;它是按多个列建立起来的索引&#xff0c;此外联合索引也是有顺序的。 如下图&#xff0c;以A列和B列建立复合索引&#xff0c;某一层节点&…
阅读更多...
学习路之PHP--计算2个坐标点之间距离、时间比较

学习路之PHP--计算2个坐标点之间距离、时间比较

一、计算2个坐标点之间距离 /** * 根据起点坐标和终点坐标测距离 * param [array] $from [起点坐标(经纬度),例如:array(118.012951,36.810024)] * param [array] $to [终点坐标(经纬度)] * param [bool] $km 是否以公里为单位 false:米 true:公里(千米) …
阅读更多...
matlab pcnormals()函数的功能 详解

matlab pcnormals()函数的功能 详解

官方解释&#xff1a; pcnormals - Estimate normals for point cloud This MATLAB function returns a matrix that stores a normal for each point in the input ptCloud. normals pcnormals(ptCloud) normals pcnormals(ptCloud,k) 输入参数 ptClo…
阅读更多...
捷米特PROFINET总线协议网关介绍

捷米特PROFINET总线协议网关介绍

关于PROFINET PROFINET由PROFIBUS国际组织&#xff08;PROFIBUS International&#xff0c;PI&#xff09;推出&#xff0c;是新一代基于工业以太网技术的自动化总线标准。 PROFINET为自动化通信领域提供了一个完整的网络解决方案&#xff0c;囊括了诸如实时以太网、运动控制…
阅读更多...
详解 Linux 常用命令

详解 Linux 常用命令

目录 简单介绍 Linux 左侧信息栏 命令 ls ll cd pwd ctrl l touch cat man echo vim vimtutor mkdir rm cp mv grep ps 面试题: 简单介绍 当我们说"Linux"时&#xff0c;通常指的是一种开源的计算机操作系统。Linux 是一个基于 UNIX 操作系…
阅读更多...
24.实现线性拟合和相关系数（matlab程序）

24.实现线性拟合和相关系数（matlab程序）

1.简述 1. 基本语法 1.1 corr函数基本语法 语法 说明 rho corr(X) 返回输入矩阵X中每对列之间的两两线性相关系数矩阵。 rho corr(X, Y) 返回输入矩阵X和Y中每对列之间的两两相关系数矩阵。 [rho, pval] corr(X, Y) 返回pval&#xff0c;一个p值矩阵&#xff0c…
阅读更多...
SpringBoot静态资源访问及参数处理

SpringBoot静态资源访问及参数处理

静态资源访问&#xff1a; 资源访问&#xff1a; 1&#xff1a;Spring Boot 支持静态和模板化的欢迎页面。它首先在配置的静态内容位置中查找index.html文件。如果未找到&#xff0c;则查找index相关模板。如果找到任一&#xff0c;它将自动用作应用程序的欢迎页面。 2&…
阅读更多...
【单片机】MSP430F149单片机，晨启，音乐播放器，蜂鸣器音乐

【单片机】MSP430F149单片机，晨启，音乐播放器，蜂鸣器音乐

四、音乐播放器 任务要求&#xff1a; 设计制作一个简易音乐播放器&#xff08;通过手柄板上的蜂鸣器发声&#xff0c;播放2到4首音 乐&#xff09;&#xff0c;同时LED模块闪烁&#xff0c;给人视、听觉美的感受。 评分细则&#xff1a; 按下播放按键P15开始播放音乐&#x…
阅读更多...
MCP4725介绍和STM32模拟IC2驱动

MCP4725介绍和STM32模拟IC2驱动

一.MCP4725 简单总结为下面几个特点。 1路DAC输出 12位分辨率 I2C 接口&#xff08;标准&#xff0c;快速&#xff0c;高速支持&#xff09; 供电电压2.7-5.5 内部EEPROM存储设置 I2C地址可配置&#xff08;A0&#xff09;&#xff08;A1、A2内置&#xff0c;默认为‘00’&…
阅读更多...
『Dubbo SPI源码分析』@Adaptive 机制分析

『Dubbo SPI源码分析』@Adaptive 机制分析

『Dubbo SPI源码分析』Adaptive 机制分析 基于 2.7.0 版本上一章&#xff1a;『Dubbo SPI源码分析』依赖注入机制分析 创建测试 demo 首先创建一个接口&#xff0c;举例为 Car package com.luban.dubbo_spi.api;SPI public interface Car {public void getColor();Adaptive…
阅读更多...
pycharm中运行py文件时，报错：找不到自己编写的包等目录问题ModuleNotFoundError: No module named ‘xxx‘

pycharm中运行py文件时，报错：找不到自己编写的包等目录问题ModuleNotFoundError: No module named ‘xxx‘

【问题描述】&#xff1a;pycharm中运行py文件时&#xff0c;报错&#xff1a;找不到自己编写的包等目录问题 【报错】: ModuleNotFoundError: No module named ‘xxx’ ERROR: file not found 【问题定位】&#xff1a;运行的py文件和用到的包或者数据不在同一个文件目录下时…
阅读更多...
【HanLP】--自然语言处理场景应用

【HanLP】--自然语言处理场景应用

目录 一、前言二、Springboot集成HanLP三、HanLP分词四、HanLP的关键字提取一、前言 HanLP 是由一系列模型与算法组成的工具包，主要功能包括分词、词性标注、关键词提取、自动摘要、依存句法分析、命名实体识别、短语提取、拼音转换、简繁转换等等。 下面将介绍HanLP如何本地…
阅读更多...
PHP swoole从入门到精通（一、如何安装swoole及phpStorm服务端代码同步设置）

PHP swoole从入门到精通（一、如何安装swoole及phpStorm服务端代码同步设置）

swoole安装直接在宝塔后台-》安装扩展 phpStorm服务端代码同步设置 https://www.cnblogs.com/yszr/p/9009961.html 软件下载地址 代码上传下载&#xff0c;鼠标右击任何一个文件或者文件夹&#xff0c;选择 Development->上传/下载/同步 点击工具栏Tools->Development…
阅读更多...
前端个人年终工作总结精选7篇

前端个人年终工作总结精选7篇

一、工作总结的种类 1、按总结的时间分&#xff0c;有年度总结、半年总结、季度总结、学期总结。进行某项重大任务时&#xff0c;还要分期总结或叫阶段总结。 2、按总结的范围分&#xff0c;有单位总结、个人总结、综合性总结、专题总结等。 3、按总结的性质分&#xff0c;有…
阅读更多...
科普 | OSI模型

科普 | OSI模型

本文简要地介绍 OSI 模型 1’ 2’ 3。 更新&#xff1a;2023 / 7 / 23 科普 | OSI模型 术语节点链路协议网络拓扑 概念作用结构应用层表示层会话层传输层网络层数据链路层物理层 数据如何流动OSI 和TCP/IP 的对应关系和协议参考链接 术语 节点 节点&#xff08; Node &#…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023