0 如何提问？

如何提问？这是个大问题，可以参考https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way/blob/main/README-zh_CN.md

提问前要先检查一下自己的硬件：

• [ ] TF卡是什么牌子的，哪里买的，发购买链接，我们只推荐在商城购买庐山派那个页面说明的TF卡。强烈不建议各位从pdd购买，即使是闪迪这种大牌子现在也有很多假货。来源不明的TF卡不建议使用。
• [ ] TF卡有没有插到位，插入时有没有清脆的卡扣咔哒一声。
• [ ] 庐山派正常上电，用户灯（RGB灯）会亮一下然后在两秒内熄灭，电源灯（PWR）红灯会保持常亮。
  • [ ] 如果用户灯有微亮，不能完全灭掉，那就和没有插入TF卡一个现象，此时庐山派会进入bootloader模式，你应该可以在设备管理器中看到新的设备。
  • [ ] 如果用户灯不受控，可能固件烧录错误，或者TF卡不行。烧录的固件一定要是最新版本的。
  • [ ] 如果电源灯一直不亮，有可能是主芯片K230已经坏了，庐山派的3.3V供电并不是上电即供电的，其被一个电子负载开关控制，该电子开关受控于K230的RTC引脚，当芯片可以正常工作时，OUT0会控制系统的3.3V正常上电。所以电源红灯不亮基本就是出大事了。

别说什么刚刚还能用；什么都没干；睡了一觉起来就不能用了；拔插 一下就不能用了，这种话一说出来就和放了个p一样，毫无价值，徒增沟通成本。

要说清楚你之前的使用方式，供电方式，有没有外接了什么东西，任务管理里面有没有新设备出来，用的哪个例程。按照以下方式来提问：

我使用的是立创庐山派，当前使用的固件版本是xxx，编译时间是xxx，用的IDE是4.0.x。TF卡是在xx购买的，能确定TF卡是大品牌的正规销售途径，之前已经试过更换TF卡并重新烧录固件了。我用xxx方式来供电，电源红灯是否可以正常亮，用户RGB灯是否在上电时会亮以下然后在两秒内完全熄灭，电脑设备管理器是否有新的设备出来，截图发出来。是新的端口还是K230 USB Boot Device。出现问题前，我做了如下操作，xxxx；当前开发板的状态是这样的，xxx；录视频发群里。用的例程是xxx，发群里。

换一种表达方式

为了高效准确地解决您的问题，请在提问时避免提供模糊无效的信息，例如：

• “刚刚还能用，什么都没干就不行了。”
• “睡了一觉起来就坏了。”
• “拔插了一下就不能用了。”

这类描述无法提供任何有用线索，会大大延迟问题解决时间。

请务必提供以下关键信息（尽可能完整，并且用一段话说明，不要问一句说一句）：

1. 基础环境：
   • “我使用的是 立创庐山派 开发板。”
   • “当前使用的 固件版本 是：XXX。”
   • “固件的 编译时间 是：XXX。”（如果已知）
   • “使用的 IDE 版本 是：4.0.x。”
2. 硬件配置与尝试：
   • “TF 卡 品牌及购买途径（需明确是大品牌正规渠道）：XXX。”
   • “我已尝试过更换 TF 卡 并 重新烧录官方固件。”（是否验证过？如验证过请说明）
   • “供电方式 是：XXX（如：电脑USB口、排针5V供电、12V供电等）供电电流够不够。”
3. 当前设备状态（关键！请逐一检查说明）：
   • 电源指示灯（红色）：是否亮起？状态（如：常亮、闪烁）？
   • 用户RGB指示灯：上电后是否短暂亮起，然后在约 2 秒内完全熄灭？是否有其他异常状态（如：常亮、颜色异常）？
   • 设备管理器：电脑连接到开发板后，是否有新设备出现？请务必截图或清晰描述：
     • 如果是新端口（COM口或串行设备），显示什么？
     • 是否出现 K230 USB Boot Device？(有这个的话就是系统都没启动呢)
   • 当前开发板还有哪些其他可观察到的现象？（如：屏幕显示内容、模块是否发热等）
   • 有没有魔法烟雾跑出来？有烟出来基本就是挂了。
4. 问题复现与操作：
   • “使用的 示例程序 是：XXX。” （请将源代码或路径发到群里）
   • “在问题发生前，我做了以下操作：XXX。（详细步骤，包括代码修改、外接设备、操作顺序等）”
   • “当前问题现象是：XXX。”（清晰描述结果，例如：程序不运行、屏幕无输出、无法连接等）
