Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

can: bittiming: move bittiming calculation functions to calc_bittiming.c

The canonical way to select or deselect an object during compilation
is to use this pattern in the relevant Makefile:

bar-$(CONFIG_FOO) := foo.o

bittiming.c instead uses some #ifdef CONFIG_CAN_CALC_BITTIMG.

Create a new file named calc_bittiming.c with all the functions which
are conditionally compiled with CONFIG_CAN_CALC_BITTIMG and modify the
Makefile according to above pattern.

Link: https://lore.kernel.org/all/20220610143009.323579-4-mailhol.vincent@wanadoo.fr
Signed-off-by: Vincent Mailhol <mailhol.vincent@wanadoo.fr>
Acked-by: Max Staudt <max@enpas.org>
Tested-by: Oliver Hartkopp <socketcan@hartkopp.net>
Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de>

authored by

Vincent Mailhol and committed by
Marc Kleine-Budde
0c7e1151 6a528644

+207 -197
+4
drivers/net/can/Kconfig
··· 96 96 source clock frequencies. Disabling saves some space, but then the 97 97 bit-timing parameters must be specified directly using the Netlink 98 98 arguments "tq", "prop_seg", "phase_seg1", "phase_seg2" and "sjw". 99 + 100 + The additional features selected by this option will be added to the 101 + can-dev module. 102 + 99 103 If unsure, say Y. 100 104 101 105 config CAN_AT91
+1
drivers/net/can/dev/Makefile
··· 4 4 5 5 can-dev-y += skb.o 6 6 7 + can-dev-$(CONFIG_CAN_CALC_BITTIMING) += calc_bittiming.o 7 8 can-dev-$(CONFIG_CAN_NETLINK) += bittiming.o 8 9 can-dev-$(CONFIG_CAN_NETLINK) += dev.o 9 10 can-dev-$(CONFIG_CAN_NETLINK) += length.o
-197
drivers/net/can/dev/bittiming.c
··· 4 4 * Copyright (C) 2008-2009 Wolfgang Grandegger <wg@grandegger.com> 5 5 */ 6 6 7 - #include <linux/units.h> 8 7 #include <linux/can/dev.h> 9 - 10 - #ifdef CONFIG_CAN_CALC_BITTIMING 11 - #define CAN_CALC_MAX_ERROR 50 /* in one-tenth of a percent */ 12 - 13 - /* Bit-timing calculation derived from: 14 - * 15 - * Code based on LinCAN sources and H8S2638 project 16 - * Copyright 2004-2006 Pavel Pisa - DCE FELK CVUT cz 17 - * Copyright 2005 Stanislav Marek 18 - * email: pisa@cmp.felk.cvut.cz 19 - * 20 - * Calculates proper bit-timing parameters for a specified bit-rate 21 - * and sample-point, which can then be used to set the bit-timing 22 - * registers of the CAN controller. You can find more information 23 - * in the header file linux/can/netlink.h. 24 - */ 25 - static int 26 - can_update_sample_point(const struct can_bittiming_const *btc, 27 - const unsigned int sample_point_nominal, const unsigned int tseg, 28 - unsigned int *tseg1_ptr, unsigned int *tseg2_ptr, 29 - unsigned int *sample_point_error_ptr) 30 - { 31 - unsigned int sample_point_error, best_sample_point_error = UINT_MAX; 32 - unsigned int sample_point, best_sample_point = 0; 33 - unsigned int tseg1, tseg2; 34 - int i; 35 - 36 - for (i = 0; i <= 1; i++) { 37 - tseg2 = tseg + CAN_SYNC_SEG - 38 - (sample_point_nominal * (tseg + CAN_SYNC_SEG)) / 39 - 1000 - i; 40 - tseg2 = clamp(tseg2, btc->tseg2_min, btc->tseg2_max); 41 - tseg1 = tseg - tseg2; 42 - if (tseg1 > btc->tseg1_max) { 43 - tseg1 = btc->tseg1_max; 44 - tseg2 = tseg - tseg1; 45 - } 46 - 47 - sample_point = 1000 * (tseg + CAN_SYNC_SEG - tseg2) / 48 - (tseg + CAN_SYNC_SEG); 49 - sample_point_error = abs(sample_point_nominal - sample_point); 50 - 51 - if (sample_point <= sample_point_nominal && 52 - sample_point_error < best_sample_point_error) { 53 - best_sample_point = sample_point; 54 - best_sample_point_error = sample_point_error; 55 - *tseg1_ptr = tseg1; 56 - *tseg2_ptr = tseg2; 57 - } 58 - } 59 - 60 - if (sample_point_error_ptr) 61 - *sample_point_error_ptr = best_sample_point_error; 62 - 63 - return best_sample_point; 64 - } 65 - 66 - int can_calc_bittiming(const struct net_device *dev, struct can_bittiming *bt, 67 - const struct can_bittiming_const *btc) 68 - { 69 - struct can_priv *priv = netdev_priv(dev); 70 - unsigned int bitrate; /* current bitrate */ 71 - unsigned int bitrate_error; /* difference between current and nominal value */ 72 - unsigned int best_bitrate_error = UINT_MAX; 73 - unsigned int sample_point_error; /* difference between current and nominal value */ 74 - unsigned int best_sample_point_error = UINT_MAX; 75 - unsigned int sample_point_nominal; /* nominal sample point */ 76 - unsigned int best_tseg = 0; /* current best value for tseg */ 77 - unsigned int best_brp = 0; /* current best value for brp */ 78 - unsigned int brp, tsegall, tseg, tseg1 = 0, tseg2 = 0; 79 - u64 v64; 80 - 81 - /* Use CiA recommended sample points */ 82 - if (bt->sample_point) { 83 - sample_point_nominal = bt->sample_point; 84 - } else { 85 - if (bt->bitrate > 800 * KILO /* BPS */) 86 - sample_point_nominal = 750; 87 - else if (bt->bitrate > 500 * KILO /* BPS */) 88 - sample_point_nominal = 800; 89 - else 90 - sample_point_nominal = 875; 91 - } 92 - 93 - /* tseg even = round down, odd = round up */ 94 - for (tseg = (btc->tseg1_max + btc->tseg2_max) * 2 + 1; 95 - tseg >= (btc->tseg1_min + btc->tseg2_min) * 2; tseg--) { 96 - tsegall = CAN_SYNC_SEG + tseg / 2; 97 - 98 - /* Compute all possible tseg choices (tseg=tseg1+tseg2) */ 99 - brp = priv->clock.freq / (tsegall * bt->bitrate) + tseg % 2; 100 - 101 - /* choose brp step which is possible in system */ 102 - brp = (brp / btc->brp_inc) * btc->brp_inc; 103 - if (brp < btc->brp_min || brp > btc->brp_max) 104 - continue; 105 - 106 - bitrate = priv->clock.freq / (brp * tsegall); 107 - bitrate_error = abs(bt->bitrate - bitrate); 108 - 109 - /* tseg brp biterror */ 110 - if (bitrate_error > best_bitrate_error) 111 - continue; 112 - 113 - /* reset sample point error if we have a better bitrate */ 114 - if (bitrate_error < best_bitrate_error) 115 - best_sample_point_error = UINT_MAX; 116 - 117 - can_update_sample_point(btc, sample_point_nominal, tseg / 2, 118 - &tseg1, &tseg2, &sample_point_error); 119 - if (sample_point_error >= best_sample_point_error) 120 - continue; 121 - 122 - best_sample_point_error = sample_point_error; 123 - best_bitrate_error = bitrate_error; 124 - best_tseg = tseg / 2; 125 - best_brp = brp; 126 - 127 - if (bitrate_error == 0 && sample_point_error == 0) 128 - break; 129 - } 130 - 131 - if (best_bitrate_error) { 132 - /* Error in one-tenth of a percent */ 133 - v64 = (u64)best_bitrate_error * 1000; 134 - do_div(v64, bt->bitrate); 135 - bitrate_error = (u32)v64; 136 - if (bitrate_error > CAN_CALC_MAX_ERROR) { 137 - netdev_err(dev, 138 - "bitrate error %d.%d%% too high\n", 139 - bitrate_error / 10, bitrate_error % 10); 140 - return -EDOM; 141 - } 142 - netdev_warn(dev, "bitrate error %d.%d%%\n", 143 - bitrate_error / 10, bitrate_error % 10); 144 - } 145 - 146 - /* real sample point */ 147 - bt->sample_point = can_update_sample_point(btc, sample_point_nominal, 148 - best_tseg, &tseg1, &tseg2, 149 - NULL); 150 - 151 - v64 = (u64)best_brp * 1000 * 1000 * 1000; 152 - do_div(v64, priv->clock.freq); 153 - bt->tq = (u32)v64; 154 - bt->prop_seg = tseg1 / 2; 155 - bt->phase_seg1 = tseg1 - bt->prop_seg; 156 - bt->phase_seg2 = tseg2; 157 - 158 - /* check for sjw user settings */ 159 - if (!bt->sjw || !btc->sjw_max) { 160 - bt->sjw = 1; 161 - } else { 162 - /* bt->sjw is at least 1 -> sanitize upper bound to sjw_max */ 163 - if (bt->sjw > btc->sjw_max) 164 - bt->sjw = btc->sjw_max; 165 - /* bt->sjw must not be higher than tseg2 */ 166 - if (tseg2 < bt->sjw) 167 - bt->sjw = tseg2; 168 - } 169 - 170 - bt->brp = best_brp; 171 - 172 - /* real bitrate */ 173 - bt->bitrate = priv->clock.freq / 174 - (bt->brp * (CAN_SYNC_SEG + tseg1 + tseg2)); 175 - 176 - return 0; 177 - } 178 - 179 - void can_calc_tdco(struct can_tdc *tdc, const struct can_tdc_const *tdc_const, 180 - const struct can_bittiming *dbt, 181 - u32 *ctrlmode, u32 ctrlmode_supported) 182 - 183 - { 184 - if (!tdc_const || !(ctrlmode_supported & CAN_CTRLMODE_TDC_AUTO)) 185 - return; 186 - 187 - *ctrlmode &= ~CAN_CTRLMODE_TDC_MASK; 188 - 189 - /* As specified in ISO 11898-1 section 11.3.3 "Transmitter 190 - * delay compensation" (TDC) is only applicable if data BRP is 191 - * one or two. 192 - */ 193 - if (dbt->brp == 1 || dbt->brp == 2) { 194 - /* Sample point in clock periods */ 195 - u32 sample_point_in_tc = (CAN_SYNC_SEG + dbt->prop_seg + 196 - dbt->phase_seg1) * dbt->brp; 197 - 198 - if (sample_point_in_tc < tdc_const->tdco_min) 199 - return; 200 - tdc->tdco = min(sample_point_in_tc, tdc_const->tdco_max); 201 - *ctrlmode |= CAN_CTRLMODE_TDC_AUTO; 202 - } 203 - } 204 - #endif /* CONFIG_CAN_CALC_BITTIMING */ 205 8 206 9 /* Checks the validity of the specified bit-timing parameters prop_seg, 207 10 * phase_seg1, phase_seg2 and sjw and tries to determine the bitrate
+202
drivers/net/can/dev/calc_bittiming.c
··· 1 + // SPDX-License-Identifier: GPL-2.0-only 2 + /* Copyright (C) 2005 Marc Kleine-Budde, Pengutronix 3 + * Copyright (C) 2006 Andrey Volkov, Varma Electronics 4 + * Copyright (C) 2008-2009 Wolfgang Grandegger <wg@grandegger.com> 5 + */ 6 + 7 + #include <linux/units.h> 8 + #include <linux/can/dev.h> 9 + 10 + #define CAN_CALC_MAX_ERROR 50 /* in one-tenth of a percent */ 11 + 12 + /* Bit-timing calculation derived from: 13 + * 14 + * Code based on LinCAN sources and H8S2638 project 15 + * Copyright 2004-2006 Pavel Pisa - DCE FELK CVUT cz 16 + * Copyright 2005 Stanislav Marek 17 + * email: pisa@cmp.felk.cvut.cz 18 + * 19 + * Calculates proper bit-timing parameters for a specified bit-rate 20 + * and sample-point, which can then be used to set the bit-timing 21 + * registers of the CAN controller. You can find more information 22 + * in the header file linux/can/netlink.h. 23 + */ 24 + static int 25 + can_update_sample_point(const struct can_bittiming_const *btc, 26 + const unsigned int sample_point_nominal, const unsigned int tseg, 27 + unsigned int *tseg1_ptr, unsigned int *tseg2_ptr, 28 + unsigned int *sample_point_error_ptr) 29 + { 30 + unsigned int sample_point_error, best_sample_point_error = UINT_MAX; 31 + unsigned int sample_point, best_sample_point = 0; 32 + unsigned int tseg1, tseg2; 33 + int i; 34 + 35 + for (i = 0; i <= 1; i++) { 36 + tseg2 = tseg + CAN_SYNC_SEG - 37 + (sample_point_nominal * (tseg + CAN_SYNC_SEG)) / 38 + 1000 - i; 39 + tseg2 = clamp(tseg2, btc->tseg2_min, btc->tseg2_max); 40 + tseg1 = tseg - tseg2; 41 + if (tseg1 > btc->tseg1_max) { 42 + tseg1 = btc->tseg1_max; 43 + tseg2 = tseg - tseg1; 44 + } 45 + 46 + sample_point = 1000 * (tseg + CAN_SYNC_SEG - tseg2) / 47 + (tseg + CAN_SYNC_SEG); 48 + sample_point_error = abs(sample_point_nominal - sample_point); 49 + 50 + if (sample_point <= sample_point_nominal && 51 + sample_point_error < best_sample_point_error) { 52 + best_sample_point = sample_point; 53 + best_sample_point_error = sample_point_error; 54 + *tseg1_ptr = tseg1; 55 + *tseg2_ptr = tseg2; 56 + } 57 + } 58 + 59 + if (sample_point_error_ptr) 60 + *sample_point_error_ptr = best_sample_point_error; 61 + 62 + return best_sample_point; 63 + } 64 + 65 + int can_calc_bittiming(const struct net_device *dev, struct can_bittiming *bt, 66 + const struct can_bittiming_const *btc) 67 + { 68 + struct can_priv *priv = netdev_priv(dev); 69 + unsigned int bitrate; /* current bitrate */ 70 + unsigned int bitrate_error; /* difference between current and nominal value */ 71 + unsigned int best_bitrate_error = UINT_MAX; 72 + unsigned int sample_point_error; /* difference between current and nominal value */ 73 + unsigned int best_sample_point_error = UINT_MAX; 74 + unsigned int sample_point_nominal; /* nominal sample point */ 75 + unsigned int best_tseg = 0; /* current best value for tseg */ 76 + unsigned int best_brp = 0; /* current best value for brp */ 77 + unsigned int brp, tsegall, tseg, tseg1 = 0, tseg2 = 0; 78 + u64 v64; 79 + 80 + /* Use CiA recommended sample points */ 81 + if (bt->sample_point) { 82 + sample_point_nominal = bt->sample_point; 83 + } else { 84 + if (bt->bitrate > 800 * KILO /* BPS */) 85 + sample_point_nominal = 750; 86 + else if (bt->bitrate > 500 * KILO /* BPS */) 87 + sample_point_nominal = 800; 88 + else 89 + sample_point_nominal = 875; 90 + } 91 + 92 + /* tseg even = round down, odd = round up */ 93 + for (tseg = (btc->tseg1_max + btc->tseg2_max) * 2 + 1; 94 + tseg >= (btc->tseg1_min + btc->tseg2_min) * 2; tseg--) { 95 + tsegall = CAN_SYNC_SEG + tseg / 2; 96 + 97 + /* Compute all possible tseg choices (tseg=tseg1+tseg2) */ 98 + brp = priv->clock.freq / (tsegall * bt->bitrate) + tseg % 2; 99 + 100 + /* choose brp step which is possible in system */ 101 + brp = (brp / btc->brp_inc) * btc->brp_inc; 102 + if (brp < btc->brp_min || brp > btc->brp_max) 103 + continue; 104 + 105 + bitrate = priv->clock.freq / (brp * tsegall); 106 + bitrate_error = abs(bt->bitrate - bitrate); 107 + 108 + /* tseg brp biterror */ 109 + if (bitrate_error > best_bitrate_error) 110 + continue; 111 + 112 + /* reset sample point error if we have a better bitrate */ 113 + if (bitrate_error < best_bitrate_error) 114 + best_sample_point_error = UINT_MAX; 115 + 116 + can_update_sample_point(btc, sample_point_nominal, tseg / 2, 117 + &tseg1, &tseg2, &sample_point_error); 118 + if (sample_point_error >= best_sample_point_error) 119 + continue; 120 + 121 + best_sample_point_error = sample_point_error; 122 + best_bitrate_error = bitrate_error; 123 + best_tseg = tseg / 2; 124 + best_brp = brp; 125 + 126 + if (bitrate_error == 0 && sample_point_error == 0) 127 + break; 128 + } 129 + 130 + if (best_bitrate_error) { 131 + /* Error in one-tenth of a percent */ 132 + v64 = (u64)best_bitrate_error * 1000; 133 + do_div(v64, bt->bitrate); 134 + bitrate_error = (u32)v64; 135 + if (bitrate_error > CAN_CALC_MAX_ERROR) { 136 + netdev_err(dev, 137 + "bitrate error %d.%d%% too high\n", 138 + bitrate_error / 10, bitrate_error % 10); 139 + return -EDOM; 140 + } 141 + netdev_warn(dev, "bitrate error %d.%d%%\n", 142 + bitrate_error / 10, bitrate_error % 10); 143 + } 144 + 145 + /* real sample point */ 146 + bt->sample_point = can_update_sample_point(btc, sample_point_nominal, 147 + best_tseg, &tseg1, &tseg2, 148 + NULL); 149 + 150 + v64 = (u64)best_brp * 1000 * 1000 * 1000; 151 + do_div(v64, priv->clock.freq); 152 + bt->tq = (u32)v64; 153 + bt->prop_seg = tseg1 / 2; 154 + bt->phase_seg1 = tseg1 - bt->prop_seg; 155 + bt->phase_seg2 = tseg2; 156 + 157 + /* check for sjw user settings */ 158 + if (!bt->sjw || !btc->sjw_max) { 159 + bt->sjw = 1; 160 + } else { 161 + /* bt->sjw is at least 1 -> sanitize upper bound to sjw_max */ 162 + if (bt->sjw > btc->sjw_max) 163 + bt->sjw = btc->sjw_max; 164 + /* bt->sjw must not be higher than tseg2 */ 165 + if (tseg2 < bt->sjw) 166 + bt->sjw = tseg2; 167 + } 168 + 169 + bt->brp = best_brp; 170 + 171 + /* real bitrate */ 172 + bt->bitrate = priv->clock.freq / 173 + (bt->brp * (CAN_SYNC_SEG + tseg1 + tseg2)); 174 + 175 + return 0; 176 + } 177 + 178 + void can_calc_tdco(struct can_tdc *tdc, const struct can_tdc_const *tdc_const, 179 + const struct can_bittiming *dbt, 180 + u32 *ctrlmode, u32 ctrlmode_supported) 181 + 182 + { 183 + if (!tdc_const || !(ctrlmode_supported & CAN_CTRLMODE_TDC_AUTO)) 184 + return; 185 + 186 + *ctrlmode &= ~CAN_CTRLMODE_TDC_MASK; 187 + 188 + /* As specified in ISO 11898-1 section 11.3.3 "Transmitter 189 + * delay compensation" (TDC) is only applicable if data BRP is 190 + * one or two. 191 + */ 192 + if (dbt->brp == 1 || dbt->brp == 2) { 193 + /* Sample point in clock periods */ 194 + u32 sample_point_in_tc = (CAN_SYNC_SEG + dbt->prop_seg + 195 + dbt->phase_seg1) * dbt->brp; 196 + 197 + if (sample_point_in_tc < tdc_const->tdco_min) 198 + return; 199 + tdc->tdco = min(sample_point_in_tc, tdc_const->tdco_max); 200 + *ctrlmode |= CAN_CTRLMODE_TDC_AUTO; 201 + } 202 + }