Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Drop SD_ aliases for SDIO signals (SD_CMD, SD_DAT0..3) on RP2040 Adalogger board

未关闭 适合新手
#11,099 3 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
68/100
Issue 类型
重构
描述清晰度
描述清楚
活跃度
冷清
技术栈
c
领域
embedded-iot

调研方向

从开发板定义 adafruit_feather_rp2040_adalogger 和 adafruit_feather_rp2350_adalogger 开始,然后将它们的 SDIO 名称与 Metro RP2040/RP2350 和 Fruit Jam 的定义进行比较。从这两块 Adalogger 开发板中移除 SD_CMD 和 SD_DAT0 到 SD_DAT3,保留 SD_CLK,并确认 SDIO_* 别名仍然存在。

由索引模型根据 Issue 内容生成。

描述

board breaks api

Per discussion in #11090, the Adalogger boards carry SD_-prefixed aliases for SDIO-only signals, and we should drop them at the next major release so SD_ consistently means SPI and SDIO_ means SDIO.

Naming rule

Bus Convention Names
SPI abbreviated, SPI terms SD_CLK, SD_MOSI, SD_MISO, SD_CS
SDIO spelled-out, SDIO terms SDIO_CLOCK, SDIO_COMMAND, SDIO_DATA0..3

The names to remove are the hybrids — the SPI SD_ prefix on SDIO-only concepts, which have no SPI meaning:

  • SD_CMD
  • SD_DAT0, SD_DAT1, SD_DAT2, SD_DAT3

SD_CLK stays (CLK is a real SPI term; there is no SD_CLOCK anywhere in the tree). Affected boards: adafruit_feather_rp2040_adalogger, adafruit_feather_rp2350_adalogger. The SDIO_* names already exist on Metro RP2040/RP2350 and Fruit Jam.

Learning Guide usage check (Adafruit_Learning_System_Guides)

Name CircuitPython guide references Safe to drop?
SD_DAT0..3 0 ✅ yes
SD_CMD 0 ✅ yes
SD_CLK 2 ⚠️ keep (SPI clock)

The two SD_CLK uses are Feather_RP2040_Adalogger/CircuitPython_SD_Card_{Read,Write}/code.py, both busio.SPI(board.SD_CLK, board.SD_MOSI, board.SD_MISO) — SPI, unaffected. The PIN_SD_DAT3_CS hits under Factory_Tests/ and runcpm-* are Arduino macros (pins_arduino.h), a separate namespace, so not affected.

cc @dhalbert @foamyguy

主要语言
C
星标
4.6k
派生
1.4k
平均合并
1 天 7 小时
30 天内合并 PR
147

环境准备

这个项目没有提供开发容器、Dockerfile 或贡献指南,环境需要你自己搭建:先看它的 README,通用步骤见我们的新手贡献指南。

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

adafruit/circuitpython 的其他 Issue

查看 adafruit/circuitpython 的全部 Issue

相似的 Issue

更多 C Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。