总结——TI_音频信号分析仪

一、简介

设备：MSPM0G3507

库：CMSIS-DSP TI

数据分析：FFT

软件：CCS CLion MATLAB

目的：对音频信号进行采样（滤波+偏置处理），通过FFT获取信号的频率成分，得到频率谱、幅值谱和功率谱

二、可行性分析

1，MATLAB

①先设置一个序列模拟实际采样数据

假设采样频率为20.48KHz，那么我们可以设置一个频率为1/20Hz的正弦函数来生成采样数据，采样数据所代表的波形为1.024KHz的正弦波

f = 1/20;    
X = (i*sin(2*pi*f*t) + 1000)*0.001; %电压

②将采样数据通过FFT转为频谱

Y = fft(X);

③对频谱进行取模处理，得到幅值谱

A = abs(Y); % 幅度谱

④通过帕斯瓦尔定理，将幅值谱转为功率谱

根据帕斯瓦尔定理，可得****，即幅值谱数据的平方除以2等于采样数据的平方。

但由于只取正频率，那么还需要乘以2

P = A.^2 / (N/2);

⑤注意事项

得到的功率谱由于是直接通过模长的平方得到，那么其单位应为（采样数据的单位V），并非

2，代码

clc;
clear all;
close all;

% 1. 构建一个序列x
N = 1024;
t = (0:N-1)'; % 创建时间向量
f = 1/20;     % 假设ADC采样频率为20.48KHz，那么这个序列为20.48/20KHz的正弦波

yuan=[2.5,10,22.5,40,62.5,90,122.5,160];%源自实际信号功率
j=1;

for i=100:100:800

X = (i*sin(2*pi*f*t) + 1000)*0.001; %电压

% 2. 转为频域
Y = fft(X);

% 3. 把Y转为幅值谱
A = abs(Y); % 幅度谱
frequencies = (1:1: N/2+1); % 频率轴
A = A(2:N/2+1); % 只取正频率部分，去除直流分量

% 4. 使用帕斯瓦尔定理转为功率谱
% Parseval定理表明时域能量等于频域能量
% 所以功率谱可以通过幅度谱的平方获得
P = A.^2 / (N/2); % 功率谱，归一化因子为N/2，因为我们只考虑正频率部分

% 画图
figure;
subplot(2,1,1);
plot(frequencies(2:end), A); % 从第二个点开始绘制，排除直流分量
title('Amplitude Spectrum');
xlabel('Frequency (Hz)');
ylabel('Magnitude');

subplot(2,1,2);
plot(frequencies(2:end), P); % 从第二个点开始绘制，排除直流分量
title('Power Spectrum');
xlabel('Frequency (Hz)');
ylabel('Power');

% 打印功率谱中的极大值
[maxP, indexMaxP] = max(P);
fprintf('%dmV:功率谱中的极大值位于频率 %d ，功率值为 %fV(或者V^2)\n', i,frequencies(indexMaxP), maxP);
fprintf('实际功率值为 %fmW,则阻抗为:%f\n\n',yuan(j),maxP/yuan(j)*1000);
j=j+1;

end

3，仿真结果

图像中舍去了直流成分，正弦波的频率成分只有一个尖峰，很合理

三、代码设计

1，库函数介绍

这次编程一共涉及到CMSIS-DSP的这两个函数，后面将以采样1024个数据为例。

同时要注意哈，由于音频信号频率一般在几十Hz到10KHz以内，根据奈奎斯特定律，采样频率应为20KHz以上。由于采样数据为1024个，想要让分辨率整一点，所以选用20.48KHz。分辨率为20.48K/1024=20

arm：表示适用arm平台

cfft：c即complex（复数），fft：快速傅里叶变换，f32：float32数据类型

mag：幅值？反正把频谱转为幅值谱

arm_cfft_f32(&arm_cfft_sR_f32_len1024, fftArray, IFFTFLAG, BITREVERSE);

 arm_cmplx_mag_f32(inputArray, outputArray, NUM_SAMPLES / 2);

①arm_cfft_f32

第一个参数 是个 CMSIS-DSP 里已经定义好的实例，在arm_const_structs.h 头文件里，且见名知义。由于采样数据是1024个（一般选用4的倍数，基4更快嘛），所以选用len1024

第二个参数就是输入的数组，准确来说是复数数组，因此你需要一个更大的数组，1024*2的数组大小。每两个相邻数组分别存放复数的实部和虚部，实部就是ADC的采样数据，虚部放0.

第三个参数是表明进行的是正变换还是逆变换。我们需要进行正变换，添0

第四个参数 是序列翻转，添1就行。详情请见

② arm_cmplx_mag_f32

第一个参数是从arm_cfft_f32得到的复数数组（频谱）

第二个参数是接收转换后的幅值谱，是实数数组，只不过数组大小为1024/2，因为对称性，除了直流成分，数组前半部分与后半部分对称。

第三个参数就是数组大小，添1024/2

2，用户函数设计

除了幅值谱外，我们还需要失真度分析、电压幅值谱、功率谱、幅值谱中极大值点等