5. 辅助信息（强烈建议）：
   • 录屏或视频：清晰地展示问题现象（包括硬件连接状态、指示灯状态、屏幕现象等）。请发到群里。
   • 核心日志：如果有串口输出或特定错误日志，请一并提供。接串口0，115200波特率。

---

为什么要这样提问？

• 提供完整信息：我们排查问题如同医生诊断病情，需要尽可能多的线索。您提供的这些关键点能帮我们快速定位问题根源（固件问题？TF卡兼容性？电源问题？操作失误？硬件故障？）。
• 节省双方时间：清晰的结构化信息避免了反复追问的时间浪费，能更快得到针对性解决方案。
• 证明问题可复现：详细描述操作步骤和环境说明问题不是偶发的，便于开发者重现和调试。
• 展现合作态度：提供详细信息和截图、视频，表明您是在认真寻求帮助并配合解决问题。

请务必按上述模板组织您的提问！完整、清晰的信息是快速解决问题的基石。感谢您的理解与配合！

1 连接IDE运行程序后不显示图像？

可能的原因

可能是【帧缓冲区】被隐藏起来了，请点击IDE右边的小三角把他显示出来：

2 没法正常启动？

可能的原因

1. 卡不行，不兼容或者速度不够，建议用这个：https://item.szlcsc.com/8422936.html ， 我现在用的就是这个。
2. 烧录的固件不对，一定是要.img后缀结尾，文件名里带"LCKFB"字样的。建议用最新的版本，请看快速入门文档里面的下载链接。
3. 固件没有烧录好，看一下设备管理器里是不是有一个【K230 USB Boot Device】，有的话就是启动不成功进入了bootloader模式。
4. 线不行，里面没有数据传输线（D+，D-），只能供电，或者线材质量太差。
5. 电脑不行，供电不足或者用了HUB，要直连电脑USB口，不要通过其他设备转接。
6. 开发板坏了，请联系交流群里的开发菌进行售后，但我们每块开发板出厂前都会上电测试，请重点怀疑以上问题。

3 默认摄像头排线装好后是歪的？

INFO

受限于板子尺寸，在layout时CSI2的立式FPC座子（默认摄像头接口）实在是放不到中间，但是我希望摄像头固定在中间，所以在亚克力上的摄像头安装孔位是居中的，这就导致摄像头的排线在安装后会歪斜。

排线漏在散热片旁边不美观，可以塞在CSI2座子和亚克力面板之间，详情请看组装视频：https://www.bilibili.com/video/BV1FmzzYQEyS/

4 连上电脑后可以看到U盘文件，但是IDE就是连不上？

INFO

先打开你的设备管理器，看是不是端口号重复了

如果和上面的图一样，那就按照以下操作来重新更改一下端口号。 右键插入开发板后新出来的端口号，打开属性面板-》端口设置-》高级-》更改下面的端口号为一个不冲突的串口号。

5 摄像头安装后没对准？

INFO

这是因为受限于板子尺寸，默认摄像头座（CSI2）无法居中放置，但是在实际使用中，我需要让摄像头居中，这就导致摄像头的安装位置和CSI2是不对齐的，这【不是】设计失误，本来就是这样设计的。

如果看起来感觉摄像头不居中，那可能是被散热片位置影响了，因为K230和DDR的组合体不在中间，可以用尺子量一下就会发现，排针和摄像头其实都在亚克力外壳中间的。

6 如何给庐山派供电？（三种供电方式）

极力推荐大家先去硬件开源平台和我们的WIKI看硬件文档。

---

1. 单庐山派+一路摄像头正常工作，从TYPE-C接口供电，一般是不会超过400mA，正常的电脑A口最高可以供电500mA。
2. 庐山派+3.1寸屏幕扩展板，从TYPE-C接口供电，一般电流会在700mA左右，此时普通的电脑A口已经不能够支持正常工作了，需要电脑的外部扩展坞来额外供电，或者通过GH1.25的2P端口来补供电。请参考以下三种供电方式。

---

USB5V_IN+：是TYPE-C供电时的电源路径。

PIN5V_OUT_IN+：是板子上的排针处的5V和那三个GH1.25-4Pin的座子的供电路径。

6.1 用Type-C来供电

• 推荐在连接IDE的时候使用。
• 不推荐脱机供电时使用。

在运动中容易松动。

