bigtreetech / bigtreetech/Rodent

macOS USB Serial Communication

Open
#8 0 comments 1 reaction 0 assignees View on GitHub
Dominant language
No language data
Stars
19
Forks
4
PR merge metrics
No merged PRs in 30d

Description

## Issue

It seems that the CH340 drivers provided by macOS do not include support for the CH340K variant used by this board. [0] I'm filing this issue to document the symptoms and provide a solution for those who encounter the same situation.

## Steps to Reproduce

* Attach jumper to VUSB pins (next to USB-C port).
* Connect board to laptop via USB cable.
* OS acknowledges the presence of a USB serial device.
* `ioreg -p IOUSB -w0 | grep "USB Serial"`
* No TTY was opened for the USB serial device. <- This is the problem (see [Fix](##fix) below).
* `ls /dev/tty* | grep "usb"`
* Return code of 1 (error) assuming the board is the only USB peripheral attached to your machine.

## Fix

This can be resolved by installing the drivers provided by [WCHSoftGroup/ch34xser_macos](https://github.com/WCHSoftGroup/ch34xser_macos) and rebooting the machine.

With the fix you should see a TTY open for the board when attached, which means the port will now be selectable in the Arduino IDE, platformio, etc.

## Hardware

* BBT Rodent v1.0
* 16" M1 MacBook Pro (2021)
* OS: macOS Sequoia 15.2 (24C101)

---
## References

[0] https://github.com/LilyGO/LILYGO-T-OI/issues/3

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.