①获取幅值谱中极大值点

跟AI（智谱、通义）进行一顿交互、辩论得到的极大值寻找函数（不是最优），用于获取幅值谱中峰值的索引。窗口大小不能太小，否则容易误判，太大则会找不到几个极大值点。

static inline void find_peaks(const float32_t *fftOutput, uint16_t fftLength, uint16_t *peaks, uint32_t NumPeaks, uint16_t windowSize)
{
    float32_t maxVal;
    uint16_t maxIdx;
    uint16_t halfWindowSize = windowSize / 2;//以一般理性而言，不会为0
    uint16_t numPeaks = 1;                   //从一次谐波开始

    //重置
    for (uint16_t i = 0; i <NumPeaks ; ++i)
    {
        peaks[i] = 0;
    }
    // 开始寻找交流成分
    for (uint16_t i = halfWindowSize; i < 512 - halfWindowSize; i++)
    {
        maxVal = fftOutput[i];
        maxIdx = i;

        // 在滑动窗口内查找最大值
        for (uint16_t j = i - halfWindowSize; j <= i + halfWindowSize; j++)
        {
            if (fftOutput[j] > maxVal)
            {
                maxVal = fftOutput[j];
                maxIdx = j;
            }
        }

        // 检查窗口中心点是否为窗口内的最大值
        if (maxIdx == i)
        {
            // 检查是否与最近的极大值足够远
            if (peaks[numPeaks] == 0 || (i - peaks[numPeaks - 1]) > windowSize)
            {
                peaks[numPeaks] = i;//peaks存的是索引
                ++numPeaks;

                //存满以后就退出
                if (numPeaks == NumPeaks)
                    return;
            }
        }
    }
}

②功率谱

根据前面MATLAB分析，只需对幅值谱（准确说是幅值谱中的极大值）进行平方和归一化处理即可

Tips：

之前做功率谱分析时，错误地将已转换为电压幅值谱当做输入。应将经由arm_cmplx_mag_f32得到的幅值谱直接转换为功率谱，不必经由第三方。

static inline float32_t powerCalculate(const float32_t *fft_Array, const uint16_t *peaks, uint16_t NumPeaks, float *power)
{
    float sum = 0;
    //总功率应去除直流量
    for (uint16_t i = 0; i <NumPeaks ; ++i)
    {
        power[i]=0;
    }

    for (uint16_t i = 1; i < NumPeaks; i++)
    {
        if (peaks[i] == 0)
        {
            break;//说明谐波已经取完
        }
        power[i] = fft_Array[peaks[i]] * fft_Array[peaks[i]] * 2 / NUM_SAMPLES;//由于只取正频率，故进行归一化处理
        sum += power[i];
    }
    return sum;
}

③幅值谱转为对应的电压幅值谱

听起来拗口，其实还挺变扭。就是把幅值谱中的幅值转为实际上的电压，因为幅值谱中的幅值代表的物理意义并非是电压，不过它与电压有个对应关系（注释里）。

static inline void voltageAmplitude_Convert(float32_t inputArray[], float32_t outputArray[])
{
    //假设原始信号的峰值为A，那么FFT的结果的每个点（除了第一个点直流分量之外）的模值就是A的N/2倍。而第一个点就是直流分量，它的模值就是直流分量的N倍。
    /**将幅值谱转为电压幅值谱*/
    for (uint16_t i = 1; i < NUM_SAMPLES / 2; ++i)
    {
        //理论上模值为峰峰值的N/2倍，实测中还应再除以0.75，后来发现就不需要了
        fft_outputbuf[i] = (float32_t) (fft_outputbuf[i] * 2 / NUM_SAMPLES);
    }
    fft_outputbuf[0] /= NUM_SAMPLES;
}

④失真度计算

二次及二次以上的谐波成分的平方和除以基波的平方，然后再开方。

此时你会发现，谐波应为基波的整数倍，也就是说除了通过查找多个峰值的办法，还可以先找到第一个峰值的索引（需先去除直流量），然后把这个索引乘以相应倍数获得对应谐波。CMSIS-DSP有这个找峰值的函数，叫arm_max_f32，记得要去除直流成分。

static inline void signalDistortionDegree(const float32_t *fft_Array, const uint16_t *peaks, uint16_t NumPeaks, float *thd)
{
    float sum = 0;
    //从二次谐波开始计算平方和
    for (uint16_t i = 2; i < NumPeaks; i++)
    {
        if (peaks[i] == 0)
        {
            break;//说明谐波已经取完
        }
        sum += fft_Array[peaks[i]] * fft_Array[peaks[i]];//平方和
    }
    sum /= (fft_Array[peaks[1]] * fft_Array[peaks[1]]);//除以1次谐波的平方
    *thd = sqrtf(sum) * 100;                           //计算出失真度，并转为百分比表示
}

3，代码

这里面需要关注的主体函数是 void SignalAnalyzer_handler();这个函数是放到while大循环里的（MSPM0的内存实在太小，只能先放弃RTOS）

