hc
2024-01-05 071106ecf68c401173c58808b1cf5f68cc50d390
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * cec-pin-priv.h - internal cec-pin header
 *
 * Copyright 2017 Cisco Systems, Inc. and/or its affiliates. All rights reserved.
 */
 
#ifndef LINUX_CEC_PIN_PRIV_H
#define LINUX_CEC_PIN_PRIV_H
 
#include <linux/types.h>
#include <linux/atomic.h>
#include <media/cec-pin.h>
 
enum cec_pin_state {
   /* CEC is off */
   CEC_ST_OFF,
   /* CEC is idle, waiting for Rx or Tx */
   CEC_ST_IDLE,
 
   /* Tx states */
 
   /* Pending Tx, waiting for Signal Free Time to expire */
   CEC_ST_TX_WAIT,
   /* Low-drive was detected, wait for bus to go high */
   CEC_ST_TX_WAIT_FOR_HIGH,
   /* Drive CEC low for the start bit */
   CEC_ST_TX_START_BIT_LOW,
   /* Drive CEC high for the start bit */
   CEC_ST_TX_START_BIT_HIGH,
   /* Generate a start bit period that is too short */
   CEC_ST_TX_START_BIT_HIGH_SHORT,
   /* Generate a start bit period that is too long */
   CEC_ST_TX_START_BIT_HIGH_LONG,
   /* Drive CEC low for the start bit using the custom timing */
   CEC_ST_TX_START_BIT_LOW_CUSTOM,
   /* Drive CEC high for the start bit using the custom timing */
   CEC_ST_TX_START_BIT_HIGH_CUSTOM,
   /* Drive CEC low for the 0 bit */
   CEC_ST_TX_DATA_BIT_0_LOW,
   /* Drive CEC high for the 0 bit */
   CEC_ST_TX_DATA_BIT_0_HIGH,
   /* Generate a bit period that is too short */
   CEC_ST_TX_DATA_BIT_0_HIGH_SHORT,
   /* Generate a bit period that is too long */
   CEC_ST_TX_DATA_BIT_0_HIGH_LONG,
   /* Drive CEC low for the 1 bit */
   CEC_ST_TX_DATA_BIT_1_LOW,
   /* Drive CEC high for the 1 bit */
   CEC_ST_TX_DATA_BIT_1_HIGH,
   /* Generate a bit period that is too short */
   CEC_ST_TX_DATA_BIT_1_HIGH_SHORT,
   /* Generate a bit period that is too long */
   CEC_ST_TX_DATA_BIT_1_HIGH_LONG,
   /*
    * Wait for start of sample time to check for Ack bit or first
    * four initiator bits to check for Arbitration Lost.
    */
   CEC_ST_TX_DATA_BIT_1_HIGH_PRE_SAMPLE,
   /* Wait for end of bit period after sampling */
   CEC_ST_TX_DATA_BIT_1_HIGH_POST_SAMPLE,
   /* Generate a bit period that is too short */
   CEC_ST_TX_DATA_BIT_1_HIGH_POST_SAMPLE_SHORT,
   /* Generate a bit period that is too long */
   CEC_ST_TX_DATA_BIT_1_HIGH_POST_SAMPLE_LONG,
   /* Drive CEC low for a data bit using the custom timing */
   CEC_ST_TX_DATA_BIT_LOW_CUSTOM,
   /* Drive CEC high for a data bit using the custom timing */
   CEC_ST_TX_DATA_BIT_HIGH_CUSTOM,
   /* Drive CEC low for a standalone pulse using the custom timing */
   CEC_ST_TX_PULSE_LOW_CUSTOM,
   /* Drive CEC high for a standalone pulse using the custom timing */
   CEC_ST_TX_PULSE_HIGH_CUSTOM,
   /* Start low drive */
   CEC_ST_TX_LOW_DRIVE,
 
   /* Rx states */
 
