Changes between Version 7 and Version 8 of spec/Com
- Timestamp:
- Jul 15, 2015, 11:19:30 AM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
spec/Com
v7 v8 18 18 * 当然、MainFunctionの呼出し間隔より短い時間を設定しても、時間管理を実現できない 19 19 * 設定値が、MainFunctionの呼出し間隔の倍数になっていない場合、厳密な時間を実現できない 20 * TMS(Transmission Mode Selector) 21 * IPDUを送信する周期などのタイミング(送信モード)の設定は、1IPDU毎に2種類(TRUEとFALSEで区別)設定できる 22 * この仕組みをTMSと呼ぶ 23 * IPDUに所属するシグナルに対するフィルタリングの結果で、TMSが切り替わる 24 * IPDUに所属するシグナルのフィルタリング結果が1つでもTRUEの場合は、TMSはTRUEとなる 20 25 21 26 * API一覧 … … 59 64 * [#ComConfig ComConfig] 60 65 * [#ComConfigurationId ComConfigurationId] 61 * [#ComGwMapping ComGwMapping]62 * [#ComGwDestination ComGwDestination]63 * [#ComGwDestinationDescription ComGwDestinationDescription]64 * [#ComBitPosition ComBitPosition]65 * [#ComSignalEndianness ComSignalEndianness]66 * [#ComSignalInitValue ComSignalInitValue]67 * [#ComTransferProperty ComTransferProperty]68 * [#ComUpdateBitPosition ComUpdateBitPosition]69 * [#ComGwIPduRef ComGwIPduRef]70 * [#ComFilter ComFilter]71 * [#ComFilterAlgorithm ComFilterAlgorithm]72 * [#ComFilterMask ComFilterMask]73 * [#ComFilterMax ComFilterMax]74 * [#ComFilterMin ComFilterMin]75 * [#ComFilterOffset ComFilterOffset]76 * [#ComFilterPeriod ComFilterPeriod]77 * [#ComFilterX ComFilterX]78 * [#ComGwSignal ComGwSignal]79 * [#ComGwSignalRef ComGwSignalRef]80 * [#ComGwSource ComGwSource]81 * [#ComGwSignal ComGwSignal]82 * [#ComGwSignalRef ComGwSignalRef]83 * [#ComGwSourceDescription ComGwSourceDescription]84 * [#ComBitPosition ComBitPosition]85 * [#ComBitSize ComBitSize]86 * [#ComSignalEndianness ComSignalEndianness]87 * [#ComSignalLength ComSignalLength]88 * [#ComSignalType ComSignalType]89 * [#ComUpdateBitPosition ComUpdateBitPosition]90 * [#ComGwIPduRef ComGwIPduRef]91 66 * [#ComIPdu ComIPdu] 92 67 * [#ComIPduCallout ComIPduCallout] … … 190 165 * [#ComFilterPeriod ComFilterPeriod] 191 166 * [#ComFilterX ComFilterX] 167 * [#ComGwMapping ComGwMapping] 168 * [#ComGwDestination ComGwDestination] 169 * [#ComGwDestinationDescription ComGwDestinationDescription] 170 * [#ComBitPosition ComBitPosition] 171 * [#ComSignalEndianness ComSignalEndianness] 172 * [#ComSignalInitValue ComSignalInitValue] 173 * [#ComTransferProperty ComTransferProperty] 174 * [#ComUpdateBitPosition ComUpdateBitPosition] 175 * [#ComGwIPduRef ComGwIPduRef] 176 * [#ComFilter ComFilter] 177 * [#ComFilterAlgorithm ComFilterAlgorithm] 178 * [#ComFilterMask ComFilterMask] 179 * [#ComFilterMax ComFilterMax] 180 * [#ComFilterMin ComFilterMin] 181 * [#ComFilterOffset ComFilterOffset] 182 * [#ComFilterPeriod ComFilterPeriod] 183 * [#ComFilterX ComFilterX] 184 * [#ComGwSignal ComGwSignal] 185 * [#ComGwSignalRef ComGwSignalRef] 186 * [#ComGwSource ComGwSource] 187 * [#ComGwSignal ComGwSignal] 188 * [#ComGwSignalRef ComGwSignalRef] 189 * [#ComGwSourceDescription ComGwSourceDescription] 190 * [#ComBitPosition ComBitPosition] 191 * [#ComBitSize ComBitSize] 192 * [#ComSignalEndianness ComSignalEndianness] 193 * [#ComSignalLength ComSignalLength] 194 * [#ComSignalType ComSignalType] 195 * [#ComUpdateBitPosition ComUpdateBitPosition] 196 * [#ComGwIPduRef ComGwIPduRef] 192 197 * [#ComTimeBase ComTimeBase] 193 198 * [#ComGwTimeBase ComGwTimeBase] … … 219 224 * 引数configで与えたポインタが指すコンフィギュレーションデータを使用して初期化される 220 225 * [wiki:tips_configuration_class#%E3%83%9D%E3%82%B9%E3%83%88%E3%83%93%E3%83%AB%E3%83%89%E3%82%BF%E3%82%A4%E3%83%A0 ポストビルド]のパラメータは本初期化により設定値を変更できる 226 * [wiki:spec_CANInterface CanIf]のCanIf_Initでは、引数にNULLを与えた場合、デフォルトのコンフィギュレーションが設定される仕様となっていることから、TOPPERS/A-COMではCom_Initも同様にNULLが与えられた場合、デフォルトのコンフィギュレーション([#ComConfigurationId ComConfigurationId]が0)を設定するように実装している 221 227 222 228 == Com_DeInit == … … 225 231 }}} 226 232 * Comモジュールの未初期化を行い、Comモジュールが提供するサービスを終了する 227 * [http://www.autosar.org/fileadmin/files/releases/4-0/software-architecture/communication-stack/standard/AUTOSAR_SWS_COM.pdf#page=87&view=fitv AUTOSAR_SWS_COM.pdfのCaveats ]では、Com_DeinitがComモジュールのAPIに割り込んで呼び出されるような使い方を考慮しなくてよいと書かれている233 * [http://www.autosar.org/fileadmin/files/releases/4-0/software-architecture/communication-stack/standard/AUTOSAR_SWS_COM.pdf#page=87&view=fitv AUTOSAR_SWS_COM.pdfのCaveats of Com_DeInit]では、Com_DeinitがComモジュールのAPIに割り込んで呼び出されるような使い方を考慮しなくてよいと書かれている 228 234 229 235 == Com_IpduGroupControl == … … 448 454 * 型:Container 449 455 * 多重度:1 456 * [#Com_Init Com_Init]により設定されるコンフィギュレーション全体のコンテナ 457 * TOPPERS/A-COMでは、[wiki:tips_configuration_class#%E3%83%9D%E3%82%B9%E3%83%88%E3%83%93%E3%83%AB%E3%83%89%E3%82%BF%E3%82%A4%E3%83%A0 ポストビルド]による複数のコンフィギュレーション定義に対応するため、多重度を1..*として本コンテナを複数定義可能としている 450 458 451 459 == ComConfigurationId == … … 455 463 * 型:IntegerParam 456 464 * 多重度:1 457 458 == ComGwMapping == 459 {{{ 460 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping 465 * [#Com_Init Com_Init]で設定したコンフィギュレーションを識別するID 466 * TOPPERS/A-COMでは、処理速度向上のため、0から連番とする制約を設けている 467 468 == ComIPdu == 469 {{{ 470 /AUTOSAR/EcucDefs/Com/ComConfig/ComIPdu 461 471 }}} 462 472 * 型:Container 463 473 * 多重度:0..* 464 465 == ComGwDestination == 466 {{{ 467 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination 468 }}} 469 * 型:Container 470 * 多重度:1..* 471 472 == ComGwDestinationDescription == 473 {{{ 474 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription 475 }}} 476 * 型:Container 477 * 多重度:0..1 478 479 == ComBitPosition == 480 {{{ 481 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComBitPosition 482 }}} 483 * 型:IntegerParam 484 * 多重度:1 485 486 == ComSignalEndianness == 487 {{{ 488 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComSignalEndianness 489 }}} 490 * 型:EnumerationParam 491 * 多重度:1 492 493 == ComSignalInitValue == 494 {{{ 495 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComSignalInitValue 496 }}} 497 * 型:StringParam 498 * 多重度:0..1 499 500 == ComTransferProperty == 501 {{{ 502 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComTransferProperty 503 }}} 504 * 型:EnumerationParam 505 * 多重度:0..1 506 507 == ComUpdateBitPosition == 508 {{{ 509 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComUpdateBitPosition 510 }}} 511 * 型:IntegerParam 512 * 多重度:0..1 513 514 == ComGwIPduRef == 515 {{{ 516 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComGwIPduRef 517 }}} 518 * 型:Reference 519 * 多重度:1 520 521 == ComFilter == 522 {{{ 523 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter 524 }}} 525 * 型:Container 526 * 多重度:0..1 527 528 == ComFilterAlgorithm == 529 {{{ 530 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterAlgorithm 531 }}} 532 * 型:EnumerationParam 533 * 多重度:1 534 535 == ComFilterMask == 536 {{{ 537 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterMask 538 }}} 539 * 型:IntegerParam 540 * 多重度:0..1 541 542 == ComFilterMax == 543 {{{ 544 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterMax 545 }}} 546 * 型:IntegerParam 547 * 多重度:0..1 548 549 == ComFilterMin == 550 {{{ 551 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterMin 552 }}} 553 * 型:IntegerParam 554 * 多重度:0..1 555 556 == ComFilterOffset == 557 {{{ 558 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterOffset 559 }}} 560 * 型:IntegerParam 561 * 多重度:0..1 562 563 == ComFilterPeriod == 564 {{{ 565 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterPeriod 566 }}} 567 * 型:IntegerParam 568 * 多重度:0..1 569 570 == ComFilterX == 571 {{{ 572 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterX 573 }}} 574 * 型:IntegerParam 575 * 多重度:0..1 576 577 == ComGwSignal == 578 {{{ 579 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwSignal 580 }}} 581 * 型:Container 582 * 多重度:0..1 583 584 == ComGwSignalRef == 585 {{{ 586 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwSignal/ComGwSignalRef 587 }}} 588 * 型:Reference 589 * 多重度:1 590 591 == ComGwSource == 592 {{{ 593 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource 594 }}} 595 * 型:Container 596 * 多重度:1 597 598 == ComGwSignal == 599 {{{ 600 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSignal 601 }}} 602 * 型:Container 603 * 多重度:0..1 604 605 == ComGwSignalRef == 606 {{{ 607 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSignal/ComGwSignalRef 608 }}} 609 * 型:Reference 610 * 多重度:1 611 612 == ComGwSourceDescription == 613 {{{ 614 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription 615 }}} 616 * 型:Container 617 * 多重度:0..1 618 619 == ComBitPosition == 620 {{{ 621 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComBitPosition 622 }}} 623 * 型:IntegerParam 624 * 多重度:1 625 626 == ComBitSize == 627 {{{ 628 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComBitSize 629 }}} 630 * 型:IntegerParam 631 * 多重度:0..1 632 633 == ComSignalEndianness == 634 {{{ 635 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComSignalEndianness 636 }}} 637 * 型:EnumerationParam 638 * 多重度:1 639 640 == ComSignalLength == 641 {{{ 642 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComSignalLength 643 }}} 644 * 型:IntegerParam 645 * 多重度:0..1 646 647 == ComSignalType == 648 {{{ 649 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComSignalType 650 }}} 651 * 型:EnumerationParam 652 * 多重度:1 653 654 == ComUpdateBitPosition == 655 {{{ 656 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComUpdateBitPosition 657 }}} 658 * 型:IntegerParam 659 * 多重度:0..1 660 661 == ComGwIPduRef == 662 {{{ 663 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComGwIPduRef 664 }}} 665 * 型:Reference 666 * 多重度:1 667 668 == ComIPdu == 669 {{{ 670 /AUTOSAR/EcucDefs/Com/ComConfig/ComIPdu 671 }}} 672 * 型:Container 673 * 多重度:0..* 474 * IPDUを設定するコンテナ 674 475 675 476 == ComIPduCallout == … … 679 480 * 型:FunctionName 680 481 * 多重度:0..1 482 * 下位モジュール([wiki:spec_PDURouter PduR])からIPDUを受信した直後に呼び出すコールアウト関数名 483 * コールアウト関数は以下のシンタックスで定義する 484 {{{ 485 boolean Com_RxIpduCallout(PduIdType Id, const uint8* IpduData) 486 }}} 681 487 682 488 == ComIPduCancellationSupport == … … 686 492 * 型:BooleanParam 687 493 * 多重度:0..1 494 * IPDU通信要求キャンセルのサポート有無 688 495 689 496 == ComIPduDirection == … … 692 499 }}} 693 500 * 型:EnumerationParam 694 * 多重度:1 501 * SEND:送信 502 * RECEIVE:受信 503 * 多重度:1 504 * IPDUの通信の方向 695 505 696 506 == ComIPduHandleId == … … 700 510 * 型:IntegerParam 701 511 * 多重度:0..1 512 * IPDUのID 513 * 下位モジュール([wiki:spec_PDURouter PduR])との受信通知、送信完了通知において、IPDUを識別するために使用される 514 * 多重度は0..1であるが、送信完了通知と受信通知のどちらも使用しないIPDUが想定されないため、TOPPERS/A-COMでは、多重度1としている 515 * TOPPERS/A-COMでは、処理速度向上のため、0から連番とする制約を設けている 702 516 703 517 == ComIPduSignalProcessing == … … 706 520 }}} 707 521 * 型:EnumerationParam 708 * 多重度:1 522 * DEFERRED:周期関数([#Com_MainFunctionRx Com_MainFunctionRx]、[#Com_MainFunctionTx Com_MainFunctionTx])でシグナルの送信完了通知、受信通知を行う 523 * IMMEDIATE:コールバック関数([#Com_RxIndication Com_RxIndication]、[#Com_TxConfirmation Com_TxConfirmation])でシグナルの送信完了通知、受信通知を行う 524 * 多重度:1 525 * シグナルに対する処理タイミングを指定する 526 * 受信の場合、IMMEDIATEを設定すれば受信したタイミングでIPDUからシグナルをアンパッキングするため、すぐに最新値を取り出せるが、コールバック関数の処理時間が長くなる 709 527 710 528 == ComIPduTriggerTransmitCallout == … … 714 532 * 型:FunctionName 715 533 * 多重度:1 534 * IPDUトリガ送信時に呼び出されるコールアウト関数名 535 * Comモジュールから下位モジュール([wiki:spec_PDURouter PduR])にIPDUを通信する直前に呼び出すコールアウト関数名 536 * コールアウト関数は以下のシンタックスで定義する 537 {{{ 538 boolean Com_TxIpduCallout(PduIdType Id, uint8* IpduData) 539 }}} 716 540 717 541 == ComIPduType == … … 720 544 }}} 721 545 * 型:EnumerationParam 722 * 多重度:1 546 * NORMAL:通常のIPDU 547 * TP:TP通信のIPDU(TP:Transport) 548 * 多重度:1 549 * IPDUの種別 723 550 724 551 == ComIPduGroupRef == … … 728 555 * 型:Reference 729 556 * 多重度:0..* 557 * 所属するIPDUグループへの参照 730 558 731 559 == ComIPduSignalGroupRef == … … 735 563 * 型:Reference 736 564 * 多重度:0..* 565 * IPDUに所属するシグナルグループへの参照 737 566 738 567 == ComIPduSignalRef == … … 742 571 * 型:Reference 743 572 * 多重度:0..* 573 * IPDUに所属するシグナルへの参照 744 574 745 575 == ComPduIdRef == … … 749 579 * 型:Reference 750 580 * 多重度:1 581 * システム全体として同一IPDUを識別するためのIPDU(グローバルIPDU)への参照 582 * 詳細は[wiki:tips_pdu_id モジュール間のPDU-IDの関係]を参照 751 583 752 584 == ComIPduCounter == … … 812 644 * 型:Container 813 645 * 多重度:0..1 646 * 送信IPDUを設定するコンテナ 814 647 815 648 == ComMinimumDelayTime == … … 819 652 * 型:FloatParam 820 653 * 多重度:0..1 654 * 最小遅延時間 655 * 本パラメータで指定した時間未満であれば、送信要求が来ても送信せず遅延させる 656 * 単位は秒 821 657 822 658 == ComTxIPduClearUpdateBit == … … 825 661 }}} 826 662 * 型:EnumerationParam 827 * 多重度:0..1 663 * CONFIRMATION:送信完了通知を受け取った際にクリア 664 * TRANSMIT:[wiki:spec_PDURouter#PduR_User:UpTransmit PduR_ComTransmit]を呼び出した際にクリア 665 * TRIGGER_TRANSMIT:[#Com_TriggerTransmit Com_TriggerTransmit]が呼び出された際にクリア 666 * 多重度:0..1 667 * 送信IPDUに所属するシグナルおよびシグナルグループのアップデートビットをクリアするタイミング 828 668 829 669 == ComTxIPduUnusedAreasDefault == … … 833 673 * 型:IntegerParam 834 674 * 多重度:1 675 * IPDU内でシグナルやアップデートビットで使用していない領域に設定する値 835 676 836 677 == ComTxModeFalse == … … 840 681 * 型:Container 841 682 * 多重度:0..1 683 * TMSがFALSEの場合の送信モードを設定するコンテナ 842 684 843 685 == ComTxMode == … … 847 689 * 型:Container 848 690 * 多重度:1 691 * 送信モードを設定するコンテナ 692 * [#ComTxModeTrue ComTxModeTrue]側にも同じコンテナが含まれる 849 693 850 694 == ComTxModeMode == … … 853 697 }}} 854 698 * 型:EnumerationParam 855 * 多重度:1 699 * DIRECT:即時送信(+N回リピート送信) 700 * PERIODIC:周期送信 701 * MIXED:DIRECT+PERIODIC 702 * NONE:送信しない 703 * 多重度:1 704 * 送信モードを選択する 856 705 857 706 == ComTxModeNumberOfRepetitions == … … 861 710 * 型:IntegerParam 862 711 * 多重度:0..1 712 * [#ComTxModeMode ComTxModeMode]がDIRECT、MIXEDの場合に、即時送信に加え、リピート送信する場合の回数(N回) 863 713 864 714 == ComTxModeRepetitionPeriod == … … 868 718 * 型:FloatParam 869 719 * 多重度:0..1 720 * [#ComTxModeMode ComTxModeMode]がDIRECT、MIXEDの場合に、即時送信に加え、リピート送信する場合の送信間隔 721 * 単位は秒 870 722 871 723 == ComTxModeTimeOffset == … … 875 727 * 型:FloatParam 876 728 * 多重度:0..1 729 * [#ComTxModeMode ComTxModeMode]がPERIODIC、MIXEDの場合の、周期送信開始時のオフセット値 730 * 単位は秒 877 731 878 732 == ComTxModeTimePeriod == … … 882 736 * 型:FloatParam 883 737 * 多重度:0..1 738 * [#ComTxModeMode ComTxModeMode]がPERIODIC、MIXEDの場合の、周期送信間隔 739 * 単位は秒 884 740 885 741 == ComTxModeTrue == … … 889 745 * 型:Container 890 746 * 多重度:0..1 747 * TMSがTRUEの場合の送信モードを設定するコンテナ 891 748 892 749 == ComTxMode == … … 896 753 * 型:Container 897 754 * 多重度:1 755 * [#ComTxMode ComTxMode]と同じ 898 756 899 757 == ComTxModeMode == … … 903 761 * 型:EnumerationParam 904 762 * 多重度:1 763 * [#ComTxModeMode ComTxModeMode]と同じ 905 764 906 765 == ComTxModeNumberOfRepetitions == … … 910 769 * 型:IntegerParam 911 770 * 多重度:0..1 771 * [#ComTxModeNumberOfRepetitions ComTxModeNumberOfRepetitions]と同じ 912 772 913 773 == ComTxModeRepetitionPeriod == … … 917 777 * 型:FloatParam 918 778 * 多重度:0..1 779 * [#ComTxModeRepetitionPeriod ComTxModeRepetitionPeriod]と同じ 919 780 920 781 == ComTxModeTimeOffset == … … 924 785 * 型:FloatParam 925 786 * 多重度:0..1 787 * [#ComTxModeTimeOffset ComTxModeTimeOffset]と同じ 926 788 927 789 == ComTxModeTimePeriod == … … 931 793 * 型:FloatParam 932 794 * 多重度:0..1 795 * [#ComTxModeTimePeriod ComTxModeTimePeriod]と同じ 933 796 934 797 == ComIPduGroup == … … 938 801 * 型:Container 939 802 * 多重度:0..* 803 * IPDUグループを設定するコンテナ 940 804 941 805 == ComIPduGroupHandleId == … … 945 809 * 型:IntegerParam 946 810 * 多重度:1 811 * IPDUグループのID 812 * TOPPERS/A-COMでは、処理速度向上のため、0から連番とする制約を設けている 947 813 948 814 == ComIPduGroupGroupRef == … … 952 818 * 型:Reference 953 819 * 多重度:0..* 820 * 所属するIPDUグループ参照 821 * IPDUグループはネストすることが可能 954 822 955 823 == ComSignal == … … 959 827 * 型:Container 960 828 * 多重度:0..* 829 * シグナルを設定するコンテナ 961 830 962 831 == ComBitPosition == … … 966 835 * 型:IntegerParam 967 836 * 多重度:1 837 * 多重度:1 838 * IPDU内のシグナルの開始ビット位置 839 * 0~(IPDUのサイズ-1)の間で指定する 968 840 969 841 == ComBitSize == … … 973 845 * 型:IntegerParam 974 846 * 多重度:0..1 847 * シグナルのビットサイズ 975 848 976 849 == ComDataInvalidAction == … … 979 852 }}} 980 853 * 型:EnumerationParam 981 * 多重度:0..1 854 * NOTIFY:無効値受信通知用コールバック関数([#ComInvalidNotification ComInvalidNotification])を呼び出す 855 * REPLACE:初期値に置き換える 856 * 多重度:0..1 857 * シグナルの無効値を受信した場合の処理を選択する 982 858 983 859 == ComErrorNotification == … … 987 863 * 型:FunctionName 988 864 * 多重度:0..1 865 * エラー発生を通知するコールバック関数名 866 * [#Com_IpduGroupControl Com_IpduGroupControl]の呼び出しによって無効化された送信IPDUに対して,送信完了通知が届いていない場合に、所属するシグナルに設定された本コールバック関数が呼び出される 867 * コールバック関数は以下のシンタックスで定義する 868 {{{ 869 void Com_CbkTxErr(void) 870 }}} 989 871 990 872 == ComFirstTimeout == … … 994 876 * 型:FloatParam 995 877 * 多重度:0..1 878 * 受信デッドラインモニタリングにおける1回目のタイムアウト時間 879 * 単位は秒 996 880 997 881 == ComHandleId == … … 1001 885 * 型:IntegerParam 1002 886 * 多重度:1 887 * シグナルのID 888 * TOPPERS/A-COMでは、処理速度向上のため、0から連番とする制約を設けている 1003 889 1004 890 == ComInvalidNotification == … … 1008 894 * 型:FunctionName 1009 895 * 多重度:0..1 896 * シグナルの無効値受信を通知するコールバック関数名 897 * コールバック関数は以下のシンタックスで定義する 898 {{{ 899 void Com_CbkInv(void) 900 }}} 1010 901 1011 902 == ComNotification == … … 1015 906 * 型:FunctionName 1016 907 * 多重度:0..1 908 * シグナルの送信完了通知または受信通知のコールバック関数名 909 * コールバック関数は以下のシンタックスで定義する 910 {{{ 911 void Com_CbkTxAck(void) 912 }}} 913 {{{ 914 void Com_CbkRxAck(void) 915 }}} 1017 916 1018 917 == ComRxDataTimeoutAction == … … 1021 920 }}} 1022 921 * 型:EnumerationParam 1023 * 多重度:0..1 922 * NONE:何もしない 923 * REPLACE:初期値に置き換える 924 * 多重度:0..1 925 * シグナルの受信デッドラインモニタリングでタイムアウトが発生した場合の処理 1024 926 1025 927 == ComSignalDataInvalidValue == … … 1029 931 * 型:StringParam 1030 932 * 多重度:0..1 933 * シグナルの無効値 1031 934 1032 935 == ComSignalEndianness == … … 1035 938 }}} 1036 939 * 型:EnumerationParam 1037 * 多重度:1 940 * LITTLE_ENDIAN:リトルエンディアン 941 * BIG_ENDIAN:ビッグエンディアン 942 * OPAQUE:オペーク(UINT8_N型で使用する) 943 * 多重度:1 944 * IPDUにシグナルをパッキングする際のエンディアン(バイトオーダー) 945 * 詳細は[wiki:tips_signal_data シグナルデータの取り扱い]を参照 1038 946 1039 947 == ComSignalInitValue == … … 1043 951 * 型:StringParam 1044 952 * 多重度:0..1 953 * シグナルの初期値 954 * 周期送信されるシグナルであれば、[#Com_SendSignal Com_SendSignal]実行前でも初期値が送信される 955 * 他のECUからデータを受信する前に[#Com_ReceiveSignal Com_ReceiveSignal]を実行すると初期値が返る 1045 956 1046 957 == ComSignalLength == … … 1050 961 * 型:IntegerParam 1051 962 * 多重度:0..1 963 * シグナルの長さ 964 * 単位はバイト 965 * [#ComSignalType ComSignalType]がUINT8_NまたはUINT8_DYNの場合に使用する 1052 966 1053 967 == ComSignalType == … … 1056 970 }}} 1057 971 * 型:EnumerationParam 1058 * 多重度:1 972 * BOOLEAN:boolean 973 * UINT8:符号なし整数(8bit) 974 * UINT16:符号なし整数(16bit) 975 * UINT32:符号なし整数(32bit) 976 * SINT8:符号あり整数(8bit) 977 * SINT16:符号あり整数(16bit) 978 * SINT32:符号あり整数(32bit) 979 * FLOAT32:浮動小数点(32bit) 980 * FLOAT64:浮動小数点(64bit) 981 * UINT8_N:配列(8bit×N) 982 * UINT8_DYN:可変長配列(8bit×N) 983 * 多重度:1 984 * シグナルのデータ型 1059 985 1060 986 == ComTimeout == … … 1064 990 * 型:FloatParam 1065 991 * 多重度:0..1 992 * デッドラインモニタリングにおけるタイムアウト時間 993 * 単位は秒 1066 994 1067 995 == ComTimeoutNotification == … … 1071 999 * 型:FunctionName 1072 1000 * 多重度:0..1 1001 * デッドラインモニタリングにおいてタイムアウト発生を通知するコールバック関数名 1002 * コールバック関数は以下のシンタックスで定義する 1003 {{{ 1004 void Com_CbkTxTOut(void) 1005 }}} 1006 {{{ 1007 void Com_CbkRxTOut(void) 1008 }}} 1073 1009 1074 1010 == ComTransferProperty == … … 1077 1013 }}} 1078 1014 * 型:EnumerationParam 1079 * 多重度:0..1 1015 * PENDING:シグナルの書き込みが発生しても,所属IPDUを即時送信しない 1016 * TRIGGERED:シグナル書き込みが発生した場合,所属IPDUを即時送信する 1017 * TRIGGERED_WITHOUT_REPETITION:シグナルの書込みが発生した場合,所属IPDUを繰り返しなしで即時送信する 1018 * TRIGGERED_ON_CHANGE:シグナルの書き込みが発生し,書き込んだ値が前回値と異なる場合,所属IPDUを即時送信する 1019 * TRIGGERED_ON_CHANGE_WITHOUT_REPETITION:シグナルの書き込みが発生し,書き込んだ値が前回値と異なる場合,所属IPDUを繰り返しなしで即時送信する 1020 * 多重度:0..1 1021 * シグナルの送信プロパティ 1080 1022 1081 1023 == ComUpdateBitPosition == … … 1085 1027 * 型:IntegerParam 1086 1028 * 多重度:0..1 1029 * IPDU内のシグナルのアップデートビット位置 1030 * シグナルデータが格納される位置とオーバーラップしないように注意する必要がある 1087 1031 1088 1032 == ComSystemTemplateSystemSignalRef == … … 1092 1036 * 型:Reference 1093 1037 * 多重度:0..1 1038 * システムシグナルへの参照 1039 * この参照情報により、異なるECU間で通信するシグナルの情報を関連付けることができる 1094 1040 1095 1041 == ComFilter == … … 1099 1045 * 型:Container 1100 1046 * 多重度:0..1 1047 * シグナルに対するフィルタを設定するコンテナ 1101 1048 1102 1049 == ComFilterAlgorithm == … … 1105 1052 }}} 1106 1053 * 型:EnumerationParam 1107 * 多重度:1 1054 * ALWAYS:常にTRUE 1055 * NEVER:常にFALSE 1056 * MASKED_NEW_DIFFERS_MASKED_OLD:(今回値 & [#ComFilterMask ComFilterMask]) != (前回値 & [#ComFilterMask ComFilterMask]) 1057 * MASKED_NEW_DIFFERS_X:(今回値 & [#ComFilterMask ComFilterMask]) != [#ComFilterX ComFilterX] 1058 * MASKED_NEW_EQUALS_X:(今回値 & [#ComFilterMask ComFilterMask]) == [#ComFilterX ComFilterX] 1059 * NEW_IS_OUTSIDE:(今回値 ≦ [#ComFilterMin ComFilterMin]) !|| ([#ComFilterMax ComFilterMax] ≦ 今回値) 1060 * NEW_IS_WITHIN:[#ComFilterMin ComFilterMin] ≦ 今回値 ≦ [#ComFilterMax ComFilterMax] 1061 * ONE_EVERY_N:(フィルタリング回数 % [#ComFilterPeriod ComFilterPeriod]) == [#ComFilterOffset ComFilterOffset] 1062 * 多重度:1 1063 * フィルタのアルゴリズム 1064 * 各アルゴリズムの計算結果によって、フィルタリングの結果が、TRUEかFALSEとして判定される 1065 * 送信も受信も同じアルゴリズムを使用する 1108 1066 1109 1067 == ComFilterMask == … … 1113 1071 * 型:IntegerParam 1114 1072 * 多重度:0..1 1073 * フィルタに設定するマスク値 1074 * [#ComFilterAlgorithm ComFilterAlgorithm]がMASKED_NEW_DIFFERS_MASKED_OLD、MASKED_NEW_DIFFERS_X、MASKED_NEW_EQUALS_Xの場合のみ使用する 1115 1075 1116 1076 == ComFilterMax == … … 1120 1080 * 型:IntegerParam 1121 1081 * 多重度:0..1 1082 * フィルタに設定する最大値 1083 * [#ComFilterAlgorithm ComFilterAlgorithm]がNEW_IS_OUTSIDE、NEW_IS_WITHINの場合のみ使用する 1122 1084 1123 1085 == ComFilterMin == … … 1127 1089 * 型:IntegerParam 1128 1090 * 多重度:0..1 1091 * フィルタに設定する最小値 1092 * [#ComFilterAlgorithm ComFilterAlgorithm]がNEW_IS_OUTSIDE、NEW_IS_WITHINの場合のみ使用する 1129 1093 1130 1094 == ComFilterOffset == … … 1134 1098 * 型:IntegerParam 1135 1099 * 多重度:0..1 1100 * フィルタに設定するオフセット 1101 * [#ComFilterAlgorithm ComFilterAlgorithm]がONE_EVERY_Nの場合のみ使用する 1136 1102 1137 1103 == ComFilterPeriod == … … 1141 1107 * 型:IntegerParam 1142 1108 * 多重度:0..1 1109 * フィルタに設定する周期 1110 * [#ComFilterAlgorithm ComFilterAlgorithm]がONE_EVERY_Nの場合のみ使用する 1143 1111 1144 1112 == ComFilterX == … … 1148 1116 * 型:IntegerParam 1149 1117 * 多重度:0..1 1118 * フィルタに設定するXの値 1119 * [#ComFilterAlgorithm ComFilterAlgorithm]がMASKED_NEW_DIFFERS_X、MASKED_NEW_EQUALS_Xの場合のみ使用する 1150 1120 1151 1121 == ComSignalGroup == … … 1155 1125 * 型:Container 1156 1126 * 多重度:0..* 1127 * シグナルグループを設定するコンテナ 1128 * サブコンテナに含まれるパラメータはシグナルのものと同じである 1157 1129 1158 1130 == ComDataInvalidAction == … … 1373 1345 * 多重度:0..1 1374 1346 1347 == ComGwMapping == 1348 {{{ 1349 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping 1350 }}} 1351 * 型:Container 1352 * 多重度:0..* 1353 * シグナルゲートウェイ設定のコンテナ 1354 1355 == ComGwDestination == 1356 {{{ 1357 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination 1358 }}} 1359 * 型:Container 1360 * 多重度:1..* 1361 1362 == ComGwDestinationDescription == 1363 {{{ 1364 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription 1365 }}} 1366 * 型:Container 1367 * 多重度:0..1 1368 1369 == ComBitPosition == 1370 {{{ 1371 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComBitPosition 1372 }}} 1373 * 型:IntegerParam 1374 1375 == ComSignalEndianness == 1376 {{{ 1377 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComSignalEndianness 1378 }}} 1379 * 型:EnumerationParam 1380 * 多重度:1 1381 1382 == ComSignalInitValue == 1383 {{{ 1384 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComSignalInitValue 1385 }}} 1386 * 型:StringParam 1387 * 多重度:0..1 1388 1389 == ComTransferProperty == 1390 {{{ 1391 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComTransferProperty 1392 }}} 1393 * 型:EnumerationParam 1394 * 多重度:0..1 1395 1396 == ComUpdateBitPosition == 1397 {{{ 1398 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComUpdateBitPosition 1399 }}} 1400 * 型:IntegerParam 1401 * 多重度:0..1 1402 1403 == ComGwIPduRef == 1404 {{{ 1405 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComGwIPduRef 1406 }}} 1407 * 型:Reference 1408 * 多重度:1 1409 1410 == ComFilter == 1411 {{{ 1412 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter 1413 }}} 1414 * 型:Container 1415 * 多重度:0..1 1416 1417 == ComFilterAlgorithm == 1418 {{{ 1419 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterAlgorithm 1420 }}} 1421 * 型:EnumerationParam 1422 * 多重度:1 1423 1424 == ComFilterMask == 1425 {{{ 1426 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterMask 1427 }}} 1428 * 型:IntegerParam 1429 * 多重度:0..1 1430 1431 == ComFilterMax == 1432 {{{ 1433 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterMax 1434 }}} 1435 * 型:IntegerParam 1436 * 多重度:0..1 1437 1438 == ComFilterMin == 1439 {{{ 1440 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterMin 1441 }}} 1442 * 型:IntegerParam 1443 * 多重度:0..1 1444 1445 == ComFilterOffset == 1446 {{{ 1447 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterOffset 1448 }}} 1449 * 型:IntegerParam 1450 * 多重度:0..1 1451 1452 == ComFilterPeriod == 1453 {{{ 1454 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterPeriod 1455 }}} 1456 * 型:IntegerParam 1457 * 多重度:0..1 1458 1459 == ComFilterX == 1460 {{{ 1461 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwDestinationDescription/ComFilter/ComFilterX 1462 }}} 1463 * 型:IntegerParam 1464 * 多重度:0..1 1465 1466 == ComGwSignal == 1467 {{{ 1468 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwSignal 1469 }}} 1470 * 型:Container 1471 * 多重度:0..1 1472 1473 == ComGwSignalRef == 1474 {{{ 1475 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwDestination/ComGwSignal/ComGwSignalRef 1476 }}} 1477 * 型:Reference 1478 * 多重度:1 1479 1480 == ComGwSource == 1481 {{{ 1482 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource 1483 }}} 1484 * 型:Container 1485 * 多重度:1 1486 1487 == ComGwSignal == 1488 {{{ 1489 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSignal 1490 }}} 1491 * 型:Container 1492 * 多重度:0..1 1493 1494 == ComGwSignalRef == 1495 {{{ 1496 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSignal/ComGwSignalRef 1497 }}} 1498 * 型:Reference 1499 * 多重度:1 1500 1501 == ComGwSourceDescription == 1502 {{{ 1503 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription 1504 }}} 1505 * 型:Container 1506 * 多重度:0..1 1507 1508 == ComBitPosition == 1509 {{{ 1510 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComBitPosition 1511 }}} 1512 * 型:IntegerParam 1513 * 多重度:1 1514 1515 == ComBitSize == 1516 {{{ 1517 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComBitSize 1518 }}} 1519 * 型:IntegerParam 1520 * 多重度:0..1 1521 1522 == ComSignalEndianness == 1523 {{{ 1524 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComSignalEndianness 1525 }}} 1526 * 型:EnumerationParam 1527 * 多重度:1 1528 1529 == ComSignalLength == 1530 {{{ 1531 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComSignalLength 1532 }}} 1533 * 型:IntegerParam 1534 * 多重度:0..1 1535 1536 == ComSignalType == 1537 {{{ 1538 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComSignalType 1539 }}} 1540 * 型:EnumerationParam 1541 * 多重度:1 1542 1543 == ComUpdateBitPosition == 1544 {{{ 1545 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComUpdateBitPosition 1546 }}} 1547 * 型:IntegerParam 1548 * 多重度:0..1 1549 1550 == ComGwIPduRef == 1551 {{{ 1552 /AUTOSAR/EcucDefs/Com/ComConfig/ComGwMapping/ComGwSource/ComGwSourceDescription/ComGwIPduRef 1553 }}} 1554 * 型:Reference 1555 * 多重度:1 1556 1375 1557 == ComTimeBase == 1376 1558 {{{ … … 1379 1561 * 型:Container 1380 1562 * 多重度:1 1563 * 周期関数の時間に関する設定を行うコンテナ 1381 1564 1382 1565 == ComGwTimeBase == … … 1386 1569 * 型:FloatParam 1387 1570 * 多重度:0..1 1571 * [#Com_MainFunctionRouteSignals Com_MainFunctionRouteSignals]の起動周期 1572 * 単位は秒 1388 1573 1389 1574 == ComRxTimeBase == … … 1393 1578 * 型:FloatParam 1394 1579 * 多重度:0..1 1580 * [#Com_MainFunctionRx Com_MainFunctionRx]の起動周期 1581 * 単位は秒 1395 1582 1396 1583 == ComTxTimeBase == … … 1400 1587 * 型:FloatParam 1401 1588 * 多重度:0..1 1589 * [#Com_MainFunctionTx Com_MainFunctionTx]の起動周期 1590 * 単位は秒 1402 1591 1403 1592 == ComGeneral == … … 1407 1596 * 型:Container 1408 1597 * 多重度:1 1598 * Comモジュールの全般的な設定を行うコンテナ 1409 1599 1410 1600 == ComConfigurationUseDet == … … 1414 1604 * 型:BooleanParam 1415 1605 * 多重度:0..1 1606 * [wiki:spec_DevelopmentErrorTracer]の使用有無 1416 1607 1417 1608 == ComEnableMDTForCyclicTransmission == … … 1421 1612 * 型:BooleanParam 1422 1613 * 多重度:0..1 1614 * 周期送信における[#ComMinimumDelayTime ComMinimumDelayTime]の使用有無 1423 1615 1424 1616 == ComRetryFailedTransmitRequests == … … 1428 1620 * 型:BooleanParam 1429 1621 * 多重度:0..1 1622 * 失敗送信要求のリトライの使用有無 1430 1623 1431 1624 == ComSupportedIPduGroups == … … 1435 1628 * 型:IntegerParam 1436 1629 * 多重度:1 1630 * IPDUグループ数の最大値 1437 1631 1438 1632 == ComVersionInfoApi == … … 1442 1636 * 型:BooleanParam 1443 1637 * 多重度:1 1444 1445 1638 * [#Com_GetVersionInfo Com_GetVersionInfo]の使用有無 1639