Skip to content

docs(README): add ASUS Sonix IR hardware notes (proximity-sensor controlled emitter)#1110

Open
jatroconis wants to merge 1 commit into
boltgolt:masterfrom
jatroconis:docs/asus-sonix-hardware-notes
Open

docs(README): add ASUS Sonix IR hardware notes (proximity-sensor controlled emitter)#1110
jatroconis wants to merge 1 commit into
boltgolt:masterfrom
jatroconis:docs/asus-sonix-hardware-notes

Conversation

@jatroconis
Copy link
Copy Markdown

Summary

Adds a small Hardware notes subsection under Troubleshooting in the README, documenting the proximity-sensor-controlled IR emitter behavior on ASUS laptops with the Sonix 3277:0018 IR module (Vivobook, ProArt, Zenbook lines).

This is a documentation-only change — no code touched.

Why

I just spent a long debug session getting Howdy working on a Vivobook X1607C and chased an IR feed that "worked for one frame and then went black" through several Howdy issues, several linux-enable-ir-emitter issues, and two forced reboots before tracking down the actual cause. The root cause is hardware behavior, not a Howdy bug, and a small note in the README would save the next person the same debug session.

The empirical investigation, including frame-by-frame brightness data with and without motion in front of the camera, is in #1109.

What the change says

  • The IR emitter on these ASUS modules is gated by the laptop's proximity sensor and only fires on motion in front of the camera. So howdy test showing a black feed when nobody is in front is expected — face entry triggers the LED at auth time.
  • Users should not run linux-enable-ir-emitter configure on these models. Multiple users have reported the brute-force UVC step wedges the USB bus on Sonix 3277:0018 and requires a hard reboot (see EmixamPP/linux-enable-ir-emitter#195). It will not find a working sequence anyway because the LED is not chipset-controlled.
  • The IR LED emitter is often physically located in the same bezel cutout as the RGB camera, not the IR-camera cutout. Privacy-shutter users should know this so they don't troubleshoot in the wrong place.

Affected hardware (per cross-issue reports)

  • ASUS Vivobook X1607C
  • ASUS ProArt PX13
  • ASUS ProArt H7606WX-DRSE011X
  • ASUS Zenbook S16 UM5606
  • Likely most 2023–2026 ASUS laptops with the Sonix module

Test plan

  • README renders correctly on GitHub (Markdown verified)
  • No code paths affected — purely additive prose

I'm happy to move this to the wiki instead if that's the preferred home for hardware quirks. Also happy to expand the section with notes about other vendor IR modules if other contributors share their findings.

Document the empirically-validated finding that on ASUS laptops with a
Sonix 3277:0018 IR module (Vivobook, ProArt, Zenbook), the IR emitter
is controlled by the laptop's proximity sensor and only fires on motion
in front of the camera. This:

- Explains why 'howdy test' shows a black feed when no one is in front
  (expected — face entry triggers the LED)
- Tells users not to run linux-enable-ir-emitter configure on these
  models (its brute-force step wedges the USB bus on Sonix chips per
  EmixamPP/linux-enable-ir-emitter#195)
- Notes the common bezel layout where the IR LED is co-located with
  the RGB camera, so privacy-shutter behavior can be misleading

References issue boltgolt#1109 for the empirical data and full investigation.

Affected models reported across boltgolt#890 and related issues:
ASUS Vivobook X1607C, ProArt PX13, ProArt H7606WX-DRSE011X, Zenbook
S16 UM5606.
@jatroconis jatroconis mentioned this pull request May 8, 2026
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.

1 participant