V4L/DVB: ir-core: Add support for RC map code register
[safe/jmp/linux-2.6] / include / media / ir-core.h
1 /*
2  * Remote Controller core header
3  *
4  * Copyright (C) 2009-2010 by Mauro Carvalho Chehab <mchehab@redhat.com>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation version 2 of the License.
9  *
10  *  This program is distributed in the hope that it will be useful,
11  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
12  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  *  GNU General Public License for more details.
14  */
15
16 #ifndef _IR_CORE
17 #define _IR_CORE
18
19 #include <linux/input.h>
20 #include <linux/spinlock.h>
21 #include <linux/kfifo.h>
22 #include <linux/time.h>
23 #include <linux/timer.h>
24
25 extern int ir_core_debug;
26 #define IR_dprintk(level, fmt, arg...)  if (ir_core_debug >= level) \
27         printk(KERN_DEBUG "%s: " fmt , __func__, ## arg)
28
29 #define IR_TYPE_UNKNOWN 0
30 #define IR_TYPE_RC5     (1  << 0)       /* Philips RC5 protocol */
31 #define IR_TYPE_PD      (1  << 1)       /* Pulse distance encoded IR */
32 #define IR_TYPE_NEC     (1  << 2)
33 #define IR_TYPE_OTHER   (((u64)1) << 63l)
34
35 enum raw_event_type {
36         IR_SPACE        = (1 << 0),
37         IR_PULSE        = (1 << 1),
38         IR_START_EVENT  = (1 << 2),
39         IR_STOP_EVENT   = (1 << 3),
40 };
41
42 struct ir_scancode {
43         u16     scancode;
44         u32     keycode;
45 };
46
47 struct ir_scancode_table {
48         struct ir_scancode      *scan;
49         int                     size;
50         u64                     ir_type;
51         char                    *name;
52         spinlock_t              lock;
53 };
54
55 struct rc_keymap {
56         struct list_head         list;
57         struct ir_scancode_table map;
58 };
59
60 struct ir_dev_props {
61         unsigned long allowed_protos;
62         void            *priv;
63         int (*change_protocol)(void *priv, u64 ir_type);
64         int (*open)(void *priv);
65         void (*close)(void *priv);
66 };
67
68 struct ir_raw_event {
69         struct timespec         delta;  /* Time spent before event */
70         enum raw_event_type     type;   /* event type */
71 };
72
73 struct ir_raw_event_ctrl {
74         struct kfifo                    kfifo;          /* fifo for the pulse/space events */
75         struct timespec                 last_event;     /* when last event occurred */
76         struct timer_list               timer_keyup;    /* timer for key release */
77 };
78
79 struct ir_input_dev {
80         struct device                   dev;            /* device */
81         char                            *driver_name;   /* Name of the driver module */
82         struct ir_scancode_table        rc_tab;         /* scan/key table */
83         unsigned long                   devno;          /* device number */
84         const struct ir_dev_props       *props;         /* Device properties */
85         struct ir_raw_event_ctrl        *raw;           /* for raw pulse/space events */
86
87         /* key info - needed by IR keycode handlers */
88         u32                             keycode;        /* linux key code */
89         int                             keypressed;     /* current state */
90 };
91
92 struct ir_raw_handler {
93         struct list_head list;
94
95         int (*decode)(struct input_dev *input_dev,
96                       struct ir_raw_event *evs,
97                       int len);
98         int (*raw_register)(struct input_dev *input_dev);
99         int (*raw_unregister)(struct input_dev *input_dev);
100 };
101
102 #define to_ir_input_dev(_attr) container_of(_attr, struct ir_input_dev, attr)
103
104 #define IR_KEYTABLE(a)                                  \
105 ir_codes_ ## a ## _table
106
107 #define DECLARE_IR_KEYTABLE(a)                                  \
108 extern struct ir_scancode_table IR_KEYTABLE(a)
109
110 #define DEFINE_IR_KEYTABLE(tabname, type)                       \
111 struct ir_scancode_table IR_KEYTABLE(tabname) = {               \
112         .scan = tabname,                                        \
113         .size = ARRAY_SIZE(tabname),                            \
114         .ir_type = type,                                        \
115         .name = #tabname,                                       \
116 };                                                              \
117 EXPORT_SYMBOL_GPL(IR_KEYTABLE(tabname))
118
119 #define DEFINE_LEGACY_IR_KEYTABLE(tabname)                      \
120         DEFINE_IR_KEYTABLE(tabname, IR_TYPE_UNKNOWN)
121
122 /* Routines from ir-keytable.c */
123
124 u32 ir_g_keycode_from_table(struct input_dev *input_dev,
125                             u32 scancode);
126 void ir_keyup(struct input_dev *dev);
127 void ir_keydown(struct input_dev *dev, int scancode);
128 int ir_input_register(struct input_dev *dev,
129                       const struct ir_scancode_table *ir_codes,
130                       const struct ir_dev_props *props,
131                       const char *driver_name);
132 void ir_input_unregister(struct input_dev *input_dev);
133
134 /* Routines from rc-map.c */
135
136 int ir_register_map(struct rc_keymap *map);
137 void ir_unregister_map(struct rc_keymap *map);
138 struct ir_scancode_table *get_rc_map(const char *name);
139
140 /* Routines from ir-sysfs.c */
141
142 int ir_register_class(struct input_dev *input_dev);
143 void ir_unregister_class(struct input_dev *input_dev);
144
145 /* Routines from ir-raw-event.c */
146 int ir_raw_event_register(struct input_dev *input_dev);
147 void ir_raw_event_unregister(struct input_dev *input_dev);
148 int ir_raw_event_store(struct input_dev *input_dev, enum raw_event_type type);
149 int ir_raw_event_handle(struct input_dev *input_dev);
150 int ir_raw_handler_register(struct ir_raw_handler *ir_raw_handler);
151 void ir_raw_handler_unregister(struct ir_raw_handler *ir_raw_handler);
152 void ir_raw_init(void);
153
154 /* from ir-nec-decoder.c */
155 #ifdef CONFIG_IR_NEC_DECODER_MODULE
156 #define load_nec_decode()       request_module("ir-nec-decoder")
157 #else
158 #define load_nec_decode()       0
159 #endif
160
161 #endif /* _IR_CORE */