低成本单发单收激光测距传感器方案 低成本单发单收激光测距全套方案，包括原理图、源代码、PCB、BOM、光学部分资料，结构、特殊元件数据手册及供应商联系方式，提供调试技术文档。 全套方案已成功打板验证，实现0.05~50m测量范围，精度在+/—1.5mm，激光波长635~650nm，功率《1mW。 方案预留了SPI LCD显示屏接口、按键接口、TTL串口，可通过串口助手看到测量数据，可自行DIY或者商业开发。

一、软件系统整体架构与开发背景

本软件系统是低成本单发单收激光测距传感器的核心控制单元，基于STM32F10x系列微控制器（Cortex-M3内核）开发，遵循CMSIS（ Cortex Microcontroller Software Interface Standard）标准架构，整合了硬件驱动、信号采集、数据处理、距离计算及系统交互等全流程功能。系统设计以“低成本、高精度、高可靠性”为核心目标，通过软件算法优化弥补硬件成本限制，适配多种编译器（ARM Compiler、IAR Compiler、GNU Compiler等），支持STM32F10x系列不同密度型号（Medium Density、High Density、Medium Density Value Line），可广泛应用于工业检测、智能传感、安防监控等场景。

低成本单发单收激光测距传感器方案 低成本单发单收激光测距全套方案，包括原理图、源代码、PCB、BOM、光学部分资料，结构、特殊元件数据手册及供应商联系方式，提供调试技术文档。 全套方案已成功打板验证，实现0.05~50m测量范围，精度在+/—1.5mm，激光波长635~650nm，功率《1mW。 方案预留了SPI LCD显示屏接口、按键接口、TTL串口，可通过串口助手看到测量数据，可自行DIY或者商业开发。

软件系统采用模块化分层设计，从底层到上层依次分为内核驱动层、外设抽象层、功能核心层和应用交互层。各层职责清晰、接口统一，既保证了硬件操作的稳定性，又为功能扩展提供了灵活空间，同时通过严格的代码规范和注释，确保代码的可读性与可维护性。

二、内核驱动层功能解析

内核驱动层是软件系统的基础，基于CMSIS标准实现Cortex-M3内核的底层控制，为上层应用提供统一的硬件访问接口，核心功能围绕内核寄存器操作、中断管理和系统时钟展开。

2.1 内核核心寄存器操作

该层通过corecm3.c与corecm3.h文件实现内核关键寄存器的读写控制，涵盖栈指针、优先级掩码、故障掩码等核心组件，具体功能如下：

1. 栈指针管理：提供getPSP()（获取进程栈指针）、setPSP()（设置进程栈指针）、getMSP()（获取主栈指针）、setMSP()（设置主栈指针）等函数，支持线程模式下进程栈与主栈的灵活切换，满足多任务运行时的栈空间管理需求，避免栈溢出风险。
2. 优先级与中断控制：实现getBASEPRI()（读取基础优先级）、setBASEPRI()（设置基础优先级）、getPRIMASK()（读取优先级掩码）、setPRIMASK()（设置优先级掩码）等接口，支持对内核中断优先级的精细控制，确保关键中断（如ADC采集完成中断、DMA传输中断）能够优先响应，保障系统实时性。
3. 故障与控制寄存器操作：提供getFAULTMASK()（读取故障掩码）、setFAULTMASK()（设置故障掩码）、getCONTROL()（读取控制寄存器）、setCONTROL()（设置控制寄存器）等函数，支持故障处理和内核工作模式配置，可在系统故障时屏蔽非关键中断，优先处理故障恢复，提升系统稳定性。
4. 数据字节序转换：包含REV()（32位数据字节序反转）、REV16()（16位数据字节序反转）、REVSH()（带符号16位数据字节序反转并扩展为32位）等函数，适配不同硬件的数据传输格式要求，避免因字节序差异导致的数据解析错误。

2.2 中断向量表与启动流程

