1c167b9c7SMaximilian Luz /* SPDX-License-Identifier: GPL-2.0+ */
2c167b9c7SMaximilian Luz /*
3c167b9c7SMaximilian Luz * Main SSAM/SSH controller structure and functionality.
4c167b9c7SMaximilian Luz *
5*221756e6SMaximilian Luz * Copyright (C) 2019-2022 Maximilian Luz <luzmaximilian@gmail.com>
6c167b9c7SMaximilian Luz */
7c167b9c7SMaximilian Luz
8c167b9c7SMaximilian Luz #ifndef _SURFACE_AGGREGATOR_CONTROLLER_H
9c167b9c7SMaximilian Luz #define _SURFACE_AGGREGATOR_CONTROLLER_H
10c167b9c7SMaximilian Luz
11c167b9c7SMaximilian Luz #include <linux/kref.h>
12c167b9c7SMaximilian Luz #include <linux/list.h>
13c167b9c7SMaximilian Luz #include <linux/mutex.h>
14c167b9c7SMaximilian Luz #include <linux/rbtree.h>
15c167b9c7SMaximilian Luz #include <linux/rwsem.h>
16c167b9c7SMaximilian Luz #include <linux/serdev.h>
17c167b9c7SMaximilian Luz #include <linux/spinlock.h>
18c167b9c7SMaximilian Luz #include <linux/srcu.h>
19c167b9c7SMaximilian Luz #include <linux/types.h>
20c167b9c7SMaximilian Luz #include <linux/workqueue.h>
21c167b9c7SMaximilian Luz
22c167b9c7SMaximilian Luz #include <linux/surface_aggregator/controller.h>
23c167b9c7SMaximilian Luz #include <linux/surface_aggregator/serial_hub.h>
24c167b9c7SMaximilian Luz
25c167b9c7SMaximilian Luz #include "ssh_request_layer.h"
26c167b9c7SMaximilian Luz
27c167b9c7SMaximilian Luz
28c167b9c7SMaximilian Luz /* -- Safe counters. -------------------------------------------------------- */
29c167b9c7SMaximilian Luz
30c167b9c7SMaximilian Luz /**
31c167b9c7SMaximilian Luz * struct ssh_seq_counter - Safe counter for SSH sequence IDs.
32c167b9c7SMaximilian Luz * @value: The current counter value.
33c167b9c7SMaximilian Luz */
34c167b9c7SMaximilian Luz struct ssh_seq_counter {
35c167b9c7SMaximilian Luz u8 value;
36c167b9c7SMaximilian Luz };
37c167b9c7SMaximilian Luz
38c167b9c7SMaximilian Luz /**
39c167b9c7SMaximilian Luz * struct ssh_rqid_counter - Safe counter for SSH request IDs.
40c167b9c7SMaximilian Luz * @value: The current counter value.
41c167b9c7SMaximilian Luz */
42c167b9c7SMaximilian Luz struct ssh_rqid_counter {
43c167b9c7SMaximilian Luz u16 value;
44c167b9c7SMaximilian Luz };
45c167b9c7SMaximilian Luz
46c167b9c7SMaximilian Luz
47c167b9c7SMaximilian Luz /* -- Event/notification system. -------------------------------------------- */
48c167b9c7SMaximilian Luz
49c167b9c7SMaximilian Luz /**
50c167b9c7SMaximilian Luz * struct ssam_nf_head - Notifier head for SSAM events.
51c167b9c7SMaximilian Luz * @srcu: The SRCU struct for synchronization.
52c167b9c7SMaximilian Luz * @head: List-head for notifier blocks registered under this head.
53c167b9c7SMaximilian Luz */
54c167b9c7SMaximilian Luz struct ssam_nf_head {
55c167b9c7SMaximilian Luz struct srcu_struct srcu;
56c167b9c7SMaximilian Luz struct list_head head;
57c167b9c7SMaximilian Luz };
58c167b9c7SMaximilian Luz
59c167b9c7SMaximilian Luz /**
60c167b9c7SMaximilian Luz * struct ssam_nf - Notifier callback- and activation-registry for SSAM events.
61c167b9c7SMaximilian Luz * @lock: Lock guarding (de-)registration of notifier blocks. Note: This
62c167b9c7SMaximilian Luz * lock does not need to be held for notifier calls, only
63c167b9c7SMaximilian Luz * registration and deregistration.
64c167b9c7SMaximilian Luz * @refcount: The root of the RB-tree used for reference-counting enabled
65c167b9c7SMaximilian Luz * events/notifications.
66c167b9c7SMaximilian Luz * @head: The list of notifier heads for event/notification callbacks.
67c167b9c7SMaximilian Luz */
68c167b9c7SMaximilian Luz struct ssam_nf {
69c167b9c7SMaximilian Luz struct mutex lock;
70c167b9c7SMaximilian Luz struct rb_root refcount;
71c167b9c7SMaximilian Luz struct ssam_nf_head head[SSH_NUM_EVENTS];
72c167b9c7SMaximilian Luz };
73c167b9c7SMaximilian Luz
74c167b9c7SMaximilian Luz
75c167b9c7SMaximilian Luz /* -- Event/async request completion system. -------------------------------- */
76c167b9c7SMaximilian Luz
77c167b9c7SMaximilian Luz struct ssam_cplt;
78c167b9c7SMaximilian Luz
79c167b9c7SMaximilian Luz /**
80c167b9c7SMaximilian Luz * struct ssam_event_item - Struct for event queuing and completion.
81c167b9c7SMaximilian Luz * @node: The node in the queue.
82c167b9c7SMaximilian Luz * @rqid: The request ID of the event.
833a7081f6SMaximilian Luz * @ops: Instance specific functions.
843a7081f6SMaximilian Luz * @ops.free: Callback for freeing this event item.
85c167b9c7SMaximilian Luz * @event: Actual event data.
86c167b9c7SMaximilian Luz */
87c167b9c7SMaximilian Luz struct ssam_event_item {
88c167b9c7SMaximilian Luz struct list_head node;
89c167b9c7SMaximilian Luz u16 rqid;
90c167b9c7SMaximilian Luz
913a7081f6SMaximilian Luz struct {
923a7081f6SMaximilian Luz void (*free)(struct ssam_event_item *event);
933a7081f6SMaximilian Luz } ops;
943a7081f6SMaximilian Luz
95c167b9c7SMaximilian Luz struct ssam_event event; /* must be last */
96c167b9c7SMaximilian Luz };
97c167b9c7SMaximilian Luz
98c167b9c7SMaximilian Luz /**
99c167b9c7SMaximilian Luz * struct ssam_event_queue - Queue for completing received events.
100c167b9c7SMaximilian Luz * @cplt: Reference to the completion system on which this queue is active.
101c167b9c7SMaximilian Luz * @lock: The lock for any operation on the queue.
102c167b9c7SMaximilian Luz * @head: The list-head of the queue.
103c167b9c7SMaximilian Luz * @work: The &struct work_struct performing completion work for this queue.
104c167b9c7SMaximilian Luz */
105c167b9c7SMaximilian Luz struct ssam_event_queue {
106c167b9c7SMaximilian Luz struct ssam_cplt *cplt;
107c167b9c7SMaximilian Luz
108c167b9c7SMaximilian Luz spinlock_t lock;
109c167b9c7SMaximilian Luz struct list_head head;
110c167b9c7SMaximilian Luz struct work_struct work;
111c167b9c7SMaximilian Luz };
112c167b9c7SMaximilian Luz
113c167b9c7SMaximilian Luz /**
114c167b9c7SMaximilian Luz * struct ssam_event_target - Set of queues for a single SSH target ID.
115c167b9c7SMaximilian Luz * @queue: The array of queues, one queue per event ID.
116c167b9c7SMaximilian Luz */
117c167b9c7SMaximilian Luz struct ssam_event_target {
118c167b9c7SMaximilian Luz struct ssam_event_queue queue[SSH_NUM_EVENTS];
119c167b9c7SMaximilian Luz };
120c167b9c7SMaximilian Luz
121c167b9c7SMaximilian Luz /**
122c167b9c7SMaximilian Luz * struct ssam_cplt - SSAM event/async request completion system.
123c167b9c7SMaximilian Luz * @dev: The device with which this system is associated. Only used
124c167b9c7SMaximilian Luz * for logging.
125c167b9c7SMaximilian Luz * @wq: The &struct workqueue_struct on which all completion work
126c167b9c7SMaximilian Luz * items are queued.
127c167b9c7SMaximilian Luz * @event: Event completion management.
128c167b9c7SMaximilian Luz * @event.target: Array of &struct ssam_event_target, one for each target.
129c167b9c7SMaximilian Luz * @event.notif: Notifier callbacks and event activation reference counting.
130c167b9c7SMaximilian Luz */
131c167b9c7SMaximilian Luz struct ssam_cplt {
132c167b9c7SMaximilian Luz struct device *dev;
133c167b9c7SMaximilian Luz struct workqueue_struct *wq;
134c167b9c7SMaximilian Luz
135c167b9c7SMaximilian Luz struct {
136c167b9c7SMaximilian Luz struct ssam_event_target target[SSH_NUM_TARGETS];
137c167b9c7SMaximilian Luz struct ssam_nf notif;
138c167b9c7SMaximilian Luz } event;
139c167b9c7SMaximilian Luz };
140c167b9c7SMaximilian Luz
141c167b9c7SMaximilian Luz
142c167b9c7SMaximilian Luz /* -- Main SSAM device structures. ------------------------------------------ */
143c167b9c7SMaximilian Luz
144c167b9c7SMaximilian Luz /**
145c167b9c7SMaximilian Luz * enum ssam_controller_state - State values for &struct ssam_controller.
146c167b9c7SMaximilian Luz * @SSAM_CONTROLLER_UNINITIALIZED:
147c167b9c7SMaximilian Luz * The controller has not been initialized yet or has been deinitialized.
148c167b9c7SMaximilian Luz * @SSAM_CONTROLLER_INITIALIZED:
149c167b9c7SMaximilian Luz * The controller is initialized, but has not been started yet.
150c167b9c7SMaximilian Luz * @SSAM_CONTROLLER_STARTED:
151c167b9c7SMaximilian Luz * The controller has been started and is ready to use.
152c167b9c7SMaximilian Luz * @SSAM_CONTROLLER_STOPPED:
153c167b9c7SMaximilian Luz * The controller has been stopped.
154c167b9c7SMaximilian Luz * @SSAM_CONTROLLER_SUSPENDED:
155c167b9c7SMaximilian Luz * The controller has been suspended.
156c167b9c7SMaximilian Luz */
157c167b9c7SMaximilian Luz enum ssam_controller_state {
158c167b9c7SMaximilian Luz SSAM_CONTROLLER_UNINITIALIZED,
159c167b9c7SMaximilian Luz SSAM_CONTROLLER_INITIALIZED,
160c167b9c7SMaximilian Luz SSAM_CONTROLLER_STARTED,
161c167b9c7SMaximilian Luz SSAM_CONTROLLER_STOPPED,
162c167b9c7SMaximilian Luz SSAM_CONTROLLER_SUSPENDED,
163c167b9c7SMaximilian Luz };
164c167b9c7SMaximilian Luz
165c167b9c7SMaximilian Luz /**
166c167b9c7SMaximilian Luz * struct ssam_controller_caps - Controller device capabilities.
167c167b9c7SMaximilian Luz * @ssh_power_profile: SSH power profile.
168c167b9c7SMaximilian Luz * @ssh_buffer_size: SSH driver UART buffer size.
169c167b9c7SMaximilian Luz * @screen_on_sleep_idle_timeout: SAM UART screen-on sleep idle timeout.
170c167b9c7SMaximilian Luz * @screen_off_sleep_idle_timeout: SAM UART screen-off sleep idle timeout.
171c167b9c7SMaximilian Luz * @d3_closes_handle: SAM closes UART handle in D3.
172c167b9c7SMaximilian Luz *
173c167b9c7SMaximilian Luz * Controller and SSH device capabilities found in ACPI.
174c167b9c7SMaximilian Luz */
175c167b9c7SMaximilian Luz struct ssam_controller_caps {
176c167b9c7SMaximilian Luz u32 ssh_power_profile;
177c167b9c7SMaximilian Luz u32 ssh_buffer_size;
178c167b9c7SMaximilian Luz u32 screen_on_sleep_idle_timeout;
179c167b9c7SMaximilian Luz u32 screen_off_sleep_idle_timeout;
180c167b9c7SMaximilian Luz u32 d3_closes_handle:1;
181c167b9c7SMaximilian Luz };
182c167b9c7SMaximilian Luz
183c167b9c7SMaximilian Luz /**
184c167b9c7SMaximilian Luz * struct ssam_controller - SSAM controller device.
185c167b9c7SMaximilian Luz * @kref: Reference count of the controller.
186c167b9c7SMaximilian Luz * @lock: Main lock for the controller, used to guard state changes.
187c167b9c7SMaximilian Luz * @state: Controller state.
188c167b9c7SMaximilian Luz * @rtl: Request transport layer for SSH I/O.
189c167b9c7SMaximilian Luz * @cplt: Completion system for SSH/SSAM events and asynchronous requests.
190c167b9c7SMaximilian Luz * @counter: Safe SSH message ID counters.
191c167b9c7SMaximilian Luz * @counter.seq: Sequence ID counter.
192c167b9c7SMaximilian Luz * @counter.rqid: Request ID counter.
193c167b9c7SMaximilian Luz * @irq: Wakeup IRQ resources.
194c167b9c7SMaximilian Luz * @irq.num: The wakeup IRQ number.
195c167b9c7SMaximilian Luz * @irq.wakeup_enabled: Whether wakeup by IRQ is enabled during suspend.
196c167b9c7SMaximilian Luz * @caps: The controller device capabilities.
197c167b9c7SMaximilian Luz */
198c167b9c7SMaximilian Luz struct ssam_controller {
199c167b9c7SMaximilian Luz struct kref kref;
200c167b9c7SMaximilian Luz
201c167b9c7SMaximilian Luz struct rw_semaphore lock;
202c167b9c7SMaximilian Luz enum ssam_controller_state state;
203c167b9c7SMaximilian Luz
204c167b9c7SMaximilian Luz struct ssh_rtl rtl;
205c167b9c7SMaximilian Luz struct ssam_cplt cplt;
206c167b9c7SMaximilian Luz
207c167b9c7SMaximilian Luz struct {
208c167b9c7SMaximilian Luz struct ssh_seq_counter seq;
209c167b9c7SMaximilian Luz struct ssh_rqid_counter rqid;
210c167b9c7SMaximilian Luz } counter;
211c167b9c7SMaximilian Luz
212c167b9c7SMaximilian Luz struct {
213c167b9c7SMaximilian Luz int num;
214c167b9c7SMaximilian Luz bool wakeup_enabled;
215c167b9c7SMaximilian Luz } irq;
216c167b9c7SMaximilian Luz
217c167b9c7SMaximilian Luz struct ssam_controller_caps caps;
218c167b9c7SMaximilian Luz };
219c167b9c7SMaximilian Luz
220c167b9c7SMaximilian Luz #define to_ssam_controller(ptr, member) \
221c167b9c7SMaximilian Luz container_of(ptr, struct ssam_controller, member)
222c167b9c7SMaximilian Luz
223c167b9c7SMaximilian Luz #define ssam_dbg(ctrl, fmt, ...) rtl_dbg(&(ctrl)->rtl, fmt, ##__VA_ARGS__)
224c167b9c7SMaximilian Luz #define ssam_info(ctrl, fmt, ...) rtl_info(&(ctrl)->rtl, fmt, ##__VA_ARGS__)
225c167b9c7SMaximilian Luz #define ssam_warn(ctrl, fmt, ...) rtl_warn(&(ctrl)->rtl, fmt, ##__VA_ARGS__)
226c167b9c7SMaximilian Luz #define ssam_err(ctrl, fmt, ...) rtl_err(&(ctrl)->rtl, fmt, ##__VA_ARGS__)
227c167b9c7SMaximilian Luz
228c167b9c7SMaximilian Luz /**
229c167b9c7SMaximilian Luz * ssam_controller_receive_buf() - Provide input-data to the controller.
230c167b9c7SMaximilian Luz * @ctrl: The controller.
231c167b9c7SMaximilian Luz * @buf: The input buffer.
232c167b9c7SMaximilian Luz * @n: The number of bytes in the input buffer.
233c167b9c7SMaximilian Luz *
234c167b9c7SMaximilian Luz * Provide input data to be evaluated by the controller, which has been
235c167b9c7SMaximilian Luz * received via the lower-level transport.
236c167b9c7SMaximilian Luz *
237c167b9c7SMaximilian Luz * Return: Returns the number of bytes consumed, or, if the packet transport
238c167b9c7SMaximilian Luz * layer of the controller has been shut down, %-ESHUTDOWN.
239c167b9c7SMaximilian Luz */
240c167b9c7SMaximilian Luz static inline
ssam_controller_receive_buf(struct ssam_controller * ctrl,const unsigned char * buf,size_t n)241c167b9c7SMaximilian Luz int ssam_controller_receive_buf(struct ssam_controller *ctrl,
242c167b9c7SMaximilian Luz const unsigned char *buf, size_t n)
243c167b9c7SMaximilian Luz {
244c167b9c7SMaximilian Luz return ssh_ptl_rx_rcvbuf(&ctrl->rtl.ptl, buf, n);
245c167b9c7SMaximilian Luz }
246c167b9c7SMaximilian Luz
247c167b9c7SMaximilian Luz /**
248c167b9c7SMaximilian Luz * ssam_controller_write_wakeup() - Notify the controller that the underlying
249c167b9c7SMaximilian Luz * device has space available for data to be written.
250c167b9c7SMaximilian Luz * @ctrl: The controller.
251c167b9c7SMaximilian Luz */
ssam_controller_write_wakeup(struct ssam_controller * ctrl)252c167b9c7SMaximilian Luz static inline void ssam_controller_write_wakeup(struct ssam_controller *ctrl)
253c167b9c7SMaximilian Luz {
254c167b9c7SMaximilian Luz ssh_ptl_tx_wakeup_transfer(&ctrl->rtl.ptl);
255c167b9c7SMaximilian Luz }
256c167b9c7SMaximilian Luz
257c167b9c7SMaximilian Luz int ssam_controller_init(struct ssam_controller *ctrl, struct serdev_device *s);
258c167b9c7SMaximilian Luz int ssam_controller_start(struct ssam_controller *ctrl);
259c167b9c7SMaximilian Luz void ssam_controller_shutdown(struct ssam_controller *ctrl);
260c167b9c7SMaximilian Luz void ssam_controller_destroy(struct ssam_controller *ctrl);
261c167b9c7SMaximilian Luz
262c167b9c7SMaximilian Luz int ssam_notifier_disable_registered(struct ssam_controller *ctrl);
263c167b9c7SMaximilian Luz void ssam_notifier_restore_registered(struct ssam_controller *ctrl);
264c167b9c7SMaximilian Luz
265c167b9c7SMaximilian Luz int ssam_irq_setup(struct ssam_controller *ctrl);
266c167b9c7SMaximilian Luz void ssam_irq_free(struct ssam_controller *ctrl);
267c167b9c7SMaximilian Luz int ssam_irq_arm_for_wakeup(struct ssam_controller *ctrl);
268c167b9c7SMaximilian Luz void ssam_irq_disarm_wakeup(struct ssam_controller *ctrl);
269c167b9c7SMaximilian Luz
270c167b9c7SMaximilian Luz void ssam_controller_lock(struct ssam_controller *c);
271c167b9c7SMaximilian Luz void ssam_controller_unlock(struct ssam_controller *c);
272c167b9c7SMaximilian Luz
273c167b9c7SMaximilian Luz int ssam_get_firmware_version(struct ssam_controller *ctrl, u32 *version);
274c167b9c7SMaximilian Luz int ssam_ctrl_notif_display_off(struct ssam_controller *ctrl);
275c167b9c7SMaximilian Luz int ssam_ctrl_notif_display_on(struct ssam_controller *ctrl);
276c167b9c7SMaximilian Luz int ssam_ctrl_notif_d0_exit(struct ssam_controller *ctrl);
277c167b9c7SMaximilian Luz int ssam_ctrl_notif_d0_entry(struct ssam_controller *ctrl);
278c167b9c7SMaximilian Luz
279c167b9c7SMaximilian Luz int ssam_controller_suspend(struct ssam_controller *ctrl);
280c167b9c7SMaximilian Luz int ssam_controller_resume(struct ssam_controller *ctrl);
281c167b9c7SMaximilian Luz
2823a7081f6SMaximilian Luz int ssam_event_item_cache_init(void);
2833a7081f6SMaximilian Luz void ssam_event_item_cache_destroy(void);
2843a7081f6SMaximilian Luz
285c167b9c7SMaximilian Luz #endif /* _SURFACE_AGGREGATOR_CONTROLLER_H */
286