71bad7f0 |
1 | /** |
2 | * Copyright (c) 2014 Raspberry Pi (Trading) Ltd. All rights reserved. |
3 | * Copyright (c) 2010-2012 Broadcom. All rights reserved. |
4 | * |
5 | * Redistribution and use in source and binary forms, with or without |
6 | * modification, are permitted provided that the following conditions |
7 | * are met: |
8 | * 1. Redistributions of source code must retain the above copyright |
9 | * notice, this list of conditions, and the following disclaimer, |
10 | * without modification. |
11 | * 2. Redistributions in binary form must reproduce the above copyright |
12 | * notice, this list of conditions and the following disclaimer in the |
13 | * documentation and/or other materials provided with the distribution. |
14 | * 3. The names of the above-listed copyright holders may not be used |
15 | * to endorse or promote products derived from this software without |
16 | * specific prior written permission. |
17 | * |
18 | * ALTERNATIVELY, this software may be distributed under the terms of the |
19 | * GNU General Public License ("GPL") version 2, as published by the Free |
20 | * Software Foundation. |
21 | * |
22 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS |
23 | * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, |
24 | * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
25 | * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR |
26 | * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
27 | * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
28 | * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
29 | * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF |
30 | * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING |
31 | * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS |
32 | * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
33 | */ |
34 | |
35 | #include <linux/kernel.h> |
36 | #include <linux/module.h> |
37 | #include <linux/types.h> |
38 | #include <linux/errno.h> |
39 | #include <linux/cdev.h> |
40 | #include <linux/fs.h> |
41 | #include <linux/device.h> |
42 | #include <linux/mm.h> |
43 | #include <linux/highmem.h> |
44 | #include <linux/pagemap.h> |
45 | #include <linux/bug.h> |
46 | #include <linux/semaphore.h> |
47 | #include <linux/list.h> |
48 | #include <linux/of.h> |
49 | #include <linux/platform_device.h> |
50 | #include <soc/bcm2835/raspberrypi-firmware.h> |
51 | |
52 | #include "vchiq_core.h" |
53 | #include "vchiq_ioctl.h" |
54 | #include "vchiq_arm.h" |
55 | #include "vchiq_debugfs.h" |
56 | #include "vchiq_killable.h" |
57 | |
58 | #define DEVICE_NAME "vchiq" |
59 | |
60 | /* Override the default prefix, which would be vchiq_arm (from the filename) */ |
61 | #undef MODULE_PARAM_PREFIX |
62 | #define MODULE_PARAM_PREFIX DEVICE_NAME "." |
63 | |
64 | #define VCHIQ_MINOR 0 |
65 | |
66 | /* Some per-instance constants */ |
67 | #define MAX_COMPLETIONS 16 |
68 | #define MAX_SERVICES 64 |
69 | #define MAX_ELEMENTS 8 |
70 | #define MSG_QUEUE_SIZE 64 |
71 | |
72 | #define KEEPALIVE_VER 1 |
73 | #define KEEPALIVE_VER_MIN KEEPALIVE_VER |
74 | |
75 | /* Run time control of log level, based on KERN_XXX level. */ |
76 | int vchiq_arm_log_level = VCHIQ_LOG_DEFAULT; |
77 | int vchiq_susp_log_level = VCHIQ_LOG_ERROR; |
78 | |
79 | #define SUSPEND_TIMER_TIMEOUT_MS 100 |
80 | #define SUSPEND_RETRY_TIMER_TIMEOUT_MS 1000 |
81 | |
82 | #define VC_SUSPEND_NUM_OFFSET 3 /* number of values before idle which are -ve */ |
83 | static const char *const suspend_state_names[] = { |
84 | "VC_SUSPEND_FORCE_CANCELED", |
85 | "VC_SUSPEND_REJECTED", |
86 | "VC_SUSPEND_FAILED", |
87 | "VC_SUSPEND_IDLE", |
88 | "VC_SUSPEND_REQUESTED", |
89 | "VC_SUSPEND_IN_PROGRESS", |
90 | "VC_SUSPEND_SUSPENDED" |
91 | }; |
92 | #define VC_RESUME_NUM_OFFSET 1 /* number of values before idle which are -ve */ |
93 | static const char *const resume_state_names[] = { |
94 | "VC_RESUME_FAILED", |
95 | "VC_RESUME_IDLE", |
96 | "VC_RESUME_REQUESTED", |
97 | "VC_RESUME_IN_PROGRESS", |
98 | "VC_RESUME_RESUMED" |
99 | }; |
100 | /* The number of times we allow force suspend to timeout before actually |
101 | ** _forcing_ suspend. This is to cater for SW which fails to release vchiq |
102 | ** correctly - we don't want to prevent ARM suspend indefinitely in this case. |
103 | */ |
104 | #define FORCE_SUSPEND_FAIL_MAX 8 |
105 | |
106 | /* The time in ms allowed for videocore to go idle when force suspend has been |
107 | * requested */ |
108 | #define FORCE_SUSPEND_TIMEOUT_MS 200 |
109 | |
110 | |
111 | static void suspend_timer_callback(unsigned long context); |
112 | |
113 | |
114 | typedef struct user_service_struct { |
115 | VCHIQ_SERVICE_T *service; |
116 | void *userdata; |
117 | VCHIQ_INSTANCE_T instance; |
118 | char is_vchi; |
119 | char dequeue_pending; |
120 | char close_pending; |
121 | int message_available_pos; |
122 | int msg_insert; |
123 | int msg_remove; |
124 | struct semaphore insert_event; |
125 | struct semaphore remove_event; |
126 | struct semaphore close_event; |
127 | VCHIQ_HEADER_T * msg_queue[MSG_QUEUE_SIZE]; |
128 | } USER_SERVICE_T; |
129 | |
130 | struct bulk_waiter_node { |
131 | struct bulk_waiter bulk_waiter; |
132 | int pid; |
133 | struct list_head list; |
134 | }; |
135 | |
136 | struct vchiq_instance_struct { |
137 | VCHIQ_STATE_T *state; |
138 | VCHIQ_COMPLETION_DATA_T completions[MAX_COMPLETIONS]; |
139 | int completion_insert; |
140 | int completion_remove; |
141 | struct semaphore insert_event; |
142 | struct semaphore remove_event; |
143 | struct mutex completion_mutex; |
144 | |
145 | int connected; |
146 | int closing; |
147 | int pid; |
148 | int mark; |
149 | int use_close_delivered; |
150 | int trace; |
151 | |
152 | struct list_head bulk_waiter_list; |
153 | struct mutex bulk_waiter_list_mutex; |
154 | |
155 | VCHIQ_DEBUGFS_NODE_T debugfs_node; |
156 | }; |
157 | |
158 | typedef struct dump_context_struct { |
159 | char __user *buf; |
160 | size_t actual; |
161 | size_t space; |
162 | loff_t offset; |
163 | } DUMP_CONTEXT_T; |
164 | |
165 | static struct cdev vchiq_cdev; |
166 | static dev_t vchiq_devid; |
167 | static VCHIQ_STATE_T g_state; |
168 | static struct class *vchiq_class; |
169 | static struct device *vchiq_dev; |
170 | static DEFINE_SPINLOCK(msg_queue_spinlock); |
171 | |
172 | static const char *const ioctl_names[] = { |
173 | "CONNECT", |
174 | "SHUTDOWN", |
175 | "CREATE_SERVICE", |
176 | "REMOVE_SERVICE", |
177 | "QUEUE_MESSAGE", |
178 | "QUEUE_BULK_TRANSMIT", |
179 | "QUEUE_BULK_RECEIVE", |
180 | "AWAIT_COMPLETION", |
181 | "DEQUEUE_MESSAGE", |
182 | "GET_CLIENT_ID", |
183 | "GET_CONFIG", |
184 | "CLOSE_SERVICE", |
185 | "USE_SERVICE", |
186 | "RELEASE_SERVICE", |
187 | "SET_SERVICE_OPTION", |
188 | "DUMP_PHYS_MEM", |
189 | "LIB_VERSION", |
190 | "CLOSE_DELIVERED" |
191 | }; |
192 | |
193 | vchiq_static_assert((sizeof(ioctl_names)/sizeof(ioctl_names[0])) == |
194 | (VCHIQ_IOC_MAX + 1)); |
195 | |
196 | static void |
197 | dump_phys_mem(void *virt_addr, uint32_t num_bytes); |
198 | |
199 | /**************************************************************************** |
200 | * |
201 | * add_completion |
202 | * |
203 | ***************************************************************************/ |
204 | |
205 | static VCHIQ_STATUS_T |
206 | add_completion(VCHIQ_INSTANCE_T instance, VCHIQ_REASON_T reason, |
207 | VCHIQ_HEADER_T *header, USER_SERVICE_T *user_service, |
208 | void *bulk_userdata) |
209 | { |
210 | VCHIQ_COMPLETION_DATA_T *completion; |
211 | DEBUG_INITIALISE(g_state.local) |
212 | |
213 | while (instance->completion_insert == |
214 | (instance->completion_remove + MAX_COMPLETIONS)) { |
215 | /* Out of space - wait for the client */ |
216 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
217 | vchiq_log_trace(vchiq_arm_log_level, |
218 | "add_completion - completion queue full"); |
219 | DEBUG_COUNT(COMPLETION_QUEUE_FULL_COUNT); |
220 | if (down_interruptible(&instance->remove_event) != 0) { |
221 | vchiq_log_info(vchiq_arm_log_level, |
222 | "service_callback interrupted"); |
223 | return VCHIQ_RETRY; |
224 | } else if (instance->closing) { |
225 | vchiq_log_info(vchiq_arm_log_level, |
226 | "service_callback closing"); |
227 | return VCHIQ_ERROR; |
228 | } |
229 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
230 | } |
231 | |
232 | completion = |
233 | &instance->completions[instance->completion_insert & |
234 | (MAX_COMPLETIONS - 1)]; |
235 | |
236 | completion->header = header; |
237 | completion->reason = reason; |
238 | /* N.B. service_userdata is updated while processing AWAIT_COMPLETION */ |
239 | completion->service_userdata = user_service->service; |
240 | completion->bulk_userdata = bulk_userdata; |
241 | |
242 | if (reason == VCHIQ_SERVICE_CLOSED) { |
243 | /* Take an extra reference, to be held until |
244 | this CLOSED notification is delivered. */ |
245 | lock_service(user_service->service); |
246 | if (instance->use_close_delivered) |
247 | user_service->close_pending = 1; |
248 | } |
249 | |
250 | /* A write barrier is needed here to ensure that the entire completion |
251 | record is written out before the insert point. */ |
252 | wmb(); |
253 | |
254 | if (reason == VCHIQ_MESSAGE_AVAILABLE) |
255 | user_service->message_available_pos = |
256 | instance->completion_insert; |
257 | instance->completion_insert++; |
258 | |
259 | up(&instance->insert_event); |
260 | |
261 | return VCHIQ_SUCCESS; |
262 | } |
263 | |
264 | /**************************************************************************** |
265 | * |
266 | * service_callback |
267 | * |
268 | ***************************************************************************/ |
269 | |
270 | static VCHIQ_STATUS_T |
271 | service_callback(VCHIQ_REASON_T reason, VCHIQ_HEADER_T *header, |
272 | VCHIQ_SERVICE_HANDLE_T handle, void *bulk_userdata) |
273 | { |
274 | /* How do we ensure the callback goes to the right client? |
275 | ** The service_user data points to a USER_SERVICE_T record containing |
276 | ** the original callback and the user state structure, which contains a |
277 | ** circular buffer for completion records. |
278 | */ |
279 | USER_SERVICE_T *user_service; |
280 | VCHIQ_SERVICE_T *service; |
281 | VCHIQ_INSTANCE_T instance; |
282 | DEBUG_INITIALISE(g_state.local) |
283 | |
284 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
285 | |
286 | service = handle_to_service(handle); |
287 | BUG_ON(!service); |
288 | user_service = (USER_SERVICE_T *)service->base.userdata; |
289 | instance = user_service->instance; |
290 | |
291 | if (!instance || instance->closing) |
292 | return VCHIQ_SUCCESS; |
293 | |
294 | vchiq_log_trace(vchiq_arm_log_level, |
295 | "service_callback - service %lx(%d,%p), reason %d, header %lx, " |
296 | "instance %lx, bulk_userdata %lx", |
297 | (unsigned long)user_service, |
298 | service->localport, user_service->userdata, |
299 | reason, (unsigned long)header, |
300 | (unsigned long)instance, (unsigned long)bulk_userdata); |
301 | |
302 | if (header && user_service->is_vchi) { |
303 | spin_lock(&msg_queue_spinlock); |
304 | while (user_service->msg_insert == |
305 | (user_service->msg_remove + MSG_QUEUE_SIZE)) { |
306 | spin_unlock(&msg_queue_spinlock); |
307 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
308 | DEBUG_COUNT(MSG_QUEUE_FULL_COUNT); |
309 | vchiq_log_trace(vchiq_arm_log_level, |
310 | "service_callback - msg queue full"); |
311 | /* If there is no MESSAGE_AVAILABLE in the completion |
312 | ** queue, add one |
313 | */ |
314 | if ((user_service->message_available_pos - |
315 | instance->completion_remove) < 0) { |
316 | VCHIQ_STATUS_T status; |
317 | vchiq_log_info(vchiq_arm_log_level, |
318 | "Inserting extra MESSAGE_AVAILABLE"); |
319 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
320 | status = add_completion(instance, reason, |
321 | NULL, user_service, bulk_userdata); |
322 | if (status != VCHIQ_SUCCESS) { |
323 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
324 | return status; |
325 | } |
326 | } |
327 | |
328 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
329 | if (down_interruptible(&user_service->remove_event) |
330 | != 0) { |
331 | vchiq_log_info(vchiq_arm_log_level, |
332 | "service_callback interrupted"); |
333 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
334 | return VCHIQ_RETRY; |
335 | } else if (instance->closing) { |
336 | vchiq_log_info(vchiq_arm_log_level, |
337 | "service_callback closing"); |
338 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
339 | return VCHIQ_ERROR; |
340 | } |
341 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
342 | spin_lock(&msg_queue_spinlock); |
343 | } |
344 | |
345 | user_service->msg_queue[user_service->msg_insert & |
346 | (MSG_QUEUE_SIZE - 1)] = header; |
347 | user_service->msg_insert++; |
348 | spin_unlock(&msg_queue_spinlock); |
349 | |
350 | up(&user_service->insert_event); |
351 | |
352 | /* If there is a thread waiting in DEQUEUE_MESSAGE, or if |
353 | ** there is a MESSAGE_AVAILABLE in the completion queue then |
354 | ** bypass the completion queue. |
355 | */ |
356 | if (((user_service->message_available_pos - |
357 | instance->completion_remove) >= 0) || |
358 | user_service->dequeue_pending) { |
359 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
360 | user_service->dequeue_pending = 0; |
361 | return VCHIQ_SUCCESS; |
362 | } |
363 | |
364 | header = NULL; |
365 | } |
366 | DEBUG_TRACE(SERVICE_CALLBACK_LINE); |
367 | |
368 | return add_completion(instance, reason, header, user_service, |
369 | bulk_userdata); |
370 | } |
371 | |
372 | /**************************************************************************** |
373 | * |
374 | * user_service_free |
375 | * |
376 | ***************************************************************************/ |
377 | static void |
378 | user_service_free(void *userdata) |
379 | { |
380 | kfree(userdata); |
381 | } |
382 | |
383 | /**************************************************************************** |
384 | * |
385 | * close_delivered |
386 | * |
387 | ***************************************************************************/ |
388 | static void close_delivered(USER_SERVICE_T *user_service) |
389 | { |
390 | vchiq_log_info(vchiq_arm_log_level, |
391 | "close_delivered(handle=%x)", |
392 | user_service->service->handle); |
393 | |
394 | if (user_service->close_pending) { |
395 | /* Allow the underlying service to be culled */ |
396 | unlock_service(user_service->service); |
397 | |
398 | /* Wake the user-thread blocked in close_ or remove_service */ |
399 | up(&user_service->close_event); |
400 | |
401 | user_service->close_pending = 0; |
402 | } |
403 | } |
404 | |
405 | /**************************************************************************** |
406 | * |
407 | * vchiq_ioctl |
408 | * |
409 | ***************************************************************************/ |
410 | static long |
411 | vchiq_ioctl(struct file *file, unsigned int cmd, unsigned long arg) |
412 | { |
413 | VCHIQ_INSTANCE_T instance = file->private_data; |
414 | VCHIQ_STATUS_T status = VCHIQ_SUCCESS; |
415 | VCHIQ_SERVICE_T *service = NULL; |
416 | long ret = 0; |
417 | int i, rc; |
418 | DEBUG_INITIALISE(g_state.local) |
419 | |
420 | vchiq_log_trace(vchiq_arm_log_level, |
421 | "vchiq_ioctl - instance %x, cmd %s, arg %lx", |
422 | (unsigned int)instance, |
423 | ((_IOC_TYPE(cmd) == VCHIQ_IOC_MAGIC) && |
424 | (_IOC_NR(cmd) <= VCHIQ_IOC_MAX)) ? |
425 | ioctl_names[_IOC_NR(cmd)] : "<invalid>", arg); |
426 | |
427 | switch (cmd) { |
428 | case VCHIQ_IOC_SHUTDOWN: |
429 | if (!instance->connected) |
430 | break; |
431 | |
432 | /* Remove all services */ |
433 | i = 0; |
434 | while ((service = next_service_by_instance(instance->state, |
435 | instance, &i)) != NULL) { |
436 | status = vchiq_remove_service(service->handle); |
437 | unlock_service(service); |
438 | if (status != VCHIQ_SUCCESS) |
439 | break; |
440 | } |
441 | service = NULL; |
442 | |
443 | if (status == VCHIQ_SUCCESS) { |
444 | /* Wake the completion thread and ask it to exit */ |
445 | instance->closing = 1; |
446 | up(&instance->insert_event); |
447 | } |
448 | |
449 | break; |
450 | |
451 | case VCHIQ_IOC_CONNECT: |
452 | if (instance->connected) { |
453 | ret = -EINVAL; |
454 | break; |
455 | } |
456 | rc = mutex_lock_interruptible(&instance->state->mutex); |
457 | if (rc != 0) { |
458 | vchiq_log_error(vchiq_arm_log_level, |
459 | "vchiq: connect: could not lock mutex for " |
460 | "state %d: %d", |
461 | instance->state->id, rc); |
462 | ret = -EINTR; |
463 | break; |
464 | } |
465 | status = vchiq_connect_internal(instance->state, instance); |
466 | mutex_unlock(&instance->state->mutex); |
467 | |
468 | if (status == VCHIQ_SUCCESS) |
469 | instance->connected = 1; |
470 | else |
471 | vchiq_log_error(vchiq_arm_log_level, |
472 | "vchiq: could not connect: %d", status); |
473 | break; |
474 | |
475 | case VCHIQ_IOC_CREATE_SERVICE: { |
476 | VCHIQ_CREATE_SERVICE_T args; |
477 | USER_SERVICE_T *user_service = NULL; |
478 | void *userdata; |
479 | int srvstate; |
480 | |
481 | if (copy_from_user |
482 | (&args, (const void __user *)arg, |
483 | sizeof(args)) != 0) { |
484 | ret = -EFAULT; |
485 | break; |
486 | } |
487 | |
488 | user_service = kmalloc(sizeof(USER_SERVICE_T), GFP_KERNEL); |
489 | if (!user_service) { |
490 | ret = -ENOMEM; |
491 | break; |
492 | } |
493 | |
494 | if (args.is_open) { |
495 | if (!instance->connected) { |
496 | ret = -ENOTCONN; |
497 | kfree(user_service); |
498 | break; |
499 | } |
500 | srvstate = VCHIQ_SRVSTATE_OPENING; |
501 | } else { |
502 | srvstate = |
503 | instance->connected ? |
504 | VCHIQ_SRVSTATE_LISTENING : |
505 | VCHIQ_SRVSTATE_HIDDEN; |
506 | } |
507 | |
508 | userdata = args.params.userdata; |
509 | args.params.callback = service_callback; |
510 | args.params.userdata = user_service; |
511 | service = vchiq_add_service_internal( |
512 | instance->state, |
513 | &args.params, srvstate, |
514 | instance, user_service_free); |
515 | |
516 | if (service != NULL) { |
517 | user_service->service = service; |
518 | user_service->userdata = userdata; |
519 | user_service->instance = instance; |
520 | user_service->is_vchi = (args.is_vchi != 0); |
521 | user_service->dequeue_pending = 0; |
522 | user_service->close_pending = 0; |
523 | user_service->message_available_pos = |
524 | instance->completion_remove - 1; |
525 | user_service->msg_insert = 0; |
526 | user_service->msg_remove = 0; |
527 | sema_init(&user_service->insert_event, 0); |
528 | sema_init(&user_service->remove_event, 0); |
529 | sema_init(&user_service->close_event, 0); |
530 | |
531 | if (args.is_open) { |
532 | status = vchiq_open_service_internal |
533 | (service, instance->pid); |
534 | if (status != VCHIQ_SUCCESS) { |
535 | vchiq_remove_service(service->handle); |
536 | service = NULL; |
537 | ret = (status == VCHIQ_RETRY) ? |
538 | -EINTR : -EIO; |
539 | break; |
540 | } |
541 | } |
542 | |
543 | if (copy_to_user((void __user *) |
544 | &(((VCHIQ_CREATE_SERVICE_T __user *) |
545 | arg)->handle), |
546 | (const void *)&service->handle, |
547 | sizeof(service->handle)) != 0) { |
548 | ret = -EFAULT; |
549 | vchiq_remove_service(service->handle); |
550 | } |
551 | |
552 | service = NULL; |
553 | } else { |
554 | ret = -EEXIST; |
555 | kfree(user_service); |
556 | } |
557 | } break; |
558 | |
559 | case VCHIQ_IOC_CLOSE_SERVICE: { |
560 | VCHIQ_SERVICE_HANDLE_T handle = (VCHIQ_SERVICE_HANDLE_T)arg; |
561 | |
562 | service = find_service_for_instance(instance, handle); |
563 | if (service != NULL) { |
564 | USER_SERVICE_T *user_service = |
565 | (USER_SERVICE_T *)service->base.userdata; |
566 | /* close_pending is false on first entry, and when the |
567 | wait in vchiq_close_service has been interrupted. */ |
568 | if (!user_service->close_pending) { |
569 | status = vchiq_close_service(service->handle); |
570 | if (status != VCHIQ_SUCCESS) |
571 | break; |
572 | } |
573 | |
574 | /* close_pending is true once the underlying service |
575 | has been closed until the client library calls the |
576 | CLOSE_DELIVERED ioctl, signalling close_event. */ |
577 | if (user_service->close_pending && |
578 | down_interruptible(&user_service->close_event)) |
579 | status = VCHIQ_RETRY; |
580 | } |
581 | else |
582 | ret = -EINVAL; |
583 | } break; |
584 | |
585 | case VCHIQ_IOC_REMOVE_SERVICE: { |
586 | VCHIQ_SERVICE_HANDLE_T handle = (VCHIQ_SERVICE_HANDLE_T)arg; |
587 | |
588 | service = find_service_for_instance(instance, handle); |
589 | if (service != NULL) { |
590 | USER_SERVICE_T *user_service = |
591 | (USER_SERVICE_T *)service->base.userdata; |
592 | /* close_pending is false on first entry, and when the |
593 | wait in vchiq_close_service has been interrupted. */ |
594 | if (!user_service->close_pending) { |
595 | status = vchiq_remove_service(service->handle); |
596 | if (status != VCHIQ_SUCCESS) |
597 | break; |
598 | } |
599 | |
600 | /* close_pending is true once the underlying service |
601 | has been closed until the client library calls the |
602 | CLOSE_DELIVERED ioctl, signalling close_event. */ |
603 | if (user_service->close_pending && |
604 | down_interruptible(&user_service->close_event)) |
605 | status = VCHIQ_RETRY; |
606 | } |
607 | else |
608 | ret = -EINVAL; |
609 | } break; |
610 | |
611 | case VCHIQ_IOC_USE_SERVICE: |
612 | case VCHIQ_IOC_RELEASE_SERVICE: { |
613 | VCHIQ_SERVICE_HANDLE_T handle = (VCHIQ_SERVICE_HANDLE_T)arg; |
614 | |
615 | service = find_service_for_instance(instance, handle); |
616 | if (service != NULL) { |
617 | status = (cmd == VCHIQ_IOC_USE_SERVICE) ? |
618 | vchiq_use_service_internal(service) : |
619 | vchiq_release_service_internal(service); |
620 | if (status != VCHIQ_SUCCESS) { |
621 | vchiq_log_error(vchiq_susp_log_level, |
622 | "%s: cmd %s returned error %d for " |
623 | "service %c%c%c%c:%03d", |
624 | __func__, |
625 | (cmd == VCHIQ_IOC_USE_SERVICE) ? |
626 | "VCHIQ_IOC_USE_SERVICE" : |
627 | "VCHIQ_IOC_RELEASE_SERVICE", |
628 | status, |
629 | VCHIQ_FOURCC_AS_4CHARS( |
630 | service->base.fourcc), |
631 | service->client_id); |
632 | ret = -EINVAL; |
633 | } |
634 | } else |
635 | ret = -EINVAL; |
636 | } break; |
637 | |
638 | case VCHIQ_IOC_QUEUE_MESSAGE: { |
639 | VCHIQ_QUEUE_MESSAGE_T args; |
640 | if (copy_from_user |
641 | (&args, (const void __user *)arg, |
642 | sizeof(args)) != 0) { |
643 | ret = -EFAULT; |
644 | break; |
645 | } |
646 | |
647 | service = find_service_for_instance(instance, args.handle); |
648 | |
649 | if ((service != NULL) && (args.count <= MAX_ELEMENTS)) { |
650 | /* Copy elements into kernel space */ |
651 | VCHIQ_ELEMENT_T elements[MAX_ELEMENTS]; |
652 | if (copy_from_user(elements, args.elements, |
653 | args.count * sizeof(VCHIQ_ELEMENT_T)) == 0) |
654 | status = vchiq_queue_message |
655 | (args.handle, |
656 | elements, args.count); |
657 | else |
658 | ret = -EFAULT; |
659 | } else { |
660 | ret = -EINVAL; |
661 | } |
662 | } break; |
663 | |
664 | case VCHIQ_IOC_QUEUE_BULK_TRANSMIT: |
665 | case VCHIQ_IOC_QUEUE_BULK_RECEIVE: { |
666 | VCHIQ_QUEUE_BULK_TRANSFER_T args; |
667 | struct bulk_waiter_node *waiter = NULL; |
668 | VCHIQ_BULK_DIR_T dir = |
669 | (cmd == VCHIQ_IOC_QUEUE_BULK_TRANSMIT) ? |
670 | VCHIQ_BULK_TRANSMIT : VCHIQ_BULK_RECEIVE; |
671 | |
672 | if (copy_from_user |
673 | (&args, (const void __user *)arg, |
674 | sizeof(args)) != 0) { |
675 | ret = -EFAULT; |
676 | break; |
677 | } |
678 | |
679 | service = find_service_for_instance(instance, args.handle); |
680 | if (!service) { |
681 | ret = -EINVAL; |
682 | break; |
683 | } |
684 | |
685 | if (args.mode == VCHIQ_BULK_MODE_BLOCKING) { |
686 | waiter = kzalloc(sizeof(struct bulk_waiter_node), |
687 | GFP_KERNEL); |
688 | if (!waiter) { |
689 | ret = -ENOMEM; |
690 | break; |
691 | } |
692 | args.userdata = &waiter->bulk_waiter; |
693 | } else if (args.mode == VCHIQ_BULK_MODE_WAITING) { |
694 | struct list_head *pos; |
695 | mutex_lock(&instance->bulk_waiter_list_mutex); |
696 | list_for_each(pos, &instance->bulk_waiter_list) { |
697 | if (list_entry(pos, struct bulk_waiter_node, |
698 | list)->pid == current->pid) { |
699 | waiter = list_entry(pos, |
700 | struct bulk_waiter_node, |
701 | list); |
702 | list_del(pos); |
703 | break; |
704 | } |
705 | |
706 | } |
707 | mutex_unlock(&instance->bulk_waiter_list_mutex); |
708 | if (!waiter) { |
709 | vchiq_log_error(vchiq_arm_log_level, |
710 | "no bulk_waiter found for pid %d", |
711 | current->pid); |
712 | ret = -ESRCH; |
713 | break; |
714 | } |
715 | vchiq_log_info(vchiq_arm_log_level, |
716 | "found bulk_waiter %x for pid %d", |
717 | (unsigned int)waiter, current->pid); |
718 | args.userdata = &waiter->bulk_waiter; |
719 | } |
720 | status = vchiq_bulk_transfer |
721 | (args.handle, |
722 | VCHI_MEM_HANDLE_INVALID, |
723 | args.data, args.size, |
724 | args.userdata, args.mode, |
725 | dir); |
726 | if (!waiter) |
727 | break; |
728 | if ((status != VCHIQ_RETRY) || fatal_signal_pending(current) || |
729 | !waiter->bulk_waiter.bulk) { |
730 | if (waiter->bulk_waiter.bulk) { |
731 | /* Cancel the signal when the transfer |
732 | ** completes. */ |
733 | spin_lock(&bulk_waiter_spinlock); |
734 | waiter->bulk_waiter.bulk->userdata = NULL; |
735 | spin_unlock(&bulk_waiter_spinlock); |
736 | } |
737 | kfree(waiter); |
738 | } else { |
739 | const VCHIQ_BULK_MODE_T mode_waiting = |
740 | VCHIQ_BULK_MODE_WAITING; |
741 | waiter->pid = current->pid; |
742 | mutex_lock(&instance->bulk_waiter_list_mutex); |
743 | list_add(&waiter->list, &instance->bulk_waiter_list); |
744 | mutex_unlock(&instance->bulk_waiter_list_mutex); |
745 | vchiq_log_info(vchiq_arm_log_level, |
746 | "saved bulk_waiter %x for pid %d", |
747 | (unsigned int)waiter, current->pid); |
748 | |
749 | if (copy_to_user((void __user *) |
750 | &(((VCHIQ_QUEUE_BULK_TRANSFER_T __user *) |
751 | arg)->mode), |
752 | (const void *)&mode_waiting, |
753 | sizeof(mode_waiting)) != 0) |
754 | ret = -EFAULT; |
755 | } |
756 | } break; |
757 | |
758 | case VCHIQ_IOC_AWAIT_COMPLETION: { |
759 | VCHIQ_AWAIT_COMPLETION_T args; |
760 | |
761 | DEBUG_TRACE(AWAIT_COMPLETION_LINE); |
762 | if (!instance->connected) { |
763 | ret = -ENOTCONN; |
764 | break; |
765 | } |
766 | |
767 | if (copy_from_user(&args, (const void __user *)arg, |
768 | sizeof(args)) != 0) { |
769 | ret = -EFAULT; |
770 | break; |
771 | } |
772 | |
773 | mutex_lock(&instance->completion_mutex); |
774 | |
775 | DEBUG_TRACE(AWAIT_COMPLETION_LINE); |
776 | while ((instance->completion_remove == |
777 | instance->completion_insert) |
778 | && !instance->closing) { |
779 | int rc; |
780 | DEBUG_TRACE(AWAIT_COMPLETION_LINE); |
781 | mutex_unlock(&instance->completion_mutex); |
782 | rc = down_interruptible(&instance->insert_event); |
783 | mutex_lock(&instance->completion_mutex); |
784 | if (rc != 0) { |
785 | DEBUG_TRACE(AWAIT_COMPLETION_LINE); |
786 | vchiq_log_info(vchiq_arm_log_level, |
787 | "AWAIT_COMPLETION interrupted"); |
788 | ret = -EINTR; |
789 | break; |
790 | } |
791 | } |
792 | DEBUG_TRACE(AWAIT_COMPLETION_LINE); |
793 | |
794 | /* A read memory barrier is needed to stop prefetch of a stale |
795 | ** completion record |
796 | */ |
797 | rmb(); |
798 | |
799 | if (ret == 0) { |
800 | int msgbufcount = args.msgbufcount; |
801 | for (ret = 0; ret < args.count; ret++) { |
802 | VCHIQ_COMPLETION_DATA_T *completion; |
803 | VCHIQ_SERVICE_T *service; |
804 | USER_SERVICE_T *user_service; |
805 | VCHIQ_HEADER_T *header; |
806 | if (instance->completion_remove == |
807 | instance->completion_insert) |
808 | break; |
809 | completion = &instance->completions[ |
810 | instance->completion_remove & |
811 | (MAX_COMPLETIONS - 1)]; |
812 | |
813 | service = completion->service_userdata; |
814 | user_service = service->base.userdata; |
815 | completion->service_userdata = |
816 | user_service->userdata; |
817 | |
818 | header = completion->header; |
819 | if (header) { |
820 | void __user *msgbuf; |
821 | int msglen; |
822 | |
823 | msglen = header->size + |
824 | sizeof(VCHIQ_HEADER_T); |
825 | /* This must be a VCHIQ-style service */ |
826 | if (args.msgbufsize < msglen) { |
827 | vchiq_log_error( |
828 | vchiq_arm_log_level, |
829 | "header %x: msgbufsize" |
830 | " %x < msglen %x", |
831 | (unsigned int)header, |
832 | args.msgbufsize, |
833 | msglen); |
834 | WARN(1, "invalid message " |
835 | "size\n"); |
836 | if (ret == 0) |
837 | ret = -EMSGSIZE; |
838 | break; |
839 | } |
840 | if (msgbufcount <= 0) |
841 | /* Stall here for lack of a |
842 | ** buffer for the message. */ |
843 | break; |
844 | /* Get the pointer from user space */ |
845 | msgbufcount--; |
846 | if (copy_from_user(&msgbuf, |
847 | (const void __user *) |
848 | &args.msgbufs[msgbufcount], |
849 | sizeof(msgbuf)) != 0) { |
850 | if (ret == 0) |
851 | ret = -EFAULT; |
852 | break; |
853 | } |
854 | |
855 | /* Copy the message to user space */ |
856 | if (copy_to_user(msgbuf, header, |
857 | msglen) != 0) { |
858 | if (ret == 0) |
859 | ret = -EFAULT; |
860 | break; |
861 | } |
862 | |
863 | /* Now it has been copied, the message |
864 | ** can be released. */ |
865 | vchiq_release_message(service->handle, |
866 | header); |
867 | |
868 | /* The completion must point to the |
869 | ** msgbuf. */ |
870 | completion->header = msgbuf; |
871 | } |
872 | |
873 | if ((completion->reason == |
874 | VCHIQ_SERVICE_CLOSED) && |
875 | !instance->use_close_delivered) |
876 | unlock_service(service); |
877 | |
878 | if (copy_to_user((void __user *)( |
879 | (size_t)args.buf + |
880 | ret * sizeof(VCHIQ_COMPLETION_DATA_T)), |
881 | completion, |
882 | sizeof(VCHIQ_COMPLETION_DATA_T)) != 0) { |
883 | if (ret == 0) |
884 | ret = -EFAULT; |
885 | break; |
886 | } |
887 | |
888 | instance->completion_remove++; |
889 | } |
890 | |
891 | if (msgbufcount != args.msgbufcount) { |
892 | if (copy_to_user((void __user *) |
893 | &((VCHIQ_AWAIT_COMPLETION_T *)arg)-> |
894 | msgbufcount, |
895 | &msgbufcount, |
896 | sizeof(msgbufcount)) != 0) { |
897 | ret = -EFAULT; |
898 | } |
899 | } |
900 | } |
901 | |
902 | if (ret != 0) |
903 | up(&instance->remove_event); |
904 | mutex_unlock(&instance->completion_mutex); |
905 | DEBUG_TRACE(AWAIT_COMPLETION_LINE); |
906 | } break; |
907 | |
908 | case VCHIQ_IOC_DEQUEUE_MESSAGE: { |
909 | VCHIQ_DEQUEUE_MESSAGE_T args; |
910 | USER_SERVICE_T *user_service; |
911 | VCHIQ_HEADER_T *header; |
912 | |
913 | DEBUG_TRACE(DEQUEUE_MESSAGE_LINE); |
914 | if (copy_from_user |
915 | (&args, (const void __user *)arg, |
916 | sizeof(args)) != 0) { |
917 | ret = -EFAULT; |
918 | break; |
919 | } |
920 | service = find_service_for_instance(instance, args.handle); |
921 | if (!service) { |
922 | ret = -EINVAL; |
923 | break; |
924 | } |
925 | user_service = (USER_SERVICE_T *)service->base.userdata; |
926 | if (user_service->is_vchi == 0) { |
927 | ret = -EINVAL; |
928 | break; |
929 | } |
930 | |
931 | spin_lock(&msg_queue_spinlock); |
932 | if (user_service->msg_remove == user_service->msg_insert) { |
933 | if (!args.blocking) { |
934 | spin_unlock(&msg_queue_spinlock); |
935 | DEBUG_TRACE(DEQUEUE_MESSAGE_LINE); |
936 | ret = -EWOULDBLOCK; |
937 | break; |
938 | } |
939 | user_service->dequeue_pending = 1; |
940 | do { |
941 | spin_unlock(&msg_queue_spinlock); |
942 | DEBUG_TRACE(DEQUEUE_MESSAGE_LINE); |
943 | if (down_interruptible( |
944 | &user_service->insert_event) != 0) { |
945 | vchiq_log_info(vchiq_arm_log_level, |
946 | "DEQUEUE_MESSAGE interrupted"); |
947 | ret = -EINTR; |
948 | break; |
949 | } |
950 | spin_lock(&msg_queue_spinlock); |
951 | } while (user_service->msg_remove == |
952 | user_service->msg_insert); |
953 | |
954 | if (ret) |
955 | break; |
956 | } |
957 | |
958 | BUG_ON((int)(user_service->msg_insert - |
959 | user_service->msg_remove) < 0); |
960 | |
961 | header = user_service->msg_queue[user_service->msg_remove & |
962 | (MSG_QUEUE_SIZE - 1)]; |
963 | user_service->msg_remove++; |
964 | spin_unlock(&msg_queue_spinlock); |
965 | |
966 | up(&user_service->remove_event); |
967 | if (header == NULL) |
968 | ret = -ENOTCONN; |
969 | else if (header->size <= args.bufsize) { |
970 | /* Copy to user space if msgbuf is not NULL */ |
971 | if ((args.buf == NULL) || |
972 | (copy_to_user((void __user *)args.buf, |
973 | header->data, |
974 | header->size) == 0)) { |
975 | ret = header->size; |
976 | vchiq_release_message( |
977 | service->handle, |
978 | header); |
979 | } else |
980 | ret = -EFAULT; |
981 | } else { |
982 | vchiq_log_error(vchiq_arm_log_level, |
983 | "header %x: bufsize %x < size %x", |
984 | (unsigned int)header, args.bufsize, |
985 | header->size); |
986 | WARN(1, "invalid size\n"); |
987 | ret = -EMSGSIZE; |
988 | } |
989 | DEBUG_TRACE(DEQUEUE_MESSAGE_LINE); |
990 | } break; |
991 | |
992 | case VCHIQ_IOC_GET_CLIENT_ID: { |
993 | VCHIQ_SERVICE_HANDLE_T handle = (VCHIQ_SERVICE_HANDLE_T)arg; |
994 | |
995 | ret = vchiq_get_client_id(handle); |
996 | } break; |
997 | |
998 | case VCHIQ_IOC_GET_CONFIG: { |
999 | VCHIQ_GET_CONFIG_T args; |
1000 | VCHIQ_CONFIG_T config; |
1001 | |
1002 | if (copy_from_user(&args, (const void __user *)arg, |
1003 | sizeof(args)) != 0) { |
1004 | ret = -EFAULT; |
1005 | break; |
1006 | } |
1007 | if (args.config_size > sizeof(config)) { |
1008 | ret = -EINVAL; |
1009 | break; |
1010 | } |
1011 | status = vchiq_get_config(instance, args.config_size, &config); |
1012 | if (status == VCHIQ_SUCCESS) { |
1013 | if (copy_to_user((void __user *)args.pconfig, |
1014 | &config, args.config_size) != 0) { |
1015 | ret = -EFAULT; |
1016 | break; |
1017 | } |
1018 | } |
1019 | } break; |
1020 | |
1021 | case VCHIQ_IOC_SET_SERVICE_OPTION: { |
1022 | VCHIQ_SET_SERVICE_OPTION_T args; |
1023 | |
1024 | if (copy_from_user( |
1025 | &args, (const void __user *)arg, |
1026 | sizeof(args)) != 0) { |
1027 | ret = -EFAULT; |
1028 | break; |
1029 | } |
1030 | |
1031 | service = find_service_for_instance(instance, args.handle); |
1032 | if (!service) { |
1033 | ret = -EINVAL; |
1034 | break; |
1035 | } |
1036 | |
1037 | status = vchiq_set_service_option( |
1038 | args.handle, args.option, args.value); |
1039 | } break; |
1040 | |
1041 | case VCHIQ_IOC_DUMP_PHYS_MEM: { |
1042 | VCHIQ_DUMP_MEM_T args; |
1043 | |
1044 | if (copy_from_user |
1045 | (&args, (const void __user *)arg, |
1046 | sizeof(args)) != 0) { |
1047 | ret = -EFAULT; |
1048 | break; |
1049 | } |
1050 | dump_phys_mem(args.virt_addr, args.num_bytes); |
1051 | } break; |
1052 | |
1053 | case VCHIQ_IOC_LIB_VERSION: { |
1054 | unsigned int lib_version = (unsigned int)arg; |
1055 | |
1056 | if (lib_version < VCHIQ_VERSION_MIN) |
1057 | ret = -EINVAL; |
1058 | else if (lib_version >= VCHIQ_VERSION_CLOSE_DELIVERED) |
1059 | instance->use_close_delivered = 1; |
1060 | } break; |
1061 | |
1062 | case VCHIQ_IOC_CLOSE_DELIVERED: { |
1063 | VCHIQ_SERVICE_HANDLE_T handle = (VCHIQ_SERVICE_HANDLE_T)arg; |
1064 | |
1065 | service = find_closed_service_for_instance(instance, handle); |
1066 | if (service != NULL) { |
1067 | USER_SERVICE_T *user_service = |
1068 | (USER_SERVICE_T *)service->base.userdata; |
1069 | close_delivered(user_service); |
1070 | } |
1071 | else |
1072 | ret = -EINVAL; |
1073 | } break; |
1074 | |
1075 | default: |
1076 | ret = -ENOTTY; |
1077 | break; |
1078 | } |
1079 | |
1080 | if (service) |
1081 | unlock_service(service); |
1082 | |
1083 | if (ret == 0) { |
1084 | if (status == VCHIQ_ERROR) |
1085 | ret = -EIO; |
1086 | else if (status == VCHIQ_RETRY) |
1087 | ret = -EINTR; |
1088 | } |
1089 | |
1090 | if ((status == VCHIQ_SUCCESS) && (ret < 0) && (ret != -EINTR) && |
1091 | (ret != -EWOULDBLOCK)) |
1092 | vchiq_log_info(vchiq_arm_log_level, |
1093 | " ioctl instance %lx, cmd %s -> status %d, %ld", |
1094 | (unsigned long)instance, |
1095 | (_IOC_NR(cmd) <= VCHIQ_IOC_MAX) ? |
1096 | ioctl_names[_IOC_NR(cmd)] : |
1097 | "<invalid>", |
1098 | status, ret); |
1099 | else |
1100 | vchiq_log_trace(vchiq_arm_log_level, |
1101 | " ioctl instance %lx, cmd %s -> status %d, %ld", |
1102 | (unsigned long)instance, |
1103 | (_IOC_NR(cmd) <= VCHIQ_IOC_MAX) ? |
1104 | ioctl_names[_IOC_NR(cmd)] : |
1105 | "<invalid>", |
1106 | status, ret); |
1107 | |
1108 | return ret; |
1109 | } |
1110 | |
1111 | /**************************************************************************** |
1112 | * |
1113 | * vchiq_open |
1114 | * |
1115 | ***************************************************************************/ |
1116 | |
1117 | static int |
1118 | vchiq_open(struct inode *inode, struct file *file) |
1119 | { |
1120 | int dev = iminor(inode) & 0x0f; |
1121 | vchiq_log_info(vchiq_arm_log_level, "vchiq_open"); |
1122 | switch (dev) { |
1123 | case VCHIQ_MINOR: { |
1124 | int ret; |
1125 | VCHIQ_STATE_T *state = vchiq_get_state(); |
1126 | VCHIQ_INSTANCE_T instance; |
1127 | |
1128 | if (!state) { |
1129 | vchiq_log_error(vchiq_arm_log_level, |
1130 | "vchiq has no connection to VideoCore"); |
1131 | return -ENOTCONN; |
1132 | } |
1133 | |
1134 | instance = kzalloc(sizeof(*instance), GFP_KERNEL); |
1135 | if (!instance) |
1136 | return -ENOMEM; |
1137 | |
1138 | instance->state = state; |
1139 | instance->pid = current->tgid; |
1140 | |
1141 | ret = vchiq_debugfs_add_instance(instance); |
1142 | if (ret != 0) { |
1143 | kfree(instance); |
1144 | return ret; |
1145 | } |
1146 | |
1147 | sema_init(&instance->insert_event, 0); |
1148 | sema_init(&instance->remove_event, 0); |
1149 | mutex_init(&instance->completion_mutex); |
1150 | mutex_init(&instance->bulk_waiter_list_mutex); |
1151 | INIT_LIST_HEAD(&instance->bulk_waiter_list); |
1152 | |
1153 | file->private_data = instance; |
1154 | } break; |
1155 | |
1156 | default: |
1157 | vchiq_log_error(vchiq_arm_log_level, |
1158 | "Unknown minor device: %d", dev); |
1159 | return -ENXIO; |
1160 | } |
1161 | |
1162 | return 0; |
1163 | } |
1164 | |
1165 | /**************************************************************************** |
1166 | * |
1167 | * vchiq_release |
1168 | * |
1169 | ***************************************************************************/ |
1170 | |
1171 | static int |
1172 | vchiq_release(struct inode *inode, struct file *file) |
1173 | { |
1174 | int dev = iminor(inode) & 0x0f; |
1175 | int ret = 0; |
1176 | switch (dev) { |
1177 | case VCHIQ_MINOR: { |
1178 | VCHIQ_INSTANCE_T instance = file->private_data; |
1179 | VCHIQ_STATE_T *state = vchiq_get_state(); |
1180 | VCHIQ_SERVICE_T *service; |
1181 | int i; |
1182 | |
1183 | vchiq_log_info(vchiq_arm_log_level, |
1184 | "vchiq_release: instance=%lx", |
1185 | (unsigned long)instance); |
1186 | |
1187 | if (!state) { |
1188 | ret = -EPERM; |
1189 | goto out; |
1190 | } |
1191 | |
1192 | /* Ensure videocore is awake to allow termination. */ |
1193 | vchiq_use_internal(instance->state, NULL, |
1194 | USE_TYPE_VCHIQ); |
1195 | |
1196 | mutex_lock(&instance->completion_mutex); |
1197 | |
1198 | /* Wake the completion thread and ask it to exit */ |
1199 | instance->closing = 1; |
1200 | up(&instance->insert_event); |
1201 | |
1202 | mutex_unlock(&instance->completion_mutex); |
1203 | |
1204 | /* Wake the slot handler if the completion queue is full. */ |
1205 | up(&instance->remove_event); |
1206 | |
1207 | /* Mark all services for termination... */ |
1208 | i = 0; |
1209 | while ((service = next_service_by_instance(state, instance, |
1210 | &i)) != NULL) { |
1211 | USER_SERVICE_T *user_service = service->base.userdata; |
1212 | |
1213 | /* Wake the slot handler if the msg queue is full. */ |
1214 | up(&user_service->remove_event); |
1215 | |
1216 | vchiq_terminate_service_internal(service); |
1217 | unlock_service(service); |
1218 | } |
1219 | |
1220 | /* ...and wait for them to die */ |
1221 | i = 0; |
1222 | while ((service = next_service_by_instance(state, instance, &i)) |
1223 | != NULL) { |
1224 | USER_SERVICE_T *user_service = service->base.userdata; |
1225 | |
1226 | down(&service->remove_event); |
1227 | |
1228 | BUG_ON(service->srvstate != VCHIQ_SRVSTATE_FREE); |
1229 | |
1230 | spin_lock(&msg_queue_spinlock); |
1231 | |
1232 | while (user_service->msg_remove != |
1233 | user_service->msg_insert) { |
1234 | VCHIQ_HEADER_T *header = user_service-> |
1235 | msg_queue[user_service->msg_remove & |
1236 | (MSG_QUEUE_SIZE - 1)]; |
1237 | user_service->msg_remove++; |
1238 | spin_unlock(&msg_queue_spinlock); |
1239 | |
1240 | if (header) |
1241 | vchiq_release_message( |
1242 | service->handle, |
1243 | header); |
1244 | spin_lock(&msg_queue_spinlock); |
1245 | } |
1246 | |
1247 | spin_unlock(&msg_queue_spinlock); |
1248 | |
1249 | unlock_service(service); |
1250 | } |
1251 | |
1252 | /* Release any closed services */ |
1253 | while (instance->completion_remove != |
1254 | instance->completion_insert) { |
1255 | VCHIQ_COMPLETION_DATA_T *completion; |
1256 | VCHIQ_SERVICE_T *service; |
1257 | completion = &instance->completions[ |
1258 | instance->completion_remove & |
1259 | (MAX_COMPLETIONS - 1)]; |
1260 | service = completion->service_userdata; |
1261 | if (completion->reason == VCHIQ_SERVICE_CLOSED) |
1262 | { |
1263 | USER_SERVICE_T *user_service = |
1264 | service->base.userdata; |
1265 | |
1266 | /* Wake any blocked user-thread */ |
1267 | if (instance->use_close_delivered) |
1268 | up(&user_service->close_event); |
1269 | unlock_service(service); |
1270 | } |
1271 | instance->completion_remove++; |
1272 | } |
1273 | |
1274 | /* Release the PEER service count. */ |
1275 | vchiq_release_internal(instance->state, NULL); |
1276 | |
1277 | { |
1278 | struct list_head *pos, *next; |
1279 | list_for_each_safe(pos, next, |
1280 | &instance->bulk_waiter_list) { |
1281 | struct bulk_waiter_node *waiter; |
1282 | waiter = list_entry(pos, |
1283 | struct bulk_waiter_node, |
1284 | list); |
1285 | list_del(pos); |
1286 | vchiq_log_info(vchiq_arm_log_level, |
1287 | "bulk_waiter - cleaned up %x " |
1288 | "for pid %d", |
1289 | (unsigned int)waiter, waiter->pid); |
1290 | kfree(waiter); |
1291 | } |
1292 | } |
1293 | |
1294 | vchiq_debugfs_remove_instance(instance); |
1295 | |
1296 | kfree(instance); |
1297 | file->private_data = NULL; |
1298 | } break; |
1299 | |
1300 | default: |
1301 | vchiq_log_error(vchiq_arm_log_level, |
1302 | "Unknown minor device: %d", dev); |
1303 | ret = -ENXIO; |
1304 | } |
1305 | |
1306 | out: |
1307 | return ret; |
1308 | } |
1309 | |
1310 | /**************************************************************************** |
1311 | * |
1312 | * vchiq_dump |
1313 | * |
1314 | ***************************************************************************/ |
1315 | |
1316 | void |
1317 | vchiq_dump(void *dump_context, const char *str, int len) |
1318 | { |
1319 | DUMP_CONTEXT_T *context = (DUMP_CONTEXT_T *)dump_context; |
1320 | |
1321 | if (context->actual < context->space) { |
1322 | int copy_bytes; |
1323 | if (context->offset > 0) { |
1324 | int skip_bytes = min(len, (int)context->offset); |
1325 | str += skip_bytes; |
1326 | len -= skip_bytes; |
1327 | context->offset -= skip_bytes; |
1328 | if (context->offset > 0) |
1329 | return; |
1330 | } |
1331 | copy_bytes = min(len, (int)(context->space - context->actual)); |
1332 | if (copy_bytes == 0) |
1333 | return; |
1334 | if (copy_to_user(context->buf + context->actual, str, |
1335 | copy_bytes)) |
1336 | context->actual = -EFAULT; |
1337 | context->actual += copy_bytes; |
1338 | len -= copy_bytes; |
1339 | |
1340 | /* If tne terminating NUL is included in the length, then it |
1341 | ** marks the end of a line and should be replaced with a |
1342 | ** carriage return. */ |
1343 | if ((len == 0) && (str[copy_bytes - 1] == '\0')) { |
1344 | char cr = '\n'; |
1345 | if (copy_to_user(context->buf + context->actual - 1, |
1346 | &cr, 1)) |
1347 | context->actual = -EFAULT; |
1348 | } |
1349 | } |
1350 | } |
1351 | |
1352 | /**************************************************************************** |
1353 | * |
1354 | * vchiq_dump_platform_instance_state |
1355 | * |
1356 | ***************************************************************************/ |
1357 | |
1358 | void |
1359 | vchiq_dump_platform_instances(void *dump_context) |
1360 | { |
1361 | VCHIQ_STATE_T *state = vchiq_get_state(); |
1362 | char buf[80]; |
1363 | int len; |
1364 | int i; |
1365 | |
1366 | /* There is no list of instances, so instead scan all services, |
1367 | marking those that have been dumped. */ |
1368 | |
1369 | for (i = 0; i < state->unused_service; i++) { |
1370 | VCHIQ_SERVICE_T *service = state->services[i]; |
1371 | VCHIQ_INSTANCE_T instance; |
1372 | |
1373 | if (service && (service->base.callback == service_callback)) { |
1374 | instance = service->instance; |
1375 | if (instance) |
1376 | instance->mark = 0; |
1377 | } |
1378 | } |
1379 | |
1380 | for (i = 0; i < state->unused_service; i++) { |
1381 | VCHIQ_SERVICE_T *service = state->services[i]; |
1382 | VCHIQ_INSTANCE_T instance; |
1383 | |
1384 | if (service && (service->base.callback == service_callback)) { |
1385 | instance = service->instance; |
1386 | if (instance && !instance->mark) { |
1387 | len = snprintf(buf, sizeof(buf), |
1388 | "Instance %x: pid %d,%s completions " |
1389 | "%d/%d", |
1390 | (unsigned int)instance, instance->pid, |
1391 | instance->connected ? " connected, " : |
1392 | "", |
1393 | instance->completion_insert - |
1394 | instance->completion_remove, |
1395 | MAX_COMPLETIONS); |
1396 | |
1397 | vchiq_dump(dump_context, buf, len + 1); |
1398 | |
1399 | instance->mark = 1; |
1400 | } |
1401 | } |
1402 | } |
1403 | } |
1404 | |
1405 | /**************************************************************************** |
1406 | * |
1407 | * vchiq_dump_platform_service_state |
1408 | * |
1409 | ***************************************************************************/ |
1410 | |
1411 | void |
1412 | vchiq_dump_platform_service_state(void *dump_context, VCHIQ_SERVICE_T *service) |
1413 | { |
1414 | USER_SERVICE_T *user_service = (USER_SERVICE_T *)service->base.userdata; |
1415 | char buf[80]; |
1416 | int len; |
1417 | |
1418 | len = snprintf(buf, sizeof(buf), " instance %x", |
1419 | (unsigned int)service->instance); |
1420 | |
1421 | if ((service->base.callback == service_callback) && |
1422 | user_service->is_vchi) { |
1423 | len += snprintf(buf + len, sizeof(buf) - len, |
1424 | ", %d/%d messages", |
1425 | user_service->msg_insert - user_service->msg_remove, |
1426 | MSG_QUEUE_SIZE); |
1427 | |
1428 | if (user_service->dequeue_pending) |
1429 | len += snprintf(buf + len, sizeof(buf) - len, |
1430 | " (dequeue pending)"); |
1431 | } |
1432 | |
1433 | vchiq_dump(dump_context, buf, len + 1); |
1434 | } |
1435 | |
1436 | /**************************************************************************** |
1437 | * |
1438 | * dump_user_mem |
1439 | * |
1440 | ***************************************************************************/ |
1441 | |
1442 | static void |
1443 | dump_phys_mem(void *virt_addr, uint32_t num_bytes) |
1444 | { |
1445 | int rc; |
1446 | uint8_t *end_virt_addr = virt_addr + num_bytes; |
1447 | int num_pages; |
1448 | int offset; |
1449 | int end_offset; |
1450 | int page_idx; |
1451 | int prev_idx; |
1452 | struct page *page; |
1453 | struct page **pages; |
1454 | uint8_t *kmapped_virt_ptr; |
1455 | |
1456 | /* Align virtAddr and endVirtAddr to 16 byte boundaries. */ |
1457 | |
1458 | virt_addr = (void *)((unsigned long)virt_addr & ~0x0fuL); |
1459 | end_virt_addr = (void *)(((unsigned long)end_virt_addr + 15uL) & |
1460 | ~0x0fuL); |
1461 | |
1462 | offset = (int)(long)virt_addr & (PAGE_SIZE - 1); |
1463 | end_offset = (int)(long)end_virt_addr & (PAGE_SIZE - 1); |
1464 | |
1465 | num_pages = (offset + num_bytes + PAGE_SIZE - 1) / PAGE_SIZE; |
1466 | |
1467 | pages = kmalloc(sizeof(struct page *) * num_pages, GFP_KERNEL); |
1468 | if (pages == NULL) { |
1469 | vchiq_log_error(vchiq_arm_log_level, |
1470 | "Unable to allocation memory for %d pages\n", |
1471 | num_pages); |
1472 | return; |
1473 | } |
1474 | |
1475 | down_read(¤t->mm->mmap_sem); |
1476 | rc = get_user_pages(current, /* task */ |
1477 | current->mm, /* mm */ |
1478 | (unsigned long)virt_addr, /* start */ |
1479 | num_pages, /* len */ |
1480 | 0, /* write */ |
1481 | 0, /* force */ |
1482 | pages, /* pages (array of page pointers) */ |
1483 | NULL); /* vmas */ |
1484 | up_read(¤t->mm->mmap_sem); |
1485 | |
1486 | prev_idx = -1; |
1487 | page = NULL; |
1488 | |
1489 | while (offset < end_offset) { |
1490 | |
1491 | int page_offset = offset % PAGE_SIZE; |
1492 | page_idx = offset / PAGE_SIZE; |
1493 | |
1494 | if (page_idx != prev_idx) { |
1495 | |
1496 | if (page != NULL) |
1497 | kunmap(page); |
1498 | page = pages[page_idx]; |
1499 | kmapped_virt_ptr = kmap(page); |
1500 | |
1501 | prev_idx = page_idx; |
1502 | } |
1503 | |
1504 | if (vchiq_arm_log_level >= VCHIQ_LOG_TRACE) |
1505 | vchiq_log_dump_mem("ph", |
1506 | (uint32_t)(unsigned long)&kmapped_virt_ptr[ |
1507 | page_offset], |
1508 | &kmapped_virt_ptr[page_offset], 16); |
1509 | |
1510 | offset += 16; |
1511 | } |
1512 | if (page != NULL) |
1513 | kunmap(page); |
1514 | |
1515 | for (page_idx = 0; page_idx < num_pages; page_idx++) |
1516 | page_cache_release(pages[page_idx]); |
1517 | |
1518 | kfree(pages); |
1519 | } |
1520 | |
1521 | /**************************************************************************** |
1522 | * |
1523 | * vchiq_read |
1524 | * |
1525 | ***************************************************************************/ |
1526 | |
1527 | static ssize_t |
1528 | vchiq_read(struct file *file, char __user *buf, |
1529 | size_t count, loff_t *ppos) |
1530 | { |
1531 | DUMP_CONTEXT_T context; |
1532 | context.buf = buf; |
1533 | context.actual = 0; |
1534 | context.space = count; |
1535 | context.offset = *ppos; |
1536 | |
1537 | vchiq_dump_state(&context, &g_state); |
1538 | |
1539 | *ppos += context.actual; |
1540 | |
1541 | return context.actual; |
1542 | } |
1543 | |
1544 | VCHIQ_STATE_T * |
1545 | vchiq_get_state(void) |
1546 | { |
1547 | |
1548 | if (g_state.remote == NULL) |
1549 | printk(KERN_ERR "%s: g_state.remote == NULL\n", __func__); |
1550 | else if (g_state.remote->initialised != 1) |
1551 | printk(KERN_NOTICE "%s: g_state.remote->initialised != 1 (%d)\n", |
1552 | __func__, g_state.remote->initialised); |
1553 | |
1554 | return ((g_state.remote != NULL) && |
1555 | (g_state.remote->initialised == 1)) ? &g_state : NULL; |
1556 | } |
1557 | |
1558 | static const struct file_operations |
1559 | vchiq_fops = { |
1560 | .owner = THIS_MODULE, |
1561 | .unlocked_ioctl = vchiq_ioctl, |
1562 | .open = vchiq_open, |
1563 | .release = vchiq_release, |
1564 | .read = vchiq_read |
1565 | }; |
1566 | |
1567 | /* |
1568 | * Autosuspend related functionality |
1569 | */ |
1570 | |
1571 | int |
1572 | vchiq_videocore_wanted(VCHIQ_STATE_T *state) |
1573 | { |
1574 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
1575 | if (!arm_state) |
1576 | /* autosuspend not supported - always return wanted */ |
1577 | return 1; |
1578 | else if (arm_state->blocked_count) |
1579 | return 1; |
1580 | else if (!arm_state->videocore_use_count) |
1581 | /* usage count zero - check for override unless we're forcing */ |
1582 | if (arm_state->resume_blocked) |
1583 | return 0; |
1584 | else |
1585 | return vchiq_platform_videocore_wanted(state); |
1586 | else |
1587 | /* non-zero usage count - videocore still required */ |
1588 | return 1; |
1589 | } |
1590 | |
1591 | static VCHIQ_STATUS_T |
1592 | vchiq_keepalive_vchiq_callback(VCHIQ_REASON_T reason, |
1593 | VCHIQ_HEADER_T *header, |
1594 | VCHIQ_SERVICE_HANDLE_T service_user, |
1595 | void *bulk_user) |
1596 | { |
1597 | vchiq_log_error(vchiq_susp_log_level, |
1598 | "%s callback reason %d", __func__, reason); |
1599 | return 0; |
1600 | } |
1601 | |
1602 | static int |
1603 | vchiq_keepalive_thread_func(void *v) |
1604 | { |
1605 | VCHIQ_STATE_T *state = (VCHIQ_STATE_T *) v; |
1606 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
1607 | |
1608 | VCHIQ_STATUS_T status; |
1609 | VCHIQ_INSTANCE_T instance; |
1610 | VCHIQ_SERVICE_HANDLE_T ka_handle; |
1611 | |
1612 | VCHIQ_SERVICE_PARAMS_T params = { |
1613 | .fourcc = VCHIQ_MAKE_FOURCC('K', 'E', 'E', 'P'), |
1614 | .callback = vchiq_keepalive_vchiq_callback, |
1615 | .version = KEEPALIVE_VER, |
1616 | .version_min = KEEPALIVE_VER_MIN |
1617 | }; |
1618 | |
1619 | status = vchiq_initialise(&instance); |
1620 | if (status != VCHIQ_SUCCESS) { |
1621 | vchiq_log_error(vchiq_susp_log_level, |
1622 | "%s vchiq_initialise failed %d", __func__, status); |
1623 | goto exit; |
1624 | } |
1625 | |
1626 | status = vchiq_connect(instance); |
1627 | if (status != VCHIQ_SUCCESS) { |
1628 | vchiq_log_error(vchiq_susp_log_level, |
1629 | "%s vchiq_connect failed %d", __func__, status); |
1630 | goto shutdown; |
1631 | } |
1632 | |
1633 | status = vchiq_add_service(instance, ¶ms, &ka_handle); |
1634 | if (status != VCHIQ_SUCCESS) { |
1635 | vchiq_log_error(vchiq_susp_log_level, |
1636 | "%s vchiq_open_service failed %d", __func__, status); |
1637 | goto shutdown; |
1638 | } |
1639 | |
1640 | while (1) { |
1641 | long rc = 0, uc = 0; |
1642 | if (wait_for_completion_interruptible(&arm_state->ka_evt) |
1643 | != 0) { |
1644 | vchiq_log_error(vchiq_susp_log_level, |
1645 | "%s interrupted", __func__); |
1646 | flush_signals(current); |
1647 | continue; |
1648 | } |
1649 | |
1650 | /* read and clear counters. Do release_count then use_count to |
1651 | * prevent getting more releases than uses */ |
1652 | rc = atomic_xchg(&arm_state->ka_release_count, 0); |
1653 | uc = atomic_xchg(&arm_state->ka_use_count, 0); |
1654 | |
1655 | /* Call use/release service the requisite number of times. |
1656 | * Process use before release so use counts don't go negative */ |
1657 | while (uc--) { |
1658 | atomic_inc(&arm_state->ka_use_ack_count); |
1659 | status = vchiq_use_service(ka_handle); |
1660 | if (status != VCHIQ_SUCCESS) { |
1661 | vchiq_log_error(vchiq_susp_log_level, |
1662 | "%s vchiq_use_service error %d", |
1663 | __func__, status); |
1664 | } |
1665 | } |
1666 | while (rc--) { |
1667 | status = vchiq_release_service(ka_handle); |
1668 | if (status != VCHIQ_SUCCESS) { |
1669 | vchiq_log_error(vchiq_susp_log_level, |
1670 | "%s vchiq_release_service error %d", |
1671 | __func__, status); |
1672 | } |
1673 | } |
1674 | } |
1675 | |
1676 | shutdown: |
1677 | vchiq_shutdown(instance); |
1678 | exit: |
1679 | return 0; |
1680 | } |
1681 | |
1682 | |
1683 | |
1684 | VCHIQ_STATUS_T |
1685 | vchiq_arm_init_state(VCHIQ_STATE_T *state, VCHIQ_ARM_STATE_T *arm_state) |
1686 | { |
1687 | VCHIQ_STATUS_T status = VCHIQ_SUCCESS; |
1688 | |
1689 | if (arm_state) { |
1690 | rwlock_init(&arm_state->susp_res_lock); |
1691 | |
1692 | init_completion(&arm_state->ka_evt); |
1693 | atomic_set(&arm_state->ka_use_count, 0); |
1694 | atomic_set(&arm_state->ka_use_ack_count, 0); |
1695 | atomic_set(&arm_state->ka_release_count, 0); |
1696 | |
1697 | init_completion(&arm_state->vc_suspend_complete); |
1698 | |
1699 | init_completion(&arm_state->vc_resume_complete); |
1700 | /* Initialise to 'done' state. We only want to block on resume |
1701 | * completion while videocore is suspended. */ |
1702 | set_resume_state(arm_state, VC_RESUME_RESUMED); |
1703 | |
1704 | init_completion(&arm_state->resume_blocker); |
1705 | /* Initialise to 'done' state. We only want to block on this |
1706 | * completion while resume is blocked */ |
1707 | complete_all(&arm_state->resume_blocker); |
1708 | |
1709 | init_completion(&arm_state->blocked_blocker); |
1710 | /* Initialise to 'done' state. We only want to block on this |
1711 | * completion while things are waiting on the resume blocker */ |
1712 | complete_all(&arm_state->blocked_blocker); |
1713 | |
1714 | arm_state->suspend_timer_timeout = SUSPEND_TIMER_TIMEOUT_MS; |
1715 | arm_state->suspend_timer_running = 0; |
1716 | init_timer(&arm_state->suspend_timer); |
1717 | arm_state->suspend_timer.data = (unsigned long)(state); |
1718 | arm_state->suspend_timer.function = suspend_timer_callback; |
1719 | |
1720 | arm_state->first_connect = 0; |
1721 | |
1722 | } |
1723 | return status; |
1724 | } |
1725 | |
1726 | /* |
1727 | ** Functions to modify the state variables; |
1728 | ** set_suspend_state |
1729 | ** set_resume_state |
1730 | ** |
1731 | ** There are more state variables than we might like, so ensure they remain in |
1732 | ** step. Suspend and resume state are maintained separately, since most of |
1733 | ** these state machines can operate independently. However, there are a few |
1734 | ** states where state transitions in one state machine cause a reset to the |
1735 | ** other state machine. In addition, there are some completion events which |
1736 | ** need to occur on state machine reset and end-state(s), so these are also |
1737 | ** dealt with in these functions. |
1738 | ** |
1739 | ** In all states we set the state variable according to the input, but in some |
1740 | ** cases we perform additional steps outlined below; |
1741 | ** |
1742 | ** VC_SUSPEND_IDLE - Initialise the suspend completion at the same time. |
1743 | ** The suspend completion is completed after any suspend |
1744 | ** attempt. When we reset the state machine we also reset |
1745 | ** the completion. This reset occurs when videocore is |
1746 | ** resumed, and also if we initiate suspend after a suspend |
1747 | ** failure. |
1748 | ** |
1749 | ** VC_SUSPEND_IN_PROGRESS - This state is considered the point of no return for |
1750 | ** suspend - ie from this point on we must try to suspend |
1751 | ** before resuming can occur. We therefore also reset the |
1752 | ** resume state machine to VC_RESUME_IDLE in this state. |
1753 | ** |
1754 | ** VC_SUSPEND_SUSPENDED - Suspend has completed successfully. Also call |
1755 | ** complete_all on the suspend completion to notify |
1756 | ** anything waiting for suspend to happen. |
1757 | ** |
1758 | ** VC_SUSPEND_REJECTED - Videocore rejected suspend. Videocore will also |
1759 | ** initiate resume, so no need to alter resume state. |
1760 | ** We call complete_all on the suspend completion to notify |
1761 | ** of suspend rejection. |
1762 | ** |
1763 | ** VC_SUSPEND_FAILED - We failed to initiate videocore suspend. We notify the |
1764 | ** suspend completion and reset the resume state machine. |
1765 | ** |
1766 | ** VC_RESUME_IDLE - Initialise the resume completion at the same time. The |
1767 | ** resume completion is in it's 'done' state whenever |
1768 | ** videcore is running. Therfore, the VC_RESUME_IDLE state |
1769 | ** implies that videocore is suspended. |
1770 | ** Hence, any thread which needs to wait until videocore is |
1771 | ** running can wait on this completion - it will only block |
1772 | ** if videocore is suspended. |
1773 | ** |
1774 | ** VC_RESUME_RESUMED - Resume has completed successfully. Videocore is running. |
1775 | ** Call complete_all on the resume completion to unblock |
1776 | ** any threads waiting for resume. Also reset the suspend |
1777 | ** state machine to it's idle state. |
1778 | ** |
1779 | ** VC_RESUME_FAILED - Currently unused - no mechanism to fail resume exists. |
1780 | */ |
1781 | |
1782 | void |
1783 | set_suspend_state(VCHIQ_ARM_STATE_T *arm_state, |
1784 | enum vc_suspend_status new_state) |
1785 | { |
1786 | /* set the state in all cases */ |
1787 | arm_state->vc_suspend_state = new_state; |
1788 | |
1789 | /* state specific additional actions */ |
1790 | switch (new_state) { |
1791 | case VC_SUSPEND_FORCE_CANCELED: |
1792 | complete_all(&arm_state->vc_suspend_complete); |
1793 | break; |
1794 | case VC_SUSPEND_REJECTED: |
1795 | complete_all(&arm_state->vc_suspend_complete); |
1796 | break; |
1797 | case VC_SUSPEND_FAILED: |
1798 | complete_all(&arm_state->vc_suspend_complete); |
1799 | arm_state->vc_resume_state = VC_RESUME_RESUMED; |
1800 | complete_all(&arm_state->vc_resume_complete); |
1801 | break; |
1802 | case VC_SUSPEND_IDLE: |
1803 | reinit_completion(&arm_state->vc_suspend_complete); |
1804 | break; |
1805 | case VC_SUSPEND_REQUESTED: |
1806 | break; |
1807 | case VC_SUSPEND_IN_PROGRESS: |
1808 | set_resume_state(arm_state, VC_RESUME_IDLE); |
1809 | break; |
1810 | case VC_SUSPEND_SUSPENDED: |
1811 | complete_all(&arm_state->vc_suspend_complete); |
1812 | break; |
1813 | default: |
1814 | BUG(); |
1815 | break; |
1816 | } |
1817 | } |
1818 | |
1819 | void |
1820 | set_resume_state(VCHIQ_ARM_STATE_T *arm_state, |
1821 | enum vc_resume_status new_state) |
1822 | { |
1823 | /* set the state in all cases */ |
1824 | arm_state->vc_resume_state = new_state; |
1825 | |
1826 | /* state specific additional actions */ |
1827 | switch (new_state) { |
1828 | case VC_RESUME_FAILED: |
1829 | break; |
1830 | case VC_RESUME_IDLE: |
1831 | reinit_completion(&arm_state->vc_resume_complete); |
1832 | break; |
1833 | case VC_RESUME_REQUESTED: |
1834 | break; |
1835 | case VC_RESUME_IN_PROGRESS: |
1836 | break; |
1837 | case VC_RESUME_RESUMED: |
1838 | complete_all(&arm_state->vc_resume_complete); |
1839 | set_suspend_state(arm_state, VC_SUSPEND_IDLE); |
1840 | break; |
1841 | default: |
1842 | BUG(); |
1843 | break; |
1844 | } |
1845 | } |
1846 | |
1847 | |
1848 | /* should be called with the write lock held */ |
1849 | inline void |
1850 | start_suspend_timer(VCHIQ_ARM_STATE_T *arm_state) |
1851 | { |
1852 | del_timer(&arm_state->suspend_timer); |
1853 | arm_state->suspend_timer.expires = jiffies + |
1854 | msecs_to_jiffies(arm_state-> |
1855 | suspend_timer_timeout); |
1856 | add_timer(&arm_state->suspend_timer); |
1857 | arm_state->suspend_timer_running = 1; |
1858 | } |
1859 | |
1860 | /* should be called with the write lock held */ |
1861 | static inline void |
1862 | stop_suspend_timer(VCHIQ_ARM_STATE_T *arm_state) |
1863 | { |
1864 | if (arm_state->suspend_timer_running) { |
1865 | del_timer(&arm_state->suspend_timer); |
1866 | arm_state->suspend_timer_running = 0; |
1867 | } |
1868 | } |
1869 | |
1870 | static inline int |
1871 | need_resume(VCHIQ_STATE_T *state) |
1872 | { |
1873 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
1874 | return (arm_state->vc_suspend_state > VC_SUSPEND_IDLE) && |
1875 | (arm_state->vc_resume_state < VC_RESUME_REQUESTED) && |
1876 | vchiq_videocore_wanted(state); |
1877 | } |
1878 | |
1879 | static int |
1880 | block_resume(VCHIQ_ARM_STATE_T *arm_state) |
1881 | { |
1882 | int status = VCHIQ_SUCCESS; |
1883 | const unsigned long timeout_val = |
1884 | msecs_to_jiffies(FORCE_SUSPEND_TIMEOUT_MS); |
1885 | int resume_count = 0; |
1886 | |
1887 | /* Allow any threads which were blocked by the last force suspend to |
1888 | * complete if they haven't already. Only give this one shot; if |
1889 | * blocked_count is incremented after blocked_blocker is completed |
1890 | * (which only happens when blocked_count hits 0) then those threads |
1891 | * will have to wait until next time around */ |
1892 | if (arm_state->blocked_count) { |
1893 | reinit_completion(&arm_state->blocked_blocker); |
1894 | write_unlock_bh(&arm_state->susp_res_lock); |
1895 | vchiq_log_info(vchiq_susp_log_level, "%s wait for previously " |
1896 | "blocked clients", __func__); |
1897 | if (wait_for_completion_interruptible_timeout( |
1898 | &arm_state->blocked_blocker, timeout_val) |
1899 | <= 0) { |
1900 | vchiq_log_error(vchiq_susp_log_level, "%s wait for " |
1901 | "previously blocked clients failed" , __func__); |
1902 | status = VCHIQ_ERROR; |
1903 | write_lock_bh(&arm_state->susp_res_lock); |
1904 | goto out; |
1905 | } |
1906 | vchiq_log_info(vchiq_susp_log_level, "%s previously blocked " |
1907 | "clients resumed", __func__); |
1908 | write_lock_bh(&arm_state->susp_res_lock); |
1909 | } |
1910 | |
1911 | /* We need to wait for resume to complete if it's in process */ |
1912 | while (arm_state->vc_resume_state != VC_RESUME_RESUMED && |
1913 | arm_state->vc_resume_state > VC_RESUME_IDLE) { |
1914 | if (resume_count > 1) { |
1915 | status = VCHIQ_ERROR; |
1916 | vchiq_log_error(vchiq_susp_log_level, "%s waited too " |
1917 | "many times for resume" , __func__); |
1918 | goto out; |
1919 | } |
1920 | write_unlock_bh(&arm_state->susp_res_lock); |
1921 | vchiq_log_info(vchiq_susp_log_level, "%s wait for resume", |
1922 | __func__); |
1923 | if (wait_for_completion_interruptible_timeout( |
1924 | &arm_state->vc_resume_complete, timeout_val) |
1925 | <= 0) { |
1926 | vchiq_log_error(vchiq_susp_log_level, "%s wait for " |
1927 | "resume failed (%s)", __func__, |
1928 | resume_state_names[arm_state->vc_resume_state + |
1929 | VC_RESUME_NUM_OFFSET]); |
1930 | status = VCHIQ_ERROR; |
1931 | write_lock_bh(&arm_state->susp_res_lock); |
1932 | goto out; |
1933 | } |
1934 | vchiq_log_info(vchiq_susp_log_level, "%s resumed", __func__); |
1935 | write_lock_bh(&arm_state->susp_res_lock); |
1936 | resume_count++; |
1937 | } |
1938 | reinit_completion(&arm_state->resume_blocker); |
1939 | arm_state->resume_blocked = 1; |
1940 | |
1941 | out: |
1942 | return status; |
1943 | } |
1944 | |
1945 | static inline void |
1946 | unblock_resume(VCHIQ_ARM_STATE_T *arm_state) |
1947 | { |
1948 | complete_all(&arm_state->resume_blocker); |
1949 | arm_state->resume_blocked = 0; |
1950 | } |
1951 | |
1952 | /* Initiate suspend via slot handler. Should be called with the write lock |
1953 | * held */ |
1954 | VCHIQ_STATUS_T |
1955 | vchiq_arm_vcsuspend(VCHIQ_STATE_T *state) |
1956 | { |
1957 | VCHIQ_STATUS_T status = VCHIQ_ERROR; |
1958 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
1959 | |
1960 | if (!arm_state) |
1961 | goto out; |
1962 | |
1963 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
1964 | status = VCHIQ_SUCCESS; |
1965 | |
1966 | |
1967 | switch (arm_state->vc_suspend_state) { |
1968 | case VC_SUSPEND_REQUESTED: |
1969 | vchiq_log_info(vchiq_susp_log_level, "%s: suspend already " |
1970 | "requested", __func__); |
1971 | break; |
1972 | case VC_SUSPEND_IN_PROGRESS: |
1973 | vchiq_log_info(vchiq_susp_log_level, "%s: suspend already in " |
1974 | "progress", __func__); |
1975 | break; |
1976 | |
1977 | default: |
1978 | /* We don't expect to be in other states, so log but continue |
1979 | * anyway */ |
1980 | vchiq_log_error(vchiq_susp_log_level, |
1981 | "%s unexpected suspend state %s", __func__, |
1982 | suspend_state_names[arm_state->vc_suspend_state + |
1983 | VC_SUSPEND_NUM_OFFSET]); |
1984 | /* fall through */ |
1985 | case VC_SUSPEND_REJECTED: |
1986 | case VC_SUSPEND_FAILED: |
1987 | /* Ensure any idle state actions have been run */ |
1988 | set_suspend_state(arm_state, VC_SUSPEND_IDLE); |
1989 | /* fall through */ |
1990 | case VC_SUSPEND_IDLE: |
1991 | vchiq_log_info(vchiq_susp_log_level, |
1992 | "%s: suspending", __func__); |
1993 | set_suspend_state(arm_state, VC_SUSPEND_REQUESTED); |
1994 | /* kick the slot handler thread to initiate suspend */ |
1995 | request_poll(state, NULL, 0); |
1996 | break; |
1997 | } |
1998 | |
1999 | out: |
2000 | vchiq_log_trace(vchiq_susp_log_level, "%s exit %d", __func__, status); |
2001 | return status; |
2002 | } |
2003 | |
2004 | void |
2005 | vchiq_platform_check_suspend(VCHIQ_STATE_T *state) |
2006 | { |
2007 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2008 | int susp = 0; |
2009 | |
2010 | if (!arm_state) |
2011 | goto out; |
2012 | |
2013 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2014 | |
2015 | write_lock_bh(&arm_state->susp_res_lock); |
2016 | if (arm_state->vc_suspend_state == VC_SUSPEND_REQUESTED && |
2017 | arm_state->vc_resume_state == VC_RESUME_RESUMED) { |
2018 | set_suspend_state(arm_state, VC_SUSPEND_IN_PROGRESS); |
2019 | susp = 1; |
2020 | } |
2021 | write_unlock_bh(&arm_state->susp_res_lock); |
2022 | |
2023 | if (susp) |
2024 | vchiq_platform_suspend(state); |
2025 | |
2026 | out: |
2027 | vchiq_log_trace(vchiq_susp_log_level, "%s exit", __func__); |
2028 | return; |
2029 | } |
2030 | |
2031 | |
2032 | static void |
2033 | output_timeout_error(VCHIQ_STATE_T *state) |
2034 | { |
2035 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2036 | char service_err[50] = ""; |
2037 | int vc_use_count = arm_state->videocore_use_count; |
2038 | int active_services = state->unused_service; |
2039 | int i; |
2040 | |
2041 | if (!arm_state->videocore_use_count) { |
2042 | snprintf(service_err, 50, " Videocore usecount is 0"); |
2043 | goto output_msg; |
2044 | } |
2045 | for (i = 0; i < active_services; i++) { |
2046 | VCHIQ_SERVICE_T *service_ptr = state->services[i]; |
2047 | if (service_ptr && service_ptr->service_use_count && |
2048 | (service_ptr->srvstate != VCHIQ_SRVSTATE_FREE)) { |
2049 | snprintf(service_err, 50, " %c%c%c%c(%d) service has " |
2050 | "use count %d%s", VCHIQ_FOURCC_AS_4CHARS( |
2051 | service_ptr->base.fourcc), |
2052 | service_ptr->client_id, |
2053 | service_ptr->service_use_count, |
2054 | service_ptr->service_use_count == |
2055 | vc_use_count ? "" : " (+ more)"); |
2056 | break; |
2057 | } |
2058 | } |
2059 | |
2060 | output_msg: |
2061 | vchiq_log_error(vchiq_susp_log_level, |
2062 | "timed out waiting for vc suspend (%d).%s", |
2063 | arm_state->autosuspend_override, service_err); |
2064 | |
2065 | } |
2066 | |
2067 | /* Try to get videocore into suspended state, regardless of autosuspend state. |
2068 | ** We don't actually force suspend, since videocore may get into a bad state |
2069 | ** if we force suspend at a bad time. Instead, we wait for autosuspend to |
2070 | ** determine a good point to suspend. If this doesn't happen within 100ms we |
2071 | ** report failure. |
2072 | ** |
2073 | ** Returns VCHIQ_SUCCESS if videocore suspended successfully, VCHIQ_RETRY if |
2074 | ** videocore failed to suspend in time or VCHIQ_ERROR if interrupted. |
2075 | */ |
2076 | VCHIQ_STATUS_T |
2077 | vchiq_arm_force_suspend(VCHIQ_STATE_T *state) |
2078 | { |
2079 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2080 | VCHIQ_STATUS_T status = VCHIQ_ERROR; |
2081 | long rc = 0; |
2082 | int repeat = -1; |
2083 | |
2084 | if (!arm_state) |
2085 | goto out; |
2086 | |
2087 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2088 | |
2089 | write_lock_bh(&arm_state->susp_res_lock); |
2090 | |
2091 | status = block_resume(arm_state); |
2092 | if (status != VCHIQ_SUCCESS) |
2093 | goto unlock; |
2094 | if (arm_state->vc_suspend_state == VC_SUSPEND_SUSPENDED) { |
2095 | /* Already suspended - just block resume and exit */ |
2096 | vchiq_log_info(vchiq_susp_log_level, "%s already suspended", |
2097 | __func__); |
2098 | status = VCHIQ_SUCCESS; |
2099 | goto unlock; |
2100 | } else if (arm_state->vc_suspend_state <= VC_SUSPEND_IDLE) { |
2101 | /* initiate suspend immediately in the case that we're waiting |
2102 | * for the timeout */ |
2103 | stop_suspend_timer(arm_state); |
2104 | if (!vchiq_videocore_wanted(state)) { |
2105 | vchiq_log_info(vchiq_susp_log_level, "%s videocore " |
2106 | "idle, initiating suspend", __func__); |
2107 | status = vchiq_arm_vcsuspend(state); |
2108 | } else if (arm_state->autosuspend_override < |
2109 | FORCE_SUSPEND_FAIL_MAX) { |
2110 | vchiq_log_info(vchiq_susp_log_level, "%s letting " |
2111 | "videocore go idle", __func__); |
2112 | status = VCHIQ_SUCCESS; |
2113 | } else { |
2114 | vchiq_log_warning(vchiq_susp_log_level, "%s failed too " |
2115 | "many times - attempting suspend", __func__); |
2116 | status = vchiq_arm_vcsuspend(state); |
2117 | } |
2118 | } else { |
2119 | vchiq_log_info(vchiq_susp_log_level, "%s videocore suspend " |
2120 | "in progress - wait for completion", __func__); |
2121 | status = VCHIQ_SUCCESS; |
2122 | } |
2123 | |
2124 | /* Wait for suspend to happen due to system idle (not forced..) */ |
2125 | if (status != VCHIQ_SUCCESS) |
2126 | goto unblock_resume; |
2127 | |
2128 | do { |
2129 | write_unlock_bh(&arm_state->susp_res_lock); |
2130 | |
2131 | rc = wait_for_completion_interruptible_timeout( |
2132 | &arm_state->vc_suspend_complete, |
2133 | msecs_to_jiffies(FORCE_SUSPEND_TIMEOUT_MS)); |
2134 | |
2135 | write_lock_bh(&arm_state->susp_res_lock); |
2136 | if (rc < 0) { |
2137 | vchiq_log_warning(vchiq_susp_log_level, "%s " |
2138 | "interrupted waiting for suspend", __func__); |
2139 | status = VCHIQ_ERROR; |
2140 | goto unblock_resume; |
2141 | } else if (rc == 0) { |
2142 | if (arm_state->vc_suspend_state > VC_SUSPEND_IDLE) { |
2143 | /* Repeat timeout once if in progress */ |
2144 | if (repeat < 0) { |
2145 | repeat = 1; |
2146 | continue; |
2147 | } |
2148 | } |
2149 | arm_state->autosuspend_override++; |
2150 | output_timeout_error(state); |
2151 | |
2152 | status = VCHIQ_RETRY; |
2153 | goto unblock_resume; |
2154 | } |
2155 | } while (0 < (repeat--)); |
2156 | |
2157 | /* Check and report state in case we need to abort ARM suspend */ |
2158 | if (arm_state->vc_suspend_state != VC_SUSPEND_SUSPENDED) { |
2159 | status = VCHIQ_RETRY; |
2160 | vchiq_log_error(vchiq_susp_log_level, |
2161 | "%s videocore suspend failed (state %s)", __func__, |
2162 | suspend_state_names[arm_state->vc_suspend_state + |
2163 | VC_SUSPEND_NUM_OFFSET]); |
2164 | /* Reset the state only if it's still in an error state. |
2165 | * Something could have already initiated another suspend. */ |
2166 | if (arm_state->vc_suspend_state < VC_SUSPEND_IDLE) |
2167 | set_suspend_state(arm_state, VC_SUSPEND_IDLE); |
2168 | |
2169 | goto unblock_resume; |
2170 | } |
2171 | |
2172 | /* successfully suspended - unlock and exit */ |
2173 | goto unlock; |
2174 | |
2175 | unblock_resume: |
2176 | /* all error states need to unblock resume before exit */ |
2177 | unblock_resume(arm_state); |
2178 | |
2179 | unlock: |
2180 | write_unlock_bh(&arm_state->susp_res_lock); |
2181 | |
2182 | out: |
2183 | vchiq_log_trace(vchiq_susp_log_level, "%s exit %d", __func__, status); |
2184 | return status; |
2185 | } |
2186 | |
2187 | void |
2188 | vchiq_check_suspend(VCHIQ_STATE_T *state) |
2189 | { |
2190 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2191 | |
2192 | if (!arm_state) |
2193 | goto out; |
2194 | |
2195 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2196 | |
2197 | write_lock_bh(&arm_state->susp_res_lock); |
2198 | if (arm_state->vc_suspend_state != VC_SUSPEND_SUSPENDED && |
2199 | arm_state->first_connect && |
2200 | !vchiq_videocore_wanted(state)) { |
2201 | vchiq_arm_vcsuspend(state); |
2202 | } |
2203 | write_unlock_bh(&arm_state->susp_res_lock); |
2204 | |
2205 | out: |
2206 | vchiq_log_trace(vchiq_susp_log_level, "%s exit", __func__); |
2207 | return; |
2208 | } |
2209 | |
2210 | |
2211 | int |
2212 | vchiq_arm_allow_resume(VCHIQ_STATE_T *state) |
2213 | { |
2214 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2215 | int resume = 0; |
2216 | int ret = -1; |
2217 | |
2218 | if (!arm_state) |
2219 | goto out; |
2220 | |
2221 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2222 | |
2223 | write_lock_bh(&arm_state->susp_res_lock); |
2224 | unblock_resume(arm_state); |
2225 | resume = vchiq_check_resume(state); |
2226 | write_unlock_bh(&arm_state->susp_res_lock); |
2227 | |
2228 | if (resume) { |
2229 | if (wait_for_completion_interruptible( |
2230 | &arm_state->vc_resume_complete) < 0) { |
2231 | vchiq_log_error(vchiq_susp_log_level, |
2232 | "%s interrupted", __func__); |
2233 | /* failed, cannot accurately derive suspend |
2234 | * state, so exit early. */ |
2235 | goto out; |
2236 | } |
2237 | } |
2238 | |
2239 | read_lock_bh(&arm_state->susp_res_lock); |
2240 | if (arm_state->vc_suspend_state == VC_SUSPEND_SUSPENDED) { |
2241 | vchiq_log_info(vchiq_susp_log_level, |
2242 | "%s: Videocore remains suspended", __func__); |
2243 | } else { |
2244 | vchiq_log_info(vchiq_susp_log_level, |
2245 | "%s: Videocore resumed", __func__); |
2246 | ret = 0; |
2247 | } |
2248 | read_unlock_bh(&arm_state->susp_res_lock); |
2249 | out: |
2250 | vchiq_log_trace(vchiq_susp_log_level, "%s exit %d", __func__, ret); |
2251 | return ret; |
2252 | } |
2253 | |
2254 | /* This function should be called with the write lock held */ |
2255 | int |
2256 | vchiq_check_resume(VCHIQ_STATE_T *state) |
2257 | { |
2258 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2259 | int resume = 0; |
2260 | |
2261 | if (!arm_state) |
2262 | goto out; |
2263 | |
2264 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2265 | |
2266 | if (need_resume(state)) { |
2267 | set_resume_state(arm_state, VC_RESUME_REQUESTED); |
2268 | request_poll(state, NULL, 0); |
2269 | resume = 1; |
2270 | } |
2271 | |
2272 | out: |
2273 | vchiq_log_trace(vchiq_susp_log_level, "%s exit", __func__); |
2274 | return resume; |
2275 | } |
2276 | |
2277 | void |
2278 | vchiq_platform_check_resume(VCHIQ_STATE_T *state) |
2279 | { |
2280 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2281 | int res = 0; |
2282 | |
2283 | if (!arm_state) |
2284 | goto out; |
2285 | |
2286 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2287 | |
2288 | write_lock_bh(&arm_state->susp_res_lock); |
2289 | if (arm_state->wake_address == 0) { |
2290 | vchiq_log_info(vchiq_susp_log_level, |
2291 | "%s: already awake", __func__); |
2292 | goto unlock; |
2293 | } |
2294 | if (arm_state->vc_resume_state == VC_RESUME_IN_PROGRESS) { |
2295 | vchiq_log_info(vchiq_susp_log_level, |
2296 | "%s: already resuming", __func__); |
2297 | goto unlock; |
2298 | } |
2299 | |
2300 | if (arm_state->vc_resume_state == VC_RESUME_REQUESTED) { |
2301 | set_resume_state(arm_state, VC_RESUME_IN_PROGRESS); |
2302 | res = 1; |
2303 | } else |
2304 | vchiq_log_trace(vchiq_susp_log_level, |
2305 | "%s: not resuming (resume state %s)", __func__, |
2306 | resume_state_names[arm_state->vc_resume_state + |
2307 | VC_RESUME_NUM_OFFSET]); |
2308 | |
2309 | unlock: |
2310 | write_unlock_bh(&arm_state->susp_res_lock); |
2311 | |
2312 | if (res) |
2313 | vchiq_platform_resume(state); |
2314 | |
2315 | out: |
2316 | vchiq_log_trace(vchiq_susp_log_level, "%s exit", __func__); |
2317 | return; |
2318 | |
2319 | } |
2320 | |
2321 | |
2322 | |
2323 | VCHIQ_STATUS_T |
2324 | vchiq_use_internal(VCHIQ_STATE_T *state, VCHIQ_SERVICE_T *service, |
2325 | enum USE_TYPE_E use_type) |
2326 | { |
2327 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2328 | VCHIQ_STATUS_T ret = VCHIQ_SUCCESS; |
2329 | char entity[16]; |
2330 | int *entity_uc; |
2331 | int local_uc, local_entity_uc; |
2332 | |
2333 | if (!arm_state) |
2334 | goto out; |
2335 | |
2336 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2337 | |
2338 | if (use_type == USE_TYPE_VCHIQ) { |
2339 | sprintf(entity, "VCHIQ: "); |
2340 | entity_uc = &arm_state->peer_use_count; |
2341 | } else if (service) { |
2342 | sprintf(entity, "%c%c%c%c:%03d", |
2343 | VCHIQ_FOURCC_AS_4CHARS(service->base.fourcc), |
2344 | service->client_id); |
2345 | entity_uc = &service->service_use_count; |
2346 | } else { |
2347 | vchiq_log_error(vchiq_susp_log_level, "%s null service " |
2348 | "ptr", __func__); |
2349 | ret = VCHIQ_ERROR; |
2350 | goto out; |
2351 | } |
2352 | |
2353 | write_lock_bh(&arm_state->susp_res_lock); |
2354 | while (arm_state->resume_blocked) { |
2355 | /* If we call 'use' while force suspend is waiting for suspend, |
2356 | * then we're about to block the thread which the force is |
2357 | * waiting to complete, so we're bound to just time out. In this |
2358 | * case, set the suspend state such that the wait will be |
2359 | * canceled, so we can complete as quickly as possible. */ |
2360 | if (arm_state->resume_blocked && arm_state->vc_suspend_state == |
2361 | VC_SUSPEND_IDLE) { |
2362 | set_suspend_state(arm_state, VC_SUSPEND_FORCE_CANCELED); |
2363 | break; |
2364 | } |
2365 | /* If suspend is already in progress then we need to block */ |
2366 | if (!try_wait_for_completion(&arm_state->resume_blocker)) { |
2367 | /* Indicate that there are threads waiting on the resume |
2368 | * blocker. These need to be allowed to complete before |
2369 | * a _second_ call to force suspend can complete, |
2370 | * otherwise low priority threads might never actually |
2371 | * continue */ |
2372 | arm_state->blocked_count++; |
2373 | write_unlock_bh(&arm_state->susp_res_lock); |
2374 | vchiq_log_info(vchiq_susp_log_level, "%s %s resume " |
2375 | "blocked - waiting...", __func__, entity); |
2376 | if (wait_for_completion_killable( |
2377 | &arm_state->resume_blocker) != 0) { |
2378 | vchiq_log_error(vchiq_susp_log_level, "%s %s " |
2379 | "wait for resume blocker interrupted", |
2380 | __func__, entity); |
2381 | ret = VCHIQ_ERROR; |
2382 | write_lock_bh(&arm_state->susp_res_lock); |
2383 | arm_state->blocked_count--; |
2384 | write_unlock_bh(&arm_state->susp_res_lock); |
2385 | goto out; |
2386 | } |
2387 | vchiq_log_info(vchiq_susp_log_level, "%s %s resume " |
2388 | "unblocked", __func__, entity); |
2389 | write_lock_bh(&arm_state->susp_res_lock); |
2390 | if (--arm_state->blocked_count == 0) |
2391 | complete_all(&arm_state->blocked_blocker); |
2392 | } |
2393 | } |
2394 | |
2395 | stop_suspend_timer(arm_state); |
2396 | |
2397 | local_uc = ++arm_state->videocore_use_count; |
2398 | local_entity_uc = ++(*entity_uc); |
2399 | |
2400 | /* If there's a pending request which hasn't yet been serviced then |
2401 | * just clear it. If we're past VC_SUSPEND_REQUESTED state then |
2402 | * vc_resume_complete will block until we either resume or fail to |
2403 | * suspend */ |
2404 | if (arm_state->vc_suspend_state <= VC_SUSPEND_REQUESTED) |
2405 | set_suspend_state(arm_state, VC_SUSPEND_IDLE); |
2406 | |
2407 | if ((use_type != USE_TYPE_SERVICE_NO_RESUME) && need_resume(state)) { |
2408 | set_resume_state(arm_state, VC_RESUME_REQUESTED); |
2409 | vchiq_log_info(vchiq_susp_log_level, |
2410 | "%s %s count %d, state count %d", |
2411 | __func__, entity, local_entity_uc, local_uc); |
2412 | request_poll(state, NULL, 0); |
2413 | } else |
2414 | vchiq_log_trace(vchiq_susp_log_level, |
2415 | "%s %s count %d, state count %d", |
2416 | __func__, entity, *entity_uc, local_uc); |
2417 | |
2418 | |
2419 | write_unlock_bh(&arm_state->susp_res_lock); |
2420 | |
2421 | /* Completion is in a done state when we're not suspended, so this won't |
2422 | * block for the non-suspended case. */ |
2423 | if (!try_wait_for_completion(&arm_state->vc_resume_complete)) { |
2424 | vchiq_log_info(vchiq_susp_log_level, "%s %s wait for resume", |
2425 | __func__, entity); |
2426 | if (wait_for_completion_killable( |
2427 | &arm_state->vc_resume_complete) != 0) { |
2428 | vchiq_log_error(vchiq_susp_log_level, "%s %s wait for " |
2429 | "resume interrupted", __func__, entity); |
2430 | ret = VCHIQ_ERROR; |
2431 | goto out; |
2432 | } |
2433 | vchiq_log_info(vchiq_susp_log_level, "%s %s resumed", __func__, |
2434 | entity); |
2435 | } |
2436 | |
2437 | if (ret == VCHIQ_SUCCESS) { |
2438 | VCHIQ_STATUS_T status = VCHIQ_SUCCESS; |
2439 | long ack_cnt = atomic_xchg(&arm_state->ka_use_ack_count, 0); |
2440 | while (ack_cnt && (status == VCHIQ_SUCCESS)) { |
2441 | /* Send the use notify to videocore */ |
2442 | status = vchiq_send_remote_use_active(state); |
2443 | if (status == VCHIQ_SUCCESS) |
2444 | ack_cnt--; |
2445 | else |
2446 | atomic_add(ack_cnt, |
2447 | &arm_state->ka_use_ack_count); |
2448 | } |
2449 | } |
2450 | |
2451 | out: |
2452 | vchiq_log_trace(vchiq_susp_log_level, "%s exit %d", __func__, ret); |
2453 | return ret; |
2454 | } |
2455 | |
2456 | VCHIQ_STATUS_T |
2457 | vchiq_release_internal(VCHIQ_STATE_T *state, VCHIQ_SERVICE_T *service) |
2458 | { |
2459 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2460 | VCHIQ_STATUS_T ret = VCHIQ_SUCCESS; |
2461 | char entity[16]; |
2462 | int *entity_uc; |
2463 | int local_uc, local_entity_uc; |
2464 | |
2465 | if (!arm_state) |
2466 | goto out; |
2467 | |
2468 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2469 | |
2470 | if (service) { |
2471 | sprintf(entity, "%c%c%c%c:%03d", |
2472 | VCHIQ_FOURCC_AS_4CHARS(service->base.fourcc), |
2473 | service->client_id); |
2474 | entity_uc = &service->service_use_count; |
2475 | } else { |
2476 | sprintf(entity, "PEER: "); |
2477 | entity_uc = &arm_state->peer_use_count; |
2478 | } |
2479 | |
2480 | write_lock_bh(&arm_state->susp_res_lock); |
2481 | if (!arm_state->videocore_use_count || !(*entity_uc)) { |
2482 | /* Don't use BUG_ON - don't allow user thread to crash kernel */ |
2483 | WARN_ON(!arm_state->videocore_use_count); |
2484 | WARN_ON(!(*entity_uc)); |
2485 | ret = VCHIQ_ERROR; |
2486 | goto unlock; |
2487 | } |
2488 | local_uc = --arm_state->videocore_use_count; |
2489 | local_entity_uc = --(*entity_uc); |
2490 | |
2491 | if (!vchiq_videocore_wanted(state)) { |
2492 | if (vchiq_platform_use_suspend_timer() && |
2493 | !arm_state->resume_blocked) { |
2494 | /* Only use the timer if we're not trying to force |
2495 | * suspend (=> resume_blocked) */ |
2496 | start_suspend_timer(arm_state); |
2497 | } else { |
2498 | vchiq_log_info(vchiq_susp_log_level, |
2499 | "%s %s count %d, state count %d - suspending", |
2500 | __func__, entity, *entity_uc, |
2501 | arm_state->videocore_use_count); |
2502 | vchiq_arm_vcsuspend(state); |
2503 | } |
2504 | } else |
2505 | vchiq_log_trace(vchiq_susp_log_level, |
2506 | "%s %s count %d, state count %d", |
2507 | __func__, entity, *entity_uc, |
2508 | arm_state->videocore_use_count); |
2509 | |
2510 | unlock: |
2511 | write_unlock_bh(&arm_state->susp_res_lock); |
2512 | |
2513 | out: |
2514 | vchiq_log_trace(vchiq_susp_log_level, "%s exit %d", __func__, ret); |
2515 | return ret; |
2516 | } |
2517 | |
2518 | void |
2519 | vchiq_on_remote_use(VCHIQ_STATE_T *state) |
2520 | { |
2521 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2522 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2523 | atomic_inc(&arm_state->ka_use_count); |
2524 | complete(&arm_state->ka_evt); |
2525 | } |
2526 | |
2527 | void |
2528 | vchiq_on_remote_release(VCHIQ_STATE_T *state) |
2529 | { |
2530 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2531 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2532 | atomic_inc(&arm_state->ka_release_count); |
2533 | complete(&arm_state->ka_evt); |
2534 | } |
2535 | |
2536 | VCHIQ_STATUS_T |
2537 | vchiq_use_service_internal(VCHIQ_SERVICE_T *service) |
2538 | { |
2539 | return vchiq_use_internal(service->state, service, USE_TYPE_SERVICE); |
2540 | } |
2541 | |
2542 | VCHIQ_STATUS_T |
2543 | vchiq_release_service_internal(VCHIQ_SERVICE_T *service) |
2544 | { |
2545 | return vchiq_release_internal(service->state, service); |
2546 | } |
2547 | |
2548 | VCHIQ_DEBUGFS_NODE_T * |
2549 | vchiq_instance_get_debugfs_node(VCHIQ_INSTANCE_T instance) |
2550 | { |
2551 | return &instance->debugfs_node; |
2552 | } |
2553 | |
2554 | int |
2555 | vchiq_instance_get_use_count(VCHIQ_INSTANCE_T instance) |
2556 | { |
2557 | VCHIQ_SERVICE_T *service; |
2558 | int use_count = 0, i; |
2559 | i = 0; |
2560 | while ((service = next_service_by_instance(instance->state, |
2561 | instance, &i)) != NULL) { |
2562 | use_count += service->service_use_count; |
2563 | unlock_service(service); |
2564 | } |
2565 | return use_count; |
2566 | } |
2567 | |
2568 | int |
2569 | vchiq_instance_get_pid(VCHIQ_INSTANCE_T instance) |
2570 | { |
2571 | return instance->pid; |
2572 | } |
2573 | |
2574 | int |
2575 | vchiq_instance_get_trace(VCHIQ_INSTANCE_T instance) |
2576 | { |
2577 | return instance->trace; |
2578 | } |
2579 | |
2580 | void |
2581 | vchiq_instance_set_trace(VCHIQ_INSTANCE_T instance, int trace) |
2582 | { |
2583 | VCHIQ_SERVICE_T *service; |
2584 | int i; |
2585 | i = 0; |
2586 | while ((service = next_service_by_instance(instance->state, |
2587 | instance, &i)) != NULL) { |
2588 | service->trace = trace; |
2589 | unlock_service(service); |
2590 | } |
2591 | instance->trace = (trace != 0); |
2592 | } |
2593 | |
2594 | static void suspend_timer_callback(unsigned long context) |
2595 | { |
2596 | VCHIQ_STATE_T *state = (VCHIQ_STATE_T *)context; |
2597 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2598 | if (!arm_state) |
2599 | goto out; |
2600 | vchiq_log_info(vchiq_susp_log_level, |
2601 | "%s - suspend timer expired - check suspend", __func__); |
2602 | vchiq_check_suspend(state); |
2603 | out: |
2604 | return; |
2605 | } |
2606 | |
2607 | VCHIQ_STATUS_T |
2608 | vchiq_use_service_no_resume(VCHIQ_SERVICE_HANDLE_T handle) |
2609 | { |
2610 | VCHIQ_STATUS_T ret = VCHIQ_ERROR; |
2611 | VCHIQ_SERVICE_T *service = find_service_by_handle(handle); |
2612 | if (service) { |
2613 | ret = vchiq_use_internal(service->state, service, |
2614 | USE_TYPE_SERVICE_NO_RESUME); |
2615 | unlock_service(service); |
2616 | } |
2617 | return ret; |
2618 | } |
2619 | |
2620 | VCHIQ_STATUS_T |
2621 | vchiq_use_service(VCHIQ_SERVICE_HANDLE_T handle) |
2622 | { |
2623 | VCHIQ_STATUS_T ret = VCHIQ_ERROR; |
2624 | VCHIQ_SERVICE_T *service = find_service_by_handle(handle); |
2625 | if (service) { |
2626 | ret = vchiq_use_internal(service->state, service, |
2627 | USE_TYPE_SERVICE); |
2628 | unlock_service(service); |
2629 | } |
2630 | return ret; |
2631 | } |
2632 | |
2633 | VCHIQ_STATUS_T |
2634 | vchiq_release_service(VCHIQ_SERVICE_HANDLE_T handle) |
2635 | { |
2636 | VCHIQ_STATUS_T ret = VCHIQ_ERROR; |
2637 | VCHIQ_SERVICE_T *service = find_service_by_handle(handle); |
2638 | if (service) { |
2639 | ret = vchiq_release_internal(service->state, service); |
2640 | unlock_service(service); |
2641 | } |
2642 | return ret; |
2643 | } |
2644 | |
2645 | void |
2646 | vchiq_dump_service_use_state(VCHIQ_STATE_T *state) |
2647 | { |
2648 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2649 | int i, j = 0; |
2650 | /* Only dump 64 services */ |
2651 | static const int local_max_services = 64; |
2652 | /* If there's more than 64 services, only dump ones with |
2653 | * non-zero counts */ |
2654 | int only_nonzero = 0; |
2655 | static const char *nz = "<-- preventing suspend"; |
2656 | |
2657 | enum vc_suspend_status vc_suspend_state; |
2658 | enum vc_resume_status vc_resume_state; |
2659 | int peer_count; |
2660 | int vc_use_count; |
2661 | int active_services; |
2662 | struct service_data_struct { |
2663 | int fourcc; |
2664 | int clientid; |
2665 | int use_count; |
2666 | } service_data[local_max_services]; |
2667 | |
2668 | if (!arm_state) |
2669 | return; |
2670 | |
2671 | read_lock_bh(&arm_state->susp_res_lock); |
2672 | vc_suspend_state = arm_state->vc_suspend_state; |
2673 | vc_resume_state = arm_state->vc_resume_state; |
2674 | peer_count = arm_state->peer_use_count; |
2675 | vc_use_count = arm_state->videocore_use_count; |
2676 | active_services = state->unused_service; |
2677 | if (active_services > local_max_services) |
2678 | only_nonzero = 1; |
2679 | |
2680 | for (i = 0; (i < active_services) && (j < local_max_services); i++) { |
2681 | VCHIQ_SERVICE_T *service_ptr = state->services[i]; |
2682 | if (!service_ptr) |
2683 | continue; |
2684 | |
2685 | if (only_nonzero && !service_ptr->service_use_count) |
2686 | continue; |
2687 | |
2688 | if (service_ptr->srvstate != VCHIQ_SRVSTATE_FREE) { |
2689 | service_data[j].fourcc = service_ptr->base.fourcc; |
2690 | service_data[j].clientid = service_ptr->client_id; |
2691 | service_data[j++].use_count = service_ptr-> |
2692 | service_use_count; |
2693 | } |
2694 | } |
2695 | |
2696 | read_unlock_bh(&arm_state->susp_res_lock); |
2697 | |
2698 | vchiq_log_warning(vchiq_susp_log_level, |
2699 | "-- Videcore suspend state: %s --", |
2700 | suspend_state_names[vc_suspend_state + VC_SUSPEND_NUM_OFFSET]); |
2701 | vchiq_log_warning(vchiq_susp_log_level, |
2702 | "-- Videcore resume state: %s --", |
2703 | resume_state_names[vc_resume_state + VC_RESUME_NUM_OFFSET]); |
2704 | |
2705 | if (only_nonzero) |
2706 | vchiq_log_warning(vchiq_susp_log_level, "Too many active " |
2707 | "services (%d). Only dumping up to first %d services " |
2708 | "with non-zero use-count", active_services, |
2709 | local_max_services); |
2710 | |
2711 | for (i = 0; i < j; i++) { |
2712 | vchiq_log_warning(vchiq_susp_log_level, |
2713 | "----- %c%c%c%c:%d service count %d %s", |
2714 | VCHIQ_FOURCC_AS_4CHARS(service_data[i].fourcc), |
2715 | service_data[i].clientid, |
2716 | service_data[i].use_count, |
2717 | service_data[i].use_count ? nz : ""); |
2718 | } |
2719 | vchiq_log_warning(vchiq_susp_log_level, |
2720 | "----- VCHIQ use count count %d", peer_count); |
2721 | vchiq_log_warning(vchiq_susp_log_level, |
2722 | "--- Overall vchiq instance use count %d", vc_use_count); |
2723 | |
2724 | vchiq_dump_platform_use_state(state); |
2725 | } |
2726 | |
2727 | VCHIQ_STATUS_T |
2728 | vchiq_check_service(VCHIQ_SERVICE_T *service) |
2729 | { |
2730 | VCHIQ_ARM_STATE_T *arm_state; |
2731 | VCHIQ_STATUS_T ret = VCHIQ_ERROR; |
2732 | |
2733 | if (!service || !service->state) |
2734 | goto out; |
2735 | |
2736 | vchiq_log_trace(vchiq_susp_log_level, "%s", __func__); |
2737 | |
2738 | arm_state = vchiq_platform_get_arm_state(service->state); |
2739 | |
2740 | read_lock_bh(&arm_state->susp_res_lock); |
2741 | if (service->service_use_count) |
2742 | ret = VCHIQ_SUCCESS; |
2743 | read_unlock_bh(&arm_state->susp_res_lock); |
2744 | |
2745 | if (ret == VCHIQ_ERROR) { |
2746 | vchiq_log_error(vchiq_susp_log_level, |
2747 | "%s ERROR - %c%c%c%c:%d service count %d, " |
2748 | "state count %d, videocore suspend state %s", __func__, |
2749 | VCHIQ_FOURCC_AS_4CHARS(service->base.fourcc), |
2750 | service->client_id, service->service_use_count, |
2751 | arm_state->videocore_use_count, |
2752 | suspend_state_names[arm_state->vc_suspend_state + |
2753 | VC_SUSPEND_NUM_OFFSET]); |
2754 | vchiq_dump_service_use_state(service->state); |
2755 | } |
2756 | out: |
2757 | return ret; |
2758 | } |
2759 | |
2760 | /* stub functions */ |
2761 | void vchiq_on_remote_use_active(VCHIQ_STATE_T *state) |
2762 | { |
2763 | (void)state; |
2764 | } |
2765 | |
2766 | void vchiq_platform_conn_state_changed(VCHIQ_STATE_T *state, |
2767 | VCHIQ_CONNSTATE_T oldstate, VCHIQ_CONNSTATE_T newstate) |
2768 | { |
2769 | VCHIQ_ARM_STATE_T *arm_state = vchiq_platform_get_arm_state(state); |
2770 | vchiq_log_info(vchiq_susp_log_level, "%d: %s->%s", state->id, |
2771 | get_conn_state_name(oldstate), get_conn_state_name(newstate)); |
2772 | if (state->conn_state == VCHIQ_CONNSTATE_CONNECTED) { |
2773 | write_lock_bh(&arm_state->susp_res_lock); |
2774 | if (!arm_state->first_connect) { |
2775 | char threadname[10]; |
2776 | arm_state->first_connect = 1; |
2777 | write_unlock_bh(&arm_state->susp_res_lock); |
2778 | snprintf(threadname, sizeof(threadname), "VCHIQka-%d", |
2779 | state->id); |
2780 | arm_state->ka_thread = kthread_create( |
2781 | &vchiq_keepalive_thread_func, |
2782 | (void *)state, |
2783 | threadname); |
2784 | if (arm_state->ka_thread == NULL) { |
2785 | vchiq_log_error(vchiq_susp_log_level, |
2786 | "vchiq: FATAL: couldn't create thread %s", |
2787 | threadname); |
2788 | } else { |
2789 | wake_up_process(arm_state->ka_thread); |
2790 | } |
2791 | } else |
2792 | write_unlock_bh(&arm_state->susp_res_lock); |
2793 | } |
2794 | } |
2795 | |
2796 | static int vchiq_probe(struct platform_device *pdev) |
2797 | { |
2798 | struct device_node *fw_node; |
2799 | struct rpi_firmware *fw; |
2800 | int err; |
2801 | void *ptr_err; |
2802 | |
2803 | fw_node = of_parse_phandle(pdev->dev.of_node, "firmware", 0); |
2804 | /* Remove comment when booting without Device Tree is no longer supported |
2805 | if (!fw_node) { |
2806 | dev_err(&pdev->dev, "Missing firmware node\n"); |
2807 | return -ENOENT; |
2808 | } |
2809 | */ |
2810 | fw = rpi_firmware_get(fw_node); |
2811 | if (!fw) |
2812 | return -EPROBE_DEFER; |
2813 | |
2814 | platform_set_drvdata(pdev, fw); |
2815 | |
2816 | /* create debugfs entries */ |
2817 | err = vchiq_debugfs_init(); |
2818 | if (err != 0) |
2819 | goto failed_debugfs_init; |
2820 | |
2821 | err = alloc_chrdev_region(&vchiq_devid, VCHIQ_MINOR, 1, DEVICE_NAME); |
2822 | if (err != 0) { |
2823 | vchiq_log_error(vchiq_arm_log_level, |
2824 | "Unable to allocate device number"); |
2825 | goto failed_alloc_chrdev; |
2826 | } |
2827 | cdev_init(&vchiq_cdev, &vchiq_fops); |
2828 | vchiq_cdev.owner = THIS_MODULE; |
2829 | err = cdev_add(&vchiq_cdev, vchiq_devid, 1); |
2830 | if (err != 0) { |
2831 | vchiq_log_error(vchiq_arm_log_level, |
2832 | "Unable to register device"); |
2833 | goto failed_cdev_add; |
2834 | } |
2835 | |
2836 | /* create sysfs entries */ |
2837 | vchiq_class = class_create(THIS_MODULE, DEVICE_NAME); |
2838 | ptr_err = vchiq_class; |
2839 | if (IS_ERR(ptr_err)) |
2840 | goto failed_class_create; |
2841 | |
2842 | vchiq_dev = device_create(vchiq_class, NULL, |
2843 | vchiq_devid, NULL, "vchiq"); |
2844 | ptr_err = vchiq_dev; |
2845 | if (IS_ERR(ptr_err)) |
2846 | goto failed_device_create; |
2847 | |
2848 | err = vchiq_platform_init(pdev, &g_state); |
2849 | if (err != 0) |
2850 | goto failed_platform_init; |
2851 | |
2852 | vchiq_log_info(vchiq_arm_log_level, |
2853 | "vchiq: initialised - version %d (min %d), device %d.%d", |
2854 | VCHIQ_VERSION, VCHIQ_VERSION_MIN, |
2855 | MAJOR(vchiq_devid), MINOR(vchiq_devid)); |
2856 | |
2857 | return 0; |
2858 | |
2859 | failed_platform_init: |
2860 | device_destroy(vchiq_class, vchiq_devid); |
2861 | failed_device_create: |
2862 | class_destroy(vchiq_class); |
2863 | failed_class_create: |
2864 | cdev_del(&vchiq_cdev); |
2865 | err = PTR_ERR(ptr_err); |
2866 | failed_cdev_add: |
2867 | unregister_chrdev_region(vchiq_devid, 1); |
2868 | failed_alloc_chrdev: |
2869 | vchiq_debugfs_deinit(); |
2870 | failed_debugfs_init: |
2871 | vchiq_log_warning(vchiq_arm_log_level, "could not load vchiq"); |
2872 | return err; |
2873 | } |
2874 | |
2875 | static int vchiq_remove(struct platform_device *pdev) |
2876 | { |
2877 | device_destroy(vchiq_class, vchiq_devid); |
2878 | class_destroy(vchiq_class); |
2879 | cdev_del(&vchiq_cdev); |
2880 | unregister_chrdev_region(vchiq_devid, 1); |
2881 | |
2882 | return 0; |
2883 | } |
2884 | |
2885 | static const struct of_device_id vchiq_of_match[] = { |
2886 | { .compatible = "brcm,bcm2835-vchiq", }, |
2887 | {}, |
2888 | }; |
2889 | MODULE_DEVICE_TABLE(of, vchiq_of_match); |
2890 | |
2891 | static struct platform_driver vchiq_driver = { |
2892 | .driver = { |
2893 | .name = "bcm2835_vchiq", |
2894 | .owner = THIS_MODULE, |
2895 | .of_match_table = vchiq_of_match, |
2896 | }, |
2897 | .probe = vchiq_probe, |
2898 | .remove = vchiq_remove, |
2899 | }; |
2900 | module_platform_driver(vchiq_driver); |
2901 | |
2902 | MODULE_LICENSE("GPL"); |
2903 | MODULE_AUTHOR("Broadcom Corporation"); |