licheepi4a: update flash doc

[sunmin89]

Summary by Sourcery

Clarify and enhance the LicheePi 4A Windows flashing instructions with improved power‑up guidance and data‑cable requirements.

Documentation:

• Update boot and power‑up instructions to emphasize using the bundled USB‑A to USB‑C cable and a 5V/2A power adapter.
• Add guidance on selecting high‑quality USB‑C data cables that support both charging and 5–10 Gbps data transfer for reliable image writing.
• Clarify fastboot usage by adding a device check step and noting that abnormal block counts may be mitigated by retrying with a higher‑speed cable.

[sourcery-ai]

Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

Updates the Windows flashing documentation for LicheePi 4A to clarify recommended power-up sequence, emphasize using a high-quality USB-A to USB-C cable for both flashing and power, and add a fastboot device check plus guidance on diagnosing slow/abnormal root flashing likely caused by poor cables.

Flow diagram for fastboot device check and root flashing diagnostics

flowchart TD
  A[Start_flashing_process] --> B[Connect_board_with_high_quality_USB-A_to_USB_Type-C_cable]
  B --> C[Run_fastboot_devices]
  C --> D{Is_device_listed}
  D -- Yes --> E[Flash_uboot_image]
  E --> F[Flash_boot_image]
  F --> G[Flash_root_image]
  G --> H{Root_flash_block_count_normal}
  H -- Yes --> I[Flashing_successful]
  H -- No --> J[Suspect_cable_issue_or_previous_steps_wrong]
  J --> K[Replace_with_higher_speed_USB_cable]
  K --> L[Repeat_flashing_steps]
  D -- No --> M[Reinstall_USB_driver_and_check_cable]
  M --> C

Loading

File-Level Changes

Change	Details	Files
Clarify recommended board power-up sequence and add guidance on choosing a proper USB-A to USB Type-C cable for flashing and power.	Rephrased the boot sequence instructions to highlight connecting HDMI first and using the bundled USB-A to USB Type-C cable to power the board from a 5V/2A adapter Added a warning callout explaining that the USB-A to USB Type-C cable used for flashing must support both charging and 5–10 Gbps data transfer and should not be a charge-only or very slow cable	docs/Installation/licheepi4a-windows.mdx
Improve fastboot flashing reliability guidance by adding a device presence check and clarifying that abnormal root flashing may be due to low-quality cables.	Inserted a fastboot command to list devices before flashing, with a note that one connected device line should appear to confirm driver and connection health Updated the warning about abnormal root partition block counts to suggest that users can also try a higher-speed data cable if they see unusually large block numbers	docs/Installation/licheepi4a-windows.mdx

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

Hey - I've left some high level feedback:

• In the USB 数据线 warning, consider describing the required cable in standard USB version terms (e.g., “USB 3.0/3.1 Gen1 5Gbps 或以上的数据线”) so users can more easily match it to product specs when purchasing.
• For the fastboot.exe devices step, you might add a brief comment or example of expected output (例如 # 预期输出: <序列号> fastboot) so users clearly know how to confirm the device is correctly detected before proceeding.

Prompt for AI Agents

Please address the comments from this code review:

## Overall Comments
- In the USB 数据线 warning, consider describing the required cable in standard USB version terms (e.g., “USB 3.0/3.1 Gen1 5Gbps 或以上的数据线”) so users can more easily match it to product specs when purchasing.
- For the `fastboot.exe devices` step, you might add a brief comment or example of expected output (例如 `# 预期输出: <序列号> fastboot`) so users clearly know how to confirm the device is correctly detected before proceeding.

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook

_{Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.}