Skip to content

Commit cc06290

Browse files
committed
ADD: linux terminal echo documentation
1 parent 5461b1b commit cc06290

File tree

1 file changed

+22
-0
lines changed

1 file changed

+22
-0
lines changed

README.md

+22
Original file line numberDiff line numberDiff line change
@@ -172,6 +172,28 @@ do not implement the workaround.
172172

173173
The RTS issue does not affect _Linux_ or _macOS_.
174174

175+
## Unexpected Echo or Garbage Characters in Linux
176+
177+
_Linux_ terminal subsystem echoes characters coming from a
178+
_bluepill-serial-monster_ port back to this port until it is switched to
179+
the raw more (see ```man 3 cfmakeraw```).
180+
181+
This behaviour is Linux-specific and is not related to
182+
_bluepill-serial-monster_ itself. See
183+
[this Stack Overflow post](https://stackoverflow.com/questions/14866899/linux-cdc-acm-device-unexpected-characters-sent-to-device)
184+
for details.
185+
186+
Usually, this is not an issue; however, it may lead to garbage characters
187+
appearing when the configuration shell is started. For instance, if **PA5**
188+
is tied to the ground when _bluepill-serial-monster_ is plugged in, the device
189+
sends the configuration mode banner to the host. The host echoes the content of
190+
the banner back to the device, which in turn tries to parse it as if it was
191+
a sequence of configuration shell commands. When _screen_ or another terminal
192+
emulation software is started, its output may contain garbage characters left
193+
due to the above exchange.
194+
195+
196+
175197
## Advanced Configuration
176198

177199
_bluepill-serial-monster_ provides a configuration shell that allows

0 commit comments

Comments
 (0)