里面可能有部分注释忘记修改，还请见谅。

//
// Created by 34753 on 2024/7/18.
//

#include "SignalAnalyzer.h"
#if SignalAnalyzer_Open
#include "ADC.h"
#include "LED.h"
#include "OPA.h"
#include "arm_const_structs.h"
#include "arm_math.h"

/**宏定义*/
#define NUM_SAMPLES 1024//采样点
#define AV 1           //放大增益
#define NUM_PEAKS 9     //取9-1个基波和谐波成分

#define IFFTFLAG 0  //正变换
#define BITREVERSE 1//逆序排列


/**变量*/
int16_t ADC_Data[1024];                  //ADC采样数据
float32_t fft_inputBuff[NUM_SAMPLES * 2];//存储复数的数组
float32_t fft_outputbuf[NUM_SAMPLES / 2];//存储实数的数组，由于奈奎斯特的特性，需要除以2

// 为了某种目的，包含了直流成分
uint16_t peaks[NUM_PEAKS];//幅值谱的极大值点
float power[NUM_PEAKS];   //功率谱
float totalPower;         //总功率单位为V^2
float thd;                //失真度

volatile bool waitADCData_Flag = true;//用于检测是否需要等待


void SignalAnalyzer_Init()
{
    OPA_Init();
    ADC_DMA_Init(ADC_Data, 1024);
}

#if 0
//计算失真度
void THD(void)
{
    thd_basic = fft_outputbuf[10];

    u[0] = fft_outputbuf[20];
    u[1] = fft_outputbuf[30];
    u[2] = fft_outputbuf[40];
    u[3] = fft_outputbuf[50];
    u[4] = fft_outputbuf[60];

    arm_power_f32(u, 4, &sum);
    arm_sqrt_f32(sum, &thd_high);

    thd = thd_high / thd_basic;
}

//计算总功率和各频率分量的频率和功率
void MW(void)
{
    thd_basic = fft_outputbuf[10];

    u[0] = fft_outputbuf[20];
    u[1] = fft_outputbuf[30];
    u[2] = fft_outputbuf[40];
    u[3] = fft_outputbuf[50];
    u[4] = fft_outputbuf[60];
    arm_power_f32(&u[0], 4, &sum);

    MW_total = sum / 5;
}
#endif

/**
 * @brief   频率谱转为电压幅值谱
 * @param inputArray 经fft转换后的频率谱数组
 * @param outputArray 输出的电压幅值谱数组
 * @note    原本需要在实测中除以0.75，后来就不需要了，原因未知
 */
static inline void voltageAmplitude_Convert(float32_t inputArray[], float32_t outputArray[])
{
    //假设原始信号的峰值为A，那么FFT的结果的每个点（除了第一个点直流分量之外）的模值就是A的N/2倍。而第一个点就是直流分量，它的模值就是直流分量的N倍。
    /**将幅值谱转为电压幅值谱*/
    for (uint16_t i = 1; i < NUM_SAMPLES / 2; ++i)
    {
        //理论上模值为峰峰值的N/2倍，实测中还应再除以0.75,后来发现就不需要了
        fft_outputbuf[i] = (float32_t) (fft_outputbuf[i] * 2 / NUM_SAMPLES);//384
    }
    fft_outputbuf[0] /= NUM_SAMPLES;
}

static inline void Amplitude_Convert(float32_t inputArray[], float32_t outputArray[])
{
    //计算信号的幅度谱  第一个参数指定了需要计算复数模的数组指针，第二个参数指定了计算结果存放的数组指针，第三个参数是需要计算复数模的数据个数。
    // 分辨率=fs（采样频率）/N（采样点数）  output输出数组，索引*分辨率=频率成分
    arm_cmplx_mag_f32(inputArray, outputArray, NUM_SAMPLES / 2);
}


/**
 * @brief   ADC数据转为频谱
 * @param ADCdata   ADC采样数据
 * @param fftArray   频谱数组
 */
static inline void ADCdataToSpectrum(const int16_t ADCdata[], float32_t fftArray[])
{
    /**将实数序列转为复数序列*/
    for (uint32_t i = 0; i < NUM_SAMPLES; ++i)
    {
        fftArray[i * 2] = (float) (ADCdata[i] * 3.3 / (4095 * AV));//转为实际电压，单位为V
        fftArray[i * 2 + 1] = 0;                                   //虚部为零
    }

    假设ADC里的就是电压值V，可以为mV，不过功率的单位应该为uW
    //    for (uint32_t i = 0; i < NUM_SAMPLES; ++i)
    //    {
    //        //w[i]=0.5*(1-arm_sin_f32(2*PI*i/(NUM_SAMPLES-1)));
    //        fftArray[i * 2] = (float) (ADCdata[i] * 0.001);
    //        //  fftArray[i * 2]=fftArray[i * 2]*w[i];
    //        fftArray[i * 2 + 1] = 0;
    //    }

    /**
 * 对ADC数据进行1024点的复数快速傅里叶变换（FFT）。
 *
 * ADC数据被转换到频域，存储了1024个复数样本。
 * 每个元素存储复数的实部和虚部，实部存储在偶数索引位置，虚部存储在奇数索引位置。
 *
 * FFT输出存储在ADC_DataOut中，包含了每个频率分量的幅度信息。
 * 返回ADC_DataOut中幅度最大的频率分量的索引，即第5个FFT点（0索引）。
 *
 * @param ADC_Data      输入的ADC数据数组
 * @param ADC_DataOut   输出的FFT结果数组
 * @param arm_max_q15    用于在ADC_DataOut中找到最大幅度值及其索引的函数
 */

    arm_cfft_f32(&arm_cfft_sR_f32_len1024, fftArray, IFFTFLAG, BITREVERSE);
}


/**
 * @brief   寻找峰值
 * @param fftOutput
 * @param fftLength
 * @param peaks 存储极大值点的数组
 * @param numPeaks  极大值点个数
 * @param windowSize 窗口大小应为奇数，太小会错过极大值，太大会判断错误极大值
 */
static inline void find_peaks(const float32_t *fftOutput, uint16_t fftLength, uint16_t *peaks, uint32_t NumPeaks, uint16_t windowSize)
{
    float32_t maxVal;
    uint16_t maxIdx;
    uint16_t halfWindowSize = windowSize / 2;//以一般理性而言，不会为0
    uint16_t numPeaks = 1;                   //从一次谐波开始

    //重置
    for (uint16_t i = 0; i <NumPeaks ; ++i)
    {
        peaks[i] = 0;
    }
    // 开始寻找交流成分
    for (uint16_t i = halfWindowSize; i < 512 - halfWindowSize; i++)
    {
        maxVal = fftOutput[i];
        maxIdx = i;

        // 在滑动窗口内查找最大值
        for (uint16_t j = i - halfWindowSize; j <= i + halfWindowSize; j++)
        {
            if (fftOutput[j] > maxVal)
            {
                maxVal = fftOutput[j];
                maxIdx = j;
            }
        }

        // 检查窗口中心点是否为窗口内的最大值
        if (maxIdx == i)
        {
            // 检查是否与最近的极大值足够远
            if (peaks[numPeaks] == 0 || (i - peaks[numPeaks - 1]) > windowSize)
            {
                peaks[numPeaks] = i;//peaks存的是索引
                ++numPeaks;

                //存满以后就退出
                if (numPeaks == NumPeaks)
                    return;
            }
        }
    }
}

/**
 * @brief  计算失真度
 * @param fft_Array
 * @param peaks
 * @param NumPeaks
 * @param thd
 * @note    失真度的单位是百分比
 */

static inline void signalDistortionDegree(const float32_t *fft_Array, const uint16_t *peaks, uint16_t NumPeaks, float *thd)
{
    float sum = 0;
    //从二次谐波开始计算平方和
    for (uint16_t i = 2; i < NumPeaks; i++)
    {
        if (peaks[i] == 0)
        {
            break;//说明谐波已经取完
        }
        sum += fft_Array[peaks[i]] * fft_Array[peaks[i]];//平方和
    }
    sum /= (fft_Array[peaks[1]] * fft_Array[peaks[1]]);//除以1次谐波的平方
    *thd = sqrtf(sum) * 100;                           //计算出失真度
}


/**
 * @brief  计算功率
 * @param fft_Array
 * @param peaks
 * @param NumPeaks
 * @param power
 * @return
 * @note    为了整齐划一，我把直流量放在power[0]中。同时要注意
 * ①由于数据是采集的电压，那么计算出的功率的单位其实是V^2(不考虑功率谱密度)，若想得到mW，那么需要再除以阻抗
 * ②想通过帕斯瓦尔定理得到功率，那么必须是直接从频率谱转换得到幅值谱，而非是电压幅值谱
 * ③若电压的单位是mV，那么计算出的功率的单位是uW
 */

static inline float32_t powerCalculate(const float32_t *fft_Array, const uint16_t *peaks, uint16_t NumPeaks, float *power)
{
    float sum = 0;
    //总功率应去除直流量
    for (uint16_t i = 0; i <NumPeaks ; ++i)
    {
        power[i]=0;
    }

    for (uint16_t i = 1; i < NumPeaks; i++)
    {
        if (peaks[i] == 0)
        {
            break;//说明谐波已经取完
        }
        power[i] = fft_Array[peaks[i]] * fft_Array[peaks[i]] * 2 / NUM_SAMPLES;//由于只取正频率，故进行归一化处理
        sum += power[i];
    }
    return sum;
}
///**
// * @brief  计算指定频率下的功率
// * @param fft_Array
// * @param fft_output
// */
//
//static inline void powerSpecialCalculate(const float32_t *fft_Array, float *fft_output)
//{
//    float sum = 0;
//    for (uint16_t i = 50; i < 500; i+=50)
//    {
//        power[i] = fft_Array[i] * fft_Array[i] * 2 / NUM_SAMPLES;//由于只取正频率，故进行归一化处理
//        sum += power[i];
//    }
//    return sum;
//}