startupstm32f10xhd.s、startupstm32f10xmd.s、startupstm32f10xmd_vl.s等启动文件为不同型号STM32F10x芯片提供中断向量表定义与启动初始化流程，核心功能包括：

1. 中断向量表定义：包含复位 handler、NMI handler、硬故障 handler、各外设中断 handler（如ADC、DMA、UART、TIM等）的入口地址，芯片复位后自动加载向量表，确保中断发生时能正确跳转至对应处理函数。
2. 栈与堆初始化：定义栈大小（默认0x400字节）和堆大小（默认0x200字节），分配栈空间用于函数调用和局部变量存储，堆空间用于动态内存分配，同时提供栈顶指针initial_sp，为内核初始化提供栈基础。
3. 启动流程控制：复位后先执行ResetHandler函数，调用SystemInit()完成系统时钟初始化，再跳转至_main函数（C库入口），最终进入用户main函数，确保系统启动流程的有序性与稳定性。

2.3 系统时钟配置

系统时钟配置通过configperiph.c中的initsysclock()与inithsi_clock()函数实现，支持两种时钟模式：

1. HSI内部时钟模式：启用内部8MHz高速振荡器，通过PLL倍频（6倍频）生成24MHz系统主时钟，无需外部晶振，降低硬件成本，适合对时钟精度要求不高的场景。
2. HSE外部时钟模式：启用外部高速晶振，经PLL倍频后生成24MHz系统主时钟，时钟稳定性更高，适合对时序精度要求严格的信号采集场景（如ADC同步采样）。
3. 外设时钟分配：完成AHB、APB1、APB2总线时钟的分配，为GPIO、ADC、DMA、UART等外设提供匹配的时钟频率，确保外设正常工作，例如APB2总线时钟为24MHz，满足ADC最高12MHz采样时钟需求。

三、外设抽象层功能解析

外设抽象层是连接内核驱动与上层功能的桥梁，通过封装STM32F10x外设操作接口，实现GPIO、ADC、DAC、DMA、UART、I2C等外设的初始化与控制，为核心功能模块提供硬件支持。

3.1 GPIO外设控制

configperiph.c中的initgpio()函数实现GPIO端口的初始化配置，核心功能如下：

1. 功能引脚配置：
   - 激光控制引脚：配置为推挽输出模式，用于控制激光发射模块的开启与关闭，支持激光快速响应（引脚速度2MHz）。
   - 电源控制引脚：配置为推挽输出模式，控制主电源（DC-DC）和模拟电源（APD、PLL）的使能，确保硬件模块按需供电，降低功耗。
   - ADC采集引脚：配置为模拟输入模式，包括回波信号采集引脚（ADCSIGNAL）和参考信号采集引脚（ADCREFCHANNEL），保证信号采集的准确性。
   - 按键引脚：配置为下拉输入模式，用于校准按钮（KEY4）的状态检测，触发系统校准流程。
2. 引脚重映射配置：通过GPIO_PinRemapConfig()函数实现UART1、JTAG等引脚的重映射，避免引脚冲突，适配传感器硬件布局需求，例如将UART1引脚重映射至GPIOB端口，满足硬件布线要求。

3.2 ADC外设控制

ADC外设控制通过captureconfigure.c与configperiph.c实现，核心功能围绕信号采集展开，具体如下：

1. ADC初始化配置：
   - 工作模式：配置为独立模式，支持扫描模式（同时采集回波信号和参考信号），非连续转换模式（由外部触发启动转换）。
   - 触发源：选择TIM1_CH1作为外部触发源，通过TIM1定时器精确控制ADC采样频率，采样频率可配置（50kHz~350kHz），满足不同精度需求。
   - 采样时间：根据采样频率配置ADC采样周期（1.5周期~239.5周期），快速采集模式下选择1.5周期，高精度模式下选择41.5周期，平衡采样速度与精度。
2. 单通道与多通道采集：
   - 多通道采集：通过ADCRegularChannelConfig()函数配置ADC1的两个常规通道（回波信号通道、参考信号通道），实现两通道同步采集，采集数据通过DMA传输至内存缓冲区。
   - 单通道采集：用于温度传感器（ADCTEMP_CHANNEL）和电压检测的单值采集，通过readADC1()函数读取单次转换结果，为温度补偿和电压校准提供数据。
3. ADC校准：每次ADC初始化后执行复位校准与启动校准流程，消除ADC硬件偏移误差，确保采集数据的准确性，校准状态通过ADCGetResetCalibrationStatus()和ADCGetCalibrationStatus()函数检测，校准完成后才能启动采集。

3.3 DMA外设控制

DMA外设用于实现ADC采集数据和UART通信数据的高速传输，核心功能在captureconfigure.c与configperiph.c中实现：

1. ADC采集DMA配置：
   - 通道选择：使用DMA1Channel1通道，对应ADC1外设，实现ADC数据到内存的直接传输，无需CPU干预，降低CPU占用率。
   - 传输参数：配置外设基地址（ADC1->DR）、内存基地址（采集缓冲区）、传输方向（外设到内存）、缓冲区大小（ADCCAPUREBUFLENGTH），内存地址自增，外设地址固定，数据宽度为半字（16位），匹配ADC1的12位转换结果。
   - 中断配置：启用DMA传输完成中断（DMAITTC），传输完成后触发中断，标记采集完成状态（capture_done），通知上层模块处理数据。
2. UART通信DMA配置：
   - 通道选择：使用DMA1_Channel4通道，对应UART1外设，实现内存数据到UART外设的直接传输，支持测量结果的高速输出。
   - 传输参数：配置外设基地址（USART1->DR）、内存基地址（待发送数据缓冲区）、传输方向（内存到外设），内存地址自增，外设地址固定，数据宽度为字节（8位），匹配UART通信的字节格式。

3.4 DAC外设控制

DAC外设用于控制APD工作电压和激光驱动电压，功能在configperiph.c的initdac()和setapdvoltage()函数中实现：

1. DAC初始化：
   - 通道配置：启用DAC通道1（激光驱动电压）和DAC通道2（APD工作电压），配置为无触发模式（软件控制输出），输出缓冲区使能，提升输出稳定性。
   - 初始电压设置：通过DACSetChannel1Data()设置激光驱动电压初始值（LASERDAC1VALUE），通过DACSetChannel2Data()设置APD初始电压值（APDDAC2VALUE1），确保硬件上电后工作在安全状态。
2. APD电压动态控制：
   - 电压计算：根据目标APD电压值，结合DAC参考电压（AREFVOLTAGE）和硬件分压电路参数（DCDCRUP、DCDCRDOWN、DCDCRDAC），计算DAC输出数据，公式为dacvalue = dacvoltage * DACMAXIUM / AREFVOLTAGE（其中dacvoltage由APD目标电压推导得出）。
   - 电压调整：通过setapdvoltage()函数实时调整APD电压，支持手动设置和自动调整（根据温度、信号振幅动态优化），确保APD工作在最佳灵敏度状态，提升信号采集质量。

3.5 UART外设控制

UART外设用于系统与上位机的通信，实现测量结果输出和指令接收，功能在config_periph.c中实现：

1. UART初始化：
   - 引脚配置：配置GPIOB的UART1TX（推挽复用输出）和UART1RX（浮空输入）引脚，通过引脚重映射（GPIORemapUSART1）调整引脚布局，适配硬件设计。
   - 通信参数：配置波特率（256000bps）、数据位（8位）、停止位（1位）、校验位（无）、硬件流控（无），确保高速稳定的通信，满足实时测量结果输出需求。
   - 中断与DMA配置：启用UART接收中断（USARTITRXNE），支持指令接收；启用UART发送DMA请求（USARTDMAReqTx），通过DMA实现数据批量发送，避免CPU频繁干预。
