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 */
115 /* Filter or route rules consist of a set of 32-bit values followed by a
124 	/* Filter and route tables contain DMA addresses that refer  in ipa_table_validate_build()
125 	 * to filter or route rules.  But the size of a table entry  in ipa_table_validate_build()
141 	/* The modem must be allotted at least one route table entry */  in ipa_table_validate_build()
149 ipa_table_valid_one(struct ipa *ipa, enum ipa_mem_id mem_id, bool route)  in ipa_table_valid_one()  argument
155 	if (route)  in ipa_table_valid_one()
160 	if (!ipa_cmd_table_valid(ipa, mem, route))  in ipa_table_valid_one()
172 		route ? "route" : "filter", mem_id, mem->size, size);  in ipa_table_valid_one()
177 /* Verify the filter and route table memory regions are the expected size */
339 			"no transaction for %s route reset\n",  in ipa_route_reset()
373 	/* Report errors, but reset filter and route tables */  in ipa_table_reset()
381 		dev_err(dev, "error %d resetting route table for %s\n",  in ipa_table_reset()
443 		/* The size of a route table region determines the number  in ipa_table_init_add()
481 	 *     - One for route table initialization (non-hashed and hashed)  in ipa_table_setup()
486 	 *     - One for route table initialization (non-hashed and hashed)  in ipa_table_setup()
520  * the filter hash values without changing route ones.
569  * ipa_route_tuple_zero() - Zero a hashed route table entry tuple
571  * @route_id:	Route table entry whose hash tuple should be zeroed
573  * Updates the route hash values without changing filter ones.
586 	/* Zero all route-related fields, preserving the rest */  in ipa_route_tuple_zero()
592 /* Configure a hashed route table; there is no ipa_route_deconfig() */
605 /* Configure a filter and route tables; there is no ipa_table_deconfig() */
616  * route table data.  This is used when initializing or resetting the IPA
617  * filter or route table.
627  * Each entry in a route table is the DMA address of a routing rule.  For
629  * when a route table is initialized or reset, its entries are made to refer
630  * to the zero rule.  The zero rule is shared for route and filter tables.
632  * Note that the IPA hardware requires a filter or route rule address to be
663 	/* The IPA hardware requires route and filter table rules to be  in ipa_table_init()