28  * DOC: IPA Filter and Route Tables
36  * filter or route table rules.  Separate tables (both filter and route)
38  * route tables, which are used when a hash of message metadata matches.
73  * The set of available route rules is divided about equally between the AP
74  * and modem.  The AP initializes all entries in a route table to refer to
76  * updating their own entries.  All entries in a route table are usable,
79  *                    IPA Route Table
81  * 1st modem route | 0x0001234500001100 | DMA address for first route rule
83  * 2nd modem route | 0x0001234500001140 | DMA address for second route rule
87  * Last modem route| 0x0001234500002280 | DMA address for Nth route rule
89  * 1st AP route    | 0x0001234500001100 | DMA address for route rule (N+1)
91  * 2nd AP route    | 0x0001234500001140 | DMA address for next route rule
95  * Last AP route   | 0x0001234500002280 | DMA address for last route rule
99 /* IPA hardware constrains filter and route tables alignment */
102 /* Assignment of route table entries to the modem and AP */
110 /* Filter or route rules consist of a set of 32-bit values followed by a
122 	 * referred to by entries in filter and route tables must be  in ipa_table_validate_build()
129 	/* Filter and route tables contain DMA addresses that refer to  in ipa_table_validate_build()
130 	 * filter or route rules.  We use a fixed constant to represent  in ipa_table_validate_build()
145 	/* The modem must be allotted at least one route table entry */  in ipa_table_validate_build()
153 ipa_table_valid_one(struct ipa *ipa, bool route, bool ipv6, bool hashed)  in ipa_table_valid_one()  argument
159 	if (route) {  in ipa_table_valid_one()
177 	if (!ipa_cmd_table_valid(ipa, mem, route, ipv6, hashed))  in ipa_table_valid_one()
190 		route ? "route" : "filter", mem->size, size);  in ipa_table_valid_one()
195 /* Verify the filter and route table memory regions are the expected size */
361 			"no transaction for %s route reset\n",  in ipa_route_reset()
397 	/* Report errors, but reset filter and route tables */  in ipa_table_reset()
405 		dev_err(dev, "error %d resetting route table for %s\n",  in ipa_table_reset()
450 	 * will have the same number of entries.  The size of the route  in ipa_table_init_add()
511  * the filter hash values without changing route ones.
534 	/* IPA version 4.2 has no hashed route tables */  in ipa_filter_config()
562  * ipa_route_tuple_zero() - Zero a hashed route table entry tuple
564  * @route_id:	Route table entry whose hash tuple should be zeroed
566  * Updates the route hash values without changing filter ones.
575 	/* Zero all route-related fields, preserving the rest */  in ipa_route_tuple_zero()
585 	/* IPA version 4.2 has no hashed route tables */  in ipa_route_config()
617  * route table data.  This is used when initializing or resetting the IPA
618  * filter or route table.
628  * Each entry in a route table is the DMA address of a routing rule.  For
630  * when a route table is initialized or reset, its entries are made to refer
631  * to the zero rule.  The zero rule is shared for route and filter tables.
633  * Note that the IPA hardware requires a filter or route rule address to be