xref: /openbmc/qemu/include/hw/input/adb.h (revision f101c9fe)
1 /*
2  * QEMU ADB emulation shared definitions and prototypes
3  *
4  * Copyright (c) 2004-2007 Fabrice Bellard
5  * Copyright (c) 2007 Jocelyn Mayer
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a copy
8  * of this software and associated documentation files (the "Software"), to deal
9  * in the Software without restriction, including without limitation the rights
10  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11  * copies of the Software, and to permit persons to whom the Software is
12  * furnished to do so, subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice shall be included in
15  * all copies or substantial portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
22  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
23  * THE SOFTWARE.
24  */
25 
26 #ifndef ADB_H
27 #define ADB_H
28 
29 #include "hw/qdev-core.h"
30 #include "qom/object.h"
31 
32 #define MAX_ADB_DEVICES 16
33 
34 #define ADB_MAX_OUT_LEN 16
35 
36 typedef struct ADBDevice ADBDevice;
37 
38 /* buf = NULL means polling */
39 typedef int ADBDeviceRequest(ADBDevice *d, uint8_t *buf_out,
40                               const uint8_t *buf, int len);
41 
42 typedef bool ADBDeviceHasData(ADBDevice *d);
43 
44 #define TYPE_ADB_DEVICE "adb-device"
45 OBJECT_DECLARE_TYPE(ADBDevice, ADBDeviceClass, ADB_DEVICE)
46 
47 struct ADBDevice {
48     /*< private >*/
49     DeviceState parent_obj;
50     /*< public >*/
51 
52     int devaddr;
53     int handler;
54 };
55 
56 
57 struct ADBDeviceClass {
58     /*< private >*/
59     DeviceClass parent_class;
60     /*< public >*/
61 
62     ADBDeviceRequest *devreq;
63     ADBDeviceHasData *devhasdata;
64 };
65 
66 #define TYPE_ADB_BUS "apple-desktop-bus"
67 OBJECT_DECLARE_SIMPLE_TYPE(ADBBusState, ADB_BUS)
68 
69 #define ADB_STATUS_BUSTIMEOUT  0x1
70 #define ADB_STATUS_POLLREPLY   0x2
71 
72 struct ADBBusState {
73     /*< private >*/
74     BusState parent_obj;
75     /*< public >*/
76 
77     ADBDevice *devices[MAX_ADB_DEVICES];
78     uint16_t pending;
79     int nb_devices;
80     int poll_index;
81     uint8_t status;
82 
83     QEMUTimer *autopoll_timer;
84     bool autopoll_enabled;
85     bool autopoll_blocked;
86     uint8_t autopoll_rate_ms;
87     uint16_t autopoll_mask;
88     void (*autopoll_cb)(void *opaque);
89     void *autopoll_cb_opaque;
90 };
91 
92 int adb_request(ADBBusState *s, uint8_t *buf_out,
93                 const uint8_t *buf, int len);
94 int adb_poll(ADBBusState *s, uint8_t *buf_out, uint16_t poll_mask);
95 
96 void adb_autopoll_block(ADBBusState *s);
97 void adb_autopoll_unblock(ADBBusState *s);
98 
99 void adb_set_autopoll_enabled(ADBBusState *s, bool enabled);
100 void adb_set_autopoll_rate_ms(ADBBusState *s, int rate_ms);
101 void adb_set_autopoll_mask(ADBBusState *s, uint16_t mask);
102 void adb_register_autopoll_callback(ADBBusState *s, void (*cb)(void *opaque),
103                                     void *opaque);
104 
105 #define TYPE_ADB_KEYBOARD "adb-keyboard"
106 #define TYPE_ADB_MOUSE "adb-mouse"
107 
108 #endif /* ADB_H */
109