From a827491b2be88758789a9f4a4ecda2f566c2c7ab Mon Sep 17 00:00:00 2001
From: Laurens Valk <laurens@pybricks.com>
Date: Fri, 20 Mar 2020 11:13:52 +0100
Subject: [PATCH] doc/pupdevices: doc ColorDistanceSensor.remote()

---
 doc/api/pupdevices.rst |  2 ++
 pybricks/pupdevices.py | 20 ++++++++++++++++++++
 2 files changed, 22 insertions(+)

diff --git a/doc/api/pupdevices.rst b/doc/api/pupdevices.rst
index a1fe9f0..72b7501 100644
--- a/doc/api/pupdevices.rst
+++ b/doc/api/pupdevices.rst
@@ -79,6 +79,8 @@ Color and Distance Sensor
 
     .. automethod:: pybricks.pupdevices.ColorDistanceSensor.distance
 
+    .. automethod:: pybricks.pupdevices.ColorDistanceSensor.remote
+
     .. rubric:: Built-in light
 
     This sensor has a built-in light. You can make it red, green, blue, or turn
diff --git a/pybricks/pupdevices.py b/pybricks/pupdevices.py
index 8ace5e0..b3d614b 100644
--- a/pybricks/pupdevices.py
+++ b/pybricks/pupdevices.py
@@ -100,3 +100,23 @@ class ColorDistanceSensor:
             to 100 (farthest).
         """
         pass
+
+    def remote(self, channel, button_1=None, button_2=None):
+        """Make the sensor act like a Power Functions 1.0 IR remote.
+
+        Choose a channel and up to two buttons to "press". The infrared
+        receiver behaves just as if responding to the real remote.
+
+        The sensor keeps sending the signal (as if you keep pressing the
+        buttons). It keeps going until you call this method again with
+        different buttons or no buttons at all.
+
+        Arguments:
+            channel (int): Channel number of the remote.
+            button_1 (Button): Button of the Power Functions 1.0 IR remote.
+                               Choose ``None`` if you don't want to press
+                               any button.
+            button_2 (Button): Button of the Power Functions 1.0 IR remote.
+                               Choose ``None`` if you don't want to press
+                               any button.
+        """