2. 数据发送与接收：
   - 数据发送：通过uartdmastarttx()函数启动DMA发送，配置DMA通道的内存基地址和传输长度，触发DMA传输后UART自动发送数据，支持格式化字符串输出（包含距离、振幅、温度、电压等信息）。
   - 数据接收：通过UART接收中断处理函数（USART1IRQHandler）读取接收数据，解析上位机指令（如校准指令、参数配置指令），触发对应系统操作。

3.6 I2C外设控制

I2C外设用于与PLL（锁相环）模块通信，配置PLL输出频率，功能在i2cfunctions.c和pllfunctions.c中实现：

1. I2C初始化：
   - 引脚配置：配置GPIOB的I2C2SDA（开漏复用输出）和I2C2SCL（开漏复用输出）引脚，设置引脚速度为50MHz，满足I2C通信速率需求。
   - 通信参数：配置I2C工作模式（I2CModeI2C）、占空比（I2CDutyCycle2）、自身地址（0x00）、ACK使能（I2CAckEnable）、寻址模式（7位地址），通信速率为400kHz（快速模式），确保PLL配置指令的快速传输。
2. PLL配置通信：
   - 数据发送：通过PLLsenddata()、PLLsenddata2()、PLLsenddatareg()等函数向PLL模块发送配置指令，包括PLL使能、频率参数设置、复位等，实现3种测距频率（162.5MHz、191.5MHz、193.5MHz）的切换。
   - 通信异常处理：通过I2CCheckEventT()函数检测I2C通信事件，超时未响应时标记错误状态（i2cerrflag），支持I2C外设重置，确保通信稳定性。

四、功能核心层功能解析

功能核心层是软件系统的核心，包含信号采集控制、数据处理、距离计算三大模块，实现从信号采集到距离结果输出的核心逻辑，是测距功能的关键所在。

4.1 信号采集控制模块

该模块在captureconfigure.c和measurefunctions.c中实现，负责控制ADC、TIM、DMA等外设协同工作，完成多频率信号的采集，核心功能如下：

1. 采集前准备：
   - 定时器配置：通过initadccapturetimer()函数配置TIM1定时器，设置预分频系数（TIMER1DIV-1）和自动重装载值（TIMER1PERIOD-1），生成ADC触发信号，TIM1CH1输出PWM信号（占空比50%），触发ADC同步采样。
   - 外设初始化：preparecapture()函数依次初始化TIM1、ADC1、DMA1Channel1，完成采集前的硬件准备，确保各外设处于就绪状态。
2. 采集启动与切换：
   - 单频率采集：startadccapture()函数根据传入的缓冲区指针，配置DMA1Channel1的内存基地址和传输长度，启动ADC和TIM1，开始采集指定频率的信号，采集完成后通过DMA中断标记capturedone。
   - 多频率切换：autohandlecapture()函数实现3种频率的自动切换采集，先切换PLL至目标频率（通过pllsetfrequency1()/2()/3()），延迟稳定后启动对应频率的信号采集，依次填充3个采集缓冲区（adccapture_buffer1/2/3），为多频测距提供数据。
3. 采集状态管理：通过dma_state变量管理采集状态（无数据、频率1采集中、频率1采集完成、频率2采集中、频率2采集完成、频率3采集中、频率3采集完成），确保采集流程有序进行，避免多频率采集冲突。

4.2 数据处理模块

数据处理模块在analyse.c中实现，对采集到的信号数据进行分析与优化，提取核心参数并进行校准补偿，为距离计算提供可靠数据，核心功能如下：

