mirror of
				https://github.com/Ysurac/openmptcprouter.git
				synced 2025-03-09 15:40:20 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			92 lines
		
	
	
	
		
			3.8 KiB
		
	
	
	
		
			Diff
		
	
	
	
	
	
			
		
		
	
	
			92 lines
		
	
	
	
		
			3.8 KiB
		
	
	
	
		
			Diff
		
	
	
	
	
	
From 4b7338d1247fe302299ee67f3f812e575fc00832 Mon Sep 17 00:00:00 2001
 | 
						|
From: Phil Elwell <phil@raspberrypi.org>
 | 
						|
Date: Wed, 5 Dec 2018 11:56:40 +0000
 | 
						|
Subject: [PATCH 292/432] overlays: Update README with removal of lirc-rpi
 | 
						|
 | 
						|
Signed-off-by: Phil Elwell <phil@raspberrypi.org>
 | 
						|
---
 | 
						|
 arch/arm/boot/dts/overlays/README | 57 ++++++++++++-------------------
 | 
						|
 1 file changed, 21 insertions(+), 36 deletions(-)
 | 
						|
 | 
						|
diff --git a/arch/arm/boot/dts/overlays/README b/arch/arm/boot/dts/overlays/README
 | 
						|
index f5e5d6f378f7..049b50535656 100644
 | 
						|
--- a/arch/arm/boot/dts/overlays/README
 | 
						|
+++ b/arch/arm/boot/dts/overlays/README
 | 
						|
@@ -56,23 +56,29 @@ have its contents deleted (or commented out).
 | 
						|
 Using Overlays
 | 
						|
 ==============
 | 
						|
 
 | 
						|
-Overlays are loaded using the "dtoverlay" directive. As an example, consider
 | 
						|
-the popular lirc-rpi module, the Linux Infrared Remote Control driver. In the
 | 
						|
-pre-DT world this would be loaded from /etc/modules, with an explicit
 | 
						|
-"modprobe lirc-rpi" command, or programmatically by lircd. With DT enabled,
 | 
						|
-this becomes a line in config.txt:
 | 
						|
+Overlays are loaded using the "dtoverlay" config.txt setting. As an example,
 | 
						|
+consider I2C Real Time Clock drivers. In the pre-DT world these would be loaded
 | 
						|
+by writing a magic string comprising a device identifier and an I2C address to
 | 
						|
+a special file in /sys/class/i2c-adapter, having first loaded the driver for
 | 
						|
+the I2C interface and the RTC device - something like this:
 | 
						|
 
 | 
						|
-    dtoverlay=lirc-rpi
 | 
						|
+    modprobe i2c-bcm2835
 | 
						|
+    modprobe rtc-ds1307
 | 
						|
+    echo ds1307 0x68 > /sys/class/i2c-adapter/i2c-1/new_device
 | 
						|
 
 | 
						|
-This causes the file /boot/overlays/lirc-rpi.dtbo to be loaded. By
 | 
						|
-default it will use GPIOs 17 (out) and 18 (in), but this can be modified using
 | 
						|
-DT parameters:
 | 
						|
+With DT enabled, this becomes a line in config.txt:
 | 
						|
 
 | 
						|
-    dtoverlay=lirc-rpi,gpio_out_pin=17,gpio_in_pin=13
 | 
						|
+    dtoverlay=i2c-rtc,ds1307
 | 
						|
 
 | 
						|
-Parameters always have default values, although in some cases (e.g. "w1-gpio")
 | 
						|
-it is necessary to provided multiple overlays in order to get the desired
 | 
						|
-behaviour. See the list of overlays below for a description of the parameters
 | 
						|
+This causes the file /boot/overlays/i2c-rtc.dtbo to be loaded and a "node"
 | 
						|
+describing the DS1307 I2C device to be added to the Device Tree for the Pi. By
 | 
						|
+default it usees address 0x68, but this can be modified with an additional DT
 | 
						|
+parameter:
 | 
						|
+
 | 
						|
+    dtoverlay=i2c-rtc,ds1307,addr=0x68
 | 
						|
+
 | 
						|
+Parameters usually have default values, although certain parameters are
 | 
						|
+mandatory. See the list of overlays below for a description of the parameters
 | 
						|
 and their defaults.
 | 
						|
 
 | 
						|
 The Overlay and Parameter Reference
 | 
						|
@@ -1135,29 +1141,8 @@ Params: <None>
 | 
						|
 
 | 
						|
 
 | 
						|
 Name:   lirc-rpi
 | 
						|
-Info:   Configures lirc-rpi (Linux Infrared Remote Control for Raspberry Pi)
 | 
						|
-        Consult the module documentation for more details.
 | 
						|
-Load:   dtoverlay=lirc-rpi,<param>=<val>
 | 
						|
-Params: gpio_out_pin            GPIO for output (default "17")
 | 
						|
-
 | 
						|
-        gpio_in_pin             GPIO for input (default "18")
 | 
						|
-
 | 
						|
-        gpio_in_pull            Pull up/down/off on the input pin
 | 
						|
-                                (default "down")
 | 
						|
-
 | 
						|
-        sense                   Override the IR receive auto-detection logic:
 | 
						|
-                                 "0" = force active-high
 | 
						|
-                                 "1" = force active-low
 | 
						|
-                                 "-1" = use auto-detection
 | 
						|
-                                (default "-1")
 | 
						|
-
 | 
						|
-        softcarrier             Turn the software carrier "on" or "off"
 | 
						|
-                                (default "on")
 | 
						|
-
 | 
						|
-        invert                  "on" = invert the output pin (default "off")
 | 
						|
-
 | 
						|
-        debug                   "on" = enable additional debug messages
 | 
						|
-                                (default "off")
 | 
						|
+Info:   This overlay has been deprecated and removed - see gpio-ir
 | 
						|
+Load:   <Deprecated>
 | 
						|
 
 | 
						|
 
 | 
						|
 Name:   ltc294x
 | 
						|
-- 
 | 
						|
2.19.1
 | 
						|
 |