就是用上面左下角的那个TYPE-C接口来连接你的电脑，C to C 和 C to A的线都可以，尽量使用电脑主板上直出的USB口，在连接屏幕时可能需要需要额外供电，有时候之前能用，但是再次上电就不能用了，那就很有可能是你的供电不足。

6.2 用外部5V来供电

• 只推荐用来临时使用，或者对外供电，不建议通过本章介绍的方案来对庐山派进行供电。
• 不推荐在连接IDE的时候使用。
• 不推荐脱机供电时使用。尤其是排针那个地方，引脚众多，非常容易误接错到芯片IO上，造成芯片损毁。排针那个地方的IO基本都是直连芯片引脚的。
• 注意，下面介绍的这些都只能供电5V。高了不行，低了也不行。尤其是别妄想往这些供电脚接3.3V。
• 三个 4P 的GH1.25口都是串口的引出，他们标号为V的那个脚和排针处的5V是同一个电源网络，接了这些GH1.25的V，和接了排针的5V0是一个效果。

排针供电：

请参考下图，只能接其中的5V0，根据原理图设计，当TYPE-C供电时，这些引脚只能对外输出，无法对内供电，所以如果你的电脑USB供电不足，是不能使用排针处的5V来补电的，这一点需要注意。

重要的事情说三遍，在接杜邦线之前一定要再三确定，

千万不要把5V供电接到IO上了！！！千万不要把5V供电接到IO上了！！！千万不要把5V供电接到IO上了！！！

否则你的庐山派极有可能原地去世。已经碰到很多接错电压导致的售后了。

有很多人看不懂这些引脚怎么看，在这里也说一下中间的框框里面，比如橘红色的3V3，5V0，GND，他们都是和电源相关的引脚，不是芯片可控制的引脚。左上角3V3左边的01是排针的标号，和PCB实物上的标注是对应的，方便大家寻找定位引脚。实际用户想要调用的引脚序号不是排针的标号，就是中间框框里的GPIO49，GPIO48这些东西，这些引脚能复用的功能也在旁边列举了，可以参考。

四个GH1.25-4p来供电

可用的接口如下图所示，随庐山派也送了三根线材，这三个口都是串口。

• 如果你的庐山派已经通过其他方式供电，那么你就绝对不要接V，把他悬空。串口通信也只需要TXD，RXD和GND。
• 如果你的庐山派就是靠这个接口来供电，那么一定要确保你没有接反，我们送的线，红色就是能且仅能接5V，黑色就是只能接GND，千万不要把5V接到其他颜色的线材上，那两个串口引脚是直连芯片脚的，只能接受3.3V的IO。在这里也给各位使用51单片机或者其他串口IO电平为5V的用户提个醒，千万不能直连，一定要做电平转换后接入。部分串口工具的IO也是5V的，在进行通信前务必要进行测试。

如果我们想用最左边这个串口2来对整个庐山派进行供电的话，就要像下面这样接线。我这里以能输出5V的串口工具做例子，大家也可以用其他能输出5V的工具来供电。用我们赠送的GH1.25-4P来接线，红色接在V脚上，黑色接在G脚上，所以我们就把红色杜邦线头接到5V，黑色杜邦线头接到GND上，此时一切正常的话你庐山派就会正常启动了。

6.3 用12V来供电

可以使用GH1.25-2P（最大1A）来进行供电，也可以直接用线材焊接板子底面的两个焊盘（最大2A）来供电，焊盘和上面的GH1.25-2P的口是同一个网络，选一个供电就行。

• 这个口支持8-24V供电，推荐各位使用12V来供电。

• 推荐在连接IDE时电脑供电不足时来补电。但建议用一个隔离或者额外的扩展坞来，避免庐山派降压芯片损坏时造成电脑的损坏。

• 推荐脱机供电时使用。【强烈建议脱机供电时使用此方式】

  

左边的焊盘可以通过焊线后供电，右边的座子就是用我们送的那个2P线来供电，下面我展示一下用泰山派的电源小板来给庐山派供电12V。

---

7 为什么只接 TXD、RXD、GND 三根线，开发板仍可能被串口工具烧坏？

⚠️先说结论

供电电压不等于 IO 信号电平。 即使没有连接串口工具的 5V 供电脚，TXD / RXD 仍然是带电压的信号线。立创·庐山派K230-CanMV开发板和立创·庐山派Lite-K230D-CanMV开发板的 UART 信号只能使用 3.3V 电平；ADC 引脚允许的最高输入电压更低，只有 1.8V。

据售后统计，超过一半的庐山派 K230 主控损坏与外部工具 IO 电平过高有关。连接串口、单片机或其他外部设备前，请先确认其实际信号电平。