1. Goertzel算法实现：
   - 系数预计算：initgoertzel()函数预计算Goertzel算法所需的正弦/余弦系数表（sinbuf、cosbuf），系数基于信号频率（SIGNALFREQ）、采样频率（ADCTRIGGERFREQ）和采样点数（POINTSTOSAMPLE）计算，公式为OMEGA = 2PIKCOEF / POINTSTOSAMPLE（KCOEF为Goertzel系数），预计算避免实时运算耗时，提升效率。
   - 信号分析：goertzel_analyse()函数使用预计算的系数表对采集数据进行运算，提取信号的实部（real）和虚部（imag），通过实部和虚部计算信号的振幅和相位，振幅计算为sqrt(imag² + real²)，相位计算为atan2(imag, real)，并转换为0~3600（0.1°分辨率）的相位值。
2. 相位差计算：processcaptureddata()函数计算回波信号与参考信号的相位差，即回波信号相位减去参考信号相位，若相位差为负则加上3600（确保相位差在0~3600范围内），相位差是距离计算的核心依据。
3. 校准与补偿：
   - 温度补偿：calculatecorrection()函数根据APD温度（APDtemperature）、信号振幅（amplitude）和APD电压（apdvoltage）计算相位补偿值，通过多项式拟合或指数函数修正温度对相位测量的影响，例如模块701A的补偿公式为correction = 0.226974APDtemperature - 0.0049827APDtemperature²，补偿后相位值需再次调整范围（确保在0~3600内）。
   - 零相位校准：dophasecalibration()函数执行零相位校准流程，采集多组零距离时的相位数据，计算平均值作为零相位偏移（zerophase1_calibration/2/3），存储至Flash，测量时用实际相位差减去零相位偏移，消除硬件零漂误差。
4. 相位预处理：
   - 平均值计算：calculateavrphase()函数计算多组相位数据的平均值，若存在零交叉相位（接近0°或360°），则先对相位数据进行偏移处理（避免零交叉导致的平均值计算错误），再求平均，降低随机噪声影响。
   - 异常值剔除：通过振幅阈值判断信号有效性，振幅低于阈值（如CALIBRATIONMINAMPLITUDE）时视为无效数据，不参与相位计算，避免无效信号导致的测量错误。

4.3 距离计算模块

距离计算模块在distance_calc.c中实现，基于多频率相位差数据解算实际距离，核心功能如下：

1. 单频率距离计算：calculatedistance()函数根据单频率的相位差（phase）、激光波长（wavelength）和周期数（N）计算距离，公式为distance = wavelengthN + (phasewavelength)/(MAXANGLE*PHASEMULT)（MAXANGLE=360，PHASE_MULT=10），其中N为信号在传播过程中的周期数，需通过多频融合确定。
2. 多频融合解算：
   - 粗略距离计算：dualNdistancecalculation()函数通过两种频率的相位差数据计算粗略距离，先通过calculatepnum()和calculatepnumadd()函数计算两种频率下的周期数N，再通过findbestn()函数选择最优周期数，代入单频率距离公式得到粗略距离。
   - 精确距离计算：tripledistcalculaton()函数结合第三种频率的相位差数据优化距离结果，先判断三种频率的相位差是否接近零（零距离模式），若是则直接取三种频率距离的平均值；若否则以双频粗略距离为基础，确定第三种频率的周期数范围（startN~stopN），通过brutforcedistcalculation()函数暴力搜索最优周期数，使三种频率的距离结果一致，得到精确距离。
3. 距离优化：
   - 表格校验：brutforcedistcalculation()函数中通过checktablevalues()函数校验周期数是否在有效范围内，避免超出缓冲区存储的距离数据，确保计算有效性。
   - 结果滤波：对解算后的距离数据进行简单滤波（如多次测量取平均），剔除异常值（如距离突变），确保测量结果的稳定性，最终距离结果转换为毫米（mm）单位输出。

五、应用交互层功能解析

应用交互层实现系统状态管理、用户操作响应和数据输出，为用户提供便捷的系统控制与交互接口，核心功能在measurefunctions.c和configperiph.c中实现。

5.1 系统状态管理

系统采用状态机机制管理工作状态，核心状态包括初始化、待机、校准、测量，各状态切换逻辑如下：

