Skip to content

Commit

Permalink
ADD: mapping logical port names to physical ports documentation section
Browse files Browse the repository at this point in the history
  • Loading branch information
r2axz committed Feb 8, 2022
1 parent 3ee0271 commit 1ab0317
Showing 1 changed file with 15 additions and 1 deletion.
16 changes: 15 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ board works with your computer, don't bother fixing it.
* 7 or 8 bit word length;
* None, even, odd parity;
* 1, 1.5, and 2 stop bits;
* Works with _CDC Class_ drives on _Linux_, _OS X_, and _Windows_;
* Works with _CDC Class_ drives on _Linux_, _macOS_, and _Windows_;
* Supports all baud rates up to 2 MBaud;
* **TXA** signal for controlling RS-485 transceivers (**DE**, **/RE**);
* _DMA_ _RX_/_TX_ for high-speed communications;
Expand Down Expand Up @@ -106,6 +106,20 @@ by the host. Please take this behaviour into account if you rely on the

_UART DMA RX/TX_ buffer size is **1024** bytes.

## Mapping Logical Port Names to Physical Ports

Unfortunately, operating systems ignore CDC port names reported by the firmware.
_Linux_ and _macOS_ tend to assign device numbers incrementally so that UART1 gets
the lowest and UART3 the highest **/dev/ttyACM...** (Linux) or
**/dev/tty.usbmodem...** (macOS) numbers. On the other hand, _Windows_ can get
pretty creative when assigning COM port numbers to USB CDC devices.

To find out which physical UART corresponds to a particular COM port on _Windows_,
open **Device Manager**, right-click on the COM port under **Ports (COM & LPT)**,
and choose **Properties**. Open the **Details** tab and select
the **Bus reported device description** property.
The **Value** field will indicate the physical UART name.

## Advanced Configuration

_bluepill-serial-monster_ provides a configuration shell that allows
Expand Down

0 comments on commit 1ab0317

Please sign in to comment.