xref: /linux/drivers/media/rc/rc-loopback.c (revision 24bce201d79807b668bf9d9e0aca801c5c0d5f78)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * Loopback driver for rc-core,
4  *
5  * Copyright (c) 2010 David Härdeman <david@hardeman.nu>
6  *
7  * This driver receives TX data and passes it back as RX data,
8  * which is useful for (scripted) debugging of rc-core without
9  * having to use actual hardware.
10  */
11 
12 #include <linux/device.h>
13 #include <linux/module.h>
14 #include <linux/sched.h>
15 #include <linux/slab.h>
16 #include <media/rc-core.h>
17 
18 #define DRIVER_NAME		"rc-loopback"
19 #define RXMASK_NARROWBAND	0x1
20 #define RXMASK_WIDEBAND		0x2
21 
22 struct loopback_dev {
23 	struct rc_dev *dev;
24 	u32 txmask;
25 	u32 txcarrier;
26 	u32 txduty;
27 	bool idle;
28 	bool wideband;
29 	bool carrierreport;
30 	u32 rxcarriermin;
31 	u32 rxcarriermax;
32 };
33 
34 static struct loopback_dev loopdev;
35 
36 static int loop_set_tx_mask(struct rc_dev *dev, u32 mask)
37 {
38 	struct loopback_dev *lodev = dev->priv;
39 
40 	if ((mask & (RXMASK_NARROWBAND | RXMASK_WIDEBAND)) != mask) {
41 		dev_dbg(&dev->dev, "invalid tx mask: %u\n", mask);
42 		return 2;
43 	}
44 
45 	dev_dbg(&dev->dev, "setting tx mask: %u\n", mask);
46 	lodev->txmask = mask;
47 	return 0;
48 }
49 
50 static int loop_set_tx_carrier(struct rc_dev *dev, u32 carrier)
51 {
52 	struct loopback_dev *lodev = dev->priv;
53 
54 	dev_dbg(&dev->dev, "setting tx carrier: %u\n", carrier);
55 	lodev->txcarrier = carrier;
56 	return 0;
57 }
58 
59 static int loop_set_tx_duty_cycle(struct rc_dev *dev, u32 duty_cycle)
60 {
61 	struct loopback_dev *lodev = dev->priv;
62 
63 	if (duty_cycle < 1 || duty_cycle > 99) {
64 		dev_dbg(&dev->dev, "invalid duty cycle: %u\n", duty_cycle);
65 		return -EINVAL;
66 	}
67 
68 	dev_dbg(&dev->dev, "setting duty cycle: %u\n", duty_cycle);
69 	lodev->txduty = duty_cycle;
70 	return 0;
71 }
72 
73 static int loop_set_rx_carrier_range(struct rc_dev *dev, u32 min, u32 max)
74 {
75 	struct loopback_dev *lodev = dev->priv;
76 
77 	if (min < 1 || min > max) {
78 		dev_dbg(&dev->dev, "invalid rx carrier range %u to %u\n", min, max);
79 		return -EINVAL;
80 	}
81 
82 	dev_dbg(&dev->dev, "setting rx carrier range %u to %u\n", min, max);
83 	lodev->rxcarriermin = min;
84 	lodev->rxcarriermax = max;
85 	return 0;
86 }
87 
88 static int loop_tx_ir(struct rc_dev *dev, unsigned *txbuf, unsigned count)
89 {
90 	struct loopback_dev *lodev = dev->priv;
91 	u32 rxmask;
92 	unsigned i;
93 	struct ir_raw_event rawir = {};
94 
95 	if (lodev->txcarrier < lodev->rxcarriermin ||
96 	    lodev->txcarrier > lodev->rxcarriermax) {
97 		dev_dbg(&dev->dev, "ignoring tx, carrier out of range\n");
98 		goto out;
99 	}
100 
101 	if (lodev->wideband)
102 		rxmask = RXMASK_WIDEBAND;
103 	else
104 		rxmask = RXMASK_NARROWBAND;
105 
106 	if (!(rxmask & lodev->txmask)) {
107 		dev_dbg(&dev->dev, "ignoring tx, rx mask mismatch\n");
108 		goto out;
109 	}
110 
111 	for (i = 0; i < count; i++) {
112 		rawir.pulse = i % 2 ? false : true;
113 		rawir.duration = txbuf[i];
114 
115 		/* simulate overflow if ridiculously long pulse was sent */
116 		if (rawir.pulse && rawir.duration > MS_TO_US(50))
117 			ir_raw_event_overflow(dev);
118 		else
119 			ir_raw_event_store_with_filter(dev, &rawir);
120 	}
121 
122 	if (lodev->carrierreport) {
123 		rawir.pulse = false;
124 		rawir.carrier_report = true;
125 		rawir.carrier = lodev->txcarrier;
126 
127 		ir_raw_event_store(dev, &rawir);
128 	}
129 
130 	/* Fake a silence long enough to cause us to go idle */
131 	rawir.pulse = false;
132 	rawir.duration = dev->timeout;
133 	ir_raw_event_store_with_filter(dev, &rawir);
134 
135 	ir_raw_event_handle(dev);
136 
137 out:
138 	return count;
139 }
140 
141 static void loop_set_idle(struct rc_dev *dev, bool enable)
142 {
143 	struct loopback_dev *lodev = dev->priv;
144 
145 	if (lodev->idle != enable) {
146 		dev_dbg(&dev->dev, "%sing idle mode\n", enable ? "enter" : "exit");
147 		lodev->idle = enable;
148 	}
149 }
150 
151 static int loop_set_wideband_receiver(struct rc_dev *dev, int enable)
152 {
153 	struct loopback_dev *lodev = dev->priv;
154 
155 	if (lodev->wideband != enable) {
156 		dev_dbg(&dev->dev, "using %sband receiver\n", enable ? "wide" : "narrow");
157 		lodev->wideband = !!enable;
158 	}
159 
160 	return 0;
161 }
162 
163 static int loop_set_carrier_report(struct rc_dev *dev, int enable)
164 {
165 	struct loopback_dev *lodev = dev->priv;
166 
167 	if (lodev->carrierreport != enable) {
168 		dev_dbg(&dev->dev, "%sabling carrier reports\n", enable ? "en" : "dis");
169 		lodev->carrierreport = !!enable;
170 	}
171 
172 	return 0;
173 }
174 
175 static int loop_set_wakeup_filter(struct rc_dev *dev,
176 				  struct rc_scancode_filter *sc)
177 {
178 	static const unsigned int max = 512;
179 	struct ir_raw_event *raw;
180 	int ret;
181 	int i;
182 
183 	/* fine to disable filter */
184 	if (!sc->mask)
185 		return 0;
186 
187 	/* encode the specified filter and loop it back */
188 	raw = kmalloc_array(max, sizeof(*raw), GFP_KERNEL);
189 	if (!raw)
190 		return -ENOMEM;
191 
192 	ret = ir_raw_encode_scancode(dev->wakeup_protocol, sc->data, raw, max);
193 	/* still loop back the partial raw IR even if it's incomplete */
194 	if (ret == -ENOBUFS)
195 		ret = max;
196 	if (ret >= 0) {
197 		/* do the loopback */
198 		for (i = 0; i < ret; ++i)
199 			ir_raw_event_store(dev, &raw[i]);
200 		ir_raw_event_handle(dev);
201 
202 		ret = 0;
203 	}
204 
205 	kfree(raw);
206 
207 	return ret;
208 }
209 
210 static int __init loop_init(void)
211 {
212 	struct rc_dev *rc;
213 	int ret;
214 
215 	rc = rc_allocate_device(RC_DRIVER_IR_RAW);
216 	if (!rc)
217 		return -ENOMEM;
218 
219 	rc->device_name		= "rc-core loopback device";
220 	rc->input_phys		= "rc-core/virtual";
221 	rc->input_id.bustype	= BUS_VIRTUAL;
222 	rc->input_id.version	= 1;
223 	rc->driver_name		= DRIVER_NAME;
224 	rc->map_name		= RC_MAP_EMPTY;
225 	rc->priv		= &loopdev;
226 	rc->allowed_protocols	= RC_PROTO_BIT_ALL_IR_DECODER;
227 	rc->allowed_wakeup_protocols = RC_PROTO_BIT_ALL_IR_ENCODER;
228 	rc->encode_wakeup	= true;
229 	rc->timeout		= IR_DEFAULT_TIMEOUT;
230 	rc->min_timeout		= 1;
231 	rc->max_timeout		= IR_MAX_TIMEOUT;
232 	rc->rx_resolution	= 1;
233 	rc->tx_resolution	= 1;
234 	rc->s_tx_mask		= loop_set_tx_mask;
235 	rc->s_tx_carrier	= loop_set_tx_carrier;
236 	rc->s_tx_duty_cycle	= loop_set_tx_duty_cycle;
237 	rc->s_rx_carrier_range	= loop_set_rx_carrier_range;
238 	rc->tx_ir		= loop_tx_ir;
239 	rc->s_idle		= loop_set_idle;
240 	rc->s_wideband_receiver	= loop_set_wideband_receiver;
241 	rc->s_carrier_report	= loop_set_carrier_report;
242 	rc->s_wakeup_filter	= loop_set_wakeup_filter;
243 
244 	loopdev.txmask		= RXMASK_NARROWBAND;
245 	loopdev.txcarrier	= 36000;
246 	loopdev.txduty		= 50;
247 	loopdev.rxcarriermin	= 1;
248 	loopdev.rxcarriermax	= ~0;
249 	loopdev.idle		= true;
250 	loopdev.wideband	= false;
251 	loopdev.carrierreport	= false;
252 
253 	ret = rc_register_device(rc);
254 	if (ret < 0) {
255 		dev_err(&rc->dev, "rc_dev registration failed\n");
256 		rc_free_device(rc);
257 		return ret;
258 	}
259 
260 	loopdev.dev = rc;
261 	return 0;
262 }
263 
264 static void __exit loop_exit(void)
265 {
266 	rc_unregister_device(loopdev.dev);
267 }
268 
269 module_init(loop_init);
270 module_exit(loop_exit);
271 
272 MODULE_DESCRIPTION("Loopback device for rc-core debugging");
273 MODULE_AUTHOR("David Härdeman <david@hardeman.nu>");
274 MODULE_LICENSE("GPL");
275