xref: /linux/drivers/ptp/ptp_sysfs.c (revision d5a7fc58da039903b332041e8c67daae36f08b50)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * PTP 1588 clock support - sysfs interface.
4  *
5  * Copyright (C) 2010 OMICRON electronics GmbH
6  * Copyright 2021 NXP
7  */
8 #include <linux/capability.h>
9 #include <linux/slab.h>
10 
11 #include "ptp_private.h"
12 
clock_name_show(struct device * dev,struct device_attribute * attr,char * page)13 static ssize_t clock_name_show(struct device *dev,
14 			       struct device_attribute *attr, char *page)
15 {
16 	struct ptp_clock *ptp = dev_get_drvdata(dev);
17 	return sysfs_emit(page, "%s\n", ptp->info->name);
18 }
19 static DEVICE_ATTR_RO(clock_name);
20 
max_phase_adjustment_show(struct device * dev,struct device_attribute * attr,char * page)21 static ssize_t max_phase_adjustment_show(struct device *dev,
22 					 struct device_attribute *attr,
23 					 char *page)
24 {
25 	struct ptp_clock *ptp = dev_get_drvdata(dev);
26 
27 	return sysfs_emit(page, "%d\n", ptp->info->getmaxphase(ptp->info));
28 }
29 static DEVICE_ATTR_RO(max_phase_adjustment);
30 
31 #define PTP_SHOW_INT(name, var)						\
32 static ssize_t var##_show(struct device *dev,				\
33 			   struct device_attribute *attr, char *page)	\
34 {									\
35 	struct ptp_clock *ptp = dev_get_drvdata(dev);			\
36 	return sysfs_emit(page, "%d\n", ptp->info->var);	\
37 }									\
38 static DEVICE_ATTR(name, 0444, var##_show, NULL);
39 
40 PTP_SHOW_INT(max_adjustment, max_adj);
41 PTP_SHOW_INT(n_alarms, n_alarm);
42 PTP_SHOW_INT(n_external_timestamps, n_ext_ts);
43 PTP_SHOW_INT(n_periodic_outputs, n_per_out);
44 PTP_SHOW_INT(n_programmable_pins, n_pins);
45 PTP_SHOW_INT(pps_available, pps);
46 
extts_enable_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t count)47 static ssize_t extts_enable_store(struct device *dev,
48 				  struct device_attribute *attr,
49 				  const char *buf, size_t count)
50 {
51 	struct ptp_clock *ptp = dev_get_drvdata(dev);
52 	struct ptp_clock_info *ops = ptp->info;
53 	struct ptp_clock_request req = { .type = PTP_CLK_REQ_EXTTS };
54 	int cnt, enable;
55 	int err = -EINVAL;
56 
57 	cnt = sscanf(buf, "%u %d", &req.extts.index, &enable);
58 	if (cnt != 2)
59 		goto out;
60 	if (req.extts.index >= ops->n_ext_ts)
61 		goto out;
62 
63 	err = ops->enable(ops, &req, enable ? 1 : 0);
64 	if (err)
65 		goto out;
66 
67 	return count;
68 out:
69 	return err;
70 }
71 static DEVICE_ATTR(extts_enable, 0220, NULL, extts_enable_store);
72 
extts_fifo_show(struct device * dev,struct device_attribute * attr,char * page)73 static ssize_t extts_fifo_show(struct device *dev,
74 			       struct device_attribute *attr, char *page)
75 {
76 	struct ptp_clock *ptp = dev_get_drvdata(dev);
77 	struct timestamp_event_queue *queue;
78 	struct ptp_extts_event event;
79 	unsigned long flags;
80 	size_t qcnt;
81 	int cnt = 0;
82 
83 	cnt = list_count_nodes(&ptp->tsevqs);
84 	if (cnt <= 0)
85 		goto out;
86 
87 	/* The sysfs fifo will always draw from the fist queue */
88 	queue = list_first_entry(&ptp->tsevqs, struct timestamp_event_queue,
89 				 qlist);
90 
91 	memset(&event, 0, sizeof(event));
92 	spin_lock_irqsave(&queue->lock, flags);
93 	qcnt = queue_cnt(queue);
94 	if (qcnt) {
95 		event = queue->buf[queue->head];
96 		/* Paired with READ_ONCE() in queue_cnt() */
97 		WRITE_ONCE(queue->head, (queue->head + 1) % PTP_MAX_TIMESTAMPS);
98 	}
99 	spin_unlock_irqrestore(&queue->lock, flags);
100 
101 	if (!qcnt)
102 		goto out;
103 
104 	cnt = sysfs_emit(page, "%u %lld %u\n",
105 			 event.index, event.t.sec, event.t.nsec);
106 out:
107 	return cnt;
108 }
109 static DEVICE_ATTR(fifo, 0444, extts_fifo_show, NULL);
110 
period_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t count)111 static ssize_t period_store(struct device *dev,
112 			    struct device_attribute *attr,
113 			    const char *buf, size_t count)
114 {
115 	struct ptp_clock *ptp = dev_get_drvdata(dev);
116 	struct ptp_clock_info *ops = ptp->info;
117 	struct ptp_clock_request req = { .type = PTP_CLK_REQ_PEROUT };
118 	int cnt, enable, err = -EINVAL;
119 
120 	cnt = sscanf(buf, "%u %lld %u %lld %u", &req.perout.index,
121 		     &req.perout.start.sec, &req.perout.start.nsec,
122 		     &req.perout.period.sec, &req.perout.period.nsec);
123 	if (cnt != 5)
124 		goto out;
125 	if (req.perout.index >= ops->n_per_out)
126 		goto out;
127 
128 	enable = req.perout.period.sec || req.perout.period.nsec;
129 	err = ops->enable(ops, &req, enable);
130 	if (err)
131 		goto out;
132 
133 	return count;
134 out:
135 	return err;
136 }
137 static DEVICE_ATTR(period, 0220, NULL, period_store);
138 
pps_enable_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t count)139 static ssize_t pps_enable_store(struct device *dev,
140 				struct device_attribute *attr,
141 				const char *buf, size_t count)
142 {
143 	struct ptp_clock *ptp = dev_get_drvdata(dev);
144 	struct ptp_clock_info *ops = ptp->info;
145 	struct ptp_clock_request req = { .type = PTP_CLK_REQ_PPS };
146 	int cnt, enable;
147 	int err = -EINVAL;
148 
149 	if (!capable(CAP_SYS_TIME))
150 		return -EPERM;
151 
152 	cnt = sscanf(buf, "%d", &enable);
153 	if (cnt != 1)
154 		goto out;
155 
156 	err = ops->enable(ops, &req, enable ? 1 : 0);
157 	if (err)
158 		goto out;
159 
160 	return count;
161 out:
162 	return err;
163 }
164 static DEVICE_ATTR(pps_enable, 0220, NULL, pps_enable_store);
165 
unregister_vclock(struct device * dev,void * data)166 static int unregister_vclock(struct device *dev, void *data)
167 {
168 	struct ptp_clock *ptp = dev_get_drvdata(dev);
169 	struct ptp_clock_info *info = ptp->info;
170 	struct ptp_vclock *vclock;
171 	u32 *num = data;
172 
173 	vclock = info_to_vclock(info);
174 	dev_info(dev->parent, "delete virtual clock ptp%d\n",
175 		 vclock->clock->index);
176 
177 	ptp_vclock_unregister(vclock);
178 	(*num)--;
179 
180 	/* For break. Not error. */
181 	if (*num == 0)
182 		return -EINVAL;
183 
184 	return 0;
185 }
186 
n_vclocks_show(struct device * dev,struct device_attribute * attr,char * page)187 static ssize_t n_vclocks_show(struct device *dev,
188 			      struct device_attribute *attr, char *page)
189 {
190 	struct ptp_clock *ptp = dev_get_drvdata(dev);
191 	ssize_t size;
192 
193 	if (mutex_lock_interruptible(&ptp->n_vclocks_mux))
194 		return -ERESTARTSYS;
195 
196 	size = sysfs_emit(page, "%u\n", ptp->n_vclocks);
197 
198 	mutex_unlock(&ptp->n_vclocks_mux);
199 
200 	return size;
201 }
202 
n_vclocks_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t count)203 static ssize_t n_vclocks_store(struct device *dev,
204 			       struct device_attribute *attr,
205 			       const char *buf, size_t count)
206 {
207 	struct ptp_clock *ptp = dev_get_drvdata(dev);
208 	struct ptp_vclock *vclock;
209 	int err = -EINVAL;
210 	u32 num, i;
211 
212 	if (kstrtou32(buf, 0, &num))
213 		return err;
214 
215 	if (mutex_lock_interruptible(&ptp->n_vclocks_mux))
216 		return -ERESTARTSYS;
217 
218 	if (num > ptp->max_vclocks) {
219 		dev_err(dev, "max value is %d\n", ptp->max_vclocks);
220 		goto out;
221 	}
222 
223 	/* Need to create more vclocks */
224 	if (num > ptp->n_vclocks) {
225 		for (i = 0; i < num - ptp->n_vclocks; i++) {
226 			vclock = ptp_vclock_register(ptp);
227 			if (!vclock)
228 				goto out;
229 
230 			*(ptp->vclock_index + ptp->n_vclocks + i) =
231 				vclock->clock->index;
232 
233 			dev_info(dev, "new virtual clock ptp%d\n",
234 				 vclock->clock->index);
235 		}
236 	}
237 
238 	/* Need to delete vclocks */
239 	if (num < ptp->n_vclocks) {
240 		i = ptp->n_vclocks - num;
241 		device_for_each_child_reverse(dev, &i,
242 					      unregister_vclock);
243 
244 		for (i = 1; i <= ptp->n_vclocks - num; i++)
245 			*(ptp->vclock_index + ptp->n_vclocks - i) = -1;
246 	}
247 
248 	/* Need to inform about changed physical clock behavior */
249 	if (!ptp->has_cycles) {
250 		if (num == 0)
251 			dev_info(dev, "only physical clock in use now\n");
252 		else
253 			dev_info(dev, "guarantee physical clock free running\n");
254 	}
255 
256 	ptp->n_vclocks = num;
257 	mutex_unlock(&ptp->n_vclocks_mux);
258 
259 	return count;
260 out:
261 	mutex_unlock(&ptp->n_vclocks_mux);
262 	return err;
263 }
264 static DEVICE_ATTR_RW(n_vclocks);
265 
max_vclocks_show(struct device * dev,struct device_attribute * attr,char * page)266 static ssize_t max_vclocks_show(struct device *dev,
267 				struct device_attribute *attr, char *page)
268 {
269 	struct ptp_clock *ptp = dev_get_drvdata(dev);
270 	ssize_t size;
271 
272 	size = sysfs_emit(page, "%u\n", ptp->max_vclocks);
273 
274 	return size;
275 }
276 
max_vclocks_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t count)277 static ssize_t max_vclocks_store(struct device *dev,
278 				 struct device_attribute *attr,
279 				 const char *buf, size_t count)
280 {
281 	struct ptp_clock *ptp = dev_get_drvdata(dev);
282 	unsigned int *vclock_index;
283 	int err = -EINVAL;
284 	size_t size;
285 	u32 max;
286 
287 	if (kstrtou32(buf, 0, &max) || max == 0)
288 		return -EINVAL;
289 
290 	if (max == ptp->max_vclocks)
291 		return count;
292 
293 	if (mutex_lock_interruptible(&ptp->n_vclocks_mux))
294 		return -ERESTARTSYS;
295 
296 	if (max < ptp->n_vclocks)
297 		goto out;
298 
299 	vclock_index = kcalloc(max, sizeof(int), GFP_KERNEL);
300 	if (!vclock_index) {
301 		err = -ENOMEM;
302 		goto out;
303 	}
304 
305 	size = sizeof(int) * ptp->n_vclocks;
306 	memcpy(vclock_index, ptp->vclock_index, size);
307 
308 	kfree(ptp->vclock_index);
309 	ptp->vclock_index = vclock_index;
310 	ptp->max_vclocks = max;
311 
312 	mutex_unlock(&ptp->n_vclocks_mux);
313 
314 	return count;
315 out:
316 	mutex_unlock(&ptp->n_vclocks_mux);
317 	return err;
318 }
319 static DEVICE_ATTR_RW(max_vclocks);
320 
321 static struct attribute *ptp_attrs[] = {
322 	&dev_attr_clock_name.attr,
323 
324 	&dev_attr_max_adjustment.attr,
325 	&dev_attr_max_phase_adjustment.attr,
326 	&dev_attr_n_alarms.attr,
327 	&dev_attr_n_external_timestamps.attr,
328 	&dev_attr_n_periodic_outputs.attr,
329 	&dev_attr_n_programmable_pins.attr,
330 	&dev_attr_pps_available.attr,
331 
332 	&dev_attr_extts_enable.attr,
333 	&dev_attr_fifo.attr,
334 	&dev_attr_period.attr,
335 	&dev_attr_pps_enable.attr,
336 	&dev_attr_n_vclocks.attr,
337 	&dev_attr_max_vclocks.attr,
338 	NULL
339 };
340 
ptp_is_attribute_visible(struct kobject * kobj,struct attribute * attr,int n)341 static umode_t ptp_is_attribute_visible(struct kobject *kobj,
342 					struct attribute *attr, int n)
343 {
344 	struct device *dev = kobj_to_dev(kobj);
345 	struct ptp_clock *ptp = dev_get_drvdata(dev);
346 	struct ptp_clock_info *info = ptp->info;
347 	umode_t mode = attr->mode;
348 
349 	if (attr == &dev_attr_extts_enable.attr ||
350 	    attr == &dev_attr_fifo.attr) {
351 		if (!info->n_ext_ts)
352 			mode = 0;
353 	} else if (attr == &dev_attr_period.attr) {
354 		if (!info->n_per_out)
355 			mode = 0;
356 	} else if (attr == &dev_attr_pps_enable.attr) {
357 		if (!info->pps)
358 			mode = 0;
359 	} else if (attr == &dev_attr_n_vclocks.attr ||
360 		   attr == &dev_attr_max_vclocks.attr) {
361 		if (ptp->is_virtual_clock)
362 			mode = 0;
363 	} else if (attr == &dev_attr_max_phase_adjustment.attr) {
364 		if (!info->adjphase || !info->getmaxphase)
365 			mode = 0;
366 	}
367 
368 	return mode;
369 }
370 
371 static const struct attribute_group ptp_group = {
372 	.is_visible	= ptp_is_attribute_visible,
373 	.attrs		= ptp_attrs,
374 };
375 
376 const struct attribute_group *ptp_groups[] = {
377 	&ptp_group,
378 	NULL
379 };
380 
ptp_pin_name2index(struct ptp_clock * ptp,const char * name)381 static int ptp_pin_name2index(struct ptp_clock *ptp, const char *name)
382 {
383 	int i;
384 	for (i = 0; i < ptp->info->n_pins; i++) {
385 		if (!strcmp(ptp->info->pin_config[i].name, name))
386 			return i;
387 	}
388 	return -1;
389 }
390 
ptp_pin_show(struct device * dev,struct device_attribute * attr,char * page)391 static ssize_t ptp_pin_show(struct device *dev, struct device_attribute *attr,
392 			    char *page)
393 {
394 	struct ptp_clock *ptp = dev_get_drvdata(dev);
395 	unsigned int func, chan;
396 	int index;
397 
398 	index = ptp_pin_name2index(ptp, attr->attr.name);
399 	if (index < 0)
400 		return -EINVAL;
401 
402 	if (mutex_lock_interruptible(&ptp->pincfg_mux))
403 		return -ERESTARTSYS;
404 
405 	func = ptp->info->pin_config[index].func;
406 	chan = ptp->info->pin_config[index].chan;
407 
408 	mutex_unlock(&ptp->pincfg_mux);
409 
410 	return sysfs_emit(page, "%u %u\n", func, chan);
411 }
412 
ptp_pin_store(struct device * dev,struct device_attribute * attr,const char * buf,size_t count)413 static ssize_t ptp_pin_store(struct device *dev, struct device_attribute *attr,
414 			     const char *buf, size_t count)
415 {
416 	struct ptp_clock *ptp = dev_get_drvdata(dev);
417 	unsigned int func, chan;
418 	int cnt, err, index;
419 
420 	cnt = sscanf(buf, "%u %u", &func, &chan);
421 	if (cnt != 2)
422 		return -EINVAL;
423 
424 	index = ptp_pin_name2index(ptp, attr->attr.name);
425 	if (index < 0)
426 		return -EINVAL;
427 
428 	if (mutex_lock_interruptible(&ptp->pincfg_mux))
429 		return -ERESTARTSYS;
430 	err = ptp_set_pinfunc(ptp, index, func, chan);
431 	mutex_unlock(&ptp->pincfg_mux);
432 	if (err)
433 		return err;
434 
435 	return count;
436 }
437 
ptp_populate_pin_groups(struct ptp_clock * ptp)438 int ptp_populate_pin_groups(struct ptp_clock *ptp)
439 {
440 	struct ptp_clock_info *info = ptp->info;
441 	int err = -ENOMEM, i, n_pins = info->n_pins;
442 
443 	if (!n_pins)
444 		return 0;
445 
446 	ptp->pin_dev_attr = kcalloc(n_pins, sizeof(*ptp->pin_dev_attr),
447 				    GFP_KERNEL);
448 	if (!ptp->pin_dev_attr)
449 		goto no_dev_attr;
450 
451 	ptp->pin_attr = kcalloc(1 + n_pins, sizeof(*ptp->pin_attr), GFP_KERNEL);
452 	if (!ptp->pin_attr)
453 		goto no_pin_attr;
454 
455 	for (i = 0; i < n_pins; i++) {
456 		struct device_attribute *da = &ptp->pin_dev_attr[i];
457 		sysfs_attr_init(&da->attr);
458 		da->attr.name = info->pin_config[i].name;
459 		da->attr.mode = 0644;
460 		da->show = ptp_pin_show;
461 		da->store = ptp_pin_store;
462 		ptp->pin_attr[i] = &da->attr;
463 	}
464 
465 	ptp->pin_attr_group.name = "pins";
466 	ptp->pin_attr_group.attrs = ptp->pin_attr;
467 
468 	ptp->pin_attr_groups[0] = &ptp->pin_attr_group;
469 
470 	return 0;
471 
472 no_pin_attr:
473 	kfree(ptp->pin_dev_attr);
474 no_dev_attr:
475 	return err;
476 }
477 
ptp_cleanup_pin_groups(struct ptp_clock * ptp)478 void ptp_cleanup_pin_groups(struct ptp_clock *ptp)
479 {
480 	kfree(ptp->pin_attr);
481 	kfree(ptp->pin_dev_attr);
482 }
483