   /* Start bit low detected */
   CEC_ST_RX_START_BIT_LOW,
   /* Start bit high detected */
   CEC_ST_RX_START_BIT_HIGH,
   /* Wait for bit sample time */
   CEC_ST_RX_DATA_SAMPLE,
   /* Wait for earliest end of bit period after sampling */
   CEC_ST_RX_DATA_POST_SAMPLE,
   /* Wait for CEC to go low (i.e. end of bit period) */
   CEC_ST_RX_DATA_WAIT_FOR_LOW,
   /* Drive CEC low to send 0 Ack bit */
   CEC_ST_RX_ACK_LOW,
   /* End of 0 Ack time, wait for earliest end of bit period */
   CEC_ST_RX_ACK_LOW_POST,
   /* Wait for CEC to go high (i.e. end of bit period */
   CEC_ST_RX_ACK_HIGH_POST,
   /* Wait for earliest end of bit period and end of message */
   CEC_ST_RX_ACK_FINISH,
   /* Start low drive */
   CEC_ST_RX_LOW_DRIVE,
 
   /* Monitor pin using interrupts */
   CEC_ST_RX_IRQ,
 
   /* Total number of pin states */
   CEC_PIN_STATES
};
 
/* Error Injection */
 
/* Error injection modes */
#define CEC_ERROR_INJ_MODE_OFF                0
#define CEC_ERROR_INJ_MODE_ONCE                1
#define CEC_ERROR_INJ_MODE_ALWAYS            2
#define CEC_ERROR_INJ_MODE_TOGGLE            3
#define CEC_ERROR_INJ_MODE_MASK                3ULL
 
/* Receive error injection options */
#define CEC_ERROR_INJ_RX_NACK_OFFSET            0
#define CEC_ERROR_INJ_RX_LOW_DRIVE_OFFSET        2
#define CEC_ERROR_INJ_RX_ADD_BYTE_OFFSET        4
#define CEC_ERROR_INJ_RX_REMOVE_BYTE_OFFSET        6
#define CEC_ERROR_INJ_RX_ARB_LOST_OFFSET        8
#define CEC_ERROR_INJ_RX_MASK                0xffffULL
 
/* Transmit error injection options */
#define CEC_ERROR_INJ_TX_NO_EOM_OFFSET            16
#define CEC_ERROR_INJ_TX_EARLY_EOM_OFFSET        18
#define CEC_ERROR_INJ_TX_SHORT_BIT_OFFSET        20
#define CEC_ERROR_INJ_TX_LONG_BIT_OFFSET        22
#define CEC_ERROR_INJ_TX_CUSTOM_BIT_OFFSET        24
#define CEC_ERROR_INJ_TX_SHORT_START_OFFSET        26
#define CEC_ERROR_INJ_TX_LONG_START_OFFSET        28
#define CEC_ERROR_INJ_TX_CUSTOM_START_OFFSET        30
#define CEC_ERROR_INJ_TX_LAST_BIT_OFFSET        32
#define CEC_ERROR_INJ_TX_ADD_BYTES_OFFSET        34
#define CEC_ERROR_INJ_TX_REMOVE_BYTE_OFFSET        36
#define CEC_ERROR_INJ_TX_LOW_DRIVE_OFFSET        38
#define CEC_ERROR_INJ_TX_MASK                0xffffffffffff0000ULL
 
#define CEC_ERROR_INJ_RX_LOW_DRIVE_ARG_IDX        0
#define CEC_ERROR_INJ_RX_ARB_LOST_ARG_IDX        1
 
#define CEC_ERROR_INJ_TX_ADD_BYTES_ARG_IDX        2
#define CEC_ERROR_INJ_TX_SHORT_BIT_ARG_IDX        3
#define CEC_ERROR_INJ_TX_LONG_BIT_ARG_IDX        4
#define CEC_ERROR_INJ_TX_CUSTOM_BIT_ARG_IDX        5
#define CEC_ERROR_INJ_TX_LAST_BIT_ARG_IDX        6
#define CEC_ERROR_INJ_TX_LOW_DRIVE_ARG_IDX        7
#define CEC_ERROR_INJ_NUM_ARGS                8
 