7.1 为什么不接 5V 供电仍会损坏开发板？

很多用户认为串口通信只连接 TXD、RXD、GND，不连接 5V 供电就一定安全。这是一个常见误区。

• 串口工具的 TXD 是输出信号。标准 TTL UART 在空闲状态下默认保持高电平，因此只要接上线，工具的 TXD 电压就会持续施加到开发板的 RXD 引脚上，与是否正在发送数据无关。
• 市面上部分廉价 USB 转串口工具使用 5V TXD / RXD 电平，或者通过短接帽把 IO 电平切换到 5V。这样的信号不能直接连接庐山派。
• 某些工具即使短接帽位于“3.3V”档，实测信号高电平仍可能达到约 3.8V，超过芯片 IO 的允许范围。
• 过压不一定会让开发板立即失效。开发板可能短时间看起来正常，但输入保护结构会持续承受应力，最终造成 IO 或主控损坏。

重点检查工具 TXD

连接时通常是“串口工具 TXD → 开发板 RXD”。真正向开发板 IO 施加电压的是串口工具的 TXD，因此必须在接板之前测量工具 TXD 相对 GND 的空闲电平。

7.2 GH1.25-4P 串口座子上的 5V 只是供电脚

庐山派提供 GH1.25-4P 带锁串口接口。座子的 V 脚是 5V 电源，不代表 RXD / TXD 可以承受 5V 信号。

序号	标识	功能	电气要求
1	V	5V 输入/输出电源脚	仅用于供电，不是串口信号
2	R	RXD，串口接收	3.3V UART 信号
3	T	TXD，串口发送	3.3V UART 信号
4	G	GND	与外部设备共地

可以把 V 理解成电源插座，只负责送电；R 和 T 则是传递数据的通信线。电源脚标注 5V，只说明电源电压是 5V，不能据此推断通信线也是 5V 电平。

IMPORTANT

如果开发板已经通过 Type-C、12V 接口或其他方式供电，连接串口时不要再接 GH1.25-4P 的 V 脚，只连接 TXD、RXD、GND 即可。拔出 GH1.25 带锁插头时，应先压下卡扣，避免拉断线材或损坏座子。

7.3 如何在连接开发板前测量串口工具电平？

测量时先不要连接开发板，只把 USB 转串口工具插入电脑：

1. 将万用表切换到直流电压档，或者准备好示波器探头。
2. 黑表笔或示波器地夹连接串口工具 GND。
3. 红表笔或示波器探头连接串口工具 TXD。
4. 不发送数据，直接读取 TXD 空闲状态下的电压。
5. 只有确认高电平不超过 3.3V，才可以连接庐山派 UART。

DANGER

如果测得约 5V、3.8V，或者无法确认工具的真实信号电平，请停止连接。不要用开发板“试一下”，应更换可靠的 3.3V 串口工具，或者增加专用电平转换电路。

7.4 实测证据

下面这类廉价 USB 转串口工具可能输出超过 3.3V 的 UART 信号，不能只根据外壳、商品标题或短接帽标识判断实际 IO 电平。

示波器测量可以看到 TXD 空闲高电平明显超过 3.3V；串口工具发送 0x55 时，波形会呈现高低电平交替，便于同时观察幅值和时序。

万用表也可以直接测量 TXD 空闲状态的高电平。由于 UART 空闲时默认保持高电平，这种测量方式可以快速筛查工具是否存在明显过压。

7.5 正确接线和工具选择

确认串口工具使用 3.3V 信号电平后，按照交叉方式连接：

串口工具	连接到庐山派	说明
TXD	RXD	工具发送，开发板接收
RXD	TXD	工具接收，开发板发送
GND	GND	双方必须共地
5V / VCC	默认不连接	开发板已经单独供电时必须悬空

• 使用前确认的是 TXD / RXD 信号电平，不是工具标注的 5V / 3.3V 供电输出档位。
• 如果工具只能输出 5V 信号，必须增加可靠的电平转换电路，严禁直接连接庐山派 IO。
• 不确定工具规格时，先测量再接线。不要仅凭短接帽颜色、丝印或商品描述判断。
• 立创开发板推出的串口工具默认使用 3.3V 通信电平。不知道如何选择时，可以参考立创开发板 CH340X USB 转 TTL 串口模块。

TIP

对硬件保持敬畏。不确定能否连接时，先测量或到官方交流群确认，再给开发板上电。花几分钟核对电平，通常比损坏主控后返修更省时间。