1. 项目概述从开箱到上电认识你的ADSP-21569刚拿到一块ADI的ADSP-21569开发板看着板子上密密麻麻的芯片、接口和指示灯是不是有点无从下手别急这篇文章就是为你准备的。我手头这块板子是ADI官方推出的SHARC ARM双核评估板核心是一颗ADSP-21569它内部集成了一个高性能的SHARC DSP核和一个ARM Cortex-A5应用处理器核主要面向音频处理、工业控制、高端测量仪器等需要复杂实时信号处理的应用场景。对于刚接触这块板子的朋友尤其是从单片机或纯ARM平台转过来的工程师第一步不是急着写代码而是要先搞清楚板子的“初始状态”——它现在能干什么各个部分是什么功能怎么让它先“跑”起来。这就像拿到一台新电脑你得先开机看看预装了什么系统有哪些端口可用而不是直接去写程序。搞清楚这些后续的软件开发、驱动调试、算法移植才能事半功倍避免很多因为硬件环境不熟悉而导致的“玄学”问题。2. 开发板硬件资源与初始状态解析在动手连接任何线缆之前我们先来一次“纸上谈兵”把板子的硬件布局和出厂预设状态摸清楚。这能帮你建立对板子的整体认知知道能量从哪里来信号往哪里去。2.1 核心板与接口布局速览ADSP-21569开发板通常采用核心板底板的架构。核心板上是ADSP-21569 SoC及其必要的外围电路如DDR3内存、QSPI Flash底板上则提供了丰富的扩展接口和调试接口。电源输入板上通常有多个电源输入选项。最常见的是通过一个桶形插座DC Jack输入12V直流电源。务必注意在接通任何电源前请使用万用表确认你的电源适配器输出极性是“内正外负”电压稳定在12V电流能力建议不小于2A。接反或电压过高会瞬间损坏板卡没有挽回余地。板子上可能还有一个USB Type-C接口这个接口通常仅用于调试和通信如UART转USB其供电能力5V不足以让整个板子全速运行因此强烈建议使用外部12V电源作为主供电。启动模式选择这是决定板子“从哪里开始”的关键。ADSP-21569支持从多种存储器启动如并行Flash、QSPI Flash、SD卡或通过USB/UART下载。板上会有一组拨码开关DIP Switch或跳线帽Jumper来配置启动模式。出厂状态下板子极大概率被设置为从板载的QSPI Flash启动因为里面已经预烧录了ADI提供的演示程序或一个最小化的引导程序。你需要找到原理图或用户手册确认这组开关的具体定义。例如开关1-4全部拨到“ON”可能代表从QSPI启动而另一种组合则可能让芯片进入UART下载模式。调试与通信接口JTAG/SWD接口用于连接仿真器如ADI的ICE-1000/2000或兼容的第三方JTAG调试器进行代码下载、单步调试、内存查看等深度操作。这是开发过程中最核心的接口。UART接口通常通过一个USB转串口芯片如FTDI FT2232引出到一个USB Micro-B或Type-C口。这个接口用于输出系统的调试打印信息printf是观察程序运行状态、与板子进行简单命令行交互的“生命线”。上电后你应该首先连接这个接口到电脑。以太网接口ADSP-21569的ARM核通常集成MAC底板通过PHY芯片提供RJ45网口。出厂演示程序可能会启用一个简单的网络服务如ping响应、HTTP服务器但这取决于预装软件。其他接口可能还包括USB Host/Device、音频输入输出I2S接口、扩展IO排针等它们在初始状态下可能未被激活。2.2 上电初体验与状态确认现在我们开始实际操作。请按顺序进行连接串口找到板上的USB转串口连接器通常标记为“USB UART”或“COM”用USB线将其连接到电脑。电脑会识别到一个新的串行设备COM口。你需要一个串口终端软件如PuttyWindows、SecureCRT、或者更现代的VS Code插件。关键参数设置波特率通常为115200数据位8停止位1无校验无流控。这是嵌入式领域最通用的调试串口配置。连接外部电源确认启动模式开关处于出厂状态通常是从QSPI启动然后将12V电源适配器连接到板子的DC插座。上电观察打开电源开关。此时你的眼睛和耳朵要忙起来了观察指示灯板上会有多个LED。通常会有一颗电源指示灯常亮一颗或多颗用户可编程LED可能还有以太网状态灯。上电瞬间所有LED可能会快速闪烁一下复位过程然后电源灯常亮。用户LED的行为完全取决于QSPI Flash里预装的程序。常见的情况是LED开始有规律地闪烁例如每秒一次这证明处理器已经成功运行起来了。聆听串口立即查看你的串口终端软件。如果一切正常你可能会看到一串乱码后跟着清晰的启动信息。乱码可能是由于处理器刚开始运行时UART尚未正确初始化输出了一些不稳定的电平。紧接着你应该能看到类似以下的输出具体内容因预装程序而异U-Boot 2019.04 (Mar 15 2023 - 10:00:00 0800) CPU: ADSP-21569 Rev 0.0 Model: ADI ADSP-21569 EZ-Board DRAM: 256 MiB Flash: 16 MiB In: serial Out: serial Err: serial Net: eth0: ethernet0x80000000 Hit any key to stop autoboot: 3这段信息极其宝贵它告诉你引导程序这里是U-Boot成功运行识别到了256MB内存和16MB Flash网络设备也已初始化。如果看到了这些恭喜你板子的最小系统工作完全正常。如果没有输出首先检查串口线是否接对、串口参数尤其是波特率是否正确。尝试按一下板子的复位按钮。如果仍无输出则需要检查启动模式开关设置是否正确或者考虑板载程序可能已被擦除。注意不同批次的开发板预装的演示程序可能不同。有的可能是简单的LED闪烁程序只控制LED而不打印信息有的可能是一个完整的Linux系统运行在ARM核上或一个VDSP工程运行在SHARC核上。通过串口输出和LED行为可以初步判断预装程序的类型。3. 出厂预装软件环境深度探秘看到串口有输出心里就踏实了一大半。接下来我们要深入了解一下这个“预装系统”到底提供了什么。3.1 引导程序Bootloader分析大多数嵌入式Linux开发板出厂都会预装U-Boot。从上面的串口打印可以看出我们的板子也是如此。在U-Boot倒计时结束前显示Hit any key to stop autoboot: 3时快速在串口终端里按任意键如回车就会进入U-Boot的命令行界面提示符通常变为。在这个界面下你可以执行一些底层命令来探索硬件printenv打印所有环境变量。这里藏着启动命令、IP地址、加载地址等关键配置。请务必先执行这个命令并保存输出结果这是板子的“出厂设置”以后恢复或排查问题时会用到。bdinfo显示板级信息更详细地列出内存分布、时钟等。boot执行默认的启动命令继续引导内核。help查看所有支持的命令。对于不跑Linux只使用SHARC核进行裸机或RTOS开发的情况预装的可能是一个ADI的第二级引导程序L2 Bootloader它负责从Flash加载VDSP生成的.ldr文件到SHARC核的内存并执行。这种情况下串口输出可能非常简洁甚至没有U-Boot那样的交互界面。3.2 预装应用程序或操作系统如果让U-Boot自动继续不按按键它会加载并启动内核。接下来串口会输出大量的Linux内核启动信息最后出现登录提示符例如... [ OK ] Started Serial Getty on ttyS0. [ OK ] Reached target Login Prompts. ADSP-21569 login:这说明板子上预装了一个完整的Linux文件系统。默认的用户名和密码通常是root/root或者analog/analog具体需要查阅板子的快速入门指南。登录成功后你就拥有了一个Linux shell可以执行ls,ps,ifconfig等命令来探索系统。此时你可以做几个关键检查网络连接执行ifconfig eth0看是否获取到了IP地址如果连接了网线且网络支持DHCP。尝试ping一下你的电脑或路由器验证网络通路。这步成功了后续通过网络如NFS、TFTP进行开发会方便得多。文件系统执行ls /查看根目录下的内容。通常会有/app或/home/root目录里面可能存放着出厂演示程序。运行中的进程执行ps看看有哪些后台进程在运行。可能有一个音频处理演示程序或Web服务器。如果预装的是纯SHARC程序无Linux那么上电后可能只是LED在规律闪烁串口没有更多交互。要与之交互通常需要通过仿真器JTAG连接使用ADI的CrossCore Embedded Studio或VisualDSP软件来调试和监控。3.3 关键外设功能速测利用预装环境我们可以快速验证几个核心外设用户LED如果预装的是Linux可以尝试操作GPIO。先找到LED对应的GPIO号查原理图或设备树例如对应gpiochip0的pin 10。然后操作# 导出GPIO echo 10 /sys/class/gpio/export # 设置为输出 echo out /sys/class/gpio/gpio10/direction # 点亮LED (假设低电平点亮) echo 0 /sys/class/gpio/gpio10/value # 熄灭LED echo 1 /sys/class/gpio/gpio10/value音频回路测试如果板子有音频编解码器如ADAU1761且预装程序包含了音频驱动你可以尝试播放一个测试音频文件可能需要先使用aplay -l查看声卡设备或者用arecord和aplay进行录音播放回路测试。按键输入找到用户按键对应的GPIO在shell中使用cat /sys/class/gpio/gpioX/valueX为GPIO号来监听按键状态变化。这些快速测试能让你直观感受硬件是否完好驱动是否就绪。4. 开发环境连接与基础工具准备在确认板子初始状态良好后我们需要为后续的深度开发搭建桥梁。这主要涉及调试器和软件工具链。4.1 仿真器连接与驱动安装要进行代码下载和调试仿真器是必不可少的。对于ADSP-21569ADI官方推荐使用ICE-1000或ICE-2000仿真器它们通过JTAG或SWD接口与芯片通信。硬件连接关闭开发板电源。找到板上的JTAG接头通常是20pin或10pin的标准ARM JTAG接口用仿真器附带的排线可靠连接。然后将仿真器的USB端连接到电脑。驱动安装连接后电脑会识别新硬件。你需要安装ADI提供的仿真器驱动这些驱动通常包含在CrossCore Embedded StudioCCES的安装包中。确保在设备管理器中仿真器被正确识别没有感叹号。软件识别打开CCES新建或打开一个工程。在Debug Configurations中选择对应的仿真器型号和处理器型号ADSP-21569并指定要加载的调试文件.elf。如果连接成功CCES应该能读取到处理器的IDCODE并能进行连接、暂停、查看寄存器等基本操作。实操心得仿真器连接有时会出问题。如果CCES无法连接请按以下顺序排查① 确认开发板和仿真器都已上电② 检查JTAG排线是否松动、方向是否正确引脚1对齐③ 尝试降低JTAG时钟频率在CCES配置里设置④ 检查是否有其他软件占用了仿真器⑤ 重启CCES甚至电脑。另外对于双核调试CCES可以同时连接ARM核和SHARC核你需要为每个核分别创建调试配置并理解它们的内存空间和调试上下文是独立的。4.2 软件工具链选择与配置ADSP-21569的双核架构意味着你可能需要两套或一套集成的工具链ARM Cortex-A5侧如果你想在ARM核上运行Linux或裸机程序主要使用GNU工具链。你可以使用ADI提供的、针对其处理器优化过的工具链通常随CCES或Linux开发套件提供也可以使用通用的arm-linux-gnueabihf-工具链。环境变量PATH需要包含工具链的bin目录。SHARC DSP侧开发SHARC核的程序必须使用ADI的CrossCore Embedded StudioCCES。它基于Eclipse集成了编译器、调试器和丰富的库如音频处理库、数学库。CCES的编译器会生成.ldr文件这个文件可以通过U-Boot、仿真器或者第二级引导程序加载到SHARC核的内存中执行。Linux构建系统如果要定制Linux内核、设备树或根文件系统你需要搭建相应的构建环境如使用buildroot或Yocto。ADI通常会提供一个参考的构建脚本或SDK。环境变量配置示例Linux主机上# 将以下内容添加到 ~/.bashrc 中 export CCES_HOME/opt/analog/cces/2.11.1 export PATH$CCES_HOME/bin:$PATH export ARM_TOOLCHAIN_PATH/opt/analog/arm-none-eabi/bin export PATH$ARM_TOOLCHAIN_PATH:$PATH # 使配置生效 source ~/.bashrc5. 从初始状态到第一个自定义程序了解了初始状态搭好了环境是时候迈出第一步让板子运行我们自己的代码了。我们从最简单的开始控制一个LED。5.1 编写一个简单的LED闪烁程序以SHARC核裸机为例假设我们要在SHARC核上运行一个程序控制底板上标记为“USER_LED1”的LED闪烁。创建CCES工程打开CCES选择File - New - CrossCore Project。选择处理器型号ADSP-21569模板可以选择Empty Project或LED Flashing Example如果有。编写主程序在main.c中我们需要操作对应的GPIO引脚。首先需要找到LED的原理图连接。假设USER_LED1连接到了处理器GPIO端口B的第5脚PB05。// 示例代码寄存器名称需参考ADSP-21569硬件手册 #include cdef21569.h // 延时函数简单循环实现不精确仅用于示例 void delay(unsigned int count) { while(count--); } int main(void) { // 1. 使能GPIOB端口的时钟如果有时钟控制 // *pREG_CLK_GPIOB_EN 0x1; // 假设的寄存器操作 // 2. 将PB05配置为输出模式 // 先设置方向寄存器对应位为1输出 // *pREG_GPIOB_DIR | (1 5); // 再设置功能复用寄存器选择为GPIO功能而非外设功能 // *pREG_GPIOB_FER ~(1 5); // 3. 主循环中控制LED闪烁 while(1) { // 设置PB05输出高电平LED灭假设高电平灭 // *pREG_GPIOB_SET (1 5); delay(1000000); // 设置PB05输出低电平LED亮 // *pREG_GPIOB_CLR (1 5); delay(1000000); } return 0; }重要上面的寄存器操作pREG_GPIOB_DIR等是示意性的绝对不可以直接使用。你必须查阅《ADSP-21569 Hardware Reference Manual》找到GPIO模块确切的寄存器地址和位定义。通常ADI会提供一套硬件抽象层HAL库或板级支持包BSP里面已经有定义好的宏和函数例如adi_gpio_SetDirection()和adi_gpio_Set()使用这些API是更安全、更可移植的做法。工程配置在工程属性中需要正确设置内存链接文件.ldf确保代码和数据被放到正确的内存区域如L1 SRAM、DDR。对于第一个简单程序可以直接使用CCES为你的开发板提供的默认链接脚本。5.2 编译、加载与运行编译在CCES中直接点击Build按钮。如果没有错误会在输出目录生成.dxe可调试文件和.ldr可加载文件等。通过仿真器加载运行确保仿真器已连接开发板已上电。在CCES中右键工程 -Debug As - Debug Configurations...创建一个针对ADSP-21569 SHARC Core的配置。在Main标签页选择正确的仿真器和处理器核心。在Debugger标签页的Initialization Commands里有时需要添加一些初始化脚本如设置时钟、释放核等对于官方开发板CCES可能自带这些脚本。点击DebugCCES会连接仿真器将程序下载到SHARC核的内存并停在main()函数入口。点击ResumeF8程序开始运行。此时你应该能看到USER_LED1开始按照代码设定的节奏闪烁。通过U-Boot加载运行进阶 如果不想依赖仿真器可以将编译好的.ldr文件放到SD卡或通过TFTP传到开发板然后在U-Boot命令行中加载并启动SHARC核。# 在U-Boot命令行中假设ldr文件已通过tftp加载到DDR的0x81000000地址 tftp 0x81000000 my_sharc_program.ldr # 使用go命令跳转到SHARC核的加载器入口点地址需根据ldr文件头确定 # 或者使用bootaux命令如果U-Boot支持来启动从核 bootaux 0x81000000执行后SHARC核将从指定地址开始执行LED同样应该闪烁。这种方式更贴近最终产品的启动方式。6. 常见问题与排查技巧实录在实际操作中你肯定会遇到各种各样的问题。下面是我在多次项目开局中总结的一些典型问题和解决方法。6.1 上电无任何反应指示灯不亮问题现象接上电源板子毫无声息电源指示灯也不亮。排查步骤电源优先用万用表测量电源适配器空载输出电压确认是12V且极性正确。然后测量板子电源输入接口处的电压确认电源已送入板内。检查开关确认板上的电源开关是否处于“ON”位置。目视与嗅觉仔细检查板子有无明显的物理损坏如磕碰、元件脱落、烧焦的痕迹或异味。重点检查电源路径上的电容、电感、电源芯片。测量板内关键电源如果条件允许使用万用表测量板上主要电源芯片的输出电压如5V、3.3V、1.8V、1.2V等具体值参考原理图。任何一个电压缺失或异常都会导致整个系统不工作。根本原因90%是电源问题包括适配器损坏、接反、板内电源电路故障。6.2 串口无输出但电源灯亮问题现象板子通电后电源灯亮用户LED可能也无规律闪烁但串口终端一片空白。排查步骤确认串口线尝试换一根USB线。有些USB线只能充电不能传输数据。确认端口与参数在设备管理器中确认COM口号并在终端软件中精确选择该端口。波特率115200是首要怀疑对象但也可以尝试其他常用波特率如9600、57600、921600。数据位8停止位1无校验无流控必须保证。检查启动模式这是高频问题点。确认启动模式拨码开关的设置与你的预期一致。如果你想从QSPI Flash启动但开关被拨到了其他模式如UART下载模式处理器可能正在等待主机发送数据从而“卡住”没有输出。仔细对照手册将开关设置为明确的“从Flash启动”模式。尝试复位按下板子的复位键观察上电瞬间串口是否有任何字符输出哪怕是乱码。有乱码说明UART硬件通路基本是通的可能是软件没配置好或程序跑飞。检查预装程序板载Flash里的程序可能被意外擦除。此时需要尝试通过仿真器连接或者将开关设置为“UART启动模式”通过串口工具重新下载一个引导程序。6.3 仿真器无法连接问题现象在CCES中点击调试报错“Cannot connect to target”、“Failed to initialize driver”等。排查步骤驱动与连接确认仿真器驱动已安装在设备管理器中显示正常。重新拔插仿真器的USB线和JTAG排线。电源与复位确保开发板已上电。尝试在连接仿真器的状态下给开发板进行一次硬复位。配置检查在CCES的Debug Configuration中确认选择的仿真器型号、处理器型号、接口类型JTAG/SWD、扫描链Scan Chain设置完全正确。对于ADSP-21569可能需要特定的初始化脚本才能连接。降低时钟频率在调试配置的“Debugger”选项卡下找到JTAG/SWD时钟频率设置将其从默认的几MHz降低到1MHz甚至500kHz。过高的时钟频率在连接不稳定或线缆较长时容易失败。多核处理ADSP-21569是多核芯片确保你连接的是正确的核心ARM Core或SHARC Core。有时需要先连接并暂停ARM核才能去连接和调试SHARC核。6.4 程序下载后不运行或行为异常问题现象程序编译成功也能下载到板子但LED不闪或者运行结果和预期不符。排查步骤时钟配置这是嵌入式系统最常见的坑。你的程序可能没有正确初始化系统时钟PLL。处理器上电后运行在内部低速时钟上如果你代码里没有配置PLL倍频到更高的主频那么你写的延时函数实际延时时间会远远长于预期导致LED闪烁慢到难以察觉。务必在main函数最开始调用或编写代码正确配置系统时钟。参考官方例程中的时钟初始化部分。GPIO配置错误反复核对LED连接的GPIO引脚号确认配置为输出模式并且电平逻辑正确高电平亮还是低电平亮。使用仿真器在线调试时可以查看该GPIO方向寄存器和数据寄存器的值是否按预期变化。内存地址错误检查链接脚本.ldf确保代码段program被放置在了正确的、可执行的内存中如L1 SRAM。如果错误地放到了DDR中而DDR控制器尚未初始化那么代码根本无法执行。中断冲突如果你的程序不小心使能了某个未正确配置的中断或者中断向量表地址错误可能导致程序一运行就进入异常从而“死掉”。对于第一个LED程序建议先屏蔽所有中断只关注GPIO操作。6.5 网络不通Ping不通问题现象开发板通过网线连接到路由器或电脑在Linux系统下执行ifconfig看不到IP地址或者有IP但ping不通网关。排查步骤物理连接检查网线确认网口指示灯通常一个亮表示连接一个闪烁表示数据是否正常。IP地址获取如果使用DHCP确认路由器DHCP服务开启。可以尝试执行udhcpc -i eth0如果使用busybox或dhclient eth0来手动获取IP。如果使用静态IP检查ifconfig eth0 IP netmask mask命令或配置文件中的IP、掩码、网关是否正确。防火墙检查你的电脑防火墙是否阻止了ICMP回显请求ping。可以暂时关闭防火墙测试。网络配置确保开发板和你的电脑在同一网段。例如开发板IP是192.168.1.100你的电脑IP应该是192.168.1.xxx子网掩码都是255.255.255.0。驱动与设备树如果以上都正常可能是网络驱动未加载或设备树配置有误。检查dmesg | grep eth或dmesg | grep dwmac具体驱动名视PHY芯片而定是否有错误信息。这涉及到内核和驱动移植是更深层次的问题。把板子的初始状态摸透就相当于拿到了地图和钥匙。后续无论是想跑一个复杂的音频算法还是构建一个完整的嵌入式Linux系统你都知道该从哪里入手出了问题该往哪个方向排查。记住嵌入式开发就是一个不断与硬件细节打交道的过程耐心和细致的观察永远是最重要的第一步。