/**
 * @brief  转为实际功率
 * @param totalPower
 * @param power
 * @param Z
 * @param NumPeaks
 */
static inline void realPower_Convert(float *totalPower, float *power, float Z, uint16_t NumPeaks)
{
    for (uint16_t i = 0; i < NumPeaks; i++)
    {
        power[i] /= Z;
    }
    *totalPower /= Z;
}


void SignalAnalyzer_handler()
{
    while (waitADCData_Flag)
        ;
    waitADCData_Flag = true;

    //    LED_ON(LED2_Blue);//表明转换开启

    ADCdataToSpectrum(ADC_Data, fft_inputBuff);//将ADC数据经FFT 转为频谱

    Amplitude_Convert(fft_inputBuff, fft_outputbuf);//转为幅值谱

    find_peaks(fft_outputbuf, NUM_SAMPLES / 2, peaks, NUM_PEAKS, 41);//寻找极大值点

    totalPower = powerCalculate(fft_outputbuf, peaks, NUM_PEAKS, power);//计算出功率V^2

    realPower_Convert(&totalPower, power, 1788.1, NUM_PEAKS);//转为实际功率W

    voltageAmplitude_Convert(fft_inputBuff, fft_outputbuf);//把频率谱转为电压幅值谱（可以不用加，因为交流成分彼此成齐次性）

    signalDistortionDegree(fft_outputbuf, peaks, NUM_PEAKS, &thd);//计算出失真度

    //    LED_OFF(LED2_Blue);
    //    __BKPT(1);
}

/**ISR中断服务*/
void ADC12_0_INST_IRQHandler(void)
{
    switch (DL_ADC12_getPendingInterrupt(ADC12_0_INST))
    {
        case DL_ADC12_IIDX_DMA_DONE:
            /**开启数据分析*/
            ADC_DMA_Stop();
            waitADCData_Flag = false;
            LED_Toggle(LED2_Blue);
            break;
        default:
            break;
    }
}
#if 0
/***********************************************
找最大值，次大值......对应的频率，分析波形
*************************************************/
void select_max(float *f, float *a)
{
    int i, j;
    float k, k1, m;
    float aMax = 0.0, aSecondMax = 0.0, aThirdMax = 0.0, aFourthMax = 0.0;
    float fMax = 0.0, fSecondMax = 0.0, fThirdMax = 0.0, fFourthMax = 0.0;
    int nMax = 0, nSecondMax = 0, nThirdMax = 0, nFourthMax = 0;
    for (i = 1; i < NUM_SAMPLES / 2; i++)//i必须是1，是0的话，会把直流分量加进去！！！！
    {
        if (a[i] > aMax)
        {
            aMax = a[i];
            nMax = i;
            fMax = f[nMax];
        }
    }
    for (i = 1; i < NUM_SAMPLES / 2; i++)
    {
        if (nMax == i)
        {
            continue;//跳过原来最大值的下标，直接开始i+1的循环
        }
        if (a[i] > aSecondMax && a[i] > a[i + 1] && a[i] > a[i - 1])
        {
            aSecondMax = a[i];
            nSecondMax = i;
            fSecondMax = f[nSecondMax];
        }
    }
    for (i = 1; i < NUM_SAMPLES / 2; i++)
    {
        if (nMax == i || nSecondMax == i)
        {
            continue;//跳过原来最大值的下标，直接开始i+1的循环
        }
        if (a[i] > aThirdMax && a[i] > a[i + 1] && a[i] > a[i - 1])
        {
            aThirdMax = a[i];
            nThirdMax = i;
            fThirdMax = f[nThirdMax];
        }
    }
    for (i = 1; i < NUM_SAMPLES / 2; i++)
    {
        if (nMax == i || nSecondMax == i || nThirdMax == i)
        {
            continue;//跳过原来最大值的下标，直接开始i+1的循环
        }
        if (a[i] > aFourthMax && a[i] > a[i + 1] && a[i] > a[i - 1])
        {
            aFourthMax = a[i];
            nFourthMax = i;
            fFourthMax = f[nFourthMax];
        }
    }
    k = fabsf(2 * fMax - fSecondMax);
    k1 = fabsf(3 * fMax - fSecondMax);
    m = fabsf((float) (aMax - 3.0 * aSecondMax));
    //    if(k<=5)
    //        LCD_ShowString(275,230,12*4,12,12,"JvChi  ");
    //    else if(k1<=5&&m<0.4)
    //        LCD_ShowString(275,230,12*4,12,12,"Fang   ");
    //    else if(k1<=5&&m>=0.4)
    //        LCD_ShowString(275,230,12*4,12,12,"SanJiao");
    //    else LCD_ShowString(275,230,12*4,12,12,"Sin    ");
}
#endif

#endif

四、总结（吐槽）

