micropython_ir projects

[micorpython_ir.git] / TRANSMITTER.md

diff --git a/TRANSMITTER.md b/TRANSMITTER.md
index 1c30d4f7709ce316a8750ef822433211624c6cd1..c76995bb5390014de2e4b4dcbd55519aa818ab0c 100644 (file)
--- a/TRANSMITTER.md
+++ b/TRANSMITTER.md
@@ -22,7 +22,10 @@ device similar to the ESP32 RMT. The device driver is
 [documented here](./RP2_RMT.md); this is for experimenters and those wanting to
 use the library in conjunction with their own PIO assembler code.
 
-## 1.1 Pyboard Wiring
+## 1.1 Wiring
+
+All microcontrollers require an external circuit to drive the LED. The notes
+below on specific microcontrollers assume that such a circuit is used.
 
 I use the following circuit which delivers just under 40mA to the diode. R2 may
 be reduced for higher current.  
@@ -47,13 +50,19 @@ updated to use it. The same circuits as above may be used to connect to pin 23
 available on the ESP32 `RMT` object, so any alternative circuit must illuminate
 the LED if the pin state is high.
 
+## 1.3 RP2 Wiring
+
+There is no `active_high` option so the circuit  must illuminate the LED if the
+pin state is high, as per the above drivers. Test programs use pin 17, but this
+can be reassigned.
+
 # 2. Dependencies and installation
 
 ## 2.1 Dependencies
 
 The device driver has no dependencies.
 
-On ESP32 a firmware version >= V1.14 is required. The Loboris port is not
+On ESP32 a firmware version >= V1.17 is required. The Loboris port is not
 supported owing to the need for the RMT device and other issues.
 
 The demo program uses `uasyncio` primitives from
@@ -163,7 +172,7 @@ skipping validation.
 | RC6_M0   | 6.0ms | 2.0ms   |
 | MCE      | 6.7ms | 2.0ms   |
 
-#### NEC class
+#### NEC class (also Samsung)
 
 Class `NEC`. Example invocation:
 ```python
@@ -181,6 +190,16 @@ the complement for values < 256.
 
 A value passed in `toggle` is ignored.
 
+For Samsung protocol set the `samsung` class variable `True`:
+```python
+from ir_tx.nec import NEC
+NEC.samsung=True
+```
+Samsung remotes do not seem to use repeat codes: the sample I have simply
+repeats the original code.
+
+Thanks are due to J.E.Tannenbaum for information about the Samsung protocol.
+
 #### Sony classes
 
 Classes `SONY_12`, `SONY_15` and `SONY_20`. Example invocation: