1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
3 * Copyright (c) 2014 Raspberry Pi (Trading) Ltd. All rights reserved.
4 * Copyright (c) 2010-2012 Broadcom. All rights reserved.
10 #include <linux/mutex.h>
11 #include <linux/platform_device.h>
12 #include <linux/semaphore.h>
13 #include <linux/atomic.h>
14 #include "vchiq_core.h"
15 #include "vchiq_debugfs.h"
17 enum vc_suspend_status {
18 VC_SUSPEND_FORCE_CANCELED = -3, /* Force suspend canceled, too busy */
19 VC_SUSPEND_REJECTED = -2, /* Videocore rejected suspend request */
20 VC_SUSPEND_FAILED = -1, /* Videocore suspend failed */
21 VC_SUSPEND_IDLE = 0, /* VC active, no suspend actions */
22 VC_SUSPEND_REQUESTED, /* User has requested suspend */
23 VC_SUSPEND_IN_PROGRESS, /* Slot handler has recvd suspend request */
24 VC_SUSPEND_SUSPENDED /* Videocore suspend succeeded */
27 enum vc_resume_status {
28 VC_RESUME_FAILED = -1, /* Videocore resume failed */
29 VC_RESUME_IDLE = 0, /* VC suspended, no resume actions */
30 VC_RESUME_REQUESTED, /* User has requested resume */
31 VC_RESUME_IN_PROGRESS, /* Slot handler has received resume request */
32 VC_RESUME_RESUMED /* Videocore resumed successfully (active) */
37 USE_TYPE_SERVICE_NO_RESUME,
41 struct vchiq_arm_state {
42 /* Keepalive-related data */
43 struct task_struct *ka_thread;
44 struct completion ka_evt;
45 atomic_t ka_use_count;
46 atomic_t ka_use_ack_count;
47 atomic_t ka_release_count;
49 struct completion vc_suspend_complete;
50 struct completion vc_resume_complete;
52 rwlock_t susp_res_lock;
53 enum vc_suspend_status vc_suspend_state;
54 enum vc_resume_status vc_resume_state;
56 unsigned int wake_address;
58 struct vchiq_state *state;
59 struct timer_list suspend_timer;
60 int suspend_timer_timeout;
61 int suspend_timer_running;
63 /* Global use count for videocore.
64 ** This is equal to the sum of the use counts for all services. When
65 ** this hits zero the videocore suspend procedure will be initiated.
67 int videocore_use_count;
69 /* Use count to track requests from videocore peer.
70 ** This use count is not associated with a service, so needs to be
71 ** tracked separately with the state.
75 /* Flag to indicate whether resume is blocked. This happens when the
78 struct completion resume_blocker;
80 struct completion blocked_blocker;
83 int autosuspend_override;
85 /* Flag to indicate that the first vchiq connect has made it through.
86 ** This means that both sides should be fully ready, and we should
87 ** be able to suspend after this point.
91 unsigned long long suspend_start_time;
92 unsigned long long sleep_start_time;
93 unsigned long long resume_start_time;
94 unsigned long long last_wake_time;
98 struct vchiq_drvdata {
99 const unsigned int cache_line_size;
100 struct rpi_firmware *fw;
103 extern int vchiq_arm_log_level;
104 extern int vchiq_susp_log_level;
106 int vchiq_platform_init(struct platform_device *pdev,
107 struct vchiq_state *state);
109 extern struct vchiq_state *
110 vchiq_get_state(void);
112 extern VCHIQ_STATUS_T
113 vchiq_arm_vcsuspend(struct vchiq_state *state);
115 extern VCHIQ_STATUS_T
116 vchiq_arm_vcresume(struct vchiq_state *state);
118 extern VCHIQ_STATUS_T
119 vchiq_arm_init_state(struct vchiq_state *state,
120 struct vchiq_arm_state *arm_state);
123 vchiq_check_resume(struct vchiq_state *state);
126 vchiq_check_suspend(struct vchiq_state *state);
128 vchiq_use_service(VCHIQ_SERVICE_HANDLE_T handle);
130 extern VCHIQ_STATUS_T
131 vchiq_release_service(VCHIQ_SERVICE_HANDLE_T handle);
133 extern VCHIQ_STATUS_T
134 vchiq_check_service(struct vchiq_service *service);
136 extern VCHIQ_STATUS_T
137 vchiq_platform_suspend(struct vchiq_state *state);
140 vchiq_platform_videocore_wanted(struct vchiq_state *state);
143 vchiq_platform_use_suspend_timer(void);
146 vchiq_dump_platform_use_state(struct vchiq_state *state);
149 vchiq_dump_service_use_state(struct vchiq_state *state);
151 extern struct vchiq_arm_state*
152 vchiq_platform_get_arm_state(struct vchiq_state *state);
155 vchiq_videocore_wanted(struct vchiq_state *state);
157 extern VCHIQ_STATUS_T
158 vchiq_use_internal(struct vchiq_state *state, struct vchiq_service *service,
159 enum USE_TYPE_E use_type);
160 extern VCHIQ_STATUS_T
161 vchiq_release_internal(struct vchiq_state *state,
162 struct vchiq_service *service);
164 extern struct vchiq_debugfs_node *
165 vchiq_instance_get_debugfs_node(VCHIQ_INSTANCE_T instance);
168 vchiq_instance_get_use_count(VCHIQ_INSTANCE_T instance);
171 vchiq_instance_get_pid(VCHIQ_INSTANCE_T instance);
174 vchiq_instance_get_trace(VCHIQ_INSTANCE_T instance);
177 vchiq_instance_set_trace(VCHIQ_INSTANCE_T instance, int trace);
180 set_suspend_state(struct vchiq_arm_state *arm_state,
181 enum vc_suspend_status new_state);
184 set_resume_state(struct vchiq_arm_state *arm_state,
185 enum vc_resume_status new_state);
188 start_suspend_timer(struct vchiq_arm_state *arm_state);
190 #endif /* VCHIQ_ARM_H */