1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Header file for the compaq Micro MFD 4 */ 5 6 #ifndef _MFD_IPAQ_MICRO_H_ 7 #define _MFD_IPAQ_MICRO_H_ 8 9 #include <linux/spinlock.h> 10 #include <linux/completion.h> 11 #include <linux/list.h> 12 13 #define TX_BUF_SIZE 32 14 #define RX_BUF_SIZE 16 15 #define CHAR_SOF 0x02 16 17 /* 18 * These are the different messages that can be sent to the microcontroller 19 * to control various aspects. 20 */ 21 #define MSG_VERSION 0x0 22 #define MSG_KEYBOARD 0x2 23 #define MSG_TOUCHSCREEN 0x3 24 #define MSG_EEPROM_READ 0x4 25 #define MSG_EEPROM_WRITE 0x5 26 #define MSG_THERMAL_SENSOR 0x6 27 #define MSG_NOTIFY_LED 0x8 28 #define MSG_BATTERY 0x9 29 #define MSG_SPI_READ 0xb 30 #define MSG_SPI_WRITE 0xc 31 #define MSG_BACKLIGHT 0xd /* H3600 only */ 32 #define MSG_CODEC_CTRL 0xe /* H3100 only */ 33 #define MSG_DISPLAY_CTRL 0xf /* H3100 only */ 34 35 /* state of receiver parser */ 36 enum rx_state { 37 STATE_SOF = 0, /* Next byte should be start of frame */ 38 STATE_ID, /* Next byte is ID & message length */ 39 STATE_DATA, /* Next byte is a data byte */ 40 STATE_CHKSUM /* Next byte should be checksum */ 41 }; 42 43 /** 44 * struct ipaq_micro_txdev - TX state 45 * @len: length of message in TX buffer 46 * @index: current index into TX buffer 47 * @buf: TX buffer 48 */ 49 struct ipaq_micro_txdev { 50 u8 len; 51 u8 index; 52 u8 buf[TX_BUF_SIZE]; 53 }; 54 55 /** 56 * struct ipaq_micro_rxdev - RX state 57 * @state: context of RX state machine 58 * @chksum: calculated checksum 59 * @id: message ID from packet 60 * @len: RX buffer length 61 * @index: RX buffer index 62 * @buf: RX buffer 63 */ 64 struct ipaq_micro_rxdev { 65 enum rx_state state; 66 unsigned char chksum; 67 u8 id; 68 unsigned int len; 69 unsigned int index; 70 u8 buf[RX_BUF_SIZE]; 71 }; 72 73 /** 74 * struct ipaq_micro_msg - message to the iPAQ microcontroller 75 * @id: 4-bit ID of the message 76 * @tx_len: length of TX data 77 * @tx_data: TX data to send 78 * @rx_len: length of received RX data 79 * @rx_data: RX data to receive 80 * @ack: a completion that will be completed when RX is complete 81 * @node: list node if message gets queued 82 */ 83 struct ipaq_micro_msg { 84 u8 id; 85 u8 tx_len; 86 u8 tx_data[TX_BUF_SIZE]; 87 u8 rx_len; 88 u8 rx_data[RX_BUF_SIZE]; 89 struct completion ack; 90 struct list_head node; 91 }; 92 93 /** 94 * struct ipaq_micro - iPAQ microcontroller state 95 * @dev: corresponding platform device 96 * @base: virtual memory base for underlying serial device 97 * @sdlc: virtual memory base for Synchronous Data Link Controller 98 * @version: version string 99 * @tx: TX state 100 * @rx: RX state 101 * @lock: lock for this state container 102 * @msg: current message 103 * @queue: message queue 104 * @key: callback for asynchronous key events 105 * @key_data: data to pass along with key events 106 * @ts: callback for asynchronous touchscreen events 107 * @ts_data: data to pass along with key events 108 */ 109 struct ipaq_micro { 110 struct device *dev; 111 void __iomem *base; 112 void __iomem *sdlc; 113 char version[5]; 114 struct ipaq_micro_txdev tx; /* transmit ISR state */ 115 struct ipaq_micro_rxdev rx; /* receive ISR state */ 116 spinlock_t lock; 117 struct ipaq_micro_msg *msg; 118 struct list_head queue; 119 void (*key) (void *data, int len, unsigned char *rxdata); 120 void *key_data; 121 void (*ts) (void *data, int len, unsigned char *rxdata); 122 void *ts_data; 123 }; 124 125 extern int 126 ipaq_micro_tx_msg(struct ipaq_micro *micro, struct ipaq_micro_msg *msg); 127 128 static inline int 129 ipaq_micro_tx_msg_sync(struct ipaq_micro *micro, 130 struct ipaq_micro_msg *msg) 131 { 132 int ret; 133 134 init_completion(&msg->ack); 135 ret = ipaq_micro_tx_msg(micro, msg); 136 wait_for_completion(&msg->ack); 137 138 return ret; 139 } 140 141 static inline int 142 ipaq_micro_tx_msg_async(struct ipaq_micro *micro, 143 struct ipaq_micro_msg *msg) 144 { 145 init_completion(&msg->ack); 146 return ipaq_micro_tx_msg(micro, msg); 147 } 148 149 #endif /* _MFD_IPAQ_MICRO_H_ */ 150