Files
MemRelay/projects/d0abaf3f-da04-4dd4-a228-bacf68f44e8f/curated/development/Troubleshooting Guide for BDYG18Pro Armbian Builder.md
T

5.3 KiB
Raw Blame History

title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit
title type permalink stable_id scope project_id workspace_type usage_profile_id preference_context document_type revision source_memory_ids source_checkpoint_ids source_file_ids source_git_commit source_git_commits source_agent_sync_ids model_connection model_name source_count source_revisions source_dispositions cited_source_ids job_cited_source_ids conflicts supersedes preferences source_cursor source_hash prompt_version schema_version curation_job_id created_at updated_at tags restored_from_commit
Troubleshooting Guide for BDYG18Pro Armbian Builder curated main/projects/d0abaf3f-da04-4dd4-a228-bacf68f44e8f/curated/development/troubleshooting-guide-for-bdyg18-pro-armbian-builder a89adf53-4420-43ef-9a95-56567f524ef6 project d0abaf3f-da04-4dd4-a228-bacf68f44e8f development null development troubleshooting 1
36234e0082845515a053c10ee552ce35a03415f0
36234e0082845515a053c10ee552ce35a03415f0
Sub2API git-restore 125
memory:40bd0324-4ef3-4777-9dba-5a7ef64a4c92 memory:340af5e9-b3e5-423a-9971-b370992738ce memory:bea4a5ba-4685-4869-a02e-f0f1c7f733ea memory:b70c1a22-6834-4e59-936c-1945b04273b7
1 1 1 1
processed unchanged unsupported skipped
78 0 47 0
memory:40bd0324-4ef3-4777-9dba-5a7ef64a4c92
memory:340af5e9-b3e5-423a-9971-b370992738ce
memory:bea4a5ba-4685-4869-a02e-f0f1c7f733ea
memory:b70c1a22-6834-4e59-936c-1945b04273b7
git:tools/driver/DriverAssitant_v5.14/Driver/x64/win10/rockusb.inf
git:tools/rkdevtool/revision.txt
git:tools/driver/DriverAssitant_v5.14/revison.log
0 5fe39ad3a37421f812566dd39f89d4c28fc6078c8d39031dff10eb6eb8d72e00 2026-08-12.3 3 null 2026-08-08T10:02:36.551871+00:00 2026-09-23T15:03:56.673042+00:00
issues
fixes
debugging
6a6a895eaf

Troubleshooting

Power‑off hangs

Symptom: systemctl poweroff leaves the board powered on; manual power‑cycle required.

Root cause: Linux sets POWER_OFF_NOTIFICATION=LONG in the eMMC EXT_CSD, putting the eMMC into a low‑power state that the BootROM cannot wake.

Fix: Enable syscon‑reboot‑mode DTB node (adds a clean reboot path) or use the emergency‑reboot.shutdown systemd script which triggers sysrq b hard reset.

Sources: evidence/emmc-reset-evaluation.txt, evidence/live-system/emergency-reboot.shutdown.


Network TX storms / low throughput

Symptom: Massive retransmits, throughput ≈ 1 Mbps.

Cause: Device Tree enables snps,tso (TCP Segmentation Offload) on the GMAC, which the driver mishandles.

Resolution: Remove the snps,tso property from the DTB (kernel 6.18.41). Verify with ethtool -k eth0 → tso: off. Throughput improves to ~30 Mbps.

Sources: evidence/live-system/tso-diagnosis-2026-07-31.txt, evidence/live-system/tso-fix-verification-2026-07-31.txt.


GMAC0 watchdog storms

Symptom: Repeated watchdog messages in the kernel log.

Cause: GMAC0 is enabled without a physical link, generating spurious watchdog events.

Fix: Disable GMAC0 in the DTB (set status = "disabled"). The system now only uses GMAC1 for the RTL8367S switch.

Source: aa3057ab-54c5-4ffc-ba85-c2f2396ee60c.


Accidental SPI‑NOR overwrite

Symptom: Flashing the SPL to SPI‑NOR overwrites the boot region; on power‑cycle the board falls back to MaskROM.

Mitigation: RKDevTool warns when the target storage is SPI‑NOR. Additionally, the build scripts enforce:

  • Target verification via SHA‑256 manifest.
  • Mandatory flash_erase before writing.

Source: aa3057ab-54c5-4ffc-ba85-c2f2396ee60c.


Docker proxy leakage

Symptom: Proxy environment variables leak into the Docker container, causing network failures.

Solution: The orchestrator strips proxy vars inside Docker and uses optional G18PRO_PROXY only when explicitly set. .curlrc, .wgetrc, and Git insteadOf are also configured.

Source: Batch 2/16, 4.


CRLF line‑ending corruption

Symptom: Files edited on Windows acquire CRLF line endings, breaking scripts inside the Docker container.

Remedy: Enforce LF line endings via .gitattributes and set core.autocrlf=false.

Source: ff34c6eb-6bba-41e5-9e43-ff80941fa823.


PCIe BAR allocation failures

Symptom: Kernel logs report BAR 0: can't assign; no space.

Work‑around: Add kernel cmdline pci=realloc (or pci=assign-busses). This re‑allocates address windows to avoid overlaps.

Source: evidence/vendor-backup/vendor-kern.log.net-lines.txt.


Rockusb driver installation issues

Problem: Windows requires a signed catalog (rockusb.cat) which is not shipped.

Temporary fix: Install the driver in Test‑Signed mode (pnputil /add-driver rockusb.inf /install) or generate a signed catalog using a code‑signing certificate.

Security note: The INF grants Everyone full read/write/execute access (D:P(A;;GRGWGX;;;WD)). Consider tightening the descriptor for production environments.

Sources: 13, 14, 15.


References

  • aa3057ab-54c5-4ffc-ba85-c2f2396ee60c
  • evidence/emmc-reset-evaluation.txt
  • evidence/live-system/emergency-reboot.shutdown
  • evidence/live-system/tso-diagnosis-2026-07-31.txt
  • evidence/live-system/tso-fix-verification-2026-07-31.txt
  • evidence/vendor-backup/vendor-kern.log.net-lines.txt
  • 4
  • 13
  • 14
  • 15