1. 初始化状态：系统上电后执行initallhardware()函数，完成内核驱动、外设、核心模块的初始化，加载Flash中的校准数据（readcalibdatafromflash()），初始化完成后进入待机状态。
2. 待机状态：系统等待用户操作（如启动测量、触发校准），此时激光和APD电源关闭，降低功耗；检测到测量使能信号（measureenabled=1）后进入测量状态，检测到校准按钮触发（checkcalibration_button()返回1）后进入校准状态。
3. 校准状态：执行dophasecalibration()函数，启动激光和APD，采集多组零相位数据，计算零相位偏移并存储至Flash（writedatatoflash()），校准完成后发出蜂鸣提示（shortbeep()），返回待机状态。
4. 测量状态：执行autohandlecapture()和autohandledata_processing()函数，自动完成多频率信号采集、数据处理、距离计算，测量结果通过UART输出，测量完成后根据配置返回待机或继续测量状态。

5.2 用户操作响应

1. 校准按钮响应：checkcalibrationbutton()函数实时检测校准按钮状态，按钮按下时触发校准流程，校准过程中通过蜂鸣器（short_beep()）提示状态（校准开始、校准完成），校准失败时输出错误信息（如“Calib FAIL: Low Signal”）。
2. 上位机指令响应：通过UART接收上位机指令（如校准指令、参数配置指令），解析指令后执行对应操作，例如接收“CALIB”指令时触发校准流程，接收“SET_FREQ=1”指令时切换至频率1的测量模式。

5.3 数据输出与显示

1. 测量结果输出：autohandledata_processing()函数格式化测量结果，输出格式包含距离（DIST）、信号振幅（AMP）、APD温度（TEMP）、APD电压（VOLT），例如“DIST;00123;AMP;0250;TEMP;0025;VOLT;085\r\n”（距离123mm，振幅250，温度25℃，电压85V），快速采集模式下输出简化格式（仅距离和振幅），满足不同应用场景需求。
2. 调试信息输出：支持调试信息输出（如校准过程中的零相位值、PLL配置信息），通过printf()函数输出至UART，便于开发调试，调试信息可通过宏定义（如DEBUG）控制启用/禁用，不影响量产版本性能。

六、系统关键特性与优势

1. 低成本设计：通过软件算法优化（如多频融合、Goertzel算法）替代高精度硬件，降低硬件成本；支持HSI内部时钟，无需外部晶振，进一步减少硬件物料成本。
2. 高精度测量：采用3种频率融合测距，消除距离模糊性，测量精度可达毫米级；结合温度补偿、零相位校准、振幅补偿，降低环境因素和硬件特性波动的影响，确保测量精度稳定。
3. 高可靠性：具备完善的故障处理机制（如I2C通信超时、ADC校准失败、信号无效），出现故障时输出错误信息并尝试恢复（如I2C重置、重新校准）；关键数据（校准数据）存储至Flash，避免掉电丢失。
4. 灵活适配：支持STM32F10x系列多种型号，适配不同硬件配置；采样频率、采样点数、测量模式等参数可通过宏定义灵活配置，满足不同测距范围（如近距离高精度、远距离快速测量）需求。
5. 低功耗优化：非测量状态下关闭激光和APD电源，降低静态功耗；外设采用DMA传输，减少CPU占用，CPU可在空闲时进入低功耗模式，适合电池供电场景。

七、总结

本软件系统围绕低成本单发单收激光测距传感器的核心需求，通过分层模块化设计，实现了从硬件驱动到距离输出的全流程功能。内核驱动层提供稳定的底层支持，外设抽象层封装硬件操作接口，功能核心层实现高精度的信号处理与距离计算，应用交互层提供便捷的用户交互接口。系统具备低成本、高精度、高可靠性、灵活适配的特点，可广泛应用于各类需要激光测距的场景，为低成本激光测距传感器的开发提供了完整、可靠的软件解决方案。