forked from ~ljy/RK356X_SDK_RELEASE

hc
2024-01-04 1543e317f1da31b75942316931e8f491a8920811
kernel/drivers/firmware/ti_sci.h
....@@ -1,4 +1,4 @@
1
-// SPDX-License-Identifier: BSD-3-Clause
1
+/* SPDX-License-Identifier: BSD-3-Clause */
22 /*
33 * Texas Instruments System Control Interface (TISCI) Protocol
44 *
....@@ -6,7 +6,7 @@
66 * The system works in a message response protocol
77 * See: http://processors.wiki.ti.com/index.php/TISCI for details
88 *
9
- * Copyright (C) 2015-2016 Texas Instruments Incorporated - http://www.ti.com/
9
+ * Copyright (C) 2015-2016 Texas Instruments Incorporated - https://www.ti.com/
1010 */
1111
1212 #ifndef __TI_SCI_H
....@@ -34,6 +34,50 @@
3434 #define TI_SCI_MSG_SET_CLOCK_FREQ 0x010c
3535 #define TI_SCI_MSG_QUERY_CLOCK_FREQ 0x010d
3636 #define TI_SCI_MSG_GET_CLOCK_FREQ 0x010e
37
+
38
+/* Resource Management Requests */
39
+#define TI_SCI_MSG_GET_RESOURCE_RANGE 0x1500
40
+
41
+/* IRQ requests */
42
+#define TI_SCI_MSG_SET_IRQ 0x1000
43
+#define TI_SCI_MSG_FREE_IRQ 0x1001
44
+
45
+/* NAVSS resource management */
46
+/* Ringacc requests */
47
+#define TI_SCI_MSG_RM_RING_ALLOCATE 0x1100
48
+#define TI_SCI_MSG_RM_RING_FREE 0x1101
49
+#define TI_SCI_MSG_RM_RING_RECONFIG 0x1102
50
+#define TI_SCI_MSG_RM_RING_RESET 0x1103
51
+#define TI_SCI_MSG_RM_RING_CFG 0x1110
52
+#define TI_SCI_MSG_RM_RING_GET_CFG 0x1111
53
+
54
+/* PSI-L requests */
55
+#define TI_SCI_MSG_RM_PSIL_PAIR 0x1280
56
+#define TI_SCI_MSG_RM_PSIL_UNPAIR 0x1281
57
+
58
+#define TI_SCI_MSG_RM_UDMAP_TX_ALLOC 0x1200
59
+#define TI_SCI_MSG_RM_UDMAP_TX_FREE 0x1201
60
+#define TI_SCI_MSG_RM_UDMAP_RX_ALLOC 0x1210
61
+#define TI_SCI_MSG_RM_UDMAP_RX_FREE 0x1211
62
+#define TI_SCI_MSG_RM_UDMAP_FLOW_CFG 0x1220
63
+#define TI_SCI_MSG_RM_UDMAP_OPT_FLOW_CFG 0x1221
64
+
65
+#define TISCI_MSG_RM_UDMAP_TX_CH_CFG 0x1205
66
+#define TISCI_MSG_RM_UDMAP_TX_CH_GET_CFG 0x1206
67
+#define TISCI_MSG_RM_UDMAP_RX_CH_CFG 0x1215
68
+#define TISCI_MSG_RM_UDMAP_RX_CH_GET_CFG 0x1216
69
+#define TISCI_MSG_RM_UDMAP_FLOW_CFG 0x1230
70
+#define TISCI_MSG_RM_UDMAP_FLOW_SIZE_THRESH_CFG 0x1231
71
+#define TISCI_MSG_RM_UDMAP_FLOW_GET_CFG 0x1232
72
+#define TISCI_MSG_RM_UDMAP_FLOW_SIZE_THRESH_GET_CFG 0x1233
73
+
74
+/* Processor Control requests */
75
+#define TI_SCI_MSG_PROC_REQUEST 0xc000
76
+#define TI_SCI_MSG_PROC_RELEASE 0xc001
77
+#define TI_SCI_MSG_PROC_HANDOVER 0xc005
78
+#define TI_SCI_MSG_SET_CONFIG 0xc100
79
+#define TI_SCI_MSG_SET_CTRL 0xc101
80
+#define TI_SCI_MSG_GET_STATUS 0xc400
3781
3882 /**
3983 * struct ti_sci_msg_hdr - Generic Message Header for All messages and responses
....@@ -195,7 +239,8 @@
195239 * @dev_id: Device identifier this request is for
196240 * @clk_id: Clock identifier for the device for this request.
197241 * Each device has it's own set of clock inputs. This indexes
198
- * which clock input to modify.
242
+ * which clock input to modify. Set to 255 if clock ID is
243
+ * greater than or equal to 255.
199244 * @request_state: Request the state for the clock to be set to.
200245 * MSG_CLOCK_SW_STATE_UNREQ: The IP does not require this clock,
201246 * it can be disabled, regardless of the state of the device
....@@ -206,6 +251,9 @@
206251 * being required by the device.(default)
207252 * MSG_CLOCK_SW_STATE_REQ: Configure the clock to be enabled,
208253 * regardless of the state of the device.
254
+ * @clk_id_32: Clock identifier for the device for this request.
255
+ * Only to be used if the clock ID is greater than or equal to
256
+ * 255.
209257 *
210258 * Normally, all required clocks are managed by TISCI entity, this is used
211259 * only for specific control *IF* required. Auto managed state is
....@@ -227,6 +275,7 @@
227275 #define MSG_CLOCK_SW_STATE_AUTO 1
228276 #define MSG_CLOCK_SW_STATE_REQ 2
229277 u8 request_state;
278
+ u32 clk_id_32;
230279 } __packed;
231280
232281 /**
....@@ -235,7 +284,11 @@
235284 * @dev_id: Device identifier this request is for
236285 * @clk_id: Clock identifier for the device for this request.
237286 * Each device has it's own set of clock inputs. This indexes
238
- * which clock input to get state of.
287
+ * which clock input to get state of. Set to 255 if the clock
288
+ * ID is greater than or equal to 255.
289
+ * @clk_id_32: Clock identifier for the device for the request.
290
+ * Only to be used if the clock ID is greater than or equal to
291
+ * 255.
239292 *
240293 * Request type is TI_SCI_MSG_GET_CLOCK_STATE, response is state
241294 * of the clock
....@@ -244,6 +297,7 @@
244297 struct ti_sci_msg_hdr hdr;
245298 u32 dev_id;
246299 u8 clk_id;
300
+ u32 clk_id_32;
247301 } __packed;
248302
249303 /**
....@@ -271,9 +325,13 @@
271325 * @dev_id: Device identifier this request is for
272326 * @clk_id: Clock identifier for the device for this request.
273327 * Each device has it's own set of clock inputs. This indexes
274
- * which clock input to modify.
328
+ * which clock input to modify. Set to 255 if clock ID is
329
+ * greater than or equal to 255.
275330 * @parent_id: The new clock parent is selectable by an index via this
276
- * parameter.
331
+ * parameter. Set to 255 if clock ID is greater than or
332
+ * equal to 255.
333
+ * @clk_id_32: Clock identifier if @clk_id field is 255.
334
+ * @parent_id_32: Parent identifier if @parent_id is 255.
277335 *
278336 * Request type is TI_SCI_MSG_SET_CLOCK_PARENT, response is generic
279337 * ACK / NACK message.
....@@ -283,6 +341,8 @@
283341 u32 dev_id;
284342 u8 clk_id;
285343 u8 parent_id;
344
+ u32 clk_id_32;
345
+ u32 parent_id_32;
286346 } __packed;
287347
288348 /**
....@@ -291,7 +351,10 @@
291351 * @dev_id: Device identifier this request is for
292352 * @clk_id: Clock identifier for the device for this request.
293353 * Each device has it's own set of clock inputs. This indexes
294
- * which clock input to get the parent for.
354
+ * which clock input to get the parent for. If this field
355
+ * contains 255, the actual clock identifier is stored in
356
+ * @clk_id_32.
357
+ * @clk_id_32: Clock identifier if the @clk_id field contains 255.
295358 *
296359 * Request type is TI_SCI_MSG_GET_CLOCK_PARENT, response is parent information
297360 */
....@@ -299,25 +362,32 @@
299362 struct ti_sci_msg_hdr hdr;
300363 u32 dev_id;
301364 u8 clk_id;
365
+ u32 clk_id_32;
302366 } __packed;
303367
304368 /**
305369 * struct ti_sci_msg_resp_get_clock_parent - Response with clock parent
306370 * @hdr: Generic Header
307
- * @parent_id: The current clock parent
371
+ * @parent_id: The current clock parent. If set to 255, the current parent
372
+ * ID can be found from the @parent_id_32 field.
373
+ * @parent_id_32: Current clock parent if @parent_id field is set to
374
+ * 255.
308375 *
309376 * Response to TI_SCI_MSG_GET_CLOCK_PARENT.
310377 */
311378 struct ti_sci_msg_resp_get_clock_parent {
312379 struct ti_sci_msg_hdr hdr;
313380 u8 parent_id;
381
+ u32 parent_id_32;
314382 } __packed;
315383
316384 /**
317385 * struct ti_sci_msg_req_get_clock_num_parents - Request to get clock parents
318386 * @hdr: Generic header
319387 * @dev_id: Device identifier this request is for
320
- * @clk_id: Clock identifier for the device for this request.
388
+ * @clk_id: Clock identifier for the device for this request. Set to
389
+ * 255 if clock ID is greater than or equal to 255.
390
+ * @clk_id_32: Clock identifier if the @clk_id field contains 255.
321391 *
322392 * This request provides information about how many clock parent options
323393 * are available for a given clock to a device. This is typically used
....@@ -330,18 +400,24 @@
330400 struct ti_sci_msg_hdr hdr;
331401 u32 dev_id;
332402 u8 clk_id;
403
+ u32 clk_id_32;
333404 } __packed;
334405
335406 /**
336407 * struct ti_sci_msg_resp_get_clock_num_parents - Response for get clk parents
337408 * @hdr: Generic header
338
- * @num_parents: Number of clock parents
409
+ * @num_parents: Number of clock parents. If set to 255, the actual
410
+ * number of parents is stored into @num_parents_32
411
+ * field instead.
412
+ * @num_parents_32: Number of clock parents if @num_parents field is
413
+ * set to 255.
339414 *
340415 * Response to TI_SCI_MSG_GET_NUM_CLOCK_PARENTS
341416 */
342417 struct ti_sci_msg_resp_get_clock_num_parents {
343418 struct ti_sci_msg_hdr hdr;
344419 u8 num_parents;
420
+ u32 num_parents_32;
345421 } __packed;
346422
347423 /**
....@@ -356,7 +432,9 @@
356432 * @max_freq_hz: The maximum allowable frequency in Hz. This is the maximum
357433 * allowable programmed frequency and does not account for clock
358434 * tolerances and jitter.
359
- * @clk_id: Clock identifier for the device for this request.
435
+ * @clk_id: Clock identifier for the device for this request. Set to
436
+ * 255 if clock identifier is greater than or equal to 255.
437
+ * @clk_id_32: Clock identifier if @clk_id is set to 255.
360438 *
361439 * NOTE: Normally clock frequency management is automatically done by TISCI
362440 * entity. In case of specific requests, TISCI evaluates capability to achieve
....@@ -373,6 +451,7 @@
373451 u64 target_freq_hz;
374452 u64 max_freq_hz;
375453 u8 clk_id;
454
+ u32 clk_id_32;
376455 } __packed;
377456
378457 /**
....@@ -400,7 +479,9 @@
400479 * @max_freq_hz: The maximum allowable frequency in Hz. This is the maximum
401480 * allowable programmed frequency and does not account for clock
402481 * tolerances and jitter.
403
- * @clk_id: Clock identifier for the device for this request.
482
+ * @clk_id: Clock identifier for the device for this request. Set to
483
+ * 255 if clock ID is greater than or equal to 255.
484
+ * @clk_id_32: Clock identifier if @clk_id field is set to 255.
404485 *
405486 * NOTE: Normally clock frequency management is automatically done by TISCI
406487 * entity. In case of specific requests, TISCI evaluates capability to achieve
....@@ -429,13 +510,16 @@
429510 u64 target_freq_hz;
430511 u64 max_freq_hz;
431512 u8 clk_id;
513
+ u32 clk_id_32;
432514 } __packed;
433515
434516 /**
435517 * struct ti_sci_msg_req_get_clock_freq - Request to get the clock frequency
436518 * @hdr: Generic Header
437519 * @dev_id: Device identifier this request is for
438
- * @clk_id: Clock identifier for the device for this request.
520
+ * @clk_id: Clock identifier for the device for this request. Set to
521
+ * 255 if clock ID is greater than or equal to 255.
522
+ * @clk_id_32: Clock identifier if @clk_id field is set to 255.
439523 *
440524 * NOTE: Normally clock frequency management is automatically done by TISCI
441525 * entity. In some cases, clock frequencies are configured by host.
....@@ -447,6 +531,7 @@
447531 struct ti_sci_msg_hdr hdr;
448532 u32 dev_id;
449533 u8 clk_id;
534
+ u32 clk_id_32;
450535 } __packed;
451536
452537 /**
....@@ -461,4 +546,872 @@
461546 u64 freq_hz;
462547 } __packed;
463548
549
+#define TI_SCI_IRQ_SECONDARY_HOST_INVALID 0xff
550
+
551
+/**
552
+ * struct ti_sci_msg_req_get_resource_range - Request to get a host's assigned
553
+ * range of resources.
554
+ * @hdr: Generic Header
555
+ * @type: Unique resource assignment type
556
+ * @subtype: Resource assignment subtype within the resource type.
557
+ * @secondary_host: Host processing entity to which the resources are
558
+ * allocated. This is required only when the destination
559
+ * host id id different from ti sci interface host id,
560
+ * else TI_SCI_IRQ_SECONDARY_HOST_INVALID can be passed.
561
+ *
562
+ * Request type is TI_SCI_MSG_GET_RESOURCE_RANGE. Responded with requested
563
+ * resource range which is of type TI_SCI_MSG_GET_RESOURCE_RANGE.
564
+ */
565
+struct ti_sci_msg_req_get_resource_range {
566
+ struct ti_sci_msg_hdr hdr;
567
+#define MSG_RM_RESOURCE_TYPE_MASK GENMASK(9, 0)
568
+#define MSG_RM_RESOURCE_SUBTYPE_MASK GENMASK(5, 0)
569
+ u16 type;
570
+ u8 subtype;
571
+ u8 secondary_host;
572
+} __packed;
573
+
574
+/**
575
+ * struct ti_sci_msg_resp_get_resource_range - Response to resource get range.
576
+ * @hdr: Generic Header
577
+ * @range_start: Start index of the resource range.
578
+ * @range_num: Number of resources in the range.
579
+ *
580
+ * Response to request TI_SCI_MSG_GET_RESOURCE_RANGE.
581
+ */
582
+struct ti_sci_msg_resp_get_resource_range {
583
+ struct ti_sci_msg_hdr hdr;
584
+ u16 range_start;
585
+ u16 range_num;
586
+} __packed;
587
+
588
+/**
589
+ * struct ti_sci_msg_req_manage_irq - Request to configure/release the route
590
+ * between the dev and the host.
591
+ * @hdr: Generic Header
592
+ * @valid_params: Bit fields defining the validity of interrupt source
593
+ * parameters. If a bit is not set, then corresponding
594
+ * field is not valid and will not be used for route set.
595
+ * Bit field definitions:
596
+ * 0 - Valid bit for @dst_id
597
+ * 1 - Valid bit for @dst_host_irq
598
+ * 2 - Valid bit for @ia_id
599
+ * 3 - Valid bit for @vint
600
+ * 4 - Valid bit for @global_event
601
+ * 5 - Valid bit for @vint_status_bit_index
602
+ * 31 - Valid bit for @secondary_host
603
+ * @src_id: IRQ source peripheral ID.
604
+ * @src_index: IRQ source index within the peripheral
605
+ * @dst_id: IRQ Destination ID. Based on the architecture it can be
606
+ * IRQ controller or host processor ID.
607
+ * @dst_host_irq: IRQ number of the destination host IRQ controller
608
+ * @ia_id: Device ID of the interrupt aggregator in which the
609
+ * vint resides.
610
+ * @vint: Virtual interrupt number if the interrupt route
611
+ * is through an interrupt aggregator.
612
+ * @global_event: Global event that is to be mapped to interrupt
613
+ * aggregator virtual interrupt status bit.
614
+ * @vint_status_bit: Virtual interrupt status bit if the interrupt route
615
+ * utilizes an interrupt aggregator status bit.
616
+ * @secondary_host: Host ID of the IRQ destination computing entity. This is
617
+ * required only when destination host id is different
618
+ * from ti sci interface host id.
619
+ *
620
+ * Request type is TI_SCI_MSG_SET/RELEASE_IRQ.
621
+ * Response is generic ACK / NACK message.
622
+ */
623
+struct ti_sci_msg_req_manage_irq {
624
+ struct ti_sci_msg_hdr hdr;
625
+#define MSG_FLAG_DST_ID_VALID TI_SCI_MSG_FLAG(0)
626
+#define MSG_FLAG_DST_HOST_IRQ_VALID TI_SCI_MSG_FLAG(1)
627
+#define MSG_FLAG_IA_ID_VALID TI_SCI_MSG_FLAG(2)
628
+#define MSG_FLAG_VINT_VALID TI_SCI_MSG_FLAG(3)
629
+#define MSG_FLAG_GLB_EVNT_VALID TI_SCI_MSG_FLAG(4)
630
+#define MSG_FLAG_VINT_STS_BIT_VALID TI_SCI_MSG_FLAG(5)
631
+#define MSG_FLAG_SHOST_VALID TI_SCI_MSG_FLAG(31)
632
+ u32 valid_params;
633
+ u16 src_id;
634
+ u16 src_index;
635
+ u16 dst_id;
636
+ u16 dst_host_irq;
637
+ u16 ia_id;
638
+ u16 vint;
639
+ u16 global_event;
640
+ u8 vint_status_bit;
641
+ u8 secondary_host;
642
+} __packed;
643
+
644
+/**
645
+ * struct ti_sci_msg_rm_ring_cfg_req - Configure a Navigator Subsystem ring
646
+ *
647
+ * Configures the non-real-time registers of a Navigator Subsystem ring.
648
+ * @hdr: Generic Header
649
+ * @valid_params: Bitfield defining validity of ring configuration parameters.
650
+ * The ring configuration fields are not valid, and will not be used for
651
+ * ring configuration, if their corresponding valid bit is zero.
652
+ * Valid bit usage:
653
+ * 0 - Valid bit for @tisci_msg_rm_ring_cfg_req addr_lo
654
+ * 1 - Valid bit for @tisci_msg_rm_ring_cfg_req addr_hi
655
+ * 2 - Valid bit for @tisci_msg_rm_ring_cfg_req count
656
+ * 3 - Valid bit for @tisci_msg_rm_ring_cfg_req mode
657
+ * 4 - Valid bit for @tisci_msg_rm_ring_cfg_req size
658
+ * 5 - Valid bit for @tisci_msg_rm_ring_cfg_req order_id
659
+ * @nav_id: Device ID of Navigator Subsystem from which the ring is allocated
660
+ * @index: ring index to be configured.
661
+ * @addr_lo: 32 LSBs of ring base address to be programmed into the ring's
662
+ * RING_BA_LO register
663
+ * @addr_hi: 16 MSBs of ring base address to be programmed into the ring's
664
+ * RING_BA_HI register.
665
+ * @count: Number of ring elements. Must be even if mode is CREDENTIALS or QM
666
+ * modes.
667
+ * @mode: Specifies the mode the ring is to be configured.
668
+ * @size: Specifies encoded ring element size. To calculate the encoded size use
669
+ * the formula (log2(size_bytes) - 2), where size_bytes cannot be
670
+ * greater than 256.
671
+ * @order_id: Specifies the ring's bus order ID.
672
+ */
673
+struct ti_sci_msg_rm_ring_cfg_req {
674
+ struct ti_sci_msg_hdr hdr;
675
+ u32 valid_params;
676
+ u16 nav_id;
677
+ u16 index;
678
+ u32 addr_lo;
679
+ u32 addr_hi;
680
+ u32 count;
681
+ u8 mode;
682
+ u8 size;
683
+ u8 order_id;
684
+} __packed;
685
+
686
+/**
687
+ * struct ti_sci_msg_rm_ring_get_cfg_req - Get RA ring's configuration
688
+ *
689
+ * Gets the configuration of the non-real-time register fields of a ring. The
690
+ * host, or a supervisor of the host, who owns the ring must be the requesting
691
+ * host. The values of the non-real-time registers are returned in
692
+ * @ti_sci_msg_rm_ring_get_cfg_resp.
693
+ *
694
+ * @hdr: Generic Header
695
+ * @nav_id: Device ID of Navigator Subsystem from which the ring is allocated
696
+ * @index: ring index.
697
+ */
698
+struct ti_sci_msg_rm_ring_get_cfg_req {
699
+ struct ti_sci_msg_hdr hdr;
700
+ u16 nav_id;
701
+ u16 index;
702
+} __packed;
703
+
704
+/**
705
+ * struct ti_sci_msg_rm_ring_get_cfg_resp - Ring get configuration response
706
+ *
707
+ * Response received by host processor after RM has handled
708
+ * @ti_sci_msg_rm_ring_get_cfg_req. The response contains the ring's
709
+ * non-real-time register values.
710
+ *
711
+ * @hdr: Generic Header
712
+ * @addr_lo: Ring 32 LSBs of base address
713
+ * @addr_hi: Ring 16 MSBs of base address.
714
+ * @count: Ring number of elements.
715
+ * @mode: Ring mode.
716
+ * @size: encoded Ring element size
717
+ * @order_id: ing order ID.
718
+ */
719
+struct ti_sci_msg_rm_ring_get_cfg_resp {
720
+ struct ti_sci_msg_hdr hdr;
721
+ u32 addr_lo;
722
+ u32 addr_hi;
723
+ u32 count;
724
+ u8 mode;
725
+ u8 size;
726
+ u8 order_id;
727
+} __packed;
728
+
729
+/**
730
+ * struct ti_sci_msg_psil_pair - Pairs a PSI-L source thread to a destination
731
+ * thread
732
+ * @hdr: Generic Header
733
+ * @nav_id: SoC Navigator Subsystem device ID whose PSI-L config proxy is
734
+ * used to pair the source and destination threads.
735
+ * @src_thread: PSI-L source thread ID within the PSI-L System thread map.
736
+ *
737
+ * UDMAP transmit channels mapped to source threads will have their
738
+ * TCHAN_THRD_ID register programmed with the destination thread if the pairing
739
+ * is successful.
740
+
741
+ * @dst_thread: PSI-L destination thread ID within the PSI-L System thread map.
742
+ * PSI-L destination threads start at index 0x8000. The request is NACK'd if
743
+ * the destination thread is not greater than or equal to 0x8000.
744
+ *
745
+ * UDMAP receive channels mapped to destination threads will have their
746
+ * RCHAN_THRD_ID register programmed with the source thread if the pairing
747
+ * is successful.
748
+ *
749
+ * Request type is TI_SCI_MSG_RM_PSIL_PAIR, response is a generic ACK or NACK
750
+ * message.
751
+ */
752
+struct ti_sci_msg_psil_pair {
753
+ struct ti_sci_msg_hdr hdr;
754
+ u32 nav_id;
755
+ u32 src_thread;
756
+ u32 dst_thread;
757
+} __packed;
758
+
759
+/**
760
+ * struct ti_sci_msg_psil_unpair - Unpairs a PSI-L source thread from a
761
+ * destination thread
762
+ * @hdr: Generic Header
763
+ * @nav_id: SoC Navigator Subsystem device ID whose PSI-L config proxy is
764
+ * used to unpair the source and destination threads.
765
+ * @src_thread: PSI-L source thread ID within the PSI-L System thread map.
766
+ *
767
+ * UDMAP transmit channels mapped to source threads will have their
768
+ * TCHAN_THRD_ID register cleared if the unpairing is successful.
769
+ *
770
+ * @dst_thread: PSI-L destination thread ID within the PSI-L System thread map.
771
+ * PSI-L destination threads start at index 0x8000. The request is NACK'd if
772
+ * the destination thread is not greater than or equal to 0x8000.
773
+ *
774
+ * UDMAP receive channels mapped to destination threads will have their
775
+ * RCHAN_THRD_ID register cleared if the unpairing is successful.
776
+ *
777
+ * Request type is TI_SCI_MSG_RM_PSIL_UNPAIR, response is a generic ACK or NACK
778
+ * message.
779
+ */
780
+struct ti_sci_msg_psil_unpair {
781
+ struct ti_sci_msg_hdr hdr;
782
+ u32 nav_id;
783
+ u32 src_thread;
784
+ u32 dst_thread;
785
+} __packed;
786
+
787
+/**
788
+ * struct ti_sci_msg_udmap_rx_flow_cfg - UDMAP receive flow configuration
789
+ * message
790
+ * @hdr: Generic Header
791
+ * @nav_id: SoC Navigator Subsystem device ID from which the receive flow is
792
+ * allocated
793
+ * @flow_index: UDMAP receive flow index for non-optional configuration.
794
+ * @rx_ch_index: Specifies the index of the receive channel using the flow_index
795
+ * @rx_einfo_present: UDMAP receive flow extended packet info present.
796
+ * @rx_psinfo_present: UDMAP receive flow PS words present.
797
+ * @rx_error_handling: UDMAP receive flow error handling configuration. Valid
798
+ * values are TI_SCI_RM_UDMAP_RX_FLOW_ERR_DROP/RETRY.
799
+ * @rx_desc_type: UDMAP receive flow descriptor type. It can be one of
800
+ * TI_SCI_RM_UDMAP_RX_FLOW_DESC_HOST/MONO.
801
+ * @rx_sop_offset: UDMAP receive flow start of packet offset.
802
+ * @rx_dest_qnum: UDMAP receive flow destination queue number.
803
+ * @rx_ps_location: UDMAP receive flow PS words location.
804
+ * 0 - end of packet descriptor
805
+ * 1 - Beginning of the data buffer
806
+ * @rx_src_tag_hi: UDMAP receive flow source tag high byte constant
807
+ * @rx_src_tag_lo: UDMAP receive flow source tag low byte constant
808
+ * @rx_dest_tag_hi: UDMAP receive flow destination tag high byte constant
809
+ * @rx_dest_tag_lo: UDMAP receive flow destination tag low byte constant
810
+ * @rx_src_tag_hi_sel: UDMAP receive flow source tag high byte selector
811
+ * @rx_src_tag_lo_sel: UDMAP receive flow source tag low byte selector
812
+ * @rx_dest_tag_hi_sel: UDMAP receive flow destination tag high byte selector
813
+ * @rx_dest_tag_lo_sel: UDMAP receive flow destination tag low byte selector
814
+ * @rx_size_thresh_en: UDMAP receive flow packet size based free buffer queue
815
+ * enable. If enabled, the ti_sci_rm_udmap_rx_flow_opt_cfg also need to be
816
+ * configured and sent.
817
+ * @rx_fdq0_sz0_qnum: UDMAP receive flow free descriptor queue 0.
818
+ * @rx_fdq1_qnum: UDMAP receive flow free descriptor queue 1.
819
+ * @rx_fdq2_qnum: UDMAP receive flow free descriptor queue 2.
820
+ * @rx_fdq3_qnum: UDMAP receive flow free descriptor queue 3.
821
+ *
822
+ * For detailed information on the settings, see the UDMAP section of the TRM.
823
+ */
824
+struct ti_sci_msg_udmap_rx_flow_cfg {
825
+ struct ti_sci_msg_hdr hdr;
826
+ u32 nav_id;
827
+ u32 flow_index;
828
+ u32 rx_ch_index;
829
+ u8 rx_einfo_present;
830
+ u8 rx_psinfo_present;
831
+ u8 rx_error_handling;
832
+ u8 rx_desc_type;
833
+ u16 rx_sop_offset;
834
+ u16 rx_dest_qnum;
835
+ u8 rx_ps_location;
836
+ u8 rx_src_tag_hi;
837
+ u8 rx_src_tag_lo;
838
+ u8 rx_dest_tag_hi;
839
+ u8 rx_dest_tag_lo;
840
+ u8 rx_src_tag_hi_sel;
841
+ u8 rx_src_tag_lo_sel;
842
+ u8 rx_dest_tag_hi_sel;
843
+ u8 rx_dest_tag_lo_sel;
844
+ u8 rx_size_thresh_en;
845
+ u16 rx_fdq0_sz0_qnum;
846
+ u16 rx_fdq1_qnum;
847
+ u16 rx_fdq2_qnum;
848
+ u16 rx_fdq3_qnum;
849
+} __packed;
850
+
851
+/**
852
+ * struct rm_ti_sci_msg_udmap_rx_flow_opt_cfg - parameters for UDMAP receive
853
+ * flow optional configuration
854
+ * @hdr: Generic Header
855
+ * @nav_id: SoC Navigator Subsystem device ID from which the receive flow is
856
+ * allocated
857
+ * @flow_index: UDMAP receive flow index for optional configuration.
858
+ * @rx_ch_index: Specifies the index of the receive channel using the flow_index
859
+ * @rx_size_thresh0: UDMAP receive flow packet size threshold 0.
860
+ * @rx_size_thresh1: UDMAP receive flow packet size threshold 1.
861
+ * @rx_size_thresh2: UDMAP receive flow packet size threshold 2.
862
+ * @rx_fdq0_sz1_qnum: UDMAP receive flow free descriptor queue for size
863
+ * threshold 1.
864
+ * @rx_fdq0_sz2_qnum: UDMAP receive flow free descriptor queue for size
865
+ * threshold 2.
866
+ * @rx_fdq0_sz3_qnum: UDMAP receive flow free descriptor queue for size
867
+ * threshold 3.
868
+ *
869
+ * For detailed information on the settings, see the UDMAP section of the TRM.
870
+ */
871
+struct rm_ti_sci_msg_udmap_rx_flow_opt_cfg {
872
+ struct ti_sci_msg_hdr hdr;
873
+ u32 nav_id;
874
+ u32 flow_index;
875
+ u32 rx_ch_index;
876
+ u16 rx_size_thresh0;
877
+ u16 rx_size_thresh1;
878
+ u16 rx_size_thresh2;
879
+ u16 rx_fdq0_sz1_qnum;
880
+ u16 rx_fdq0_sz2_qnum;
881
+ u16 rx_fdq0_sz3_qnum;
882
+} __packed;
883
+
884
+/**
885
+ * Configures a Navigator Subsystem UDMAP transmit channel
886
+ *
887
+ * Configures the non-real-time registers of a Navigator Subsystem UDMAP
888
+ * transmit channel. The channel index must be assigned to the host defined
889
+ * in the TISCI header via the RM board configuration resource assignment
890
+ * range list.
891
+ *
892
+ * @hdr: Generic Header
893
+ *
894
+ * @valid_params: Bitfield defining validity of tx channel configuration
895
+ * parameters. The tx channel configuration fields are not valid, and will not
896
+ * be used for ch configuration, if their corresponding valid bit is zero.
897
+ * Valid bit usage:
898
+ * 0 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_pause_on_err
899
+ * 1 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_atype
900
+ * 2 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_chan_type
901
+ * 3 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_fetch_size
902
+ * 4 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::txcq_qnum
903
+ * 5 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_priority
904
+ * 6 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_qos
905
+ * 7 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_orderid
906
+ * 8 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_sched_priority
907
+ * 9 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_filt_einfo
908
+ * 10 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_filt_pswords
909
+ * 11 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_supr_tdpkt
910
+ * 12 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_credit_count
911
+ * 13 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::fdepth
912
+ * 14 - Valid bit for @ref ti_sci_msg_rm_udmap_tx_ch_cfg::tx_burst_size
913
+ *
914
+ * @nav_id: SoC device ID of Navigator Subsystem where tx channel is located
915
+ *
916
+ * @index: UDMAP transmit channel index.
917
+ *
918
+ * @tx_pause_on_err: UDMAP transmit channel pause on error configuration to
919
+ * be programmed into the tx_pause_on_err field of the channel's TCHAN_TCFG
920
+ * register.
921
+ *
922
+ * @tx_filt_einfo: UDMAP transmit channel extended packet information passing
923
+ * configuration to be programmed into the tx_filt_einfo field of the
924
+ * channel's TCHAN_TCFG register.
925
+ *
926
+ * @tx_filt_pswords: UDMAP transmit channel protocol specific word passing
927
+ * configuration to be programmed into the tx_filt_pswords field of the
928
+ * channel's TCHAN_TCFG register.
929
+ *
930
+ * @tx_atype: UDMAP transmit channel non Ring Accelerator access pointer
931
+ * interpretation configuration to be programmed into the tx_atype field of
932
+ * the channel's TCHAN_TCFG register.
933
+ *
934
+ * @tx_chan_type: UDMAP transmit channel functional channel type and work
935
+ * passing mechanism configuration to be programmed into the tx_chan_type
936
+ * field of the channel's TCHAN_TCFG register.
937
+ *
938
+ * @tx_supr_tdpkt: UDMAP transmit channel teardown packet generation suppression
939
+ * configuration to be programmed into the tx_supr_tdpkt field of the channel's
940
+ * TCHAN_TCFG register.
941
+ *
942
+ * @tx_fetch_size: UDMAP transmit channel number of 32-bit descriptor words to
943
+ * fetch configuration to be programmed into the tx_fetch_size field of the
944
+ * channel's TCHAN_TCFG register. The user must make sure to set the maximum
945
+ * word count that can pass through the channel for any allowed descriptor type.
946
+ *
947
+ * @tx_credit_count: UDMAP transmit channel transfer request credit count
948
+ * configuration to be programmed into the count field of the TCHAN_TCREDIT
949
+ * register. Specifies how many credits for complete TRs are available.
950
+ *
951
+ * @txcq_qnum: UDMAP transmit channel completion queue configuration to be
952
+ * programmed into the txcq_qnum field of the TCHAN_TCQ register. The specified
953
+ * completion queue must be assigned to the host, or a subordinate of the host,
954
+ * requesting configuration of the transmit channel.
955
+ *
956
+ * @tx_priority: UDMAP transmit channel transmit priority value to be programmed
957
+ * into the priority field of the channel's TCHAN_TPRI_CTRL register.
958
+ *
959
+ * @tx_qos: UDMAP transmit channel transmit qos value to be programmed into the
960
+ * qos field of the channel's TCHAN_TPRI_CTRL register.
961
+ *
962
+ * @tx_orderid: UDMAP transmit channel bus order id value to be programmed into
963
+ * the orderid field of the channel's TCHAN_TPRI_CTRL register.
964
+ *
965
+ * @fdepth: UDMAP transmit channel FIFO depth configuration to be programmed
966
+ * into the fdepth field of the TCHAN_TFIFO_DEPTH register. Sets the number of
967
+ * Tx FIFO bytes which are allowed to be stored for the channel. Check the UDMAP
968
+ * section of the TRM for restrictions regarding this parameter.
969
+ *
970
+ * @tx_sched_priority: UDMAP transmit channel tx scheduling priority
971
+ * configuration to be programmed into the priority field of the channel's
972
+ * TCHAN_TST_SCHED register.
973
+ *
974
+ * @tx_burst_size: UDMAP transmit channel burst size configuration to be
975
+ * programmed into the tx_burst_size field of the TCHAN_TCFG register.
976
+ */
977
+struct ti_sci_msg_rm_udmap_tx_ch_cfg_req {
978
+ struct ti_sci_msg_hdr hdr;
979
+ u32 valid_params;
980
+ u16 nav_id;
981
+ u16 index;
982
+ u8 tx_pause_on_err;
983
+ u8 tx_filt_einfo;
984
+ u8 tx_filt_pswords;
985
+ u8 tx_atype;
986
+ u8 tx_chan_type;
987
+ u8 tx_supr_tdpkt;
988
+ u16 tx_fetch_size;
989
+ u8 tx_credit_count;
990
+ u16 txcq_qnum;
991
+ u8 tx_priority;
992
+ u8 tx_qos;
993
+ u8 tx_orderid;
994
+ u16 fdepth;
995
+ u8 tx_sched_priority;
996
+ u8 tx_burst_size;
997
+} __packed;
998
+
999
+/**
1000
+ * Configures a Navigator Subsystem UDMAP receive channel
1001
+ *
1002
+ * Configures the non-real-time registers of a Navigator Subsystem UDMAP
1003
+ * receive channel. The channel index must be assigned to the host defined
1004
+ * in the TISCI header via the RM board configuration resource assignment
1005
+ * range list.
1006
+ *
1007
+ * @hdr: Generic Header
1008
+ *
1009
+ * @valid_params: Bitfield defining validity of rx channel configuration
1010
+ * parameters.
1011
+ * The rx channel configuration fields are not valid, and will not be used for
1012
+ * ch configuration, if their corresponding valid bit is zero.
1013
+ * Valid bit usage:
1014
+ * 0 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_pause_on_err
1015
+ * 1 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_atype
1016
+ * 2 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_chan_type
1017
+ * 3 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_fetch_size
1018
+ * 4 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rxcq_qnum
1019
+ * 5 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_priority
1020
+ * 6 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_qos
1021
+ * 7 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_orderid
1022
+ * 8 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_sched_priority
1023
+ * 9 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::flowid_start
1024
+ * 10 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::flowid_cnt
1025
+ * 11 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_ignore_short
1026
+ * 12 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_ignore_long
1027
+ * 14 - Valid bit for @ti_sci_msg_rm_udmap_rx_ch_cfg_req::rx_burst_size
1028
+ *
1029
+ * @nav_id: SoC device ID of Navigator Subsystem where rx channel is located
1030
+ *
1031
+ * @index: UDMAP receive channel index.
1032
+ *
1033
+ * @rx_fetch_size: UDMAP receive channel number of 32-bit descriptor words to
1034
+ * fetch configuration to be programmed into the rx_fetch_size field of the
1035
+ * channel's RCHAN_RCFG register.
1036
+ *
1037
+ * @rxcq_qnum: UDMAP receive channel completion queue configuration to be
1038
+ * programmed into the rxcq_qnum field of the RCHAN_RCQ register.
1039
+ * The specified completion queue must be assigned to the host, or a subordinate
1040
+ * of the host, requesting configuration of the receive channel.
1041
+ *
1042
+ * @rx_priority: UDMAP receive channel receive priority value to be programmed
1043
+ * into the priority field of the channel's RCHAN_RPRI_CTRL register.
1044
+ *
1045
+ * @rx_qos: UDMAP receive channel receive qos value to be programmed into the
1046
+ * qos field of the channel's RCHAN_RPRI_CTRL register.
1047
+ *
1048
+ * @rx_orderid: UDMAP receive channel bus order id value to be programmed into
1049
+ * the orderid field of the channel's RCHAN_RPRI_CTRL register.
1050
+ *
1051
+ * @rx_sched_priority: UDMAP receive channel rx scheduling priority
1052
+ * configuration to be programmed into the priority field of the channel's
1053
+ * RCHAN_RST_SCHED register.
1054
+ *
1055
+ * @flowid_start: UDMAP receive channel additional flows starting index
1056
+ * configuration to program into the flow_start field of the RCHAN_RFLOW_RNG
1057
+ * register. Specifies the starting index for flow IDs the receive channel is to
1058
+ * make use of beyond the default flow. flowid_start and @ref flowid_cnt must be
1059
+ * set as valid and configured together. The starting flow ID set by
1060
+ * @ref flowid_cnt must be a flow index within the Navigator Subsystem's subset
1061
+ * of flows beyond the default flows statically mapped to receive channels.
1062
+ * The additional flows must be assigned to the host, or a subordinate of the
1063
+ * host, requesting configuration of the receive channel.
1064
+ *
1065
+ * @flowid_cnt: UDMAP receive channel additional flows count configuration to
1066
+ * program into the flowid_cnt field of the RCHAN_RFLOW_RNG register.
1067
+ * This field specifies how many flow IDs are in the additional contiguous range
1068
+ * of legal flow IDs for the channel. @ref flowid_start and flowid_cnt must be
1069
+ * set as valid and configured together. Disabling the valid_params field bit
1070
+ * for flowid_cnt indicates no flow IDs other than the default are to be
1071
+ * allocated and used by the receive channel. @ref flowid_start plus flowid_cnt
1072
+ * cannot be greater than the number of receive flows in the receive channel's
1073
+ * Navigator Subsystem. The additional flows must be assigned to the host, or a
1074
+ * subordinate of the host, requesting configuration of the receive channel.
1075
+ *
1076
+ * @rx_pause_on_err: UDMAP receive channel pause on error configuration to be
1077
+ * programmed into the rx_pause_on_err field of the channel's RCHAN_RCFG
1078
+ * register.
1079
+ *
1080
+ * @rx_atype: UDMAP receive channel non Ring Accelerator access pointer
1081
+ * interpretation configuration to be programmed into the rx_atype field of the
1082
+ * channel's RCHAN_RCFG register.
1083
+ *
1084
+ * @rx_chan_type: UDMAP receive channel functional channel type and work passing
1085
+ * mechanism configuration to be programmed into the rx_chan_type field of the
1086
+ * channel's RCHAN_RCFG register.
1087
+ *
1088
+ * @rx_ignore_short: UDMAP receive channel short packet treatment configuration
1089
+ * to be programmed into the rx_ignore_short field of the RCHAN_RCFG register.
1090
+ *
1091
+ * @rx_ignore_long: UDMAP receive channel long packet treatment configuration to
1092
+ * be programmed into the rx_ignore_long field of the RCHAN_RCFG register.
1093
+ *
1094
+ * @rx_burst_size: UDMAP receive channel burst size configuration to be
1095
+ * programmed into the rx_burst_size field of the RCHAN_RCFG register.
1096
+ */
1097
+struct ti_sci_msg_rm_udmap_rx_ch_cfg_req {
1098
+ struct ti_sci_msg_hdr hdr;
1099
+ u32 valid_params;
1100
+ u16 nav_id;
1101
+ u16 index;
1102
+ u16 rx_fetch_size;
1103
+ u16 rxcq_qnum;
1104
+ u8 rx_priority;
1105
+ u8 rx_qos;
1106
+ u8 rx_orderid;
1107
+ u8 rx_sched_priority;
1108
+ u16 flowid_start;
1109
+ u16 flowid_cnt;
1110
+ u8 rx_pause_on_err;
1111
+ u8 rx_atype;
1112
+ u8 rx_chan_type;
1113
+ u8 rx_ignore_short;
1114
+ u8 rx_ignore_long;
1115
+ u8 rx_burst_size;
1116
+} __packed;
1117
+
1118
+/**
1119
+ * Configures a Navigator Subsystem UDMAP receive flow
1120
+ *
1121
+ * Configures a Navigator Subsystem UDMAP receive flow's registers.
1122
+ * Configuration does not include the flow registers which handle size-based
1123
+ * free descriptor queue routing.
1124
+ *
1125
+ * The flow index must be assigned to the host defined in the TISCI header via
1126
+ * the RM board configuration resource assignment range list.
1127
+ *
1128
+ * @hdr: Standard TISCI header
1129
+ *
1130
+ * @valid_params
1131
+ * Bitfield defining validity of rx flow configuration parameters. The
1132
+ * rx flow configuration fields are not valid, and will not be used for flow
1133
+ * configuration, if their corresponding valid bit is zero. Valid bit usage:
1134
+ * 0 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_einfo_present
1135
+ * 1 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_psinfo_present
1136
+ * 2 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_error_handling
1137
+ * 3 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_desc_type
1138
+ * 4 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_sop_offset
1139
+ * 5 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_dest_qnum
1140
+ * 6 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_src_tag_hi
1141
+ * 7 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_src_tag_lo
1142
+ * 8 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_dest_tag_hi
1143
+ * 9 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_dest_tag_lo
1144
+ * 10 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_src_tag_hi_sel
1145
+ * 11 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_src_tag_lo_sel
1146
+ * 12 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_dest_tag_hi_sel
1147
+ * 13 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_dest_tag_lo_sel
1148
+ * 14 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_fdq0_sz0_qnum
1149
+ * 15 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_fdq1_sz0_qnum
1150
+ * 16 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_fdq2_sz0_qnum
1151
+ * 17 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_fdq3_sz0_qnum
1152
+ * 18 - Valid bit for @tisci_msg_rm_udmap_flow_cfg_req::rx_ps_location
1153
+ *
1154
+ * @nav_id: SoC device ID of Navigator Subsystem from which the receive flow is
1155
+ * allocated
1156
+ *
1157
+ * @flow_index: UDMAP receive flow index for non-optional configuration.
1158
+ *
1159
+ * @rx_einfo_present:
1160
+ * UDMAP receive flow extended packet info present configuration to be
1161
+ * programmed into the rx_einfo_present field of the flow's RFLOW_RFA register.
1162
+ *
1163
+ * @rx_psinfo_present:
1164
+ * UDMAP receive flow PS words present configuration to be programmed into the
1165
+ * rx_psinfo_present field of the flow's RFLOW_RFA register.
1166
+ *
1167
+ * @rx_error_handling:
1168
+ * UDMAP receive flow error handling configuration to be programmed into the
1169
+ * rx_error_handling field of the flow's RFLOW_RFA register.
1170
+ *
1171
+ * @rx_desc_type:
1172
+ * UDMAP receive flow descriptor type configuration to be programmed into the
1173
+ * rx_desc_type field field of the flow's RFLOW_RFA register.
1174
+ *
1175
+ * @rx_sop_offset:
1176
+ * UDMAP receive flow start of packet offset configuration to be programmed
1177
+ * into the rx_sop_offset field of the RFLOW_RFA register. See the UDMAP
1178
+ * section of the TRM for more information on this setting. Valid values for
1179
+ * this field are 0-255 bytes.
1180
+ *
1181
+ * @rx_dest_qnum:
1182
+ * UDMAP receive flow destination queue configuration to be programmed into the
1183
+ * rx_dest_qnum field of the flow's RFLOW_RFA register. The specified
1184
+ * destination queue must be valid within the Navigator Subsystem and must be
1185
+ * owned by the host, or a subordinate of the host, requesting allocation and
1186
+ * configuration of the receive flow.
1187
+ *
1188
+ * @rx_src_tag_hi:
1189
+ * UDMAP receive flow source tag high byte constant configuration to be
1190
+ * programmed into the rx_src_tag_hi field of the flow's RFLOW_RFB register.
1191
+ * See the UDMAP section of the TRM for more information on this setting.
1192
+ *
1193
+ * @rx_src_tag_lo:
1194
+ * UDMAP receive flow source tag low byte constant configuration to be
1195
+ * programmed into the rx_src_tag_lo field of the flow's RFLOW_RFB register.
1196
+ * See the UDMAP section of the TRM for more information on this setting.
1197
+ *
1198
+ * @rx_dest_tag_hi:
1199
+ * UDMAP receive flow destination tag high byte constant configuration to be
1200
+ * programmed into the rx_dest_tag_hi field of the flow's RFLOW_RFB register.
1201
+ * See the UDMAP section of the TRM for more information on this setting.
1202
+ *
1203
+ * @rx_dest_tag_lo:
1204
+ * UDMAP receive flow destination tag low byte constant configuration to be
1205
+ * programmed into the rx_dest_tag_lo field of the flow's RFLOW_RFB register.
1206
+ * See the UDMAP section of the TRM for more information on this setting.
1207
+ *
1208
+ * @rx_src_tag_hi_sel:
1209
+ * UDMAP receive flow source tag high byte selector configuration to be
1210
+ * programmed into the rx_src_tag_hi_sel field of the RFLOW_RFC register. See
1211
+ * the UDMAP section of the TRM for more information on this setting.
1212
+ *
1213
+ * @rx_src_tag_lo_sel:
1214
+ * UDMAP receive flow source tag low byte selector configuration to be
1215
+ * programmed into the rx_src_tag_lo_sel field of the RFLOW_RFC register. See
1216
+ * the UDMAP section of the TRM for more information on this setting.
1217
+ *
1218
+ * @rx_dest_tag_hi_sel:
1219
+ * UDMAP receive flow destination tag high byte selector configuration to be
1220
+ * programmed into the rx_dest_tag_hi_sel field of the RFLOW_RFC register. See
1221
+ * the UDMAP section of the TRM for more information on this setting.
1222
+ *
1223
+ * @rx_dest_tag_lo_sel:
1224
+ * UDMAP receive flow destination tag low byte selector configuration to be
1225
+ * programmed into the rx_dest_tag_lo_sel field of the RFLOW_RFC register. See
1226
+ * the UDMAP section of the TRM for more information on this setting.
1227
+ *
1228
+ * @rx_fdq0_sz0_qnum:
1229
+ * UDMAP receive flow free descriptor queue 0 configuration to be programmed
1230
+ * into the rx_fdq0_sz0_qnum field of the flow's RFLOW_RFD register. See the
1231
+ * UDMAP section of the TRM for more information on this setting. The specified
1232
+ * free queue must be valid within the Navigator Subsystem and must be owned
1233
+ * by the host, or a subordinate of the host, requesting allocation and
1234
+ * configuration of the receive flow.
1235
+ *
1236
+ * @rx_fdq1_qnum:
1237
+ * UDMAP receive flow free descriptor queue 1 configuration to be programmed
1238
+ * into the rx_fdq1_qnum field of the flow's RFLOW_RFD register. See the
1239
+ * UDMAP section of the TRM for more information on this setting. The specified
1240
+ * free queue must be valid within the Navigator Subsystem and must be owned
1241
+ * by the host, or a subordinate of the host, requesting allocation and
1242
+ * configuration of the receive flow.
1243
+ *
1244
+ * @rx_fdq2_qnum:
1245
+ * UDMAP receive flow free descriptor queue 2 configuration to be programmed
1246
+ * into the rx_fdq2_qnum field of the flow's RFLOW_RFE register. See the
1247
+ * UDMAP section of the TRM for more information on this setting. The specified
1248
+ * free queue must be valid within the Navigator Subsystem and must be owned
1249
+ * by the host, or a subordinate of the host, requesting allocation and
1250
+ * configuration of the receive flow.
1251
+ *
1252
+ * @rx_fdq3_qnum:
1253
+ * UDMAP receive flow free descriptor queue 3 configuration to be programmed
1254
+ * into the rx_fdq3_qnum field of the flow's RFLOW_RFE register. See the
1255
+ * UDMAP section of the TRM for more information on this setting. The specified
1256
+ * free queue must be valid within the Navigator Subsystem and must be owned
1257
+ * by the host, or a subordinate of the host, requesting allocation and
1258
+ * configuration of the receive flow.
1259
+ *
1260
+ * @rx_ps_location:
1261
+ * UDMAP receive flow PS words location configuration to be programmed into the
1262
+ * rx_ps_location field of the flow's RFLOW_RFA register.
1263
+ */
1264
+struct ti_sci_msg_rm_udmap_flow_cfg_req {
1265
+ struct ti_sci_msg_hdr hdr;
1266
+ u32 valid_params;
1267
+ u16 nav_id;
1268
+ u16 flow_index;
1269
+ u8 rx_einfo_present;
1270
+ u8 rx_psinfo_present;
1271
+ u8 rx_error_handling;
1272
+ u8 rx_desc_type;
1273
+ u16 rx_sop_offset;
1274
+ u16 rx_dest_qnum;
1275
+ u8 rx_src_tag_hi;
1276
+ u8 rx_src_tag_lo;
1277
+ u8 rx_dest_tag_hi;
1278
+ u8 rx_dest_tag_lo;
1279
+ u8 rx_src_tag_hi_sel;
1280
+ u8 rx_src_tag_lo_sel;
1281
+ u8 rx_dest_tag_hi_sel;
1282
+ u8 rx_dest_tag_lo_sel;
1283
+ u16 rx_fdq0_sz0_qnum;
1284
+ u16 rx_fdq1_qnum;
1285
+ u16 rx_fdq2_qnum;
1286
+ u16 rx_fdq3_qnum;
1287
+ u8 rx_ps_location;
1288
+} __packed;
1289
+
1290
+/**
1291
+ * struct ti_sci_msg_req_proc_request - Request a processor
1292
+ * @hdr: Generic Header
1293
+ * @processor_id: ID of processor being requested
1294
+ *
1295
+ * Request type is TI_SCI_MSG_PROC_REQUEST, response is a generic ACK/NACK
1296
+ * message.
1297
+ */
1298
+struct ti_sci_msg_req_proc_request {
1299
+ struct ti_sci_msg_hdr hdr;
1300
+ u8 processor_id;
1301
+} __packed;
1302
+
1303
+/**
1304
+ * struct ti_sci_msg_req_proc_release - Release a processor
1305
+ * @hdr: Generic Header
1306
+ * @processor_id: ID of processor being released
1307
+ *
1308
+ * Request type is TI_SCI_MSG_PROC_RELEASE, response is a generic ACK/NACK
1309
+ * message.
1310
+ */
1311
+struct ti_sci_msg_req_proc_release {
1312
+ struct ti_sci_msg_hdr hdr;
1313
+ u8 processor_id;
1314
+} __packed;
1315
+
1316
+/**
1317
+ * struct ti_sci_msg_req_proc_handover - Handover a processor to a host
1318
+ * @hdr: Generic Header
1319
+ * @processor_id: ID of processor being handed over
1320
+ * @host_id: Host ID the control needs to be transferred to
1321
+ *
1322
+ * Request type is TI_SCI_MSG_PROC_HANDOVER, response is a generic ACK/NACK
1323
+ * message.
1324
+ */
1325
+struct ti_sci_msg_req_proc_handover {
1326
+ struct ti_sci_msg_hdr hdr;
1327
+ u8 processor_id;
1328
+ u8 host_id;
1329
+} __packed;
1330
+
1331
+/* Boot Vector masks */
1332
+#define TI_SCI_ADDR_LOW_MASK GENMASK_ULL(31, 0)
1333
+#define TI_SCI_ADDR_HIGH_MASK GENMASK_ULL(63, 32)
1334
+#define TI_SCI_ADDR_HIGH_SHIFT 32
1335
+
1336
+/**
1337
+ * struct ti_sci_msg_req_set_config - Set Processor boot configuration
1338
+ * @hdr: Generic Header
1339
+ * @processor_id: ID of processor being configured
1340
+ * @bootvector_low: Lower 32 bit address (Little Endian) of boot vector
1341
+ * @bootvector_high: Higher 32 bit address (Little Endian) of boot vector
1342
+ * @config_flags_set: Optional Processor specific Config Flags to set.
1343
+ * Setting a bit here implies the corresponding mode
1344
+ * will be set
1345
+ * @config_flags_clear: Optional Processor specific Config Flags to clear.
1346
+ * Setting a bit here implies the corresponding mode
1347
+ * will be cleared
1348
+ *
1349
+ * Request type is TI_SCI_MSG_PROC_HANDOVER, response is a generic ACK/NACK
1350
+ * message.
1351
+ */
1352
+struct ti_sci_msg_req_set_config {
1353
+ struct ti_sci_msg_hdr hdr;
1354
+ u8 processor_id;
1355
+ u32 bootvector_low;
1356
+ u32 bootvector_high;
1357
+ u32 config_flags_set;
1358
+ u32 config_flags_clear;
1359
+} __packed;
1360
+
1361
+/**
1362
+ * struct ti_sci_msg_req_set_ctrl - Set Processor boot control flags
1363
+ * @hdr: Generic Header
1364
+ * @processor_id: ID of processor being configured
1365
+ * @control_flags_set: Optional Processor specific Control Flags to set.
1366
+ * Setting a bit here implies the corresponding mode
1367
+ * will be set
1368
+ * @control_flags_clear:Optional Processor specific Control Flags to clear.
1369
+ * Setting a bit here implies the corresponding mode
1370
+ * will be cleared
1371
+ *
1372
+ * Request type is TI_SCI_MSG_SET_CTRL, response is a generic ACK/NACK
1373
+ * message.
1374
+ */
1375
+struct ti_sci_msg_req_set_ctrl {
1376
+ struct ti_sci_msg_hdr hdr;
1377
+ u8 processor_id;
1378
+ u32 control_flags_set;
1379
+ u32 control_flags_clear;
1380
+} __packed;
1381
+
1382
+/**
1383
+ * struct ti_sci_msg_req_get_status - Processor boot status request
1384
+ * @hdr: Generic Header
1385
+ * @processor_id: ID of processor whose status is being requested
1386
+ *
1387
+ * Request type is TI_SCI_MSG_GET_STATUS, response is an appropriate
1388
+ * message, or NACK in case of inability to satisfy request.
1389
+ */
1390
+struct ti_sci_msg_req_get_status {
1391
+ struct ti_sci_msg_hdr hdr;
1392
+ u8 processor_id;
1393
+} __packed;
1394
+
1395
+/**
1396
+ * struct ti_sci_msg_resp_get_status - Processor boot status response
1397
+ * @hdr: Generic Header
1398
+ * @processor_id: ID of processor whose status is returned
1399
+ * @bootvector_low: Lower 32 bit address (Little Endian) of boot vector
1400
+ * @bootvector_high: Higher 32 bit address (Little Endian) of boot vector
1401
+ * @config_flags: Optional Processor specific Config Flags set currently
1402
+ * @control_flags: Optional Processor specific Control Flags set currently
1403
+ * @status_flags: Optional Processor specific Status Flags set currently
1404
+ *
1405
+ * Response structure to a TI_SCI_MSG_GET_STATUS request.
1406
+ */
1407
+struct ti_sci_msg_resp_get_status {
1408
+ struct ti_sci_msg_hdr hdr;
1409
+ u8 processor_id;
1410
+ u32 bootvector_low;
1411
+ u32 bootvector_high;
1412
+ u32 config_flags;
1413
+ u32 control_flags;
1414
+ u32 status_flags;
1415
+} __packed;
1416
+
4641417 #endif /* __TI_SCI_H */