1 // SPDX-License-Identifier: GPL-2.0
2 /* Copyright (c) 2018-2019, Vladimir Oltean <olteanv@gmail.com>
6 /* In the dynamic configuration interface, the switch exposes a register-like
7 * view of some of the static configuration tables.
8 * Many times the field organization of the dynamic tables is abbreviated (not
9 * all fields are dynamically reconfigurable) and different from the static
10 * ones, but the key reason for having it is that we can spare a switch reset
11 * for settings that can be changed dynamically.
13 * This file creates a per-switch-family abstraction called
14 * struct sja1105_dynamic_table_ops and two operations that work with it:
15 * - sja1105_dynamic_config_write
16 * - sja1105_dynamic_config_read
18 * Compared to the struct sja1105_table_ops from sja1105_static_config.c,
19 * the dynamic accessors work with a compound buffer:
25 * +-----------------------------------------+------------------+
26 * | ENTRY BUFFER | COMMAND BUFFER |
27 * +-----------------------------------------+------------------+
29 * <----------------------- packed_size ------------------------>
31 * The ENTRY BUFFER may or may not have the same layout, or size, as its static
32 * configuration table entry counterpart. When it does, the same packing
33 * function is reused (bar exceptional cases - see
34 * sja1105pqrs_dyn_l2_lookup_entry_packing).
36 * The reason for the COMMAND BUFFER being at the end is to be able to send
37 * a dynamic write command through a single SPI burst. By the time the switch
38 * reacts to the command, the ENTRY BUFFER is already populated with the data
41 * The COMMAND BUFFER is always SJA1105_SIZE_DYN_CMD bytes (one 32-bit word) in
44 * Sometimes the ENTRY BUFFER does not really exist (when the number of fields
45 * that can be reconfigured is small), then the switch repurposes some of the
46 * unused 32 bits of the COMMAND BUFFER to hold ENTRY data.
48 * The key members of struct sja1105_dynamic_table_ops are:
49 * - .entry_packing: A function that deals with packing an ENTRY structure
50 * into an SPI buffer, or retrieving an ENTRY structure
52 * The @packed_buf pointer it's given does always point to
53 * the ENTRY portion of the buffer.
54 * - .cmd_packing: A function that deals with packing/unpacking the COMMAND
55 * structure to/from the SPI buffer.
56 * It is given the same @packed_buf pointer as .entry_packing,
57 * so most of the time, the @packed_buf points *behind* the
58 * COMMAND offset inside the buffer.
59 * To access the COMMAND portion of the buffer, the function
60 * knows its correct offset.
61 * Giving both functions the same pointer is handy because in
62 * extreme cases (see sja1105pqrs_dyn_l2_lookup_entry_packing)
63 * the .entry_packing is able to jump to the COMMAND portion,
64 * or vice-versa (sja1105pqrs_l2_lookup_cmd_packing).
65 * - .access: A bitmap of:
66 * OP_READ: Set if the hardware manual marks the ENTRY portion of the
67 * dynamic configuration table buffer as R (readable) after
68 * an SPI read command (the switch will populate the buffer).
69 * OP_WRITE: Set if the manual marks the ENTRY portion of the dynamic
70 * table buffer as W (writable) after an SPI write command
71 * (the switch will read the fields provided in the buffer).
72 * OP_DEL: Set if the manual says the VALIDENT bit is supported in the
73 * COMMAND portion of this dynamic config buffer (i.e. the
74 * specified entry can be invalidated through a SPI write
76 * OP_SEARCH: Set if the manual says that the index of an entry can
77 * be retrieved in the COMMAND portion of the buffer based
78 * on its ENTRY portion, as a result of a SPI write command.
79 * Only the TCAM-based FDB table on SJA1105 P/Q/R/S supports
81 * - .max_entry_count: The number of entries, counting from zero, that can be
82 * reconfigured through the dynamic interface. If a static
83 * table can be reconfigured at all dynamically, this
84 * number always matches the maximum number of supported
86 * - .packed_size: The length in bytes of the compound ENTRY + COMMAND BUFFER.
87 * Note that sometimes the compound buffer may contain holes in
88 * it (see sja1105_vlan_lookup_cmd_packing). The @packed_buf is
89 * contiguous however, so @packed_size includes any unused
91 * - .addr: The base SPI address at which the buffer must be written to the
92 * switch's memory. When looking at the hardware manual, this must
93 * always match the lowest documented address for the ENTRY, and not
94 * that of the COMMAND, since the other 32-bit words will follow along
95 * at the correct addresses.
98 #define SJA1105_SIZE_DYN_CMD 4
100 #define SJA1105ET_SIZE_MAC_CONFIG_DYN_ENTRY \
103 #define SJA1105ET_SIZE_L2_LOOKUP_DYN_CMD \
104 (SJA1105_SIZE_DYN_CMD + SJA1105ET_SIZE_L2_LOOKUP_ENTRY)
106 #define SJA1105PQRS_SIZE_L2_LOOKUP_DYN_CMD \
107 (SJA1105_SIZE_DYN_CMD + SJA1105PQRS_SIZE_L2_LOOKUP_ENTRY)
109 #define SJA1105_SIZE_VLAN_LOOKUP_DYN_CMD \
110 (SJA1105_SIZE_DYN_CMD + 4 + SJA1105_SIZE_VLAN_LOOKUP_ENTRY)
112 #define SJA1105_SIZE_L2_FORWARDING_DYN_CMD \
113 (SJA1105_SIZE_DYN_CMD + SJA1105_SIZE_L2_FORWARDING_ENTRY)
115 #define SJA1105ET_SIZE_MAC_CONFIG_DYN_CMD \
116 (SJA1105_SIZE_DYN_CMD + SJA1105ET_SIZE_MAC_CONFIG_DYN_ENTRY)
118 #define SJA1105PQRS_SIZE_MAC_CONFIG_DYN_CMD \
119 (SJA1105_SIZE_DYN_CMD + SJA1105PQRS_SIZE_MAC_CONFIG_ENTRY)
121 #define SJA1105ET_SIZE_L2_LOOKUP_PARAMS_DYN_CMD \
124 #define SJA1105ET_SIZE_GENERAL_PARAMS_DYN_CMD \
127 #define SJA1105_MAX_DYN_CMD_SIZE \
128 SJA1105PQRS_SIZE_MAC_CONFIG_DYN_CMD
130 struct sja1105_dyn_cmd {
139 enum sja1105_hostcmd {
140 SJA1105_HOSTCMD_SEARCH = 1,
141 SJA1105_HOSTCMD_READ = 2,
142 SJA1105_HOSTCMD_WRITE = 3,
143 SJA1105_HOSTCMD_INVALIDATE = 4,
147 sja1105pqrs_l2_lookup_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
150 u8 *p = buf + SJA1105PQRS_SIZE_L2_LOOKUP_ENTRY;
151 const int size = SJA1105_SIZE_DYN_CMD;
154 sja1105_packing(p, &cmd->valid, 31, 31, size, op);
155 sja1105_packing(p, &cmd->rdwrset, 30, 30, size, op);
156 sja1105_packing(p, &cmd->errors, 29, 29, size, op);
157 sja1105_packing(p, &cmd->valident, 27, 27, size, op);
159 /* VALIDENT is supposed to indicate "keep or not", but in SJA1105 E/T,
160 * using it to delete a management route was unsupported. UM10944
163 * In case of a write access with the MGMTROUTE flag set,
164 * the flag will be ignored. It will always be found cleared
165 * for read accesses with the MGMTROUTE flag set.
167 * SJA1105 P/Q/R/S keeps the same behavior w.r.t. VALIDENT, but there
168 * is now another flag called HOSTCMD which does more stuff (quoting
171 * A write request is accepted only when HOSTCMD is set to write host
172 * or invalid. A read request is accepted only when HOSTCMD is set to
173 * search host or read host.
175 * So it is possible to translate a RDWRSET/VALIDENT combination into
176 * HOSTCMD so that we keep the dynamic command API in place, and
177 * at the same time achieve compatibility with the management route
180 if (cmd->rdwrset == SPI_READ) {
182 hostcmd = SJA1105_HOSTCMD_SEARCH;
184 hostcmd = SJA1105_HOSTCMD_READ;
188 hostcmd = SJA1105_HOSTCMD_WRITE;
190 hostcmd = SJA1105_HOSTCMD_INVALIDATE;
192 sja1105_packing(p, &hostcmd, 25, 23, size, op);
194 /* Hack - The hardware takes the 'index' field within
195 * struct sja1105_l2_lookup_entry as the index on which this command
196 * will operate. However it will ignore everything else, so 'index'
197 * is logically part of command but physically part of entry.
198 * Populate the 'index' entry field from within the command callback,
199 * such that our API doesn't need to ask for a full-blown entry
200 * structure when e.g. a delete is requested.
202 sja1105_packing(buf, &cmd->index, 15, 6,
203 SJA1105PQRS_SIZE_L2_LOOKUP_ENTRY, op);
206 /* The switch is so retarded that it makes our command/entry abstraction
209 * On P/Q/R/S, the switch tries to say whether a FDB entry
210 * is statically programmed or dynamically learned via a flag called LOCKEDS.
211 * The hardware manual says about this fiels:
213 * On write will specify the format of ENTRY.
214 * On read the flag will be found cleared at times the VALID flag is found
215 * set. The flag will also be found cleared in response to a read having the
216 * MGMTROUTE flag set. In response to a read with the MGMTROUTE flag
217 * cleared, the flag be set if the most recent access operated on an entry
218 * that was either loaded by configuration or through dynamic reconfiguration
219 * (as opposed to automatically learned entries).
221 * The trouble with this flag is that it's part of the *command* to access the
222 * dynamic interface, and not part of the *entry* retrieved from it.
223 * Otherwise said, for a sja1105_dynamic_config_read, LOCKEDS is supposed to be
224 * an output from the switch into the command buffer, and for a
225 * sja1105_dynamic_config_write, the switch treats LOCKEDS as an input
226 * (hence we can write either static, or automatically learned entries, from
228 * But the manual contradicts itself in the last phrase where it says that on
229 * read, LOCKEDS will be set to 1 for all FDB entries written through the
230 * dynamic interface (therefore, the value of LOCKEDS from the
231 * sja1105_dynamic_config_write is not really used for anything, it'll store a
233 * This means you can't really write a FDB entry with LOCKEDS=0 (automatically
234 * learned) into the switch, which kind of makes sense.
235 * As for reading through the dynamic interface, it doesn't make too much sense
236 * to put LOCKEDS into the command, since the switch will inevitably have to
237 * ignore it (otherwise a command would be like "read the FDB entry 123, but
238 * only if it's dynamically learned" <- well how am I supposed to know?) and
239 * just use it as an output buffer for its findings. But guess what... that's
240 * what the entry buffer is for!
241 * Unfortunately, what really breaks this abstraction is the fact that it
242 * wasn't designed having the fact in mind that the switch can output
243 * entry-related data as writeback through the command buffer.
244 * However, whether a FDB entry is statically or dynamically learned *is* part
245 * of the entry and not the command data, no matter what the switch thinks.
246 * In order to do that, we'll need to wrap around the
247 * sja1105pqrs_l2_lookup_entry_packing from sja1105_static_config.c, and take
248 * a peek outside of the caller-supplied @buf (the entry buffer), to reach the
252 sja1105pqrs_dyn_l2_lookup_entry_packing(void *buf, void *entry_ptr,
255 struct sja1105_l2_lookup_entry *entry = entry_ptr;
256 u8 *cmd = buf + SJA1105PQRS_SIZE_L2_LOOKUP_ENTRY;
257 const int size = SJA1105_SIZE_DYN_CMD;
259 sja1105_packing(cmd, &entry->lockeds, 28, 28, size, op);
261 return sja1105pqrs_l2_lookup_entry_packing(buf, entry_ptr, op);
265 sja1105et_l2_lookup_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
268 u8 *p = buf + SJA1105ET_SIZE_L2_LOOKUP_ENTRY;
269 const int size = SJA1105_SIZE_DYN_CMD;
271 sja1105_packing(p, &cmd->valid, 31, 31, size, op);
272 sja1105_packing(p, &cmd->rdwrset, 30, 30, size, op);
273 sja1105_packing(p, &cmd->errors, 29, 29, size, op);
274 sja1105_packing(p, &cmd->valident, 27, 27, size, op);
275 /* Hack - see comments above. */
276 sja1105_packing(buf, &cmd->index, 29, 20,
277 SJA1105ET_SIZE_L2_LOOKUP_ENTRY, op);
281 sja1105et_mgmt_route_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
284 u8 *p = buf + SJA1105ET_SIZE_L2_LOOKUP_ENTRY;
287 sja1105et_l2_lookup_cmd_packing(buf, cmd, op);
289 sja1105_pack(p, &mgmtroute, 26, 26, SJA1105_SIZE_DYN_CMD);
292 static size_t sja1105et_mgmt_route_entry_packing(void *buf, void *entry_ptr,
295 struct sja1105_mgmt_entry *entry = entry_ptr;
296 const size_t size = SJA1105ET_SIZE_L2_LOOKUP_ENTRY;
298 /* UM10944: To specify if a PTP egress timestamp shall be captured on
299 * each port upon transmission of the frame, the LSB of VLANID in the
300 * ENTRY field provided by the host must be set.
301 * Bit 1 of VLANID then specifies the register where the timestamp for
302 * this port is stored in.
304 sja1105_packing(buf, &entry->tsreg, 85, 85, size, op);
305 sja1105_packing(buf, &entry->takets, 84, 84, size, op);
306 sja1105_packing(buf, &entry->macaddr, 83, 36, size, op);
307 sja1105_packing(buf, &entry->destports, 35, 31, size, op);
308 sja1105_packing(buf, &entry->enfport, 30, 30, size, op);
313 sja1105pqrs_mgmt_route_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
316 u8 *p = buf + SJA1105PQRS_SIZE_L2_LOOKUP_ENTRY;
319 sja1105pqrs_l2_lookup_cmd_packing(buf, cmd, op);
321 sja1105_pack(p, &mgmtroute, 26, 26, SJA1105_SIZE_DYN_CMD);
324 static size_t sja1105pqrs_mgmt_route_entry_packing(void *buf, void *entry_ptr,
327 const size_t size = SJA1105PQRS_SIZE_L2_LOOKUP_ENTRY;
328 struct sja1105_mgmt_entry *entry = entry_ptr;
330 /* In P/Q/R/S, enfport got renamed to mgmtvalid, but its purpose
331 * is the same (driver uses it to confirm that frame was sent).
332 * So just keep the name from E/T.
334 sja1105_packing(buf, &entry->tsreg, 71, 71, size, op);
335 sja1105_packing(buf, &entry->takets, 70, 70, size, op);
336 sja1105_packing(buf, &entry->macaddr, 69, 22, size, op);
337 sja1105_packing(buf, &entry->destports, 21, 17, size, op);
338 sja1105_packing(buf, &entry->enfport, 16, 16, size, op);
342 /* In E/T, entry is at addresses 0x27-0x28. There is a 4 byte gap at 0x29,
343 * and command is at 0x2a. Similarly in P/Q/R/S there is a 1 register gap
344 * between entry (0x2d, 0x2e) and command (0x30).
347 sja1105_vlan_lookup_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
350 u8 *p = buf + SJA1105_SIZE_VLAN_LOOKUP_ENTRY + 4;
351 const int size = SJA1105_SIZE_DYN_CMD;
353 sja1105_packing(p, &cmd->valid, 31, 31, size, op);
354 sja1105_packing(p, &cmd->rdwrset, 30, 30, size, op);
355 sja1105_packing(p, &cmd->valident, 27, 27, size, op);
356 /* Hack - see comments above, applied for 'vlanid' field of
357 * struct sja1105_vlan_lookup_entry.
359 sja1105_packing(buf, &cmd->index, 38, 27,
360 SJA1105_SIZE_VLAN_LOOKUP_ENTRY, op);
364 sja1105_l2_forwarding_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
367 u8 *p = buf + SJA1105_SIZE_L2_FORWARDING_ENTRY;
368 const int size = SJA1105_SIZE_DYN_CMD;
370 sja1105_packing(p, &cmd->valid, 31, 31, size, op);
371 sja1105_packing(p, &cmd->errors, 30, 30, size, op);
372 sja1105_packing(p, &cmd->rdwrset, 29, 29, size, op);
373 sja1105_packing(p, &cmd->index, 4, 0, size, op);
377 sja1105et_mac_config_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
380 const int size = SJA1105_SIZE_DYN_CMD;
381 /* Yup, user manual definitions are reversed */
384 sja1105_packing(reg1, &cmd->valid, 31, 31, size, op);
385 sja1105_packing(reg1, &cmd->index, 26, 24, size, op);
388 static size_t sja1105et_mac_config_entry_packing(void *buf, void *entry_ptr,
391 const int size = SJA1105ET_SIZE_MAC_CONFIG_DYN_ENTRY;
392 struct sja1105_mac_config_entry *entry = entry_ptr;
393 /* Yup, user manual definitions are reversed */
397 sja1105_packing(reg1, &entry->speed, 30, 29, size, op);
398 sja1105_packing(reg1, &entry->drpdtag, 23, 23, size, op);
399 sja1105_packing(reg1, &entry->drpuntag, 22, 22, size, op);
400 sja1105_packing(reg1, &entry->retag, 21, 21, size, op);
401 sja1105_packing(reg1, &entry->dyn_learn, 20, 20, size, op);
402 sja1105_packing(reg1, &entry->egress, 19, 19, size, op);
403 sja1105_packing(reg1, &entry->ingress, 18, 18, size, op);
404 sja1105_packing(reg1, &entry->ing_mirr, 17, 17, size, op);
405 sja1105_packing(reg1, &entry->egr_mirr, 16, 16, size, op);
406 sja1105_packing(reg1, &entry->vlanprio, 14, 12, size, op);
407 sja1105_packing(reg1, &entry->vlanid, 11, 0, size, op);
408 sja1105_packing(reg2, &entry->tp_delin, 31, 16, size, op);
409 sja1105_packing(reg2, &entry->tp_delout, 15, 0, size, op);
410 /* MAC configuration table entries which can't be reconfigured:
411 * top, base, enabled, ifg, maxage, drpnona664
413 /* Bogus return value, not used anywhere */
418 sja1105pqrs_mac_config_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
421 const int size = SJA1105ET_SIZE_MAC_CONFIG_DYN_ENTRY;
422 u8 *p = buf + SJA1105PQRS_SIZE_MAC_CONFIG_ENTRY;
424 sja1105_packing(p, &cmd->valid, 31, 31, size, op);
425 sja1105_packing(p, &cmd->errors, 30, 30, size, op);
426 sja1105_packing(p, &cmd->rdwrset, 29, 29, size, op);
427 sja1105_packing(p, &cmd->index, 2, 0, size, op);
431 sja1105et_l2_lookup_params_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
434 sja1105_packing(buf, &cmd->valid, 31, 31,
435 SJA1105ET_SIZE_L2_LOOKUP_PARAMS_DYN_CMD, op);
439 sja1105et_l2_lookup_params_entry_packing(void *buf, void *entry_ptr,
442 struct sja1105_l2_lookup_params_entry *entry = entry_ptr;
444 sja1105_packing(buf, &entry->poly, 7, 0,
445 SJA1105ET_SIZE_L2_LOOKUP_PARAMS_DYN_CMD, op);
446 /* Bogus return value, not used anywhere */
451 sja1105et_general_params_cmd_packing(void *buf, struct sja1105_dyn_cmd *cmd,
454 const int size = SJA1105ET_SIZE_GENERAL_PARAMS_DYN_CMD;
456 sja1105_packing(buf, &cmd->valid, 31, 31, size, op);
457 sja1105_packing(buf, &cmd->errors, 30, 30, size, op);
461 sja1105et_general_params_entry_packing(void *buf, void *entry_ptr,
464 struct sja1105_general_params_entry *entry = entry_ptr;
465 const int size = SJA1105ET_SIZE_GENERAL_PARAMS_DYN_CMD;
467 sja1105_packing(buf, &entry->mirr_port, 2, 0, size, op);
468 /* Bogus return value, not used anywhere */
472 #define OP_READ BIT(0)
473 #define OP_WRITE BIT(1)
474 #define OP_DEL BIT(2)
475 #define OP_SEARCH BIT(3)
477 /* SJA1105E/T: First generation */
478 struct sja1105_dynamic_table_ops sja1105et_dyn_ops[BLK_IDX_MAX_DYN] = {
479 [BLK_IDX_L2_LOOKUP] = {
480 .entry_packing = sja1105et_l2_lookup_entry_packing,
481 .cmd_packing = sja1105et_l2_lookup_cmd_packing,
482 .access = (OP_READ | OP_WRITE | OP_DEL),
483 .max_entry_count = SJA1105_MAX_L2_LOOKUP_COUNT,
484 .packed_size = SJA1105ET_SIZE_L2_LOOKUP_DYN_CMD,
487 [BLK_IDX_MGMT_ROUTE] = {
488 .entry_packing = sja1105et_mgmt_route_entry_packing,
489 .cmd_packing = sja1105et_mgmt_route_cmd_packing,
490 .access = (OP_READ | OP_WRITE),
491 .max_entry_count = SJA1105_NUM_PORTS,
492 .packed_size = SJA1105ET_SIZE_L2_LOOKUP_DYN_CMD,
495 [BLK_IDX_L2_POLICING] = {0},
496 [BLK_IDX_VLAN_LOOKUP] = {
497 .entry_packing = sja1105_vlan_lookup_entry_packing,
498 .cmd_packing = sja1105_vlan_lookup_cmd_packing,
499 .access = (OP_WRITE | OP_DEL),
500 .max_entry_count = SJA1105_MAX_VLAN_LOOKUP_COUNT,
501 .packed_size = SJA1105_SIZE_VLAN_LOOKUP_DYN_CMD,
504 [BLK_IDX_L2_FORWARDING] = {
505 .entry_packing = sja1105_l2_forwarding_entry_packing,
506 .cmd_packing = sja1105_l2_forwarding_cmd_packing,
507 .max_entry_count = SJA1105_MAX_L2_FORWARDING_COUNT,
509 .packed_size = SJA1105_SIZE_L2_FORWARDING_DYN_CMD,
512 [BLK_IDX_MAC_CONFIG] = {
513 .entry_packing = sja1105et_mac_config_entry_packing,
514 .cmd_packing = sja1105et_mac_config_cmd_packing,
515 .max_entry_count = SJA1105_MAX_MAC_CONFIG_COUNT,
517 .packed_size = SJA1105ET_SIZE_MAC_CONFIG_DYN_CMD,
520 [BLK_IDX_L2_LOOKUP_PARAMS] = {
521 .entry_packing = sja1105et_l2_lookup_params_entry_packing,
522 .cmd_packing = sja1105et_l2_lookup_params_cmd_packing,
523 .max_entry_count = SJA1105_MAX_L2_LOOKUP_PARAMS_COUNT,
525 .packed_size = SJA1105ET_SIZE_L2_LOOKUP_PARAMS_DYN_CMD,
528 [BLK_IDX_L2_FORWARDING_PARAMS] = {0},
529 [BLK_IDX_AVB_PARAMS] = {0},
530 [BLK_IDX_GENERAL_PARAMS] = {
531 .entry_packing = sja1105et_general_params_entry_packing,
532 .cmd_packing = sja1105et_general_params_cmd_packing,
533 .max_entry_count = SJA1105_MAX_GENERAL_PARAMS_COUNT,
535 .packed_size = SJA1105ET_SIZE_GENERAL_PARAMS_DYN_CMD,
538 [BLK_IDX_XMII_PARAMS] = {0},
541 /* SJA1105P/Q/R/S: Second generation */
542 struct sja1105_dynamic_table_ops sja1105pqrs_dyn_ops[BLK_IDX_MAX_DYN] = {
543 [BLK_IDX_L2_LOOKUP] = {
544 .entry_packing = sja1105pqrs_dyn_l2_lookup_entry_packing,
545 .cmd_packing = sja1105pqrs_l2_lookup_cmd_packing,
546 .access = (OP_READ | OP_WRITE | OP_DEL | OP_SEARCH),
547 .max_entry_count = SJA1105_MAX_L2_LOOKUP_COUNT,
548 .packed_size = SJA1105PQRS_SIZE_L2_LOOKUP_DYN_CMD,
551 [BLK_IDX_MGMT_ROUTE] = {
552 .entry_packing = sja1105pqrs_mgmt_route_entry_packing,
553 .cmd_packing = sja1105pqrs_mgmt_route_cmd_packing,
554 .access = (OP_READ | OP_WRITE | OP_DEL | OP_SEARCH),
555 .max_entry_count = SJA1105_NUM_PORTS,
556 .packed_size = SJA1105PQRS_SIZE_L2_LOOKUP_DYN_CMD,
559 [BLK_IDX_L2_POLICING] = {0},
560 [BLK_IDX_VLAN_LOOKUP] = {
561 .entry_packing = sja1105_vlan_lookup_entry_packing,
562 .cmd_packing = sja1105_vlan_lookup_cmd_packing,
563 .access = (OP_READ | OP_WRITE | OP_DEL),
564 .max_entry_count = SJA1105_MAX_VLAN_LOOKUP_COUNT,
565 .packed_size = SJA1105_SIZE_VLAN_LOOKUP_DYN_CMD,
568 [BLK_IDX_L2_FORWARDING] = {
569 .entry_packing = sja1105_l2_forwarding_entry_packing,
570 .cmd_packing = sja1105_l2_forwarding_cmd_packing,
571 .max_entry_count = SJA1105_MAX_L2_FORWARDING_COUNT,
573 .packed_size = SJA1105_SIZE_L2_FORWARDING_DYN_CMD,
576 [BLK_IDX_MAC_CONFIG] = {
577 .entry_packing = sja1105pqrs_mac_config_entry_packing,
578 .cmd_packing = sja1105pqrs_mac_config_cmd_packing,
579 .max_entry_count = SJA1105_MAX_MAC_CONFIG_COUNT,
580 .access = (OP_READ | OP_WRITE),
581 .packed_size = SJA1105PQRS_SIZE_MAC_CONFIG_DYN_CMD,
584 [BLK_IDX_L2_LOOKUP_PARAMS] = {
585 .entry_packing = sja1105et_l2_lookup_params_entry_packing,
586 .cmd_packing = sja1105et_l2_lookup_params_cmd_packing,
587 .max_entry_count = SJA1105_MAX_L2_LOOKUP_PARAMS_COUNT,
588 .access = (OP_READ | OP_WRITE),
589 .packed_size = SJA1105ET_SIZE_L2_LOOKUP_PARAMS_DYN_CMD,
592 [BLK_IDX_L2_FORWARDING_PARAMS] = {0},
593 [BLK_IDX_AVB_PARAMS] = {0},
594 [BLK_IDX_GENERAL_PARAMS] = {
595 .entry_packing = sja1105et_general_params_entry_packing,
596 .cmd_packing = sja1105et_general_params_cmd_packing,
597 .max_entry_count = SJA1105_MAX_GENERAL_PARAMS_COUNT,
599 .packed_size = SJA1105ET_SIZE_GENERAL_PARAMS_DYN_CMD,
602 [BLK_IDX_XMII_PARAMS] = {0},
605 /* Provides read access to the settings through the dynamic interface
607 * @blk_idx is used as key to select from the sja1105_dynamic_table_ops.
608 * The selection is limited by the hardware in respect to which
609 * configuration blocks can be read through the dynamic interface.
610 * @index is used to retrieve a particular table entry. If negative,
611 * (and if the @blk_idx supports the searching operation) a search
612 * is performed by the @entry parameter.
613 * @entry Type-casted to an unpacked structure that holds a table entry
614 * of the type specified in @blk_idx.
615 * Usually an output argument. If @index is negative, then this
616 * argument is used as input/output: it should be pre-populated
617 * with the element to search for. Entries which support the
618 * search operation will have an "index" field (not the @index
619 * argument to this function) and that is where the found index
620 * will be returned (or left unmodified - thus negative - if not
623 int sja1105_dynamic_config_read(struct sja1105_private *priv,
624 enum sja1105_blk_idx blk_idx,
625 int index, void *entry)
627 const struct sja1105_dynamic_table_ops *ops;
628 struct sja1105_dyn_cmd cmd = {0};
629 /* SPI payload buffer */
630 u8 packed_buf[SJA1105_MAX_DYN_CMD_SIZE] = {0};
634 if (blk_idx >= BLK_IDX_MAX_DYN)
637 ops = &priv->info->dyn_ops[blk_idx];
639 if (index >= 0 && index >= ops->max_entry_count)
641 if (index < 0 && !(ops->access & OP_SEARCH))
643 if (!(ops->access & OP_READ))
645 if (ops->packed_size > SJA1105_MAX_DYN_CMD_SIZE)
647 if (!ops->cmd_packing)
649 if (!ops->entry_packing)
652 cmd.valid = true; /* Trigger action on table entry */
653 cmd.rdwrset = SPI_READ; /* Action is read */
655 /* Avoid copying a signed negative number to an u64 */
663 ops->cmd_packing(packed_buf, &cmd, PACK);
666 ops->entry_packing(packed_buf, entry, PACK);
668 /* Send SPI write operation: read config table entry */
669 rc = sja1105_spi_send_packed_buf(priv, SPI_WRITE, ops->addr,
670 packed_buf, ops->packed_size);
674 /* Loop until we have confirmation that hardware has finished
675 * processing the command and has cleared the VALID field
678 memset(packed_buf, 0, ops->packed_size);
680 /* Retrieve the read operation's result */
681 rc = sja1105_spi_send_packed_buf(priv, SPI_READ, ops->addr,
682 packed_buf, ops->packed_size);
686 cmd = (struct sja1105_dyn_cmd) {0};
687 ops->cmd_packing(packed_buf, &cmd, UNPACK);
688 /* UM10944: [valident] will always be found cleared
689 * during a read access with MGMTROUTE set.
690 * So don't error out in that case.
692 if (!cmd.valident && blk_idx != BLK_IDX_MGMT_ROUTE)
695 } while (cmd.valid && --retries);
700 /* Don't dereference possibly NULL pointer - maybe caller
701 * only wanted to see whether the entry existed or not.
704 ops->entry_packing(packed_buf, entry, UNPACK);
708 int sja1105_dynamic_config_write(struct sja1105_private *priv,
709 enum sja1105_blk_idx blk_idx,
710 int index, void *entry, bool keep)
712 const struct sja1105_dynamic_table_ops *ops;
713 struct sja1105_dyn_cmd cmd = {0};
714 /* SPI payload buffer */
715 u8 packed_buf[SJA1105_MAX_DYN_CMD_SIZE] = {0};
718 if (blk_idx >= BLK_IDX_MAX_DYN)
721 ops = &priv->info->dyn_ops[blk_idx];
723 if (index >= ops->max_entry_count)
727 if (!(ops->access & OP_WRITE))
729 if (!keep && !(ops->access & OP_DEL))
731 if (ops->packed_size > SJA1105_MAX_DYN_CMD_SIZE)
734 cmd.valident = keep; /* If false, deletes entry */
735 cmd.valid = true; /* Trigger action on table entry */
736 cmd.rdwrset = SPI_WRITE; /* Action is write */
739 if (!ops->cmd_packing)
741 ops->cmd_packing(packed_buf, &cmd, PACK);
743 if (!ops->entry_packing)
745 /* Don't dereference potentially NULL pointer if just
746 * deleting a table entry is what was requested. For cases
747 * where 'index' field is physically part of entry structure,
748 * and needed here, we deal with that in the cmd_packing callback.
751 ops->entry_packing(packed_buf, entry, PACK);
753 /* Send SPI write operation: read config table entry */
754 rc = sja1105_spi_send_packed_buf(priv, SPI_WRITE, ops->addr,
755 packed_buf, ops->packed_size);
759 cmd = (struct sja1105_dyn_cmd) {0};
760 ops->cmd_packing(packed_buf, &cmd, UNPACK);
767 static u8 sja1105_crc8_add(u8 crc, u8 byte, u8 poly)
771 for (i = 0; i < 8; i++) {
772 if ((crc ^ byte) & (1 << 7)) {
783 /* CRC8 algorithm with non-reversed input, non-reversed output,
784 * no input xor and no output xor. Code customized for receiving
785 * the SJA1105 E/T FDB keys (vlanid, macaddr) as input. CRC polynomial
786 * is also received as argument in the Koopman notation that the switch
787 * hardware stores it in.
789 u8 sja1105et_fdb_hash(struct sja1105_private *priv, const u8 *addr, u16 vid)
791 struct sja1105_l2_lookup_params_entry *l2_lookup_params =
792 priv->static_config.tables[BLK_IDX_L2_LOOKUP_PARAMS].entries;
793 u64 poly_koopman = l2_lookup_params->poly;
794 /* Convert polynomial from Koopman to 'normal' notation */
795 u8 poly = (u8)(1 + (poly_koopman << 1));
796 u64 vlanid = l2_lookup_params->shared_learn ? 0 : vid;
797 u64 input = (vlanid << 48) | ether_addr_to_u64(addr);
798 u8 crc = 0; /* seed */
801 /* Mask the eight bytes starting from MSB one at a time */
802 for (i = 56; i >= 0; i -= 8) {
803 u8 byte = (input & (0xffull << i)) >> i;
805 crc = sja1105_crc8_add(crc, byte, poly);