Skip to content

docs(a7z): add USB-C Power port as host mode overlay guide#1536

Merged
jack-ma merged 2 commits intoradxa-docs:mainfrom
tangzz-radxa:docs/a7z-usb-c-host-mode-v2
Mar 26, 2026
Merged

docs(a7z): add USB-C Power port as host mode overlay guide#1536
jack-ma merged 2 commits intoradxa-docs:mainfrom
tangzz-radxa:docs/a7z-usb-c-host-mode-v2

Conversation

@tangzz-radxa
Copy link
Contributor

Description

Add instructions for enabling USB-C Power port (interface ①, USB-C 2.0 OTG & Power) as host mode on A7Z using device tree overlay. This allows connecting peripherals like wireless mouse receivers and keyboards to the USB-C Power port.

Changes

  • Added new section to docs/cubie/a7z/hardware-use/type-c.md
  • Includes complete overlay DTS template, build steps, and verification steps
  • Notes compatibility with Cubie A7S

Motivation

Customers frequently ask why peripherals don't work when connected to the USB-C Power port. The port defaults to device mode and requires a device tree overlay to switch to host mode.

Add instructions for enabling USB-C Power port (interface ①) as host mode
on A7Z using device tree overlay. The port defaults to device mode; this
guide shows how to switch it to host mode via rsetup to connect
peripherals such as wireless mouse receivers, keyboards and USB flash
drives.

Note: this branch is created fresh from upstream/main to ensure no
DC-power-related content from the original PR is carried over.
@tangzz-radxa tangzz-radxa requested a review from a team as a code owner March 26, 2026 06:46
@tangzz-radxa
Copy link
Contributor Author

Hi @jack-ma, this PR is created fresh from upstream/main with all DC-power-related content completely removed. The guide now only covers the USB-C Power port (interface ①) as host mode overlay, without any mention of DC power interfaces. The old PR #1492 has been closed.

Please review when you have time.

@jack-ma
Copy link
Contributor

jack-ma commented Mar 26, 2026

@tangzz-radxa PR 内容没有没有问题,请补充英文版本翻译。

@tangzz-radxa
Copy link
Contributor Author

Done. 已补充英文版本,添加了 USB-C Power 接口作为 Host 模式的完整翻译到 i18n/en/docusaurus-plugin-content-docs/current/cubie/a7z/hardware-use/type-c.md

@jack-ma jack-ma merged commit 7d223e4 into radxa-docs:main Mar 26, 2026
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants