1/*
 2 * System Trace Module (STM) infrastructure
 3 * Copyright (c) 2014, Intel Corporation.
 4 *
 5 * This program is free software; you can redistribute it and/or modify it
 6 * under the terms and conditions of the GNU General Public License,
 7 * version 2, as published by the Free Software Foundation.
 8 *
 9 * This program is distributed in the hope it will be useful, but WITHOUT
10 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
12 * more details.
13 *
14 * STM class implements generic infrastructure for  System Trace Module devices
15 * as defined in MIPI STPv2 specification.
16 */
17
18#ifndef _STM_STM_H_
19#define _STM_STM_H_
20
21struct stp_policy;
22struct stp_policy_node;
23
24struct stp_policy_node *
25stp_policy_node_lookup(struct stm_device *stm, char *s);
26void stp_policy_node_put(struct stp_policy_node *policy_node);
27void stp_policy_unbind(struct stp_policy *policy);
28
29void stp_policy_node_get_ranges(struct stp_policy_node *policy_node,
30				unsigned int *mstart, unsigned int *mend,
31				unsigned int *cstart, unsigned int *cend);
32int stp_configfs_init(void);
33void stp_configfs_exit(void);
34
35struct stp_master {
36	unsigned int	nr_free;
37	unsigned long	chan_map[0];
38};
39
40struct stm_device {
41	struct device		dev;
42	struct module		*owner;
43	struct stp_policy	*policy;
44	struct mutex		policy_mutex;
45	int			major;
46	unsigned int		sw_nmasters;
47	struct stm_data		*data;
48	struct mutex		link_mutex;
49	spinlock_t		link_lock;
50	struct list_head	link_list;
51	/* master allocation */
52	spinlock_t		mc_lock;
53	struct stp_master	*masters[0];
54};
55
56#define to_stm_device(_d)				\
57	container_of((_d), struct stm_device, dev)
58
59struct stm_output {
60	spinlock_t		lock;
61	unsigned int		master;
62	unsigned int		channel;
63	unsigned int		nr_chans;
64};
65
66struct stm_file {
67	struct stm_device	*stm;
68	struct stp_policy_node	*policy_node;
69	struct stm_output	output;
70};
71
72struct stm_device *stm_find_device(const char *name);
73void stm_put_device(struct stm_device *stm);
74
75struct stm_source_device {
76	struct device		dev;
77	struct stm_source_data	*data;
78	spinlock_t		link_lock;
79	struct stm_device __rcu	*link;
80	struct list_head	link_entry;
81	/* one output per stm_source device */
82	struct stp_policy_node	*policy_node;
83	struct stm_output	output;
84};
85
86#define to_stm_source_device(_d)				\
87	container_of((_d), struct stm_source_device, dev)
88
89#endif /* _STM_STM_H_ */

 1/* SPDX-License-Identifier: GPL-2.0 */
 2/*
 3 * System Trace Module (STM) infrastructure
 4 * Copyright (c) 2014, Intel Corporation.
 
 
 
 
 
 
 
 
 
 5 *
 6 * STM class implements generic infrastructure for  System Trace Module devices
 7 * as defined in MIPI STPv2 specification.
 8 */
 9
10#ifndef _STM_STM_H_
11#define _STM_STM_H_
12
13struct stp_policy;
14struct stp_policy_node;
15
16struct stp_policy_node *
17stp_policy_node_lookup(struct stm_device *stm, char *s);
18void stp_policy_node_put(struct stp_policy_node *policy_node);
19void stp_policy_unbind(struct stp_policy *policy);
20
21void stp_policy_node_get_ranges(struct stp_policy_node *policy_node,
22				unsigned int *mstart, unsigned int *mend,
23				unsigned int *cstart, unsigned int *cend);
24int stp_configfs_init(void);
25void stp_configfs_exit(void);
26
27struct stp_master {
28	unsigned int	nr_free;
29	unsigned long	chan_map[0];
30};
31
32struct stm_device {
33	struct device		dev;
34	struct module		*owner;
35	struct stp_policy	*policy;
36	struct mutex		policy_mutex;
37	int			major;
38	unsigned int		sw_nmasters;
39	struct stm_data		*data;
40	struct mutex		link_mutex;
41	spinlock_t		link_lock;
42	struct list_head	link_list;
43	/* master allocation */
44	spinlock_t		mc_lock;
45	struct stp_master	*masters[0];
46};
47
48#define to_stm_device(_d)				\
49	container_of((_d), struct stm_device, dev)
50
51struct stm_output {
52	spinlock_t		lock;
53	unsigned int		master;
54	unsigned int		channel;
55	unsigned int		nr_chans;
56};
57
58struct stm_file {
59	struct stm_device	*stm;
60	struct stp_policy_node	*policy_node;
61	struct stm_output	output;
62};
63
64struct stm_device *stm_find_device(const char *name);
65void stm_put_device(struct stm_device *stm);
66
67struct stm_source_device {
68	struct device		dev;
69	struct stm_source_data	*data;
70	spinlock_t		link_lock;
71	struct stm_device __rcu	*link;
72	struct list_head	link_entry;
73	/* one output per stm_source device */
74	struct stp_policy_node	*policy_node;
75	struct stm_output	output;
76};
77
78#define to_stm_source_device(_d)				\
79	container_of((_d), struct stm_source_device, dev)
80
81#endif /* _STM_STM_H_ */