comparison cdg3/sap/psi.pdf @ 16:c15047b3d00d

cdg3: import from freecalypso-citrine/cdg
author Mychaela Falconia <falcon@freecalypso.org>
date Tue, 27 Sep 2016 16:27:34 +0000
parents
children
comparison
equal deleted inserted replaced
15:c8bdae60fcb1 16:c15047b3d00d
1 ;********************************************************************************
2 ;*** File : PSI.pdf
3 ;*** Creation : Wed Mar 11 09:58:36 CST 2009
4 ;*** XSLT Processor : Apache Software Foundation / http://xml.apache.org/xalan-j / supports XSLT-Ver: 1
5 ;*** Copyright : (c) Texas Instruments AG, Berlin Germany 2002
6 ;********************************************************************************
7 ;*** Document Type : Service Access Point Specification
8 ;*** Document Name : PSI
9 ;*** Document No. : ..01.001
10 ;*** Document Date : 2004-02-09
11 ;*** Document Status: BEING_PROCESSED
12 ;*** Document Author: RM
13 ;********************************************************************************
14
15
16
17 PRAGMA SRC_FILE_TIME "Thu Nov 29 09:51:16 2007"
18 PRAGMA LAST_MODIFIED "2004-02-09"
19 PRAGMA ID_AND_VERSION "..01.001"
20
21
22
23 CONST PSI_PEER_ENTITY_NAME_LENGTH 6 ; Length ofentity name for data exchange
24
25
26
27 VALTAB VAL_cause
28 VAL 0xD300 PSICS_SUCCESS "0b11010011 00000000 no error"
29 VAL 0xD301 PSICS_INVALID_PARAMS "0b11010011 00000001 device number invalid or parameter invalid "
30 VAL 0xD302 PSICS_INTERNAL_DRV_ERROR "0b11010011 00000010 A driver function returned DRV_INTERNAL_ERROR"
31 VAL 0xD303 PSICS_DISCONNECT "0b11010011 00000011 The driver signalled a DRV_SIGTYPE_DISCONNECT"
32
33 VALTAB VAL_psi_line_states
34 VAL 0x00 PSI_LINE_STD_NOT_VALID "b00000000 no line state request is given"
35
36 VALTAB VAL_psi_baud_rate
37 VAL 0xffffffff DIO4_BAUD_NOT_VALID "baudrate is not changed"
38
39 VALTAB VAL_psi_char_frame
40 VAL 0x00000000 DIO_CF_NOT_VALID "char frame values are not changed"
41
42 VALTAB VAL_psi_flow_control
43 VAL 0xffffffff DIO_FLOW_NOT_VALID "flow control value are not changed"
44
45 VALTAB VAL_psi_mux_mode
46 VAL 0xffffffff DIO_MUX_MODE_NOT_VALID "mux mode is unchanged"
47
48 VALTAB VAL_pkt_flag
49 VAL 0x80000000 DIO_FLAG_PKT_PROTOCOL "device can transfer information to identify the packet protocol"
50 VAL 0xffffffff DIO_FLAG_PKT_PROT_NOT_VALID "packet flag is not changed"
51
52 VALTAB VAL_psi_sleep_mode
53 VAL 0x00 DIO_SLEEP_NOT_VALID "value is not valid"
54 VAL 0xff DIO_SLEEP_NOT_CHAN "value is not changed"
55
56 VALTAB VAL_psi_guard_per
57 VAL 0xff DIO_GUARD_PER_NOT_VALID "guard period is not changed"
58
59 VALTAB VAL_psi_dev_mode
60 VAL 0x00000000 DEV_MODE_NOT_VALID "device mode is unchanged"
61
62 VALTAB VAL_psi_esc_char
63 VAL 0x00 ESC_CHAR_NOT_VALID "escape character is not changed"
64
65 VALTAB VAL_pkt_type
66 VAL 0x0021 DIO_PACKET_IPV4 "IP packet version 4"
67 VAL 0x002D DIO_PACKET_VJ_CTCP "IPv4 packet with Van Jacobson compressed TCP/IP header"
68 VAL 0x002F DIO_PACKET_VJ_UTCP "IPv4 packet with Van Jacobson uncompressed TCP/IP header"
69 VAL 0x0057 DIO_PACKET_IPV6 "IP packet version 6"
70
71 VALTAB VAL_psi_xon
72 VAL 0x00 XON_NOT_VALID "xon value is unchanged"
73
74 VALTAB VAL_psi_xoff
75 VAL 0x00 XOFF_NOT_VALID "xoff value is unchanged"
76
77 VALTAB VAL_psi_n1
78 VAL 0x00 PSI_MUX_N1_NOT_VALID "mux max frame size is not changed"
79
80 VALTAB VAL_psi_n2
81 VAL 0x00 PSI_MUX_N2_NOT_VALID "number of retransmission is not changed"
82
83 VALTAB VAL_psi_t1
84 VAL 0x00 PSI_MUX_T1_NOT_VALID "acknowledgement timer is not changed"
85
86 VALTAB VAL_psi_t2
87 VAL 0x00 PSI_MUX_T2_NOT_VALID "response timer is not changed"
88
89 VALTAB VAL_psi_t3
90 VAL 0x00 PSI_MUX_T3_NOT_VALID "wake up response timer is not changed"
91
92 VALTAB VAL_psi_k
93 VAL 0x00 PSI_K_NOT_VALID "windows size is not changed"
94
95 VALTAB VAL_psi_data_mode
96 VAL 0x01 DRIVER_MODE_AT "The driver will transmit AT commands."
97 VAL 0x02 DRIVER_MODE_DATA "The driver will transmit data."
98 VAL 0x03 DRIVER_MODE_AT_DATA "The driver will transmit AT commands and data"
99
100
101
102
103 VAR cause "cause value" S
104
105 VAL @p_PSI - VAL_cause@
106
107 VAR devId "device identifier" L
108
109 VAL @p_DIO - VAL_device@
110
111 VAR dti_direction "link identifier" B
112
113
114 VAR drv_handle "driver handle" S
115
116
117 VAR line_state "line state information" S
118
119 VAL @p_PSI - VAL_psi_line_states@
120 VAL @p_DIO - VAL_line_states@
121
122 VAR link_id "link identifier" L
123
124
125 VAR psi_data_mode "TE will use the device to transmit AT commands or data or both" B
126
127 VAL @p_PSI - VAL_psi_data_mode@
128
129 VAR retValue "return value" S
130
131
132 VAR signal_type "signal information" S
133
134
135 VAR name "entity name" B
136
137
138
139
140
141 UNION DIO_CAP_UN "Structured Element"
142 {
143 ser_cap EXTERN @p_DIO - DIO_CAP_SER@ DIO_CAP_SER ; capabilities of serial driver
144 pkt_cap EXTERN @p_DIO - DIO_CAP_PKT@ DIO_CAP_PKT ; capabilities of packet driver
145 mux_cap EXTERN @p_DIO - DIO_CAP_SER_MUX@ DIO_CAP_SER_MUX ; capabilities of mux driver
146 }
147
148
149
150 UNION DIO_DCB_UN "Structured Element"
151 {
152 ser_dcb EXTERN @p_DIO - DIO_DCB_SER@ DIO_DCB_SER ; configuration of serial driver
153 pkt_dcb EXTERN @p_DIO - DIO_DCB_PKT@ DIO_DCB_PKT ; configuration of packet driver
154 mux_dcb EXTERN @p_DIO - DIO_DCB_SER_MUX@ DIO_DCB_SER_MUX ; configuration of mux driver
155 }
156
157
158
159 COMP peer "communication entity name"
160 {
161 name [PSI_PEER_ENTITY_NAME_LENGTH] ; communication peer name
162 }
163
164
165
166
167
168
169 ; PSI_CONN_IND 0x8000401D
170 ; PSI_CONN_IND_TEST 0x8009401D
171 ; PSI_CONN_RES 0x8000001D
172 ; PSI_CONN_REJ 0x8001001D
173 ; PSI_DISCONN_IND 0x8001401D
174 ; PSI_CLOSE_REQ 0x8002001D
175 ; PSI_CLOSE_CNF 0x8008401D
176 ; PSI_DTI_OPEN_REQ 0x8003001D
177 ; PSI_DTI_CLOSE_REQ 0x8004001D
178 ; PSI_DTI_OPEN_CNF 0x8002401D
179 ; PSI_DTI_CLOSE_CNF 0x8003401D
180 ; PSI_DTI_CLOSE_IND 0x8004401D
181 ; PSI_SETCONF_CNF 0x8005401D
182 ; PSI_SETCONF_REQ 0x8005001D
183 ; PSI_SETCONF_REQ_TEST 0x800D001D
184 ; PSI_LINE_STATE_REQ 0x8006001D
185 ; PSI_LINE_STATE_CNF 0x8006401D
186 ; PSI_LINE_STATE_IND 0x8007401D
187 ; PSI_SIG_CLEAR_IND 0x8007001D
188 ; PSI_SIG_FLUSH_IND 0x8008001D
189 ; PSI_SIG_READ_IND 0x8009001D
190 ; PSI_SIG_WRITE_IND 0x800A001D
191 ; PSI_SIG_CONNECT_IND 0x800B001D
192 ; PSI_SIG_DISCONNECT_IND 0x800C001D
193 ; PSI_DIOSIM_INIT_REQ 0x8020401D
194 ; PSI_DIOSIM_INIT_CNF 0x8020001D
195 ; PSI_DIOSIM_GET_CAP_REQ 0x8021401D
196 ; PSI_DIOSIM_GET_CAP_SER_CNF 0x8021001D
197 ; PSI_DIOSIM_GET_CAP_PKT_CNF 0x802C001D
198 ; PSI_DIOSIM_SET_CONF_SER_REQ 0x8022401D
199 ; PSI_DIOSIM_SET_CONF_PKT_REQ 0x802C401D
200 ; PSI_DIOSIM_SET_CONF_CNF 0x8022001D
201 ; PSI_DIOSIM_GET_CONF_SER_REQ 0x8023401D
202 ; PSI_DIOSIM_GET_CONF_CNF 0x8023001D
203 ; PSI_DIOSIM_CLOSE_DEV_REQ 0x8024401D
204 ; PSI_DIOSIM_CLOSE_DEV_CNF 0x8024001D
205 ; PSI_DIOSIM_FLUSH_REQ 0x8025401D
206 ; PSI_DIOSIM_FLUSH_CNF 0x8025001D
207 ; PSI_DIOSIM_CLEAR_REQ 0x8026401D
208 ; PSI_DIOSIM_CLEAR_CNF 0x8026001D
209 ; PSI_DIOSIM_GET_TXB_REQ 0x8027401D
210 ; PSI_DIOSIM_GET_TXB_CNF 0x8027001D
211 ; PSI_DIOSIM_SET_RXB_REQ 0x8028401D
212 ; PSI_DIOSIM_SET_RXB_CNF 0x8028001D
213 ; PSI_DIOSIM_READ_REQ 0x8029401D
214 ; PSI_DIOSIM_READ_SER_CNF 0x8029001D
215 ; PSI_DIOSIM_READ_PKT_CNF 0x802D001D
216 ; PSI_DIOSIM_WRITE_SER_REQ 0x802A401D
217 ; PSI_DIOSIM_WRITE_PKT_REQ 0x802E401D
218 ; PSI_DIOSIM_WRITE_CNF 0x802A001D
219 ; PSI_DIOSIM_EXIT_REQ 0x802B401D
220 ; PSI_DIOSIM_SIGN_IND 0x802B001D
221
222
223
224 PRIM PSI_CONN_IND 0x8000401D
225 {
226 devId ; Device Identifier
227 EXTERN @p_DIO - DIO_CAP@ DIO_CAP PTR ; Device Capability
228 psi_data_mode ; Device data mode
229 }
230
231
232
233
234
235
236 PRIM PSI_CONN_IND_TEST 0x8009401D
237 {
238 devId ; Device Identifier
239 DIO_CAP_UN ; device capability test structure
240 psi_data_mode ; device data mode
241 }
242
243
244
245
246
247
248 PRIM PSI_CONN_RES 0x8000001D
249 {
250 devId ; device identifier
251 }
252
253
254
255
256
257
258 PRIM PSI_CONN_REJ 0x8001001D
259 {
260 devId ; device identifier
261 }
262
263
264
265
266
267
268 PRIM PSI_DISCONN_IND 0x8001401D
269 {
270 devId ; device identifier
271 cause ; cause value
272 }
273
274
275
276
277
278
279 PRIM PSI_CLOSE_REQ 0x8002001D
280 {
281 devId ; device identifier
282 }
283
284
285
286
287
288
289 PRIM PSI_CLOSE_CNF 0x8008401D
290 {
291 devId ; device identifier
292 }
293
294
295
296
297
298
299 PRIM PSI_DTI_OPEN_REQ 0x8003001D
300 {
301 devId ; device identifier
302 peer ; peer name
303 link_id ; dti link identifier
304 dti_direction ; direction of DTI link
305 }
306
307
308
309
310
311
312 PRIM PSI_DTI_CLOSE_REQ 0x8004001D
313 {
314 devId ; device identifier
315 link_id ; dti link identifier
316 }
317
318
319
320
321
322
323 PRIM PSI_DTI_OPEN_CNF 0x8002401D
324 {
325 devId ; device identifier
326 cause ; cause value
327 link_id ; dti link identifier
328 }
329
330
331
332
333
334
335 PRIM PSI_DTI_CLOSE_CNF 0x8003401D
336 {
337 devId ; device identifier
338 link_id ; dti link identifier
339 }
340
341
342
343
344
345
346 PRIM PSI_DTI_CLOSE_IND 0x8004401D
347 {
348 devId ; device identifier
349 link_id ; dti link identifier
350 }
351
352
353
354
355
356
357 PRIM PSI_SETCONF_CNF 0x8005401D
358 {
359 devId ; device identifier
360 cause ; cause value
361 }
362
363
364
365
366
367
368 PRIM PSI_SETCONF_REQ 0x8005001D
369 {
370 devId ; device identifier
371 EXTERN @p_DIO - DIO_DCB@ DIO_DCB PTR ; configuration structure
372 }
373
374
375
376
377
378
379 PRIM PSI_SETCONF_REQ_TEST 0x800D001D
380 {
381 devId ; Primitive Item
382 DIO_DCB_UN ; Primitive Item
383 }
384
385
386
387
388
389
390 PRIM PSI_LINE_STATE_REQ 0x8006001D
391 {
392 devId ; device identifier
393 line_state ; line state information
394 }
395
396
397
398
399
400
401 PRIM PSI_LINE_STATE_CNF 0x8006401D
402 {
403 devId ; device identifier
404 }
405
406
407
408
409
410
411 PRIM PSI_LINE_STATE_IND 0x8007401D
412 {
413 devId ; device identifier
414 line_state ; line state information
415 }
416
417
418
419
420
421
422 PRIM PSI_SIG_CLEAR_IND 0x8007001D
423 {
424 }
425
426
427
428
429
430
431 PRIM PSI_SIG_FLUSH_IND 0x8008001D
432 {
433 }
434
435
436
437
438
439
440 PRIM PSI_SIG_READ_IND 0x8009001D
441 {
442 }
443
444
445
446
447
448
449 PRIM PSI_SIG_WRITE_IND 0x800A001D
450 {
451 }
452
453
454
455
456
457
458 PRIM PSI_SIG_CONNECT_IND 0x800B001D
459 {
460 }
461
462
463
464
465
466
467 PRIM PSI_SIG_DISCONNECT_IND 0x800C001D
468 {
469 }
470
471
472
473
474
475
476 PRIM PSI_DIOSIM_INIT_REQ 0x8020401D
477 {
478 drv_handle ; Primitive Item
479 }
480
481
482
483
484
485
486 PRIM PSI_DIOSIM_INIT_CNF 0x8020001D
487 {
488 retValue ; return value
489 }
490
491
492
493
494
495
496 PRIM PSI_DIOSIM_GET_CAP_REQ 0x8021401D
497 {
498 devId ; device identifier
499 }
500
501
502
503
504
505
506 PRIM PSI_DIOSIM_GET_CAP_SER_CNF 0x8021001D
507 {
508 retValue ; return value
509 EXTERN @p_DIO - DIO_CAP_SER@ DIO_CAP_SER ; serial device capability structure
510 }
511
512
513
514
515
516
517 PRIM PSI_DIOSIM_GET_CAP_PKT_CNF 0x802C001D
518 {
519 retValue ; return value
520 EXTERN @p_DIO - DIO_CAP_PKT@ DIO_CAP_PKT ; packet device capability structure
521 }
522
523
524
525
526
527
528 PRIM PSI_DIOSIM_SET_CONF_SER_REQ 0x8022401D
529 {
530 devId ; device Identifier
531 EXTERN @p_DIO - DIO_DCB_SER@ DIO_DCB_SER ; serial configuration parameter structure
532 }
533
534
535
536
537
538
539 PRIM PSI_DIOSIM_SET_CONF_PKT_REQ 0x802C401D
540 {
541 devId ; device identifier
542 EXTERN @p_DIO - DIO_DCB_PKT@ DIO_DCB_PKT ; configuration params
543 }
544
545
546
547
548
549
550 PRIM PSI_DIOSIM_SET_CONF_CNF 0x8022001D
551 {
552 retValue ; return value
553 }
554
555
556
557
558
559
560 PRIM PSI_DIOSIM_GET_CONF_SER_REQ 0x8023401D
561 {
562 devId ; device identifier
563 EXTERN @p_DIO - DIO_DCB_SER@ DIO_DCB_SER ; serial device configuration parameter
564 }
565
566
567
568
569
570
571 PRIM PSI_DIOSIM_GET_CONF_CNF 0x8023001D
572 {
573 retValue ; return value
574 }
575
576
577
578
579
580
581 PRIM PSI_DIOSIM_CLOSE_DEV_REQ 0x8024401D
582 {
583 devId ; device identifier
584 }
585
586
587
588
589
590
591 PRIM PSI_DIOSIM_CLOSE_DEV_CNF 0x8024001D
592 {
593 retValue ; return value
594 }
595
596
597
598
599
600
601 PRIM PSI_DIOSIM_FLUSH_REQ 0x8025401D
602 {
603 devId ; device identifier
604 }
605
606
607
608
609
610
611 PRIM PSI_DIOSIM_FLUSH_CNF 0x8025001D
612 {
613 retValue ; return value
614 }
615
616
617
618
619
620
621 PRIM PSI_DIOSIM_CLEAR_REQ 0x8026401D
622 {
623 devId ; device identifier
624 }
625
626
627
628
629
630
631 PRIM PSI_DIOSIM_CLEAR_CNF 0x8026001D
632 {
633 retValue ; return value
634 }
635
636
637
638
639
640
641 PRIM PSI_DIOSIM_GET_TXB_REQ 0x8027401D
642 {
643 devId ; device identifier
644 }
645
646
647
648
649
650
651 PRIM PSI_DIOSIM_GET_TXB_CNF 0x8027001D
652 {
653 retValue ; return value
654 }
655
656
657
658
659
660
661 PRIM PSI_DIOSIM_SET_RXB_REQ 0x8028401D
662 {
663 devId ; device identifier
664 }
665
666
667
668
669
670
671 PRIM PSI_DIOSIM_SET_RXB_CNF 0x8028001D
672 {
673 retValue ; Primitive Item
674 }
675
676
677
678
679
680
681 PRIM PSI_DIOSIM_READ_REQ 0x8029401D
682 {
683 devId ; device identifier
684 }
685
686
687
688
689
690
691 PRIM PSI_DIOSIM_READ_SER_CNF 0x8029001D
692 {
693 retValue ; return value
694 EXTERN @p_DIO - control_type@ control_type ; control info type
695 EXTERN @p_DIO - length@ length ; control info len
696 EXTERN @p_DIO - state@ state ; control info state
697 }
698
699
700
701
702
703
704 PRIM PSI_DIOSIM_READ_PKT_CNF 0x802D001D
705 {
706 retValue ; return value
707 }
708
709
710
711
712
713
714 PRIM PSI_DIOSIM_WRITE_SER_REQ 0x802A401D
715 {
716 devId ; device identifier
717 EXTERN @p_DIO - DIO_CTRL_LINES@ DIO_CTRL_LINES ; serial control info strucrture
718 }
719
720
721
722
723
724
725 PRIM PSI_DIOSIM_WRITE_PKT_REQ 0x802E401D
726 {
727 devId ; device identifier
728 }
729
730
731
732
733
734
735 PRIM PSI_DIOSIM_WRITE_CNF 0x802A001D
736 {
737 retValue ; return value
738 }
739
740
741
742
743
744
745 PRIM PSI_DIOSIM_EXIT_REQ 0x802B401D
746 {
747 }
748
749
750
751
752
753
754 PRIM PSI_DIOSIM_SIGN_IND 0x802B001D
755 {
756 devId ; device identifier
757 signal_type ; signal information
758 }
759
760
761
762
763
764
765
766
767