1 // SPDX-License-Identifier: GPL-2.0+
3 * TI Common Platform Time Sync
5 * Copyright (C) 2012 Richard Cochran <richardcochran@gmail.com>
8 #include <linux/clk-provider.h>
11 #include <linux/hrtimer.h>
12 #include <linux/module.h>
13 #include <linux/net_tstamp.h>
14 #include <linux/ptp_classify.h>
15 #include <linux/time.h>
16 #include <linux/uaccess.h>
17 #include <linux/workqueue.h>
18 #include <linux/if_ether.h>
19 #include <linux/if_vlan.h>
23 #define CPTS_SKB_TX_WORK_TIMEOUT 1 /* jiffies */
25 struct cpts_skb_cb_data {
29 #define cpts_read32(c, r) readl_relaxed(&c->reg->r)
30 #define cpts_write32(c, v, r) writel_relaxed(v, &c->reg->r)
32 static int cpts_match(struct sk_buff *skb, unsigned int ptp_class,
33 u16 ts_seqid, u8 ts_msgtype);
35 static int event_expired(struct cpts_event *event)
37 return time_after(jiffies, event->tmo);
40 static int event_type(struct cpts_event *event)
42 return (event->high >> EVENT_TYPE_SHIFT) & EVENT_TYPE_MASK;
45 static int cpts_fifo_pop(struct cpts *cpts, u32 *high, u32 *low)
47 u32 r = cpts_read32(cpts, intstat_raw);
49 if (r & TS_PEND_RAW) {
50 *high = cpts_read32(cpts, event_high);
51 *low = cpts_read32(cpts, event_low);
52 cpts_write32(cpts, EVENT_POP, event_pop);
58 static int cpts_purge_events(struct cpts *cpts)
60 struct list_head *this, *next;
61 struct cpts_event *event;
64 list_for_each_safe(this, next, &cpts->events) {
65 event = list_entry(this, struct cpts_event, list);
66 if (event_expired(event)) {
67 list_del_init(&event->list);
68 list_add(&event->list, &cpts->pool);
74 pr_debug("cpts: event pool cleaned up %d\n", removed);
75 return removed ? 0 : -1;
78 static void cpts_purge_txq(struct cpts *cpts)
80 struct cpts_skb_cb_data *skb_cb;
81 struct sk_buff *skb, *tmp;
84 skb_queue_walk_safe(&cpts->txq, skb, tmp) {
85 skb_cb = (struct cpts_skb_cb_data *)skb->cb;
86 if (time_after(jiffies, skb_cb->tmo)) {
87 __skb_unlink(skb, &cpts->txq);
88 dev_consume_skb_any(skb);
94 dev_dbg(cpts->dev, "txq cleaned up %d\n", removed);
97 static bool cpts_match_tx_ts(struct cpts *cpts, struct cpts_event *event)
99 struct sk_buff *skb, *tmp;
104 mtype = (event->high >> MESSAGE_TYPE_SHIFT) & MESSAGE_TYPE_MASK;
105 seqid = (event->high >> SEQUENCE_ID_SHIFT) & SEQUENCE_ID_MASK;
107 /* no need to grab txq.lock as access is always done under cpts->lock */
108 skb_queue_walk_safe(&cpts->txq, skb, tmp) {
109 struct skb_shared_hwtstamps ssh;
110 unsigned int class = ptp_classify_raw(skb);
111 struct cpts_skb_cb_data *skb_cb =
112 (struct cpts_skb_cb_data *)skb->cb;
114 if (cpts_match(skb, class, seqid, mtype)) {
115 u64 ns = timecounter_cyc2time(&cpts->tc, event->low);
117 memset(&ssh, 0, sizeof(ssh));
118 ssh.hwtstamp = ns_to_ktime(ns);
119 skb_tstamp_tx(skb, &ssh);
121 __skb_unlink(skb, &cpts->txq);
122 dev_consume_skb_any(skb);
123 dev_dbg(cpts->dev, "match tx timestamp mtype %u seqid %04x\n",
128 if (time_after(jiffies, skb_cb->tmo)) {
129 /* timeout any expired skbs over 1s */
130 dev_dbg(cpts->dev, "expiring tx timestamp from txq\n");
131 __skb_unlink(skb, &cpts->txq);
132 dev_consume_skb_any(skb);
140 * Returns zero if matching event type was found.
142 static int cpts_fifo_read(struct cpts *cpts, int match)
146 struct cpts_event *event;
148 for (i = 0; i < CPTS_FIFO_DEPTH; i++) {
149 if (cpts_fifo_pop(cpts, &hi, &lo))
152 if (list_empty(&cpts->pool) && cpts_purge_events(cpts)) {
153 pr_err("cpts: event pool empty\n");
157 event = list_first_entry(&cpts->pool, struct cpts_event, list);
158 event->tmo = jiffies + 2;
161 type = event_type(event);
164 if (cpts_match_tx_ts(cpts, event)) {
165 /* if the new event matches an existing skb,
166 * then don't queue it
173 list_del_init(&event->list);
174 list_add_tail(&event->list, &cpts->events);
181 pr_err("cpts: unknown event type\n");
187 return type == match ? 0 : -1;
190 static u64 cpts_systim_read(const struct cyclecounter *cc)
193 struct cpts_event *event;
194 struct list_head *this, *next;
195 struct cpts *cpts = container_of(cc, struct cpts, cc);
197 cpts_write32(cpts, TS_PUSH, ts_push);
198 if (cpts_fifo_read(cpts, CPTS_EV_PUSH))
199 pr_err("cpts: unable to obtain a time stamp\n");
201 list_for_each_safe(this, next, &cpts->events) {
202 event = list_entry(this, struct cpts_event, list);
203 if (event_type(event) == CPTS_EV_PUSH) {
204 list_del_init(&event->list);
205 list_add(&event->list, &cpts->pool);
214 /* PTP clock operations */
216 static int cpts_ptp_adjfreq(struct ptp_clock_info *ptp, s32 ppb)
222 struct cpts *cpts = container_of(ptp, struct cpts, info);
228 mult = cpts->cc_mult;
231 diff = div_u64(adj, 1000000000ULL);
233 spin_lock_irqsave(&cpts->lock, flags);
235 timecounter_read(&cpts->tc);
237 cpts->cc.mult = neg_adj ? mult - diff : mult + diff;
239 spin_unlock_irqrestore(&cpts->lock, flags);
244 static int cpts_ptp_adjtime(struct ptp_clock_info *ptp, s64 delta)
247 struct cpts *cpts = container_of(ptp, struct cpts, info);
249 spin_lock_irqsave(&cpts->lock, flags);
250 timecounter_adjtime(&cpts->tc, delta);
251 spin_unlock_irqrestore(&cpts->lock, flags);
256 static int cpts_ptp_gettime(struct ptp_clock_info *ptp, struct timespec64 *ts)
260 struct cpts *cpts = container_of(ptp, struct cpts, info);
262 spin_lock_irqsave(&cpts->lock, flags);
263 ns = timecounter_read(&cpts->tc);
264 spin_unlock_irqrestore(&cpts->lock, flags);
266 *ts = ns_to_timespec64(ns);
271 static int cpts_ptp_settime(struct ptp_clock_info *ptp,
272 const struct timespec64 *ts)
276 struct cpts *cpts = container_of(ptp, struct cpts, info);
278 ns = timespec64_to_ns(ts);
280 spin_lock_irqsave(&cpts->lock, flags);
281 timecounter_init(&cpts->tc, &cpts->cc, ns);
282 spin_unlock_irqrestore(&cpts->lock, flags);
287 static int cpts_ptp_enable(struct ptp_clock_info *ptp,
288 struct ptp_clock_request *rq, int on)
293 static long cpts_overflow_check(struct ptp_clock_info *ptp)
295 struct cpts *cpts = container_of(ptp, struct cpts, info);
296 unsigned long delay = cpts->ov_check_period;
297 struct timespec64 ts;
300 spin_lock_irqsave(&cpts->lock, flags);
301 ts = ns_to_timespec64(timecounter_read(&cpts->tc));
303 if (!skb_queue_empty(&cpts->txq)) {
304 cpts_purge_txq(cpts);
305 if (!skb_queue_empty(&cpts->txq))
306 delay = CPTS_SKB_TX_WORK_TIMEOUT;
308 spin_unlock_irqrestore(&cpts->lock, flags);
310 pr_debug("cpts overflow check at %lld.%09ld\n",
311 (long long)ts.tv_sec, ts.tv_nsec);
315 static const struct ptp_clock_info cpts_info = {
316 .owner = THIS_MODULE,
317 .name = "CTPS timer",
322 .adjfreq = cpts_ptp_adjfreq,
323 .adjtime = cpts_ptp_adjtime,
324 .gettime64 = cpts_ptp_gettime,
325 .settime64 = cpts_ptp_settime,
326 .enable = cpts_ptp_enable,
327 .do_aux_work = cpts_overflow_check,
330 static int cpts_match(struct sk_buff *skb, unsigned int ptp_class,
331 u16 ts_seqid, u8 ts_msgtype)
334 unsigned int offset = 0;
335 u8 *msgtype, *data = skb->data;
337 if (ptp_class & PTP_CLASS_VLAN)
340 switch (ptp_class & PTP_CLASS_PMASK) {
342 offset += ETH_HLEN + IPV4_HLEN(data + offset) + UDP_HLEN;
345 offset += ETH_HLEN + IP6_HLEN + UDP_HLEN;
354 if (skb->len + ETH_HLEN < offset + OFF_PTP_SEQUENCE_ID + sizeof(*seqid))
357 if (unlikely(ptp_class & PTP_CLASS_V1))
358 msgtype = data + offset + OFF_PTP_CONTROL;
360 msgtype = data + offset;
362 seqid = (u16 *)(data + offset + OFF_PTP_SEQUENCE_ID);
364 return (ts_msgtype == (*msgtype & 0xf) && ts_seqid == ntohs(*seqid));
367 static u64 cpts_find_ts(struct cpts *cpts, struct sk_buff *skb, int ev_type)
370 struct cpts_event *event;
371 struct list_head *this, *next;
372 unsigned int class = ptp_classify_raw(skb);
377 if (class == PTP_CLASS_NONE)
380 spin_lock_irqsave(&cpts->lock, flags);
381 cpts_fifo_read(cpts, -1);
382 list_for_each_safe(this, next, &cpts->events) {
383 event = list_entry(this, struct cpts_event, list);
384 if (event_expired(event)) {
385 list_del_init(&event->list);
386 list_add(&event->list, &cpts->pool);
389 mtype = (event->high >> MESSAGE_TYPE_SHIFT) & MESSAGE_TYPE_MASK;
390 seqid = (event->high >> SEQUENCE_ID_SHIFT) & SEQUENCE_ID_MASK;
391 if (ev_type == event_type(event) &&
392 cpts_match(skb, class, seqid, mtype)) {
393 ns = timecounter_cyc2time(&cpts->tc, event->low);
394 list_del_init(&event->list);
395 list_add(&event->list, &cpts->pool);
400 if (ev_type == CPTS_EV_TX && !ns) {
401 struct cpts_skb_cb_data *skb_cb =
402 (struct cpts_skb_cb_data *)skb->cb;
403 /* Not found, add frame to queue for processing later.
404 * The periodic FIFO check will handle this.
407 /* get the timestamp for timeouts */
408 skb_cb->tmo = jiffies + msecs_to_jiffies(100);
409 __skb_queue_tail(&cpts->txq, skb);
410 ptp_schedule_worker(cpts->clock, 0);
412 spin_unlock_irqrestore(&cpts->lock, flags);
417 void cpts_rx_timestamp(struct cpts *cpts, struct sk_buff *skb)
420 struct skb_shared_hwtstamps *ssh;
422 ns = cpts_find_ts(cpts, skb, CPTS_EV_RX);
425 ssh = skb_hwtstamps(skb);
426 memset(ssh, 0, sizeof(*ssh));
427 ssh->hwtstamp = ns_to_ktime(ns);
429 EXPORT_SYMBOL_GPL(cpts_rx_timestamp);
431 void cpts_tx_timestamp(struct cpts *cpts, struct sk_buff *skb)
434 struct skb_shared_hwtstamps ssh;
436 if (!(skb_shinfo(skb)->tx_flags & SKBTX_IN_PROGRESS))
438 ns = cpts_find_ts(cpts, skb, CPTS_EV_TX);
441 memset(&ssh, 0, sizeof(ssh));
442 ssh.hwtstamp = ns_to_ktime(ns);
443 skb_tstamp_tx(skb, &ssh);
445 EXPORT_SYMBOL_GPL(cpts_tx_timestamp);
447 int cpts_register(struct cpts *cpts)
451 skb_queue_head_init(&cpts->txq);
452 INIT_LIST_HEAD(&cpts->events);
453 INIT_LIST_HEAD(&cpts->pool);
454 for (i = 0; i < CPTS_MAX_EVENTS; i++)
455 list_add(&cpts->pool_data[i].list, &cpts->pool);
457 clk_enable(cpts->refclk);
459 cpts_write32(cpts, CPTS_EN, control);
460 cpts_write32(cpts, TS_PEND_EN, int_enable);
462 timecounter_init(&cpts->tc, &cpts->cc, ktime_to_ns(ktime_get_real()));
464 cpts->clock = ptp_clock_register(&cpts->info, cpts->dev);
465 if (IS_ERR(cpts->clock)) {
466 err = PTR_ERR(cpts->clock);
470 cpts->phc_index = ptp_clock_index(cpts->clock);
472 ptp_schedule_worker(cpts->clock, cpts->ov_check_period);
476 clk_disable(cpts->refclk);
479 EXPORT_SYMBOL_GPL(cpts_register);
481 void cpts_unregister(struct cpts *cpts)
483 if (WARN_ON(!cpts->clock))
486 ptp_clock_unregister(cpts->clock);
489 cpts_write32(cpts, 0, int_enable);
490 cpts_write32(cpts, 0, control);
492 /* Drop all packet */
493 skb_queue_purge(&cpts->txq);
495 clk_disable(cpts->refclk);
497 EXPORT_SYMBOL_GPL(cpts_unregister);
499 static void cpts_calc_mult_shift(struct cpts *cpts)
501 u64 frac, maxsec, ns;
504 freq = clk_get_rate(cpts->refclk);
506 /* Calc the maximum number of seconds which we can run before
509 maxsec = cpts->cc.mask;
510 do_div(maxsec, freq);
511 /* limit conversation rate to 10 sec as higher values will produce
512 * too small mult factors and so reduce the conversion accuracy
517 /* Calc overflow check period (maxsec / 2) */
518 cpts->ov_check_period = (HZ * maxsec) / 2;
519 dev_info(cpts->dev, "cpts: overflow check period %lu (jiffies)\n",
520 cpts->ov_check_period);
522 if (cpts->cc.mult || cpts->cc.shift)
525 clocks_calc_mult_shift(&cpts->cc.mult, &cpts->cc.shift,
526 freq, NSEC_PER_SEC, maxsec);
529 ns = cyclecounter_cyc2ns(&cpts->cc, freq, cpts->cc.mask, &frac);
532 "CPTS: ref_clk_freq:%u calc_mult:%u calc_shift:%u error:%lld nsec/sec\n",
533 freq, cpts->cc.mult, cpts->cc.shift, (ns - NSEC_PER_SEC));
536 static int cpts_of_mux_clk_setup(struct cpts *cpts, struct device_node *node)
538 struct device_node *refclk_np;
539 const char **parent_names;
540 unsigned int num_parents;
541 struct clk_hw *clk_hw;
545 refclk_np = of_get_child_by_name(node, "cpts-refclk-mux");
547 /* refclk selection supported not for all SoCs */
550 num_parents = of_clk_get_parent_count(refclk_np);
551 if (num_parents < 1) {
552 dev_err(cpts->dev, "mux-clock %s must have parents\n",
557 parent_names = devm_kzalloc(cpts->dev, (sizeof(char *) * num_parents),
560 mux_table = devm_kzalloc(cpts->dev, sizeof(*mux_table) * num_parents,
562 if (!mux_table || !parent_names) {
567 of_clk_parent_fill(refclk_np, parent_names, num_parents);
569 ret = of_property_read_variable_u32_array(refclk_np, "ti,mux-tbl",
571 num_parents, num_parents);
575 clk_hw = clk_hw_register_mux_table(cpts->dev, refclk_np->name,
576 parent_names, num_parents,
578 &cpts->reg->rftclk_sel, 0, 0x1F,
580 if (IS_ERR(clk_hw)) {
581 ret = PTR_ERR(clk_hw);
585 ret = devm_add_action_or_reset(cpts->dev,
586 (void(*)(void *))clk_hw_unregister_mux,
589 dev_err(cpts->dev, "add clkmux unreg action %d", ret);
593 ret = of_clk_add_hw_provider(refclk_np, of_clk_hw_simple_get, clk_hw);
597 ret = devm_add_action_or_reset(cpts->dev,
598 (void(*)(void *))of_clk_del_provider,
601 dev_err(cpts->dev, "add clkmux provider unreg action %d", ret);
608 of_node_put(refclk_np);
612 static int cpts_of_parse(struct cpts *cpts, struct device_node *node)
617 if (!of_property_read_u32(node, "cpts_clock_mult", &prop))
618 cpts->cc.mult = prop;
620 if (!of_property_read_u32(node, "cpts_clock_shift", &prop))
621 cpts->cc.shift = prop;
623 if ((cpts->cc.mult && !cpts->cc.shift) ||
624 (!cpts->cc.mult && cpts->cc.shift))
627 return cpts_of_mux_clk_setup(cpts, node);
630 dev_err(cpts->dev, "CPTS: Missing property in the DT.\n");
634 struct cpts *cpts_create(struct device *dev, void __iomem *regs,
635 struct device_node *node)
640 cpts = devm_kzalloc(dev, sizeof(*cpts), GFP_KERNEL);
642 return ERR_PTR(-ENOMEM);
645 cpts->reg = (struct cpsw_cpts __iomem *)regs;
646 spin_lock_init(&cpts->lock);
648 ret = cpts_of_parse(cpts, node);
652 cpts->refclk = devm_get_clk_from_child(dev, node, "cpts");
653 if (IS_ERR(cpts->refclk))
654 /* try get clk from dev node for compatibility */
655 cpts->refclk = devm_clk_get(dev, "cpts");
657 if (IS_ERR(cpts->refclk)) {
658 dev_err(dev, "Failed to get cpts refclk %ld\n",
659 PTR_ERR(cpts->refclk));
660 return ERR_CAST(cpts->refclk);
663 ret = clk_prepare(cpts->refclk);
667 cpts->cc.read = cpts_systim_read;
668 cpts->cc.mask = CLOCKSOURCE_MASK(32);
669 cpts->info = cpts_info;
671 cpts_calc_mult_shift(cpts);
672 /* save cc.mult original value as it can be modified
673 * by cpts_ptp_adjfreq().
675 cpts->cc_mult = cpts->cc.mult;
679 EXPORT_SYMBOL_GPL(cpts_create);
681 void cpts_release(struct cpts *cpts)
686 if (WARN_ON(!cpts->refclk))
689 clk_unprepare(cpts->refclk);
691 EXPORT_SYMBOL_GPL(cpts_release);
693 MODULE_LICENSE("GPL v2");
694 MODULE_DESCRIPTION("TI CPTS driver");
695 MODULE_AUTHOR("Richard Cochran <richardcochran@gmail.com>");