/* Special CEC op values */
#define CEC_ERROR_INJ_OP_ANY                0x00000100
 
/* The default for the low/high time of the custom pulse */
#define CEC_TIM_CUSTOM_DEFAULT                1000
 
#define CEC_NUM_PIN_EVENTS                128
#define CEC_PIN_EVENT_FL_IS_HIGH            (1 << 0)
#define CEC_PIN_EVENT_FL_DROPPED            (1 << 1)
 
#define CEC_PIN_IRQ_UNCHANGED    0
#define CEC_PIN_IRQ_DISABLE    1
#define CEC_PIN_IRQ_ENABLE    2
 
struct cec_pin {
   struct cec_adapter        *adap;
   const struct cec_pin_ops    *ops;
   struct task_struct        *kthread;
   wait_queue_head_t        kthread_waitq;
   struct hrtimer            timer;
   ktime_t                ts;
   unsigned int            wait_usecs;
   u16                la_mask;
   bool                enabled;
   bool                monitor_all;
   bool                rx_eom;
   bool                enable_irq_failed;
   enum cec_pin_state        state;
   struct cec_msg            tx_msg;
   u32                tx_bit;
   bool                tx_nacked;
   u32                tx_signal_free_time;
   bool                tx_toggle;
   struct cec_msg            rx_msg;
   u32                rx_bit;
   bool                rx_toggle;
   u32                rx_start_bit_low_too_short_cnt;
   u64                rx_start_bit_low_too_short_ts;
   u32                rx_start_bit_low_too_short_delta;
   u32                rx_start_bit_too_short_cnt;
   u64                rx_start_bit_too_short_ts;
   u32                rx_start_bit_too_short_delta;
   u32                rx_start_bit_too_long_cnt;
   u32                rx_data_bit_too_short_cnt;
   u64                rx_data_bit_too_short_ts;
   u32                rx_data_bit_too_short_delta;
   u32                rx_data_bit_too_long_cnt;
   u32                rx_low_drive_cnt;
 
   struct cec_msg            work_rx_msg;
   u8                work_tx_status;
   ktime_t                work_tx_ts;
   atomic_t            work_irq_change;
   atomic_t            work_pin_num_events;
   unsigned int            work_pin_events_wr;
   unsigned int            work_pin_events_rd;
   ktime_t                work_pin_ts[CEC_NUM_PIN_EVENTS];
   u8                work_pin_events[CEC_NUM_PIN_EVENTS];
   bool                work_pin_events_dropped;
   u32                work_pin_events_dropped_cnt;
   ktime_t                timer_ts;
   u32                timer_cnt;
   u32                timer_100ms_overruns;
   u32                timer_300ms_overruns;
   u32                timer_max_overrun;
   u32                timer_sum_overrun;
 
   u32                tx_custom_low_usecs;
   u32                tx_custom_high_usecs;
   bool                tx_ignore_nack_until_eom;
   bool                tx_custom_pulse;
   bool                tx_generated_poll;
   bool                tx_post_eom;
   u8                tx_extra_bytes;
   u32                tx_low_drive_cnt;
#ifdef CONFIG_CEC_PIN_ERROR_INJ
   u64                error_inj[CEC_ERROR_INJ_OP_ANY + 1];
   u8                error_inj_args[CEC_ERROR_INJ_OP_ANY + 1][CEC_ERROR_INJ_NUM_ARGS];
#endif
};
 
void cec_pin_start_timer(struct cec_pin *pin);
 
#ifdef CONFIG_CEC_PIN_ERROR_INJ
bool cec_pin_error_inj_parse_line(struct cec_adapter *adap, char *line);
int cec_pin_error_inj_show(struct cec_adapter *adap, struct seq_file *sf);
 
u16 cec_pin_rx_error_inj(struct cec_pin *pin);
u16 cec_pin_tx_error_inj(struct cec_pin *pin);
#endif
 
#endif