Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1 | /* |
| 2 | * USB RedRat3 IR Transceiver rc-core driver |
| 3 | * |
| 4 | * Copyright (c) 2011 by Jarod Wilson <jarod@redhat.com> |
| 5 | * based heavily on the work of Stephen Cox, with additional |
| 6 | * help from RedRat Ltd. |
| 7 | * |
| 8 | * This driver began life based an an old version of the first-generation |
| 9 | * lirc_mceusb driver from the lirc 0.7.2 distribution. It was then |
| 10 | * significantly rewritten by Stephen Cox with the aid of RedRat Ltd's |
| 11 | * Chris Dodge. |
| 12 | * |
| 13 | * The driver was then ported to rc-core and significantly rewritten again, |
| 14 | * by Jarod, using the in-kernel mceusb driver as a guide, after an initial |
| 15 | * port effort was started by Stephen. |
| 16 | * |
| 17 | * TODO LIST: |
| 18 | * - fix lirc not showing repeats properly |
| 19 | * -- |
| 20 | * |
| 21 | * The RedRat3 is a USB transceiver with both send & receive, |
| 22 | * with 2 separate sensors available for receive to enable |
| 23 | * both good long range reception for general use, and good |
| 24 | * short range reception when required for learning a signal. |
| 25 | * |
| 26 | * http://www.redrat.co.uk/ |
| 27 | * |
| 28 | * It uses its own little protocol to communicate, the required |
| 29 | * parts of which are embedded within this driver. |
| 30 | * -- |
| 31 | * |
| 32 | * This program is free software; you can redistribute it and/or modify |
| 33 | * it under the terms of the GNU General Public License as published by |
| 34 | * the Free Software Foundation; either version 2 of the License, or |
| 35 | * (at your option) any later version. |
| 36 | * |
| 37 | * This program is distributed in the hope that it will be useful, |
| 38 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 39 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 40 | * GNU General Public License for more details. |
| 41 | * |
| 42 | * You should have received a copy of the GNU General Public License |
| 43 | * along with this program; if not, write to the Free Software |
| 44 | * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
| 45 | * |
| 46 | */ |
| 47 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 48 | #include <asm/unaligned.h> |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 49 | #include <linux/device.h> |
| 50 | #include <linux/module.h> |
| 51 | #include <linux/slab.h> |
| 52 | #include <linux/usb.h> |
| 53 | #include <linux/usb/input.h> |
| 54 | #include <media/rc-core.h> |
| 55 | |
| 56 | /* Driver Information */ |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 57 | #define DRIVER_AUTHOR "Jarod Wilson <jarod@redhat.com>" |
| 58 | #define DRIVER_AUTHOR2 "The Dweller, Stephen Cox" |
| 59 | #define DRIVER_DESC "RedRat3 USB IR Transceiver Driver" |
| 60 | #define DRIVER_NAME "redrat3" |
| 61 | |
| 62 | /* module parameters */ |
| 63 | #ifdef CONFIG_USB_DEBUG |
| 64 | static int debug = 1; |
| 65 | #else |
| 66 | static int debug; |
| 67 | #endif |
| 68 | |
| 69 | #define RR3_DEBUG_STANDARD 0x1 |
| 70 | #define RR3_DEBUG_FUNCTION_TRACE 0x2 |
| 71 | |
| 72 | #define rr3_dbg(dev, fmt, ...) \ |
| 73 | do { \ |
| 74 | if (debug & RR3_DEBUG_STANDARD) \ |
| 75 | dev_info(dev, fmt, ## __VA_ARGS__); \ |
| 76 | } while (0) |
| 77 | |
| 78 | #define rr3_ftr(dev, fmt, ...) \ |
| 79 | do { \ |
| 80 | if (debug & RR3_DEBUG_FUNCTION_TRACE) \ |
| 81 | dev_info(dev, fmt, ## __VA_ARGS__); \ |
| 82 | } while (0) |
| 83 | |
| 84 | /* bulk data transfer types */ |
| 85 | #define RR3_ERROR 0x01 |
| 86 | #define RR3_MOD_SIGNAL_IN 0x20 |
| 87 | #define RR3_MOD_SIGNAL_OUT 0x21 |
| 88 | |
| 89 | /* Get the RR firmware version */ |
| 90 | #define RR3_FW_VERSION 0xb1 |
| 91 | #define RR3_FW_VERSION_LEN 64 |
| 92 | /* Send encoded signal bulk-sent earlier*/ |
| 93 | #define RR3_TX_SEND_SIGNAL 0xb3 |
| 94 | #define RR3_SET_IR_PARAM 0xb7 |
| 95 | #define RR3_GET_IR_PARAM 0xb8 |
| 96 | /* Blink the red LED on the device */ |
| 97 | #define RR3_BLINK_LED 0xb9 |
| 98 | /* Read serial number of device */ |
| 99 | #define RR3_READ_SER_NO 0xba |
| 100 | #define RR3_SER_NO_LEN 4 |
| 101 | /* Start capture with the RC receiver */ |
| 102 | #define RR3_RC_DET_ENABLE 0xbb |
| 103 | /* Stop capture with the RC receiver */ |
| 104 | #define RR3_RC_DET_DISABLE 0xbc |
| 105 | /* Return the status of RC detector capture */ |
| 106 | #define RR3_RC_DET_STATUS 0xbd |
| 107 | /* Reset redrat */ |
| 108 | #define RR3_RESET 0xa0 |
| 109 | |
| 110 | /* Max number of lengths in the signal. */ |
| 111 | #define RR3_IR_IO_MAX_LENGTHS 0x01 |
| 112 | /* Periods to measure mod. freq. */ |
| 113 | #define RR3_IR_IO_PERIODS_MF 0x02 |
| 114 | /* Size of memory for main signal data */ |
| 115 | #define RR3_IR_IO_SIG_MEM_SIZE 0x03 |
| 116 | /* Delta value when measuring lengths */ |
| 117 | #define RR3_IR_IO_LENGTH_FUZZ 0x04 |
| 118 | /* Timeout for end of signal detection */ |
| 119 | #define RR3_IR_IO_SIG_TIMEOUT 0x05 |
| 120 | /* Minumum value for pause recognition. */ |
| 121 | #define RR3_IR_IO_MIN_PAUSE 0x06 |
| 122 | |
| 123 | /* Clock freq. of EZ-USB chip */ |
| 124 | #define RR3_CLK 24000000 |
| 125 | /* Clock periods per timer count */ |
| 126 | #define RR3_CLK_PER_COUNT 12 |
| 127 | /* (RR3_CLK / RR3_CLK_PER_COUNT) */ |
| 128 | #define RR3_CLK_CONV_FACTOR 2000000 |
| 129 | /* USB bulk-in IR data endpoint address */ |
| 130 | #define RR3_BULK_IN_EP_ADDR 0x82 |
| 131 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 132 | /* Size of the fixed-length portion of the signal */ |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 133 | #define RR3_DRIVER_MAXLENS 128 |
| 134 | #define RR3_MAX_SIG_SIZE 512 |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 135 | #define RR3_TIME_UNIT 50 |
| 136 | #define RR3_END_OF_SIGNAL 0x7f |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 137 | #define RR3_TX_TRAILER_LEN 2 |
| 138 | #define RR3_RX_MIN_TIMEOUT 5 |
| 139 | #define RR3_RX_MAX_TIMEOUT 2000 |
| 140 | |
| 141 | /* The 8051's CPUCS Register address */ |
| 142 | #define RR3_CPUCS_REG_ADDR 0x7f92 |
| 143 | |
| 144 | #define USB_RR3USB_VENDOR_ID 0x112a |
| 145 | #define USB_RR3USB_PRODUCT_ID 0x0001 |
| 146 | #define USB_RR3IIUSB_PRODUCT_ID 0x0005 |
| 147 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 148 | struct redrat3_header { |
| 149 | __be16 length; |
| 150 | __be16 transfer_type; |
| 151 | } __packed; |
| 152 | |
| 153 | /* sending and receiving irdata */ |
| 154 | struct redrat3_irdata { |
| 155 | struct redrat3_header header; |
| 156 | __be32 pause; |
| 157 | __be16 mod_freq_count; |
| 158 | __be16 num_periods; |
| 159 | __u8 max_lengths; |
| 160 | __u8 no_lengths; |
| 161 | __be16 max_sig_size; |
| 162 | __be16 sig_size; |
| 163 | __u8 no_repeats; |
| 164 | __be16 lens[RR3_DRIVER_MAXLENS]; /* not aligned */ |
| 165 | __u8 sigdata[RR3_MAX_SIG_SIZE]; |
| 166 | } __packed; |
| 167 | |
| 168 | /* firmware errors */ |
| 169 | struct redrat3_error { |
| 170 | struct redrat3_header header; |
| 171 | __be16 fw_error; |
| 172 | } __packed; |
| 173 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 174 | /* table of devices that work with this driver */ |
| 175 | static struct usb_device_id redrat3_dev_table[] = { |
| 176 | /* Original version of the RedRat3 */ |
| 177 | {USB_DEVICE(USB_RR3USB_VENDOR_ID, USB_RR3USB_PRODUCT_ID)}, |
| 178 | /* Second Version/release of the RedRat3 - RetRat3-II */ |
| 179 | {USB_DEVICE(USB_RR3USB_VENDOR_ID, USB_RR3IIUSB_PRODUCT_ID)}, |
| 180 | {} /* Terminating entry */ |
| 181 | }; |
| 182 | |
| 183 | /* Structure to hold all of our device specific stuff */ |
| 184 | struct redrat3_dev { |
| 185 | /* core device bits */ |
| 186 | struct rc_dev *rc; |
| 187 | struct device *dev; |
| 188 | |
| 189 | /* save off the usb device pointer */ |
| 190 | struct usb_device *udev; |
| 191 | |
| 192 | /* the receive endpoint */ |
| 193 | struct usb_endpoint_descriptor *ep_in; |
| 194 | /* the buffer to receive data */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 195 | void *bulk_in_buf; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 196 | /* urb used to read ir data */ |
| 197 | struct urb *read_urb; |
| 198 | |
| 199 | /* the send endpoint */ |
| 200 | struct usb_endpoint_descriptor *ep_out; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 201 | |
| 202 | /* usb dma */ |
| 203 | dma_addr_t dma_in; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 204 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 205 | /* rx signal timeout timer */ |
| 206 | struct timer_list rx_timeout; |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 207 | u32 hw_timeout; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 208 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 209 | /* Is the device currently transmitting?*/ |
| 210 | bool transmitting; |
| 211 | |
| 212 | /* store for current packet */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 213 | struct redrat3_irdata irdata; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 214 | u16 bytes_read; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 215 | |
| 216 | u32 carrier; |
| 217 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 218 | char name[64]; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 219 | char phys[64]; |
| 220 | }; |
| 221 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 222 | /* |
| 223 | * redrat3_issue_async |
| 224 | * |
| 225 | * Issues an async read to the ir data in port.. |
| 226 | * sets the callback to be redrat3_handle_async |
| 227 | */ |
| 228 | static void redrat3_issue_async(struct redrat3_dev *rr3) |
| 229 | { |
| 230 | int res; |
| 231 | |
| 232 | rr3_ftr(rr3->dev, "Entering %s\n", __func__); |
| 233 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 234 | res = usb_submit_urb(rr3->read_urb, GFP_ATOMIC); |
| 235 | if (res) |
| 236 | rr3_dbg(rr3->dev, "%s: receive request FAILED! " |
| 237 | "(res %d, len %d)\n", __func__, res, |
| 238 | rr3->read_urb->transfer_buffer_length); |
| 239 | } |
| 240 | |
| 241 | static void redrat3_dump_fw_error(struct redrat3_dev *rr3, int code) |
| 242 | { |
| 243 | if (!rr3->transmitting && (code != 0x40)) |
| 244 | dev_info(rr3->dev, "fw error code 0x%02x: ", code); |
| 245 | |
| 246 | switch (code) { |
| 247 | case 0x00: |
| 248 | pr_cont("No Error\n"); |
| 249 | break; |
| 250 | |
| 251 | /* Codes 0x20 through 0x2f are IR Firmware Errors */ |
| 252 | case 0x20: |
| 253 | pr_cont("Initial signal pulse not long enough " |
| 254 | "to measure carrier frequency\n"); |
| 255 | break; |
| 256 | case 0x21: |
| 257 | pr_cont("Not enough length values allocated for signal\n"); |
| 258 | break; |
| 259 | case 0x22: |
| 260 | pr_cont("Not enough memory allocated for signal data\n"); |
| 261 | break; |
| 262 | case 0x23: |
| 263 | pr_cont("Too many signal repeats\n"); |
| 264 | break; |
| 265 | case 0x28: |
| 266 | pr_cont("Insufficient memory available for IR signal " |
| 267 | "data memory allocation\n"); |
| 268 | break; |
| 269 | case 0x29: |
| 270 | pr_cont("Insufficient memory available " |
| 271 | "for IrDa signal data memory allocation\n"); |
| 272 | break; |
| 273 | |
| 274 | /* Codes 0x30 through 0x3f are USB Firmware Errors */ |
| 275 | case 0x30: |
| 276 | pr_cont("Insufficient memory available for bulk " |
| 277 | "transfer structure\n"); |
| 278 | break; |
| 279 | |
| 280 | /* |
| 281 | * Other error codes... These are primarily errors that can occur in |
| 282 | * the control messages sent to the redrat |
| 283 | */ |
| 284 | case 0x40: |
| 285 | if (!rr3->transmitting) |
| 286 | pr_cont("Signal capture has been terminated\n"); |
| 287 | break; |
| 288 | case 0x41: |
| 289 | pr_cont("Attempt to set/get and unknown signal I/O " |
| 290 | "algorithm parameter\n"); |
| 291 | break; |
| 292 | case 0x42: |
| 293 | pr_cont("Signal capture already started\n"); |
| 294 | break; |
| 295 | |
| 296 | default: |
| 297 | pr_cont("Unknown Error\n"); |
| 298 | break; |
| 299 | } |
| 300 | } |
| 301 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 302 | static u32 redrat3_val_to_mod_freq(struct redrat3_irdata *irdata) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 303 | { |
| 304 | u32 mod_freq = 0; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 305 | u16 mod_freq_count = be16_to_cpu(irdata->mod_freq_count); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 306 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 307 | if (mod_freq_count != 0) |
| 308 | mod_freq = (RR3_CLK * be16_to_cpu(irdata->num_periods)) / |
| 309 | (mod_freq_count * RR3_CLK_PER_COUNT); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 310 | |
| 311 | return mod_freq; |
| 312 | } |
| 313 | |
| 314 | /* this function scales down the figures for the same result... */ |
| 315 | static u32 redrat3_len_to_us(u32 length) |
| 316 | { |
| 317 | u32 biglen = length * 1000; |
| 318 | u32 divisor = (RR3_CLK_CONV_FACTOR) / 1000; |
| 319 | u32 result = (u32) (biglen / divisor); |
| 320 | |
| 321 | /* don't allow zero lengths to go back, breaks lirc */ |
| 322 | return result ? result : 1; |
| 323 | } |
| 324 | |
| 325 | /* |
| 326 | * convert us back into redrat3 lengths |
| 327 | * |
| 328 | * length * 1000 length * 1000000 |
| 329 | * ------------- = ---------------- = micro |
| 330 | * rr3clk / 1000 rr3clk |
| 331 | |
| 332 | * 6 * 2 4 * 3 micro * rr3clk micro * rr3clk / 1000 |
| 333 | * ----- = 4 ----- = 6 -------------- = len --------------------- |
| 334 | * 3 2 1000000 1000 |
| 335 | */ |
| 336 | static u32 redrat3_us_to_len(u32 microsec) |
| 337 | { |
| 338 | u32 result; |
| 339 | u32 divisor; |
| 340 | |
| 341 | microsec &= IR_MAX_DURATION; |
| 342 | divisor = (RR3_CLK_CONV_FACTOR / 1000); |
| 343 | result = (u32)(microsec * divisor) / 1000; |
| 344 | |
| 345 | /* don't allow zero lengths to go back, breaks lirc */ |
| 346 | return result ? result : 1; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 347 | } |
| 348 | |
Jarod Wilson | 68b2a69 | 2011-07-13 18:26:05 -0300 | [diff] [blame] | 349 | /* timer callback to send reset event */ |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 350 | static void redrat3_rx_timeout(unsigned long data) |
| 351 | { |
| 352 | struct redrat3_dev *rr3 = (struct redrat3_dev *)data; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 353 | |
| 354 | rr3_dbg(rr3->dev, "calling ir_raw_event_reset\n"); |
| 355 | ir_raw_event_reset(rr3->rc); |
| 356 | } |
| 357 | |
| 358 | static void redrat3_process_ir_data(struct redrat3_dev *rr3) |
| 359 | { |
| 360 | DEFINE_IR_RAW_EVENT(rawir); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 361 | struct device *dev; |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 362 | unsigned i, trailer = 0; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 363 | unsigned sig_size, single_len, offset, val; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 364 | unsigned long delay; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 365 | u32 mod_freq; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 366 | |
| 367 | if (!rr3) { |
| 368 | pr_err("%s called with no context!\n", __func__); |
| 369 | return; |
| 370 | } |
| 371 | |
| 372 | rr3_ftr(rr3->dev, "Entered %s\n", __func__); |
| 373 | |
| 374 | dev = rr3->dev; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 375 | |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 376 | /* Make sure we reset the IR kfifo after a bit of inactivity */ |
| 377 | delay = usecs_to_jiffies(rr3->hw_timeout); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 378 | mod_timer(&rr3->rx_timeout, jiffies + delay); |
| 379 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 380 | mod_freq = redrat3_val_to_mod_freq(&rr3->irdata); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 381 | rr3_dbg(dev, "Got mod_freq of %u\n", mod_freq); |
| 382 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 383 | /* process each rr3 encoded byte into an int */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 384 | sig_size = be16_to_cpu(rr3->irdata.sig_size); |
| 385 | for (i = 0; i < sig_size; i++) { |
| 386 | offset = rr3->irdata.sigdata[i]; |
| 387 | val = get_unaligned_be16(&rr3->irdata.lens[offset]); |
| 388 | single_len = redrat3_len_to_us(val); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 389 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 390 | /* we should always get pulse/space/pulse/space samples */ |
| 391 | if (i % 2) |
| 392 | rawir.pulse = false; |
| 393 | else |
| 394 | rawir.pulse = true; |
| 395 | |
| 396 | rawir.duration = US_TO_NS(single_len); |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 397 | /* Save initial pulse length to fudge trailer */ |
| 398 | if (i == 0) |
| 399 | trailer = rawir.duration; |
Jarod Wilson | 2c594ff | 2011-07-13 18:26:06 -0300 | [diff] [blame] | 400 | /* cap the value to IR_MAX_DURATION */ |
| 401 | rawir.duration &= IR_MAX_DURATION; |
| 402 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 403 | rr3_dbg(dev, "storing %s with duration %d (i: %d)\n", |
| 404 | rawir.pulse ? "pulse" : "space", rawir.duration, i); |
| 405 | ir_raw_event_store_with_filter(rr3->rc, &rawir); |
| 406 | } |
| 407 | |
| 408 | /* add a trailing space, if need be */ |
| 409 | if (i % 2) { |
| 410 | rawir.pulse = false; |
| 411 | /* this duration is made up, and may not be ideal... */ |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 412 | if (trailer < US_TO_NS(1000)) |
| 413 | rawir.duration = US_TO_NS(2800); |
| 414 | else |
| 415 | rawir.duration = trailer; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 416 | rr3_dbg(dev, "storing trailing space with duration %d\n", |
| 417 | rawir.duration); |
| 418 | ir_raw_event_store_with_filter(rr3->rc, &rawir); |
| 419 | } |
| 420 | |
| 421 | rr3_dbg(dev, "calling ir_raw_event_handle\n"); |
| 422 | ir_raw_event_handle(rr3->rc); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 423 | } |
| 424 | |
| 425 | /* Util fn to send rr3 cmds */ |
| 426 | static u8 redrat3_send_cmd(int cmd, struct redrat3_dev *rr3) |
| 427 | { |
| 428 | struct usb_device *udev; |
| 429 | u8 *data; |
| 430 | int res; |
| 431 | |
| 432 | data = kzalloc(sizeof(u8), GFP_KERNEL); |
| 433 | if (!data) |
| 434 | return -ENOMEM; |
| 435 | |
| 436 | udev = rr3->udev; |
| 437 | res = usb_control_msg(udev, usb_rcvctrlpipe(udev, 0), cmd, |
| 438 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, |
| 439 | 0x0000, 0x0000, data, sizeof(u8), HZ * 10); |
| 440 | |
| 441 | if (res < 0) { |
| 442 | dev_err(rr3->dev, "%s: Error sending rr3 cmd res %d, data %d", |
| 443 | __func__, res, *data); |
| 444 | res = -EIO; |
| 445 | } else |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 446 | res = data[0]; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 447 | |
| 448 | kfree(data); |
| 449 | |
| 450 | return res; |
| 451 | } |
| 452 | |
| 453 | /* Enables the long range detector and starts async receive */ |
| 454 | static int redrat3_enable_detector(struct redrat3_dev *rr3) |
| 455 | { |
| 456 | struct device *dev = rr3->dev; |
| 457 | u8 ret; |
| 458 | |
| 459 | rr3_ftr(dev, "Entering %s\n", __func__); |
| 460 | |
| 461 | ret = redrat3_send_cmd(RR3_RC_DET_ENABLE, rr3); |
| 462 | if (ret != 0) |
| 463 | dev_dbg(dev, "%s: unexpected ret of %d\n", |
| 464 | __func__, ret); |
| 465 | |
| 466 | ret = redrat3_send_cmd(RR3_RC_DET_STATUS, rr3); |
| 467 | if (ret != 1) { |
| 468 | dev_err(dev, "%s: detector status: %d, should be 1\n", |
| 469 | __func__, ret); |
| 470 | return -EIO; |
| 471 | } |
| 472 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 473 | redrat3_issue_async(rr3); |
| 474 | |
| 475 | return 0; |
| 476 | } |
| 477 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 478 | static inline void redrat3_delete(struct redrat3_dev *rr3, |
| 479 | struct usb_device *udev) |
| 480 | { |
| 481 | rr3_ftr(rr3->dev, "%s cleaning up\n", __func__); |
| 482 | usb_kill_urb(rr3->read_urb); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 483 | |
| 484 | usb_free_urb(rr3->read_urb); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 485 | |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 486 | usb_free_coherent(udev, le16_to_cpu(rr3->ep_in->wMaxPacketSize), |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 487 | rr3->bulk_in_buf, rr3->dma_in); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 488 | |
| 489 | kfree(rr3); |
| 490 | } |
| 491 | |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 492 | static u32 redrat3_get_timeout(struct redrat3_dev *rr3) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 493 | { |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 494 | __be32 *tmp; |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 495 | u32 timeout = MS_TO_US(150); /* a sane default, if things go haywire */ |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 496 | int len, ret, pipe; |
| 497 | |
| 498 | len = sizeof(*tmp); |
| 499 | tmp = kzalloc(len, GFP_KERNEL); |
| 500 | if (!tmp) { |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 501 | dev_warn(rr3->dev, "Memory allocation faillure\n"); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 502 | return timeout; |
| 503 | } |
| 504 | |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 505 | pipe = usb_rcvctrlpipe(rr3->udev, 0); |
| 506 | ret = usb_control_msg(rr3->udev, pipe, RR3_GET_IR_PARAM, |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 507 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, |
| 508 | RR3_IR_IO_SIG_TIMEOUT, 0, tmp, len, HZ * 5); |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 509 | if (ret != len) |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 510 | dev_warn(rr3->dev, "Failed to read timeout from hardware\n"); |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 511 | else { |
| 512 | timeout = redrat3_len_to_us(be32_to_cpup(tmp)); |
| 513 | |
| 514 | rr3_dbg(rr3->dev, "Got timeout of %d ms\n", timeout / 1000); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 515 | } |
| 516 | |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 517 | kfree(tmp); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 518 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 519 | return timeout; |
| 520 | } |
| 521 | |
| 522 | static void redrat3_reset(struct redrat3_dev *rr3) |
| 523 | { |
| 524 | struct usb_device *udev = rr3->udev; |
| 525 | struct device *dev = rr3->dev; |
| 526 | int rc, rxpipe, txpipe; |
| 527 | u8 *val; |
| 528 | int len = sizeof(u8); |
| 529 | |
| 530 | rr3_ftr(dev, "Entering %s\n", __func__); |
| 531 | |
| 532 | rxpipe = usb_rcvctrlpipe(udev, 0); |
| 533 | txpipe = usb_sndctrlpipe(udev, 0); |
| 534 | |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 535 | val = kmalloc(len, GFP_KERNEL); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 536 | if (!val) { |
| 537 | dev_err(dev, "Memory allocation failure\n"); |
| 538 | return; |
| 539 | } |
| 540 | |
| 541 | *val = 0x01; |
| 542 | rc = usb_control_msg(udev, rxpipe, RR3_RESET, |
| 543 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, |
| 544 | RR3_CPUCS_REG_ADDR, 0, val, len, HZ * 25); |
| 545 | rr3_dbg(dev, "reset returned 0x%02x\n", rc); |
| 546 | |
| 547 | *val = 5; |
| 548 | rc = usb_control_msg(udev, txpipe, RR3_SET_IR_PARAM, |
| 549 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_OUT, |
| 550 | RR3_IR_IO_LENGTH_FUZZ, 0, val, len, HZ * 25); |
| 551 | rr3_dbg(dev, "set ir parm len fuzz %d rc 0x%02x\n", *val, rc); |
| 552 | |
| 553 | *val = RR3_DRIVER_MAXLENS; |
| 554 | rc = usb_control_msg(udev, txpipe, RR3_SET_IR_PARAM, |
| 555 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_OUT, |
| 556 | RR3_IR_IO_MAX_LENGTHS, 0, val, len, HZ * 25); |
| 557 | rr3_dbg(dev, "set ir parm max lens %d rc 0x%02x\n", *val, rc); |
| 558 | |
| 559 | kfree(val); |
| 560 | } |
| 561 | |
| 562 | static void redrat3_get_firmware_rev(struct redrat3_dev *rr3) |
| 563 | { |
| 564 | int rc = 0; |
| 565 | char *buffer; |
| 566 | |
| 567 | rr3_ftr(rr3->dev, "Entering %s\n", __func__); |
| 568 | |
| 569 | buffer = kzalloc(sizeof(char) * (RR3_FW_VERSION_LEN + 1), GFP_KERNEL); |
| 570 | if (!buffer) { |
| 571 | dev_err(rr3->dev, "Memory allocation failure\n"); |
| 572 | return; |
| 573 | } |
| 574 | |
| 575 | rc = usb_control_msg(rr3->udev, usb_rcvctrlpipe(rr3->udev, 0), |
| 576 | RR3_FW_VERSION, |
| 577 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, |
| 578 | 0, 0, buffer, RR3_FW_VERSION_LEN, HZ * 5); |
| 579 | |
| 580 | if (rc >= 0) |
| 581 | dev_info(rr3->dev, "Firmware rev: %s", buffer); |
| 582 | else |
| 583 | dev_err(rr3->dev, "Problem fetching firmware ID\n"); |
| 584 | |
| 585 | kfree(buffer); |
| 586 | rr3_ftr(rr3->dev, "Exiting %s\n", __func__); |
| 587 | } |
| 588 | |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 589 | static void redrat3_read_packet_start(struct redrat3_dev *rr3, unsigned len) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 590 | { |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 591 | struct redrat3_header *header = rr3->bulk_in_buf; |
| 592 | unsigned pktlen, pkttype; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 593 | |
| 594 | rr3_ftr(rr3->dev, "Entering %s\n", __func__); |
| 595 | |
| 596 | /* grab the Length and type of transfer */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 597 | pktlen = be16_to_cpu(header->length); |
| 598 | pkttype = be16_to_cpu(header->transfer_type); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 599 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 600 | if (pktlen > sizeof(rr3->irdata)) { |
| 601 | dev_warn(rr3->dev, "packet length %u too large\n", pktlen); |
| 602 | return; |
| 603 | } |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 604 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 605 | switch (pkttype) { |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 606 | case RR3_ERROR: |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 607 | if (len >= sizeof(struct redrat3_error)) { |
| 608 | struct redrat3_error *error = rr3->bulk_in_buf; |
| 609 | unsigned fw_error = be16_to_cpu(error->fw_error); |
| 610 | redrat3_dump_fw_error(rr3, fw_error); |
| 611 | } |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 612 | break; |
| 613 | |
| 614 | case RR3_MOD_SIGNAL_IN: |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 615 | memcpy(&rr3->irdata, rr3->bulk_in_buf, len); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 616 | rr3->bytes_read = len; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 617 | rr3_dbg(rr3->dev, "bytes_read %d, pktlen %d\n", |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 618 | rr3->bytes_read, pktlen); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 619 | break; |
| 620 | |
| 621 | default: |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 622 | rr3_dbg(rr3->dev, "ignoring packet with type 0x%02x, len of %d, 0x%02x\n", |
| 623 | pkttype, len, pktlen); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 624 | break; |
| 625 | } |
| 626 | } |
| 627 | |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 628 | static void redrat3_read_packet_continue(struct redrat3_dev *rr3, unsigned len) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 629 | { |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 630 | void *irdata = &rr3->irdata; |
| 631 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 632 | rr3_ftr(rr3->dev, "Entering %s\n", __func__); |
| 633 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 634 | if (len + rr3->bytes_read > sizeof(rr3->irdata)) { |
| 635 | dev_warn(rr3->dev, "too much data for packet\n"); |
| 636 | rr3->bytes_read = 0; |
| 637 | return; |
| 638 | } |
| 639 | |
| 640 | memcpy(irdata + rr3->bytes_read, rr3->bulk_in_buf, len); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 641 | |
| 642 | rr3->bytes_read += len; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 643 | rr3_dbg(rr3->dev, "bytes_read %d, pktlen %d\n", rr3->bytes_read, |
| 644 | be16_to_cpu(rr3->irdata.header.length)); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 645 | } |
| 646 | |
| 647 | /* gather IR data from incoming urb, process it when we have enough */ |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 648 | static int redrat3_get_ir_data(struct redrat3_dev *rr3, unsigned len) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 649 | { |
| 650 | struct device *dev = rr3->dev; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 651 | unsigned pkttype; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 652 | int ret = 0; |
| 653 | |
| 654 | rr3_ftr(dev, "Entering %s\n", __func__); |
| 655 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 656 | if (rr3->bytes_read == 0 && len >= sizeof(struct redrat3_header)) { |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 657 | redrat3_read_packet_start(rr3, len); |
| 658 | } else if (rr3->bytes_read != 0) { |
| 659 | redrat3_read_packet_continue(rr3, len); |
| 660 | } else if (rr3->bytes_read == 0) { |
| 661 | dev_err(dev, "error: no packet data read\n"); |
| 662 | ret = -ENODATA; |
| 663 | goto out; |
| 664 | } |
| 665 | |
Sean Young | 38e35a8 | 2013-07-30 19:00:00 -0300 | [diff] [blame^] | 666 | if (rr3->bytes_read < be16_to_cpu(rr3->irdata.header.length) + |
| 667 | sizeof(struct redrat3_header)) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 668 | /* we're still accumulating data */ |
| 669 | return 0; |
| 670 | |
| 671 | /* if we get here, we've got IR data to decode */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 672 | pkttype = be16_to_cpu(rr3->irdata.header.transfer_type); |
| 673 | if (pkttype == RR3_MOD_SIGNAL_IN) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 674 | redrat3_process_ir_data(rr3); |
| 675 | else |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 676 | rr3_dbg(dev, "discarding non-signal data packet (type 0x%02x)\n", |
| 677 | pkttype); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 678 | |
| 679 | out: |
| 680 | rr3->bytes_read = 0; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 681 | return ret; |
| 682 | } |
| 683 | |
| 684 | /* callback function from USB when async USB request has completed */ |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 685 | static void redrat3_handle_async(struct urb *urb) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 686 | { |
| 687 | struct redrat3_dev *rr3; |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 688 | int ret; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 689 | |
| 690 | if (!urb) |
| 691 | return; |
| 692 | |
| 693 | rr3 = urb->context; |
| 694 | if (!rr3) { |
| 695 | pr_err("%s called with invalid context!\n", __func__); |
| 696 | usb_unlink_urb(urb); |
| 697 | return; |
| 698 | } |
| 699 | |
| 700 | rr3_ftr(rr3->dev, "Entering %s\n", __func__); |
| 701 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 702 | switch (urb->status) { |
| 703 | case 0: |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 704 | ret = redrat3_get_ir_data(rr3, urb->actual_length); |
| 705 | if (!ret) { |
| 706 | /* no error, prepare to read more */ |
| 707 | redrat3_issue_async(rr3); |
| 708 | } |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 709 | break; |
| 710 | |
| 711 | case -ECONNRESET: |
| 712 | case -ENOENT: |
| 713 | case -ESHUTDOWN: |
| 714 | usb_unlink_urb(urb); |
| 715 | return; |
| 716 | |
| 717 | case -EPIPE: |
| 718 | default: |
| 719 | dev_warn(rr3->dev, "Error: urb status = %d\n", urb->status); |
| 720 | rr3->bytes_read = 0; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 721 | break; |
| 722 | } |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 723 | } |
| 724 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 725 | static u16 mod_freq_to_val(unsigned int mod_freq) |
| 726 | { |
| 727 | int mult = 6000000; |
| 728 | |
| 729 | /* Clk used in mod. freq. generation is CLK24/4. */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 730 | return 65536 - (mult / mod_freq); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 731 | } |
| 732 | |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 733 | static int redrat3_set_tx_carrier(struct rc_dev *rcdev, u32 carrier) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 734 | { |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 735 | struct redrat3_dev *rr3 = rcdev->priv; |
| 736 | struct device *dev = rr3->dev; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 737 | |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 738 | rr3_dbg(dev, "Setting modulation frequency to %u", carrier); |
Dan Carpenter | 48cafec | 2012-09-11 07:11:24 -0300 | [diff] [blame] | 739 | if (carrier == 0) |
| 740 | return -EINVAL; |
| 741 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 742 | rr3->carrier = carrier; |
| 743 | |
| 744 | return carrier; |
| 745 | } |
| 746 | |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 747 | static int redrat3_transmit_ir(struct rc_dev *rcdev, unsigned *txbuf, |
| 748 | unsigned count) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 749 | { |
| 750 | struct redrat3_dev *rr3 = rcdev->priv; |
| 751 | struct device *dev = rr3->dev; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 752 | struct redrat3_irdata *irdata = NULL; |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 753 | int ret, ret_len; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 754 | int lencheck, cur_sample_len, pipe; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 755 | int *sample_lens = NULL; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 756 | u8 curlencheck = 0; |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 757 | unsigned i, sendbuf_len; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 758 | |
| 759 | rr3_ftr(dev, "Entering %s\n", __func__); |
| 760 | |
| 761 | if (rr3->transmitting) { |
| 762 | dev_warn(dev, "%s: transmitter already in use\n", __func__); |
| 763 | return -EAGAIN; |
| 764 | } |
| 765 | |
Sean Young | 671ea67 | 2013-07-08 17:33:09 -0300 | [diff] [blame] | 766 | if (count > RR3_MAX_SIG_SIZE - RR3_TX_TRAILER_LEN) |
| 767 | return -EINVAL; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 768 | |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 769 | /* rr3 will disable rc detector on transmit */ |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 770 | rr3->transmitting = true; |
| 771 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 772 | sample_lens = kzalloc(sizeof(int) * RR3_DRIVER_MAXLENS, GFP_KERNEL); |
| 773 | if (!sample_lens) { |
| 774 | ret = -ENOMEM; |
| 775 | goto out; |
| 776 | } |
| 777 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 778 | irdata = kzalloc(sizeof(*irdata), GFP_KERNEL); |
| 779 | if (!irdata) { |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 780 | ret = -ENOMEM; |
| 781 | goto out; |
| 782 | } |
| 783 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 784 | for (i = 0; i < count; i++) { |
Sean Young | 06eae25 | 2013-01-29 08:19:31 -0300 | [diff] [blame] | 785 | cur_sample_len = redrat3_us_to_len(txbuf[i]); |
Sean Young | 801b69f | 2013-02-16 17:25:43 -0300 | [diff] [blame] | 786 | if (cur_sample_len > 0xffff) { |
| 787 | dev_warn(dev, "transmit period of %uus truncated to %uus\n", |
| 788 | txbuf[i], redrat3_len_to_us(0xffff)); |
| 789 | cur_sample_len = 0xffff; |
| 790 | } |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 791 | for (lencheck = 0; lencheck < curlencheck; lencheck++) { |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 792 | if (sample_lens[lencheck] == cur_sample_len) |
| 793 | break; |
| 794 | } |
| 795 | if (lencheck == curlencheck) { |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 796 | rr3_dbg(dev, "txbuf[%d]=%u, pos %d, enc %u\n", |
| 797 | i, txbuf[i], curlencheck, cur_sample_len); |
Sean Young | 06eae25 | 2013-01-29 08:19:31 -0300 | [diff] [blame] | 798 | if (curlencheck < RR3_DRIVER_MAXLENS) { |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 799 | /* now convert the value to a proper |
| 800 | * rr3 value.. */ |
| 801 | sample_lens[curlencheck] = cur_sample_len; |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 802 | put_unaligned_be16(cur_sample_len, |
| 803 | &irdata->lens[curlencheck]); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 804 | curlencheck++; |
| 805 | } else { |
Sean Young | 671ea67 | 2013-07-08 17:33:09 -0300 | [diff] [blame] | 806 | ret = -EINVAL; |
| 807 | goto out; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 808 | } |
| 809 | } |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 810 | irdata->sigdata[i] = lencheck; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 811 | } |
| 812 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 813 | irdata->sigdata[count] = RR3_END_OF_SIGNAL; |
| 814 | irdata->sigdata[count + 1] = RR3_END_OF_SIGNAL; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 815 | |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 816 | sendbuf_len = offsetof(struct redrat3_irdata, |
| 817 | sigdata[count + RR3_TX_TRAILER_LEN]); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 818 | /* fill in our packet header */ |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 819 | irdata->header.length = cpu_to_be16(sendbuf_len - |
| 820 | sizeof(struct redrat3_header)); |
| 821 | irdata->header.transfer_type = cpu_to_be16(RR3_MOD_SIGNAL_OUT); |
| 822 | irdata->pause = cpu_to_be32(redrat3_len_to_us(100)); |
| 823 | irdata->mod_freq_count = cpu_to_be16(mod_freq_to_val(rr3->carrier)); |
| 824 | irdata->no_lengths = curlencheck; |
| 825 | irdata->sig_size = cpu_to_be16(count + RR3_TX_TRAILER_LEN); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 826 | |
| 827 | pipe = usb_sndbulkpipe(rr3->udev, rr3->ep_out->bEndpointAddress); |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 828 | ret = usb_bulk_msg(rr3->udev, pipe, irdata, |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 829 | sendbuf_len, &ret_len, 10 * HZ); |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 830 | rr3_dbg(dev, "sent %d bytes, (ret %d)\n", ret_len, ret); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 831 | |
| 832 | /* now tell the hardware to transmit what we sent it */ |
| 833 | pipe = usb_rcvctrlpipe(rr3->udev, 0); |
| 834 | ret = usb_control_msg(rr3->udev, pipe, RR3_TX_SEND_SIGNAL, |
| 835 | USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 836 | 0, 0, irdata, 2, HZ * 10); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 837 | |
| 838 | if (ret < 0) |
| 839 | dev_err(dev, "Error: control msg send failed, rc %d\n", ret); |
| 840 | else |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 841 | ret = count; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 842 | |
| 843 | out: |
| 844 | kfree(sample_lens); |
Sean Young | 4c055a5 | 2013-02-16 17:25:44 -0300 | [diff] [blame] | 845 | kfree(irdata); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 846 | |
| 847 | rr3->transmitting = false; |
Andrew Vincer | dbea188 | 2011-11-08 12:43:45 -0300 | [diff] [blame] | 848 | /* rr3 re-enables rc detector because it was enabled before */ |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 849 | |
| 850 | return ret; |
| 851 | } |
| 852 | |
| 853 | static struct rc_dev *redrat3_init_rc_dev(struct redrat3_dev *rr3) |
| 854 | { |
| 855 | struct device *dev = rr3->dev; |
| 856 | struct rc_dev *rc; |
| 857 | int ret = -ENODEV; |
| 858 | u16 prod = le16_to_cpu(rr3->udev->descriptor.idProduct); |
| 859 | |
| 860 | rc = rc_allocate_device(); |
| 861 | if (!rc) { |
| 862 | dev_err(dev, "remote input dev allocation failed\n"); |
| 863 | goto out; |
| 864 | } |
| 865 | |
| 866 | snprintf(rr3->name, sizeof(rr3->name), "RedRat3%s " |
| 867 | "Infrared Remote Transceiver (%04x:%04x)", |
| 868 | prod == USB_RR3IIUSB_PRODUCT_ID ? "-II" : "", |
| 869 | le16_to_cpu(rr3->udev->descriptor.idVendor), prod); |
| 870 | |
| 871 | usb_make_path(rr3->udev, rr3->phys, sizeof(rr3->phys)); |
| 872 | |
| 873 | rc->input_name = rr3->name; |
| 874 | rc->input_phys = rr3->phys; |
| 875 | usb_to_input_id(rr3->udev, &rc->input_id); |
| 876 | rc->dev.parent = dev; |
| 877 | rc->priv = rr3; |
| 878 | rc->driver_type = RC_DRIVER_IR_RAW; |
David Härdeman | c003ab1 | 2012-10-11 19:11:54 -0300 | [diff] [blame] | 879 | rc->allowed_protos = RC_BIT_ALL; |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 880 | rc->timeout = US_TO_NS(2750); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 881 | rc->tx_ir = redrat3_transmit_ir; |
| 882 | rc->s_tx_carrier = redrat3_set_tx_carrier; |
| 883 | rc->driver_name = DRIVER_NAME; |
Sean Young | 06eae25 | 2013-01-29 08:19:31 -0300 | [diff] [blame] | 884 | rc->rx_resolution = US_TO_NS(2); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 885 | rc->map_name = RC_MAP_HAUPPAUGE; |
| 886 | |
| 887 | ret = rc_register_device(rc); |
| 888 | if (ret < 0) { |
| 889 | dev_err(dev, "remote dev registration failed\n"); |
| 890 | goto out; |
| 891 | } |
| 892 | |
| 893 | return rc; |
| 894 | |
| 895 | out: |
| 896 | rc_free_device(rc); |
| 897 | return NULL; |
| 898 | } |
| 899 | |
Greg Kroah-Hartman | 4c62e97 | 2012-12-21 13:17:53 -0800 | [diff] [blame] | 900 | static int redrat3_dev_probe(struct usb_interface *intf, |
| 901 | const struct usb_device_id *id) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 902 | { |
| 903 | struct usb_device *udev = interface_to_usbdev(intf); |
| 904 | struct device *dev = &intf->dev; |
| 905 | struct usb_host_interface *uhi; |
| 906 | struct redrat3_dev *rr3; |
| 907 | struct usb_endpoint_descriptor *ep; |
| 908 | struct usb_endpoint_descriptor *ep_in = NULL; |
| 909 | struct usb_endpoint_descriptor *ep_out = NULL; |
| 910 | u8 addr, attrs; |
| 911 | int pipe, i; |
| 912 | int retval = -ENOMEM; |
| 913 | |
| 914 | rr3_ftr(dev, "%s called\n", __func__); |
| 915 | |
| 916 | uhi = intf->cur_altsetting; |
| 917 | |
| 918 | /* find our bulk-in and bulk-out endpoints */ |
| 919 | for (i = 0; i < uhi->desc.bNumEndpoints; ++i) { |
| 920 | ep = &uhi->endpoint[i].desc; |
| 921 | addr = ep->bEndpointAddress; |
| 922 | attrs = ep->bmAttributes; |
| 923 | |
| 924 | if ((ep_in == NULL) && |
| 925 | ((addr & USB_ENDPOINT_DIR_MASK) == USB_DIR_IN) && |
| 926 | ((attrs & USB_ENDPOINT_XFERTYPE_MASK) == |
| 927 | USB_ENDPOINT_XFER_BULK)) { |
| 928 | rr3_dbg(dev, "found bulk-in endpoint at 0x%02x\n", |
| 929 | ep->bEndpointAddress); |
| 930 | /* data comes in on 0x82, 0x81 is for other data... */ |
| 931 | if (ep->bEndpointAddress == RR3_BULK_IN_EP_ADDR) |
| 932 | ep_in = ep; |
| 933 | } |
| 934 | |
| 935 | if ((ep_out == NULL) && |
| 936 | ((addr & USB_ENDPOINT_DIR_MASK) == USB_DIR_OUT) && |
| 937 | ((attrs & USB_ENDPOINT_XFERTYPE_MASK) == |
| 938 | USB_ENDPOINT_XFER_BULK)) { |
| 939 | rr3_dbg(dev, "found bulk-out endpoint at 0x%02x\n", |
| 940 | ep->bEndpointAddress); |
| 941 | ep_out = ep; |
| 942 | } |
| 943 | } |
| 944 | |
| 945 | if (!ep_in || !ep_out) { |
| 946 | dev_err(dev, "Couldn't find both in and out endpoints\n"); |
| 947 | retval = -ENODEV; |
| 948 | goto no_endpoints; |
| 949 | } |
| 950 | |
| 951 | /* allocate memory for our device state and initialize it */ |
| 952 | rr3 = kzalloc(sizeof(*rr3), GFP_KERNEL); |
| 953 | if (rr3 == NULL) { |
| 954 | dev_err(dev, "Memory allocation failure\n"); |
Dan Carpenter | 7eb7571 | 2011-05-26 05:55:08 -0300 | [diff] [blame] | 955 | goto no_endpoints; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 956 | } |
| 957 | |
| 958 | rr3->dev = &intf->dev; |
| 959 | |
| 960 | /* set up bulk-in endpoint */ |
| 961 | rr3->read_urb = usb_alloc_urb(0, GFP_KERNEL); |
| 962 | if (!rr3->read_urb) { |
| 963 | dev_err(dev, "Read urb allocation failure\n"); |
| 964 | goto error; |
| 965 | } |
| 966 | |
| 967 | rr3->ep_in = ep_in; |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 968 | rr3->bulk_in_buf = usb_alloc_coherent(udev, |
| 969 | le16_to_cpu(ep_in->wMaxPacketSize), GFP_ATOMIC, &rr3->dma_in); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 970 | if (!rr3->bulk_in_buf) { |
| 971 | dev_err(dev, "Read buffer allocation failure\n"); |
| 972 | goto error; |
| 973 | } |
| 974 | |
| 975 | pipe = usb_rcvbulkpipe(udev, ep_in->bEndpointAddress); |
Sean Young | fa7b9ac | 2013-02-16 17:25:45 -0300 | [diff] [blame] | 976 | usb_fill_bulk_urb(rr3->read_urb, udev, pipe, rr3->bulk_in_buf, |
| 977 | le16_to_cpu(ep_in->wMaxPacketSize), redrat3_handle_async, rr3); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 978 | |
| 979 | rr3->ep_out = ep_out; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 980 | rr3->udev = udev; |
| 981 | |
| 982 | redrat3_reset(rr3); |
| 983 | redrat3_get_firmware_rev(rr3); |
| 984 | |
| 985 | /* might be all we need to do? */ |
| 986 | retval = redrat3_enable_detector(rr3); |
| 987 | if (retval < 0) |
| 988 | goto error; |
| 989 | |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 990 | /* store current hardware timeout, in us, will use for kfifo resets */ |
| 991 | rr3->hw_timeout = redrat3_get_timeout(rr3); |
| 992 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 993 | /* default.. will get overridden by any sends with a freq defined */ |
| 994 | rr3->carrier = 38000; |
| 995 | |
| 996 | rr3->rc = redrat3_init_rc_dev(rr3); |
Peter Senna Tschudin | 6ea7cf7 | 2012-09-04 08:05:05 -0300 | [diff] [blame] | 997 | if (!rr3->rc) { |
| 998 | retval = -ENOMEM; |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 999 | goto error; |
Peter Senna Tschudin | 6ea7cf7 | 2012-09-04 08:05:05 -0300 | [diff] [blame] | 1000 | } |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1001 | setup_timer(&rr3->rx_timeout, redrat3_rx_timeout, (unsigned long)rr3); |
| 1002 | |
| 1003 | /* we can register the device now, as it is ready */ |
| 1004 | usb_set_intfdata(intf, rr3); |
| 1005 | |
| 1006 | rr3_ftr(dev, "Exiting %s\n", __func__); |
| 1007 | return 0; |
| 1008 | |
| 1009 | error: |
| 1010 | redrat3_delete(rr3, rr3->udev); |
| 1011 | |
| 1012 | no_endpoints: |
| 1013 | dev_err(dev, "%s: retval = %x", __func__, retval); |
| 1014 | |
| 1015 | return retval; |
| 1016 | } |
| 1017 | |
Greg Kroah-Hartman | 4c62e97 | 2012-12-21 13:17:53 -0800 | [diff] [blame] | 1018 | static void redrat3_dev_disconnect(struct usb_interface *intf) |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1019 | { |
| 1020 | struct usb_device *udev = interface_to_usbdev(intf); |
| 1021 | struct redrat3_dev *rr3 = usb_get_intfdata(intf); |
| 1022 | |
| 1023 | rr3_ftr(&intf->dev, "Entering %s\n", __func__); |
| 1024 | |
| 1025 | if (!rr3) |
| 1026 | return; |
| 1027 | |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1028 | usb_set_intfdata(intf, NULL); |
| 1029 | rc_unregister_device(rr3->rc); |
Jarod Wilson | c53f9f0 | 2011-07-13 18:26:07 -0300 | [diff] [blame] | 1030 | del_timer_sync(&rr3->rx_timeout); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1031 | redrat3_delete(rr3, udev); |
| 1032 | |
| 1033 | rr3_ftr(&intf->dev, "RedRat3 IR Transceiver now disconnected\n"); |
| 1034 | } |
| 1035 | |
| 1036 | static int redrat3_dev_suspend(struct usb_interface *intf, pm_message_t message) |
| 1037 | { |
| 1038 | struct redrat3_dev *rr3 = usb_get_intfdata(intf); |
| 1039 | rr3_ftr(rr3->dev, "suspend\n"); |
| 1040 | usb_kill_urb(rr3->read_urb); |
| 1041 | return 0; |
| 1042 | } |
| 1043 | |
| 1044 | static int redrat3_dev_resume(struct usb_interface *intf) |
| 1045 | { |
| 1046 | struct redrat3_dev *rr3 = usb_get_intfdata(intf); |
| 1047 | rr3_ftr(rr3->dev, "resume\n"); |
| 1048 | if (usb_submit_urb(rr3->read_urb, GFP_ATOMIC)) |
| 1049 | return -EIO; |
| 1050 | return 0; |
| 1051 | } |
| 1052 | |
| 1053 | static struct usb_driver redrat3_dev_driver = { |
| 1054 | .name = DRIVER_NAME, |
| 1055 | .probe = redrat3_dev_probe, |
Greg Kroah-Hartman | 4c62e97 | 2012-12-21 13:17:53 -0800 | [diff] [blame] | 1056 | .disconnect = redrat3_dev_disconnect, |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1057 | .suspend = redrat3_dev_suspend, |
| 1058 | .resume = redrat3_dev_resume, |
| 1059 | .reset_resume = redrat3_dev_resume, |
| 1060 | .id_table = redrat3_dev_table |
| 1061 | }; |
| 1062 | |
Greg Kroah-Hartman | ecb3b2b | 2011-11-18 09:46:12 -0800 | [diff] [blame] | 1063 | module_usb_driver(redrat3_dev_driver); |
Jarod Wilson | 2154be6 | 2011-05-04 14:02:42 -0300 | [diff] [blame] | 1064 | |
| 1065 | MODULE_DESCRIPTION(DRIVER_DESC); |
| 1066 | MODULE_AUTHOR(DRIVER_AUTHOR); |
| 1067 | MODULE_AUTHOR(DRIVER_AUTHOR2); |
| 1068 | MODULE_LICENSE("GPL"); |
| 1069 | MODULE_DEVICE_TABLE(usb, redrat3_dev_table); |
| 1070 | |
| 1071 | module_param(debug, int, S_IRUGO | S_IWUSR); |
| 1072 | MODULE_PARM_DESC(debug, "Enable module debug spew. 0 = no debugging (default) " |
| 1073 | "0x1 = standard debug messages, 0x2 = function tracing debug. " |
| 1074 | "Flag bits are addative (i.e., 0x3 for both debug types)."); |