28  * DOC: IPA Filter and Route Tables
35  * Separate tables (both filter and route) used for IPv4 and IPv6.  There
36  * are normally another set of "hashed" filter and route tables, which are
41  * an object (such as a route or filter table) in IPA-resident memory must
42  * 128-byte aligned.  An object in system memory (such as a route or filter
44  * route or filter rules in system memory.
49  * filter or route table rules.
83  * The set of available route rules is divided about equally between the AP
84  * and modem.  The AP initializes all entries in a route table to refer to
86  * updating their own entries.  All entries in a route table are usable,
89  *                    IPA Route Table
91  * 1st modem route | 0x0001234500001100 | DMA address for first route rule
93  * 2nd modem route | 0x0001234500001140 | DMA address for second route rule
97  * Last modem route| 0x0001234500002280 | DMA address for Nth route rule
99  * 1st AP route    | 0x0001234500001100 | DMA address for route rule (N+1)
101  * 2nd AP route    | 0x0001234500001140 | DMA address for next route rule
105  * Last AP route   | 0x0001234500002280 | DMA address for last route rule
109 /* Assignment of route table entries to the modem and AP */
117 /* Filter or route rules consist of a set of 32-bit values followed by a
126 	/* Filter and route tables contain DMA addresses that refer  in ipa_table_validate_build()
127 	 * to filter or route rules.  But the size of a table entry  in ipa_table_validate_build()
143 	/* The modem must be allotted at least one route table entry */  in ipa_table_validate_build()
151 ipa_table_valid_one(struct ipa *ipa, enum ipa_mem_id mem_id, bool route)  in ipa_table_valid_one()  argument
157 	if (route)  in ipa_table_valid_one()
162 	if (!ipa_cmd_table_valid(ipa, mem, route))  in ipa_table_valid_one()
174 		route ? "route" : "filter", mem_id, mem->size, size);  in ipa_table_valid_one()
179 /* Verify the filter and route table memory regions are the expected size */
341 			"no transaction for %s route reset\n",  in ipa_route_reset()
375 	/* Report errors, but reset filter and route tables */  in ipa_table_reset()
383 		dev_err(dev, "error %d resetting route table for %s\n",  in ipa_table_reset()
429 	 * will have the same number of entries.  The size of the route  in ipa_table_init_add()
482  * the filter hash values without changing route ones.
528  * ipa_route_tuple_zero() - Zero a hashed route table entry tuple
530  * @route_id:	Route table entry whose hash tuple should be zeroed
532  * Updates the route hash values without changing filter ones.
541 	/* Zero all route-related fields, preserving the rest */  in ipa_route_tuple_zero()
547 /* Configure a hashed route table; there is no ipa_route_deconfig() */
560 /* Configure a filter and route tables; there is no ipa_table_deconfig() */
571  * route table data.  This is used when initializing or resetting the IPA
572  * filter or route table.
582  * Each entry in a route table is the DMA address of a routing rule.  For
584  * when a route table is initialized or reset, its entries are made to refer
585  * to the zero rule.  The zero rule is shared for route and filter tables.
587  * Note that the IPA hardware requires a filter or route rule address to be
618 	/* The IPA hardware requires route and filter table rules to be  in ipa_table_init()