1 // SPDX-License-Identifier: GPL-2.0+
3 * TI Common Platform Time Sync
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 */
24 #define CPTS_SKB_RX_TX_TMO 100 /*ms */
25 #define CPTS_EVENT_RX_TX_TIMEOUT (100) /* ms */
27 struct cpts_skb_cb_data {
32 #define cpts_read32(c, r) readl_relaxed(&c->reg->r)
33 #define cpts_write32(c, v, r) writel_relaxed(v, &c->reg->r)
35 static int cpts_event_port(struct cpts_event *event)
37 return (event->high >> PORT_NUMBER_SHIFT) & PORT_NUMBER_MASK;
40 static int event_expired(struct cpts_event *event)
42 return time_after(jiffies, event->tmo);
45 static int event_type(struct cpts_event *event)
47 return (event->high >> EVENT_TYPE_SHIFT) & EVENT_TYPE_MASK;
50 static int cpts_fifo_pop(struct cpts *cpts, u32 *high, u32 *low)
52 u32 r = cpts_read32(cpts, intstat_raw);
54 if (r & TS_PEND_RAW) {
55 *high = cpts_read32(cpts, event_high);
56 *low = cpts_read32(cpts, event_low);
57 cpts_write32(cpts, EVENT_POP, event_pop);
63 static int cpts_purge_events(struct cpts *cpts)
65 struct list_head *this, *next;
66 struct cpts_event *event;
69 list_for_each_safe(this, next, &cpts->events) {
70 event = list_entry(this, struct cpts_event, list);
71 if (event_expired(event)) {
72 list_del_init(&event->list);
73 list_add(&event->list, &cpts->pool);
79 dev_dbg(cpts->dev, "cpts: event pool cleaned up %d\n", removed);
80 return removed ? 0 : -1;
83 static void cpts_purge_txq(struct cpts *cpts)
85 struct cpts_skb_cb_data *skb_cb;
86 struct sk_buff *skb, *tmp;
89 skb_queue_walk_safe(&cpts->txq, skb, tmp) {
90 skb_cb = (struct cpts_skb_cb_data *)skb->cb;
91 if (time_after(jiffies, skb_cb->tmo)) {
92 __skb_unlink(skb, &cpts->txq);
93 dev_consume_skb_any(skb);
99 dev_dbg(cpts->dev, "txq cleaned up %d\n", removed);
103 * Returns zero if matching event type was found.
105 static int cpts_fifo_read(struct cpts *cpts, int match)
107 struct ptp_clock_event pevent;
108 bool need_schedule = false;
109 struct cpts_event *event;
114 spin_lock_irqsave(&cpts->lock, flags);
116 for (i = 0; i < CPTS_FIFO_DEPTH; i++) {
117 if (cpts_fifo_pop(cpts, &hi, &lo))
120 if (list_empty(&cpts->pool) && cpts_purge_events(cpts)) {
121 dev_warn(cpts->dev, "cpts: event pool empty\n");
125 event = list_first_entry(&cpts->pool, struct cpts_event, list);
128 event->timestamp = timecounter_cyc2time(&cpts->tc, event->low);
129 type = event_type(event);
131 dev_dbg(cpts->dev, "CPTS_EV: %d high:%08X low:%08x\n",
132 type, event->high, event->low);
135 WRITE_ONCE(cpts->cur_timestamp, lo);
136 timecounter_read(&cpts->tc);
137 if (cpts->mult_new) {
138 cpts->cc.mult = cpts->mult_new;
142 complete(&cpts->ts_push_complete);
146 event->tmo = jiffies +
147 msecs_to_jiffies(CPTS_EVENT_RX_TX_TIMEOUT);
149 list_del_init(&event->list);
150 list_add_tail(&event->list, &cpts->events);
151 need_schedule = true;
157 pevent.timestamp = event->timestamp;
158 pevent.type = PTP_CLOCK_EXTTS;
159 pevent.index = cpts_event_port(event) - 1;
160 ptp_clock_event(cpts->clock, &pevent);
163 dev_err(cpts->dev, "cpts: unknown event type\n");
170 spin_unlock_irqrestore(&cpts->lock, flags);
172 if (!cpts->irq_poll && need_schedule)
173 ptp_schedule_worker(cpts->clock, 0);
175 return type == match ? 0 : -1;
178 void cpts_misc_interrupt(struct cpts *cpts)
180 cpts_fifo_read(cpts, -1);
182 EXPORT_SYMBOL_GPL(cpts_misc_interrupt);
184 static u64 cpts_systim_read(const struct cyclecounter *cc)
186 struct cpts *cpts = container_of(cc, struct cpts, cc);
188 return READ_ONCE(cpts->cur_timestamp);
191 static void cpts_update_cur_time(struct cpts *cpts, int match,
192 struct ptp_system_timestamp *sts)
196 reinit_completion(&cpts->ts_push_complete);
198 /* use spin_lock_irqsave() here as it has to run very fast */
199 spin_lock_irqsave(&cpts->lock, flags);
200 ptp_read_system_prets(sts);
201 cpts_write32(cpts, TS_PUSH, ts_push);
202 cpts_read32(cpts, ts_push);
203 ptp_read_system_postts(sts);
204 spin_unlock_irqrestore(&cpts->lock, flags);
206 if (cpts->irq_poll && cpts_fifo_read(cpts, match) && match != -1)
207 dev_err(cpts->dev, "cpts: unable to obtain a time stamp\n");
209 if (!cpts->irq_poll &&
210 !wait_for_completion_timeout(&cpts->ts_push_complete, HZ))
211 dev_err(cpts->dev, "cpts: obtain a time stamp timeout\n");
214 /* PTP clock operations */
216 static int cpts_ptp_adjfreq(struct ptp_clock_info *ptp, s32 ppb)
218 struct cpts *cpts = container_of(ptp, struct cpts, info);
227 mult = cpts->cc_mult;
230 diff = div_u64(adj, 1000000000ULL);
232 mutex_lock(&cpts->ptp_clk_mutex);
234 cpts->mult_new = neg_adj ? mult - diff : mult + diff;
236 cpts_update_cur_time(cpts, CPTS_EV_PUSH, NULL);
238 mutex_unlock(&cpts->ptp_clk_mutex);
242 static int cpts_ptp_adjtime(struct ptp_clock_info *ptp, s64 delta)
244 struct cpts *cpts = container_of(ptp, struct cpts, info);
246 mutex_lock(&cpts->ptp_clk_mutex);
247 timecounter_adjtime(&cpts->tc, delta);
248 mutex_unlock(&cpts->ptp_clk_mutex);
253 static int cpts_ptp_gettimeex(struct ptp_clock_info *ptp,
254 struct timespec64 *ts,
255 struct ptp_system_timestamp *sts)
257 struct cpts *cpts = container_of(ptp, struct cpts, info);
260 mutex_lock(&cpts->ptp_clk_mutex);
262 cpts_update_cur_time(cpts, CPTS_EV_PUSH, sts);
264 ns = timecounter_read(&cpts->tc);
265 mutex_unlock(&cpts->ptp_clk_mutex);
267 *ts = ns_to_timespec64(ns);
272 static int cpts_ptp_settime(struct ptp_clock_info *ptp,
273 const struct timespec64 *ts)
275 struct cpts *cpts = container_of(ptp, struct cpts, info);
278 ns = timespec64_to_ns(ts);
280 mutex_lock(&cpts->ptp_clk_mutex);
281 timecounter_init(&cpts->tc, &cpts->cc, ns);
282 mutex_unlock(&cpts->ptp_clk_mutex);
287 static int cpts_extts_enable(struct cpts *cpts, u32 index, int on)
291 if (((cpts->hw_ts_enable & BIT(index)) >> index) == on)
294 mutex_lock(&cpts->ptp_clk_mutex);
296 v = cpts_read32(cpts, control);
299 cpts->hw_ts_enable |= BIT(index);
301 v &= ~BIT(8 + index);
302 cpts->hw_ts_enable &= ~BIT(index);
304 cpts_write32(cpts, v, control);
306 mutex_unlock(&cpts->ptp_clk_mutex);
311 static int cpts_ptp_enable(struct ptp_clock_info *ptp,
312 struct ptp_clock_request *rq, int on)
314 struct cpts *cpts = container_of(ptp, struct cpts, info);
317 case PTP_CLK_REQ_EXTTS:
318 return cpts_extts_enable(cpts, rq->extts.index, on);
326 static bool cpts_match_tx_ts(struct cpts *cpts, struct cpts_event *event)
328 struct sk_buff_head txq_list;
329 struct sk_buff *skb, *tmp;
334 mtype_seqid = event->high &
335 ((MESSAGE_TYPE_MASK << MESSAGE_TYPE_SHIFT) |
336 (SEQUENCE_ID_MASK << SEQUENCE_ID_SHIFT) |
337 (EVENT_TYPE_MASK << EVENT_TYPE_SHIFT));
339 __skb_queue_head_init(&txq_list);
341 spin_lock_irqsave(&cpts->txq.lock, flags);
342 skb_queue_splice_init(&cpts->txq, &txq_list);
343 spin_unlock_irqrestore(&cpts->txq.lock, flags);
345 skb_queue_walk_safe(&txq_list, skb, tmp) {
346 struct skb_shared_hwtstamps ssh;
347 struct cpts_skb_cb_data *skb_cb =
348 (struct cpts_skb_cb_data *)skb->cb;
350 if (mtype_seqid == skb_cb->skb_mtype_seqid) {
351 memset(&ssh, 0, sizeof(ssh));
352 ssh.hwtstamp = ns_to_ktime(event->timestamp);
353 skb_tstamp_tx(skb, &ssh);
355 __skb_unlink(skb, &txq_list);
356 dev_consume_skb_any(skb);
357 dev_dbg(cpts->dev, "match tx timestamp mtype_seqid %08x\n",
362 if (time_after(jiffies, skb_cb->tmo)) {
363 /* timeout any expired skbs over 1s */
364 dev_dbg(cpts->dev, "expiring tx timestamp from txq\n");
365 __skb_unlink(skb, &txq_list);
366 dev_consume_skb_any(skb);
370 spin_lock_irqsave(&cpts->txq.lock, flags);
371 skb_queue_splice(&txq_list, &cpts->txq);
372 spin_unlock_irqrestore(&cpts->txq.lock, flags);
377 static void cpts_process_events(struct cpts *cpts)
379 struct list_head *this, *next;
380 struct cpts_event *event;
381 LIST_HEAD(events_free);
385 spin_lock_irqsave(&cpts->lock, flags);
386 list_splice_init(&cpts->events, &events);
387 spin_unlock_irqrestore(&cpts->lock, flags);
389 list_for_each_safe(this, next, &events) {
390 event = list_entry(this, struct cpts_event, list);
391 if (cpts_match_tx_ts(cpts, event) ||
392 time_after(jiffies, event->tmo)) {
393 list_del_init(&event->list);
394 list_add(&event->list, &events_free);
398 spin_lock_irqsave(&cpts->lock, flags);
399 list_splice_tail(&events, &cpts->events);
400 list_splice_tail(&events_free, &cpts->pool);
401 spin_unlock_irqrestore(&cpts->lock, flags);
404 static long cpts_overflow_check(struct ptp_clock_info *ptp)
406 struct cpts *cpts = container_of(ptp, struct cpts, info);
407 unsigned long delay = cpts->ov_check_period;
411 mutex_lock(&cpts->ptp_clk_mutex);
413 cpts_update_cur_time(cpts, -1, NULL);
414 ns = timecounter_read(&cpts->tc);
416 cpts_process_events(cpts);
418 spin_lock_irqsave(&cpts->txq.lock, flags);
419 if (!skb_queue_empty(&cpts->txq)) {
420 cpts_purge_txq(cpts);
421 if (!skb_queue_empty(&cpts->txq))
422 delay = CPTS_SKB_TX_WORK_TIMEOUT;
424 spin_unlock_irqrestore(&cpts->txq.lock, flags);
426 dev_dbg(cpts->dev, "cpts overflow check at %lld\n", ns);
427 mutex_unlock(&cpts->ptp_clk_mutex);
431 static const struct ptp_clock_info cpts_info = {
432 .owner = THIS_MODULE,
433 .name = "CTPS timer",
438 .adjfreq = cpts_ptp_adjfreq,
439 .adjtime = cpts_ptp_adjtime,
440 .gettimex64 = cpts_ptp_gettimeex,
441 .settime64 = cpts_ptp_settime,
442 .enable = cpts_ptp_enable,
443 .do_aux_work = cpts_overflow_check,
446 static int cpts_skb_get_mtype_seqid(struct sk_buff *skb, u32 *mtype_seqid)
448 unsigned int ptp_class = ptp_classify_raw(skb);
449 u8 *msgtype, *data = skb->data;
450 unsigned int offset = 0;
453 if (ptp_class == PTP_CLASS_NONE)
456 if (ptp_class & PTP_CLASS_VLAN)
459 switch (ptp_class & PTP_CLASS_PMASK) {
461 offset += ETH_HLEN + IPV4_HLEN(data + offset) + UDP_HLEN;
464 offset += ETH_HLEN + IP6_HLEN + UDP_HLEN;
473 if (skb->len + ETH_HLEN < offset + OFF_PTP_SEQUENCE_ID + sizeof(*seqid))
476 if (unlikely(ptp_class & PTP_CLASS_V1))
477 msgtype = data + offset + OFF_PTP_CONTROL;
479 msgtype = data + offset;
481 seqid = (u16 *)(data + offset + OFF_PTP_SEQUENCE_ID);
482 *mtype_seqid = (*msgtype & MESSAGE_TYPE_MASK) << MESSAGE_TYPE_SHIFT;
483 *mtype_seqid |= (ntohs(*seqid) & SEQUENCE_ID_MASK) << SEQUENCE_ID_SHIFT;
488 static u64 cpts_find_ts(struct cpts *cpts, struct sk_buff *skb,
489 int ev_type, u32 skb_mtype_seqid)
491 struct list_head *this, *next;
492 struct cpts_event *event;
497 cpts_fifo_read(cpts, -1);
498 spin_lock_irqsave(&cpts->lock, flags);
499 list_for_each_safe(this, next, &cpts->events) {
500 event = list_entry(this, struct cpts_event, list);
501 if (event_expired(event)) {
502 list_del_init(&event->list);
503 list_add(&event->list, &cpts->pool);
507 mtype_seqid = event->high &
508 ((MESSAGE_TYPE_MASK << MESSAGE_TYPE_SHIFT) |
509 (SEQUENCE_ID_MASK << SEQUENCE_ID_SHIFT) |
510 (EVENT_TYPE_MASK << EVENT_TYPE_SHIFT));
512 if (mtype_seqid == skb_mtype_seqid) {
513 ns = event->timestamp;
514 list_del_init(&event->list);
515 list_add(&event->list, &cpts->pool);
519 spin_unlock_irqrestore(&cpts->lock, flags);
524 void cpts_rx_timestamp(struct cpts *cpts, struct sk_buff *skb)
526 struct cpts_skb_cb_data *skb_cb = (struct cpts_skb_cb_data *)skb->cb;
527 struct skb_shared_hwtstamps *ssh;
531 ret = cpts_skb_get_mtype_seqid(skb, &skb_cb->skb_mtype_seqid);
535 skb_cb->skb_mtype_seqid |= (CPTS_EV_RX << EVENT_TYPE_SHIFT);
537 dev_dbg(cpts->dev, "%s mtype seqid %08x\n",
538 __func__, skb_cb->skb_mtype_seqid);
540 ns = cpts_find_ts(cpts, skb, CPTS_EV_RX, skb_cb->skb_mtype_seqid);
543 ssh = skb_hwtstamps(skb);
544 memset(ssh, 0, sizeof(*ssh));
545 ssh->hwtstamp = ns_to_ktime(ns);
547 EXPORT_SYMBOL_GPL(cpts_rx_timestamp);
549 void cpts_tx_timestamp(struct cpts *cpts, struct sk_buff *skb)
551 struct cpts_skb_cb_data *skb_cb = (struct cpts_skb_cb_data *)skb->cb;
554 if (!(skb_shinfo(skb)->tx_flags & SKBTX_IN_PROGRESS))
557 ret = cpts_skb_get_mtype_seqid(skb, &skb_cb->skb_mtype_seqid);
561 skb_cb->skb_mtype_seqid |= (CPTS_EV_TX << EVENT_TYPE_SHIFT);
563 dev_dbg(cpts->dev, "%s mtype seqid %08x\n",
564 __func__, skb_cb->skb_mtype_seqid);
566 /* Always defer TX TS processing to PTP worker */
568 /* get the timestamp for timeouts */
569 skb_cb->tmo = jiffies + msecs_to_jiffies(CPTS_SKB_RX_TX_TMO);
570 skb_queue_tail(&cpts->txq, skb);
571 ptp_schedule_worker(cpts->clock, 0);
573 EXPORT_SYMBOL_GPL(cpts_tx_timestamp);
575 int cpts_register(struct cpts *cpts)
579 skb_queue_head_init(&cpts->txq);
580 INIT_LIST_HEAD(&cpts->events);
581 INIT_LIST_HEAD(&cpts->pool);
582 for (i = 0; i < CPTS_MAX_EVENTS; i++)
583 list_add(&cpts->pool_data[i].list, &cpts->pool);
585 clk_enable(cpts->refclk);
587 cpts_write32(cpts, CPTS_EN, control);
588 cpts_write32(cpts, TS_PEND_EN, int_enable);
590 timecounter_init(&cpts->tc, &cpts->cc, ktime_get_real_ns());
592 cpts->clock = ptp_clock_register(&cpts->info, cpts->dev);
593 if (IS_ERR(cpts->clock)) {
594 err = PTR_ERR(cpts->clock);
598 cpts->phc_index = ptp_clock_index(cpts->clock);
600 ptp_schedule_worker(cpts->clock, cpts->ov_check_period);
604 clk_disable(cpts->refclk);
607 EXPORT_SYMBOL_GPL(cpts_register);
609 void cpts_unregister(struct cpts *cpts)
611 if (WARN_ON(!cpts->clock))
614 ptp_clock_unregister(cpts->clock);
617 cpts_write32(cpts, 0, int_enable);
618 cpts_write32(cpts, 0, control);
620 /* Drop all packet */
621 skb_queue_purge(&cpts->txq);
623 clk_disable(cpts->refclk);
625 EXPORT_SYMBOL_GPL(cpts_unregister);
627 static void cpts_calc_mult_shift(struct cpts *cpts)
629 u64 frac, maxsec, ns;
632 freq = clk_get_rate(cpts->refclk);
634 /* Calc the maximum number of seconds which we can run before
637 maxsec = cpts->cc.mask;
638 do_div(maxsec, freq);
639 /* limit conversation rate to 10 sec as higher values will produce
640 * too small mult factors and so reduce the conversion accuracy
645 /* Calc overflow check period (maxsec / 2) */
646 cpts->ov_check_period = (HZ * maxsec) / 2;
647 dev_info(cpts->dev, "cpts: overflow check period %lu (jiffies)\n",
648 cpts->ov_check_period);
650 if (cpts->cc.mult || cpts->cc.shift)
653 clocks_calc_mult_shift(&cpts->cc.mult, &cpts->cc.shift,
654 freq, NSEC_PER_SEC, maxsec);
657 ns = cyclecounter_cyc2ns(&cpts->cc, freq, cpts->cc.mask, &frac);
660 "CPTS: ref_clk_freq:%u calc_mult:%u calc_shift:%u error:%lld nsec/sec\n",
661 freq, cpts->cc.mult, cpts->cc.shift, (ns - NSEC_PER_SEC));
664 static int cpts_of_mux_clk_setup(struct cpts *cpts, struct device_node *node)
666 struct device_node *refclk_np;
667 const char **parent_names;
668 unsigned int num_parents;
669 struct clk_hw *clk_hw;
673 refclk_np = of_get_child_by_name(node, "cpts-refclk-mux");
675 /* refclk selection supported not for all SoCs */
678 num_parents = of_clk_get_parent_count(refclk_np);
679 if (num_parents < 1) {
680 dev_err(cpts->dev, "mux-clock %s must have parents\n",
685 parent_names = devm_kzalloc(cpts->dev, (sizeof(char *) * num_parents),
688 mux_table = devm_kzalloc(cpts->dev, sizeof(*mux_table) * num_parents,
690 if (!mux_table || !parent_names) {
695 of_clk_parent_fill(refclk_np, parent_names, num_parents);
697 ret = of_property_read_variable_u32_array(refclk_np, "ti,mux-tbl",
699 num_parents, num_parents);
703 clk_hw = clk_hw_register_mux_table(cpts->dev, refclk_np->name,
704 parent_names, num_parents,
706 &cpts->reg->rftclk_sel, 0, 0x1F,
708 if (IS_ERR(clk_hw)) {
709 ret = PTR_ERR(clk_hw);
713 ret = devm_add_action_or_reset(cpts->dev,
714 (void(*)(void *))clk_hw_unregister_mux,
717 dev_err(cpts->dev, "add clkmux unreg action %d", ret);
721 ret = of_clk_add_hw_provider(refclk_np, of_clk_hw_simple_get, clk_hw);
725 ret = devm_add_action_or_reset(cpts->dev,
726 (void(*)(void *))of_clk_del_provider,
729 dev_err(cpts->dev, "add clkmux provider unreg action %d", ret);
736 of_node_put(refclk_np);
740 static int cpts_of_parse(struct cpts *cpts, struct device_node *node)
745 if (!of_property_read_u32(node, "cpts_clock_mult", &prop))
746 cpts->cc.mult = prop;
748 if (!of_property_read_u32(node, "cpts_clock_shift", &prop))
749 cpts->cc.shift = prop;
751 if ((cpts->cc.mult && !cpts->cc.shift) ||
752 (!cpts->cc.mult && cpts->cc.shift))
755 return cpts_of_mux_clk_setup(cpts, node);
758 dev_err(cpts->dev, "CPTS: Missing property in the DT.\n");
762 struct cpts *cpts_create(struct device *dev, void __iomem *regs,
763 struct device_node *node, u32 n_ext_ts)
768 cpts = devm_kzalloc(dev, sizeof(*cpts), GFP_KERNEL);
770 return ERR_PTR(-ENOMEM);
773 cpts->reg = (struct cpsw_cpts __iomem *)regs;
774 cpts->irq_poll = true;
775 spin_lock_init(&cpts->lock);
776 mutex_init(&cpts->ptp_clk_mutex);
777 init_completion(&cpts->ts_push_complete);
779 ret = cpts_of_parse(cpts, node);
783 cpts->refclk = devm_get_clk_from_child(dev, node, "cpts");
784 if (IS_ERR(cpts->refclk))
785 /* try get clk from dev node for compatibility */
786 cpts->refclk = devm_clk_get(dev, "cpts");
788 if (IS_ERR(cpts->refclk)) {
789 dev_err(dev, "Failed to get cpts refclk %ld\n",
790 PTR_ERR(cpts->refclk));
791 return ERR_CAST(cpts->refclk);
794 ret = clk_prepare(cpts->refclk);
798 cpts->cc.read = cpts_systim_read;
799 cpts->cc.mask = CLOCKSOURCE_MASK(32);
800 cpts->info = cpts_info;
803 cpts->info.n_ext_ts = n_ext_ts;
805 cpts_calc_mult_shift(cpts);
806 /* save cc.mult original value as it can be modified
807 * by cpts_ptp_adjfreq().
809 cpts->cc_mult = cpts->cc.mult;
813 EXPORT_SYMBOL_GPL(cpts_create);
815 void cpts_release(struct cpts *cpts)
820 if (WARN_ON(!cpts->refclk))
823 clk_unprepare(cpts->refclk);
825 EXPORT_SYMBOL_GPL(cpts_release);
827 MODULE_LICENSE("GPL v2");
828 MODULE_DESCRIPTION("TI CPTS driver");