从STM32换成TI开发挺不习惯的，在STM32里可以各种手搓寄存器，结果到TI这里有一种处处受限的感觉。最直接的体现就是创建工程，充分让你体会到了什么叫不得自由 ，什么工程必须从模板库里创建否则用不了sysconfig （除非想与TI库绝缘）、想使用gcc编译器就必须下载9.2版本等等，稍微对工程做了一点点 修改就直接崩溃了，还是修不好的那种。同时TI又不支持OpenOCD，想使用GDB但板子似乎只支持TI官方的调试工具（总之很难），导致CLion直接被禁。然后就是几天的挣扎，好不容易才得到一个可以运行、稍微符合开发习惯的工程，没敢改太多。

然后就是TI的驱动库，虽然模板、文档很多，但是国内网上的教程过少（无论中英文），处处是坑。最让我无法理解的就是GPIO的配置，在stm32中使用寄存器配置GPIO时，只需要找到对应端口和引脚数就行，结果TI里还需要下面这个东西，what can I say？这除了sysconfig和直接查芯片，根本不知道啊

#define GPIO_OLED_DC_IOMUX (IOMUX_PINCM35)

吐槽归吐槽，经过一段时间的熟悉后，CCS还是很好用的，比如那个图形化展示数据，分析信号时简直犹如神助。当初觉得难估计是从stm32猛地转ti导致的，反过来大概也是一样的吧。

除此之外，再说一下浅显的个人经验，再使用sysconfig初始化工程时，由于习惯了stm32的开发，对于这种纯图形化反而不适应（与CubeMX不同），有时看着配置选项并不如直接看代码清晰，偏偏偏置选项和生成的代码还有些反差萌。所以和之前使用CubeMX一样，只是把它当做一个学习的工具：

导入示例工程，咔咔乱改，生成符合需求的可用代码，把代码添加到自己新建的文件中，并标上注释，一气呵成。

就比如下面的SPI.c/h文件：

//
// Created by 34753 on 2024/7/20.
//

#ifndef ISB_TI_SPI_H
#define ISB_TI_SPI_H
#include "ZQ_Conf.h"
#if USE_SPI
#include "ti_init.h"

#define SPI_0_INST SPI1


void SPI_Init(void);
void SPI_DMA_Init(void);/*不可用*/
void SPI_DMA_Send(uint8_t *data, uint16_t len);/*不可用*/
void SPI_DMA_Repeat_SendWord(uint16_t data, uint16_t times);/**不可用*/
void SPI_DMA_WriteByte(uint8_t data);

__STATIC_INLINE void SPI_WriteByte(uint8_t data)
{
    while (DL_SPI_isBusy(SPI_0_INST))
        ;
    DL_SPI_transmitData8(SPI_0_INST, data);
}

//void SPI_WriteWord(uint16_t data);
void SPI_SendData(uint8_t *data, uint16_t len);
#endif
#endif//ISB_TI_SPI_H

//
// Created by 34753 on 2024/7/20.
//

#include "SPI.h"
#if USE_SPI
#include "LED.h"

/* Defines for SPI_0 */

#define SPI_0_INST_IRQHandler SPI1_IRQHandler
#define SPI_0_INST_INT_IRQN SPI1_INT_IRQn
#define GPIO_SPI_0_PICO_PORT GPIOB
#define GPIO_SPI_0_PICO_PIN DL_GPIO_PIN_8
#define GPIO_SPI_0_IOMUX_PICO (IOMUX_PINCM25)
#define GPIO_SPI_0_IOMUX_PICO_FUNC IOMUX_PINCM25_PF_SPI1_PICO
#define GPIO_SPI_0_POCI_PORT GPIOB
#define GPIO_SPI_0_POCI_PIN DL_GPIO_PIN_7
#define GPIO_SPI_0_IOMUX_POCI (IOMUX_PINCM24)
#define GPIO_SPI_0_IOMUX_POCI_FUNC IOMUX_PINCM24_PF_SPI1_POCI

/* GPIO configuration for SPI_0 */
#define GPIO_SPI_0_SCLK_PORT GPIOB
#define GPIO_SPI_0_SCLK_PIN DL_GPIO_PIN_16
#define GPIO_SPI_0_IOMUX_SCLK (IOMUX_PINCM33)
#define GPIO_SPI_0_IOMUX_SCLK_FUNC IOMUX_PINCM33_PF_SPI1_SCLK

#define GPIO_SPI_0_CS1_PORT GPIOB
#define GPIO_SPI_0_CS1_PIN DL_GPIO_PIN_17
#define GPIO_SPI_0_IOMUX_CS1 (IOMUX_PINCM43)
#define GPIO_SPI_0_IOMUX_CS1_FUNC IOMUX_PINCM43_PF_SPI1_CS1_POCI1


/* Defines for DMA_CH1 */
#define DMA_CH1_CHAN_ID (1)
#define SPI_0_INST_DMA_TRIGGER (DMA_SPI1_TX_TRIG)

static volatile bool SPI_DMA_Mode_Flag = false;//默认模式


static const DL_SPI_Config gSPI_0_config = {
        .mode = DL_SPI_MODE_CONTROLLER,
        .frameFormat = DL_SPI_FRAME_FORMAT_MOTO4_POL1_PHA1,
        .parity = DL_SPI_PARITY_NONE,
        .dataSize = DL_SPI_DATA_SIZE_8,
        .bitOrder = DL_SPI_BIT_ORDER_MSB_FIRST,
        .chipSelectPin = DL_SPI_CHIP_SELECT_1,
};

