Skip to content

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

Open
tangzz-radxa wants to merge 5 commits intoradxa-docs:mainfrom
tangzz-radxa:docs/a7z-usb-c-host-mode
Open

docs(a7z): add USB-C Power port as host mode overlay guide#1492
tangzz-radxa wants to merge 5 commits intoradxa-docs:mainfrom
tangzz-radxa:docs/a7z-usb-c-host-mode

Conversation

@tangzz-radxa
Copy link
Contributor

Description

Add instructions for enabling USB-C Power port as host mode on A7Z using device tree overlay. This allows connecting peripherals like wireless mouse receivers and keyboards to the USB-C Power接口 (the USB-C port next to the DC power barrel jack).

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 as host mode on A7Z
using device tree overlay. This allows connecting peripherals like
wireless mouse receivers and keyboards to the USB-C Power接口.

The overlay sets usb_port_type to 0x01 (host mode) on usbc0.
Also applicable to Cubie A7S.
@tangzz-radxa tangzz-radxa requested a review from a team as a code owner March 19, 2026 03:17
Copy link
Contributor

@xzl01 xzl01 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a7z没有dc电源接口

… guide

Reviewer xzl01 noted that A7Z has no DC power interface.
The USB-C Power port is interface ① (USB-C 2.0 OTG & Power) as
documented in hardware-info.md.

Fixes radxa-docs#1492 review comment.
…C host guide

The cubie-a7a-radxa-25w-poe.dts overlay is for Cubie A7A PoE support,
not A7Z USB-C host mode. Remove this misleading reference and instead
provide a minimal self-contained overlay example with proper explanation
of the usb_port_type setting.
@tangzz-radxa
Copy link
Contributor Author

Fixed: 已移除对 cubie-a7a-radxa-25w-poe.dts 的引用。该 overlay 面向 Cubie A7A 的 PoE 功能,与 A7Z USB-C Power 接口的 host 模式配置无关。

现在改为提供最小可用的 overlay 示例(包含 /dts-v1/、/plugin/、compatible 和 &usbc0 usb_port_type 设置),并补充了 usb_port_type 设置项的说明,便于用户理解。

@tangzz-radxa
Copy link
Contributor Author

@xzl01 The DC power jack reference and the cubie-a7a PoE overlay have been removed from the guide (commits e258afb and ddf04a8). The fixes are on the branch. Could you please re-review?

@tangzz-radxa
Copy link
Contributor Author

Hi @xzl01, the CHANGES_REQUESTED review has been addressed with the following commits:

  • e258afb: fix(a7z): remove incorrect DC power jack reference in USB-C host mode guide
  • ddf04a8: fix(a7z): remove misleading cubie-a7a PoE overlay reference from USB-C host guide

The branch has been updated. Could you please re-review when you have time?

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