it amazes me that people still trust printed or online docs.
Just for clarification: manufacturers datasheet fall into either or both of those two categories. Did you mean to include them as well?
I -HATE- the Tx/Rx naming convention. Every manufacturer has their own interpretation of what "Tx" and "Rx" should mean...does "Tx" mean "I transmit on this pin", or does it mean "connect this pin to Tx on your device"? The entire world would be a better place if they would just drop "Tx"/"Rx" entirely and replace them with arrows showing the direction of data transfer, arrow leaving the chip for an output, arrow entering the chip for an input. Or at least write "input" and "output" next to "Rx" and "Tx" so end-users know what convention is being used by the manufacturer.
I hate it too. I spend decades wiring up serial links between different manufactures equipment and for a standard RS-232 certainly created a lot of troubleshooting and wasted time.
I really like how the SPI interfaces uses signal names like MISO and MOSI. No confusion of what the signal direction is between the master and slave.
I don't quite agree on that. Master In Slave Out is as confusing as Tx or Rx. Why?
- It does not give any information on what goes in or out....
- unless you know whether the chip acts as a slave or a master
- Master or Slave is a function unbound to the schematics: it is a logical, not electrical feature.
Some chips have serial data pins named
DI or
DO (Data In/Out, e.g.
WS2812) or even
SI or
SO. Both conventions unambiguously identify the pin function and direction without having to look at the schematics.
Right, you might know you need to wire all
MOSI nets together and all
MISO nets together. But
MOSI is an
input on a
slave and an
output on the
master,
MISO is an
output on a slave and an
input on the master... Still ambiguous. If you can get what goes in or out of the
chip by just reading the pin name then the pin is cleverly named. As to MOSI and MISO you either have to know whether the chip is a slave or a master hence resort to its context (i.e. the schematics), which is not as good.
Now if the manufacturer also uses a pin named
DI to also send data *out* (e.g. Newhaven LCDs) that is a different story...