static const DL_SPI_ClockConfig gSPI_0_clockConfig = {
        .clockSel = DL_SPI_CLOCK_BUSCLK,
        .divideRatio = DL_SPI_CLOCK_DIVIDE_RATIO_1};


static const DL_DMA_Config gDMA_CH1Config = {
        .transferMode = DL_DMA_SINGLE_TRANSFER_MODE,//不可使用RepeatSingle，否则会出现乱波
        .extendedMode = DL_DMA_NORMAL_MODE,
        .destIncrement = DL_DMA_ADDR_UNCHANGED,
        .srcIncrement = DL_DMA_ADDR_INCREMENT,
        .destWidth = DL_DMA_WIDTH_BYTE,
        .srcWidth = DL_DMA_WIDTH_BYTE,
        .trigger = SPI_0_INST_DMA_TRIGGER,
        .triggerType = DL_DMA_TRIGGER_TYPE_EXTERNAL,
};


void SPI_Init(void)
{
    DL_SPI_reset(SPI_0_INST);
    DL_SPI_enablePower(SPI_0_INST);

    /**GPIO初始化*/
    DL_GPIO_initPeripheralOutputFunction(GPIO_SPI_0_IOMUX_SCLK, GPIO_SPI_0_IOMUX_SCLK_FUNC);
    DL_GPIO_initPeripheralOutputFunction(GPIO_SPI_0_IOMUX_PICO, GPIO_SPI_0_IOMUX_PICO_FUNC);
    DL_GPIO_initPeripheralOutputFunction(GPIO_SPI_0_IOMUX_CS1, GPIO_SPI_0_IOMUX_CS1_FUNC);
    DL_SPI_Config gSPI_0_config = {
            .mode = DL_SPI_MODE_CONTROLLER,
            .frameFormat = DL_SPI_FRAME_FORMAT_MOTO4_POL0_PHA0,
            .parity = DL_SPI_PARITY_NONE,
            .dataSize = DL_SPI_DATA_SIZE_8,
            .bitOrder = DL_SPI_BIT_ORDER_MSB_FIRST,
            .chipSelectPin = DL_SPI_CHIP_SELECT_1,
    };

    DL_SPI_setClockConfig(SPI_0_INST, (DL_SPI_ClockConfig *) &gSPI_0_clockConfig);

    DL_SPI_init(SPI_0_INST, &gSPI_0_config);

    /* Configure Controller mode */
    /*
     * Set the bit rate clock divider to generate the serial output clock
     *     outputBitRate = (spiInputClock) / ((1 + SCR) * 2)
     *     500000 = (32000000)/((1 + 31) * 2)
     */
    //  TFT_4SPI最快为  BUS_CLK：80MHz，不分频；SPI： 2分频（添1）
    //  OLED_4SPI最快为    BUS_CLK：80MHz，不分频；SPI： 4分频（添3）
    DL_SPI_setBitRateSerialClockDivider(SPI_0_INST, 3);
    /* Set RX and TX FIFO threshold levels */
    DL_SPI_setFIFOThreshold(SPI_0_INST, DL_SPI_RX_FIFO_LEVEL_1_2_FULL, DL_SPI_TX_FIFO_LEVEL_1_2_EMPTY);

    /* Enable module */
    DL_SPI_enable(SPI_0_INST);
}



//void SPI_WriteWord(uint16_t data)
//{
//    while (DL_SPI_isBusy(SPI_0_INST))
//        ;
//    DL_SPI_transmitData16(SPI_0_INST, data);
//}
void SPI_SendData(uint8_t *data, uint16_t len)
{
    uint16_t i = 0;
    for (i = 0; i < len; i++)
    {
        while (DL_SPI_isBusy(SPI_0_INST))
            ;
        DL_SPI_transmitData8(SPI_0_INST, data[i]);
    }
}

void SPI_DMA_Init(void)
{
#if !USE_TI_SYSCONFIG
    DL_SPI_reset(SPI_0_INST);
    DL_SPI_enablePower(SPI_0_INST);

    /**GPIO初始化*/
    DL_GPIO_initPeripheralOutputFunction(GPIO_SPI_0_IOMUX_SCLK, GPIO_SPI_0_IOMUX_SCLK_FUNC);
    DL_GPIO_initPeripheralOutputFunction(GPIO_SPI_0_IOMUX_PICO, GPIO_SPI_0_IOMUX_PICO_FUNC);
    DL_GPIO_initPeripheralInputFunction(GPIO_SPI_0_IOMUX_POCI, GPIO_SPI_0_IOMUX_POCI_FUNC);
    DL_GPIO_initPeripheralOutputFunction(GPIO_SPI_0_IOMUX_CS1, GPIO_SPI_0_IOMUX_CS1_FUNC);

    /**SPI初始化*/
    DL_SPI_setClockConfig(SPI_0_INST, (DL_SPI_ClockConfig *) &gSPI_0_clockConfig);

    DL_SPI_init(SPI_0_INST, (DL_SPI_Config *) &gSPI_0_config);

    /* Configure Controller mode */
    /*
     * Set the bit rate clock divider to generate the serial output clock
     *     outputBitRate = (spiInputClock) / ((1 + SCR) * 2)
     *     5000000 = (80000000)/((1 + 7) * 2)
     */
    DL_SPI_setBitRateSerialClockDivider(SPI_0_INST, 7);

    /* Enable SPI TX interrupt as a trigger for DMA */
    DL_SPI_enableDMATransmitEvent(SPI_0_INST);
    /* Set RX and TX FIFO threshold levels */
    DL_SPI_setFIFOThreshold(SPI_0_INST, DL_SPI_RX_FIFO_LEVEL_ONE_FRAME, DL_SPI_TX_FIFO_LEVEL_ONE_FRAME);
    DL_SPI_enableInterrupt(SPI_0_INST, (DL_SPI_INTERRUPT_DMA_DONE_TX |
                                        DL_SPI_INTERRUPT_TX_EMPTY));

    /* Enable module */
    DL_SPI_enable(SPI_0_INST);

    /**DMA初始化*/
    DL_DMA_initChannel(DMA, DMA_CH1_CHAN_ID, (DL_DMA_Config *) &gDMA_CH1Config);
#endif
    /**开启SPI中断*/
    NVIC_EnableIRQ(SPI_0_INST_INT_IRQN);
}

void SPI_DMA_Send(uint8_t *data, uint16_t len)
{
    DL_DMA_setSrcAddr(DMA, DMA_CH1_CHAN_ID, (uint32_t) data);
    DL_DMA_setDestAddr(DMA, DMA_CH1_CHAN_ID, (uint32_t) (&SPI_0_INST->TXDATA));
    DL_DMA_setTransferSize(DMA, DMA_CH1_CHAN_ID, len);

    DL_DMA_enableChannel(DMA, DMA_CH1_CHAN_ID);
}

void SPI_DMA_WriteByte(uint8_t data)
{
    DL_DMA_setSrcAddr(DMA, DMA_CH1_CHAN_ID, (uint32_t) data);
    DL_DMA_setDestAddr(DMA, DMA_CH1_CHAN_ID, (uint32_t) (&SPI_0_INST->TXDATA));
    DL_DMA_setTransferSize(DMA, DMA_CH1_CHAN_ID, 1);

    DL_DMA_enableChannel(DMA, DMA_CH1_CHAN_ID);
}

/**
 * @brief   重复传送某字节
 * @param data
 * @param times
 * @note    首先会把模式调为单次模式，然后再把数据写入DMA，最后再开启DMA传输结束后注意把模式切换回来。
 */
void SPI_DMA_Repeat_SendWord(uint16_t data, uint16_t times)
{
    DL_DMA_Config gDMA_CH1Config_temp = {
            .transferMode = DL_DMA_SINGLE_TRANSFER_MODE,//不可使用RepeatSingle，否则会出现乱波
            .extendedMode = DL_DMA_NORMAL_MODE,
            .destIncrement = DL_DMA_ADDR_UNCHANGED,
            .srcIncrement = DL_DMA_ADDR_UNCHANGED,
            .destWidth = DL_DMA_WIDTH_HALF_WORD,
            .srcWidth = DL_DMA_WIDTH_HALF_WORD,
            .trigger = SPI_0_INST_DMA_TRIGGER,
            .triggerType = DL_DMA_TRIGGER_TYPE_EXTERNAL,
    };
    SPI_DMA_Mode_Flag = true;//模式改变
    DL_DMA_initChannel(DMA, DMA_CH1_CHAN_ID, &gDMA_CH1Config_temp);

    DL_DMA_setSrcAddr(DMA, DMA_CH1_CHAN_ID, (uint32_t) &data);
    DL_DMA_setDestAddr(DMA, DMA_CH1_CHAN_ID, (uint32_t) (&SPI_0_INST->TXDATA));
    DL_DMA_setTransferSize(DMA, DMA_CH1_CHAN_ID, times);

    DL_DMA_enableChannel(DMA, DMA_CH1_CHAN_ID);
}

void SPI_RecoverMode(void)
{
    DL_DMA_initChannel(DMA, DMA_CH1_CHAN_ID, (DL_DMA_Config *) &gDMA_CH1Config);
}

void SPI_0_INST_IRQHandler(void)
{
    switch (DL_SPI_getPendingInterrupt(SPI_0_INST))
    {
        case DL_SPI_IIDX_DMA_DONE_TX:
            LED_OFF(LED2_Green);
            LED_ON(LED2_Red);
            break;

        case DL_SPI_IIDX_TX_EMPTY:
            //重置DMA模式
            if (SPI_DMA_Mode_Flag)
                SPI_RecoverMode();
            LED_OFF(LED2_Red);
            break;

        default:
            break;
    }
}

#endif