AUTOSAR COM

Gebruik en semantiek

De functie Com_Init initialiseert de interne en externe interfaces en variabelen van de AUTOSAR-COM-laag voor de daaropvolgende verwerking ([SWS_Com_00432]). De aanroep verloopt synchroon en is niet re-entrant (Non Reentrant) ([SWS_Com_00432]). Als overdrachtsparameter dient config als pointer naar de configuratiedata van de COM-module (const Com_ConfigType* config); een retourwaarde ontbreekt ([SWS_Com_00432]). In multi-partitieconfiguraties waarin hoofdfuncties van de COM-module aan meerdere partities zijn toegewezen, kan COM per partitie een eigen initialisatiefunctie beschikbaar stellen ([SWS_Com_00432]).

Volgordevoorwaarden en foutafhandeling

De initialisatie via Com_Init is de functionele voorwaarde voor het reguliere gebruik van de COM-interfaces: als een API-service vóór Com_Init of na een aanroep van Com_DeInit wordt aangeroepen, wordt de foutcode COM_E_UNINIT (0x02) gegenereerd ([SWS_Com_00804]). Uitsluitend de aanroepen van Com_GetStatus, Com_GetVersionInfo, Com_MainFunctionRx, Com_MainFunctionTx en Com_MainFunctionRouteSignals zijn vrijgesteld van deze foutcontrole ([SWS_Com_00804]).

Samenspel bij de PDU- en signaalinitialisatie

Na uitvoering van Com_Init blijft de eigenlijke inter-ECU-communicatie aanvankelijk gedeactiveerd ([SWS_Com_00432]). Interpretatie: Voor het reguliere zend- en ontvangstbedrijf is daarom vermoedelijk een naderhand uitgevoerde activering van de respectievelijke I-PDU-groepen vereist. Vraag Q-8407f9a6281c3764 (open) Voor bepaalde datastructuren voert Com_Init echter al directe initialisaties uit:

• Als een I-PDU niet aan een I-PDU-groep is toegewezen, start COM deze I-PDU al binnen Com_Init zodanig alsof deze via Com_IpduGroupStart met gezette initialisatieparameter was gestart ([SWS_Com_00840]).
• Voor signaalgroepen met geconfigureerde array-toegang (ComSignalGroupArrayAccess) initialiseert Com_Init het bijbehorende bufferbereik van de I-PDU aan de hand van de initiële waarden (ComSignalInitValue) van alle opgenomen groepssignalen ([SWS_Com_00850]).

Gebruik en aanroepcontext

De synchrone functie [SWS_Com_00130] (interpretatie: in de payload geregistreerd als 'Init', maar specificeert de signatuur void Com_DeInit(void)) beëindigt de inter-ECU-communicatie en brengt de AUTOSAR COM-module in de niet-geïnitialiseerde toestand ([SWS_Com_00130]). Vraag Q-3e91d7d0a140cee0 (open) De service heeft de service-ID 0x02, vereist geen overdrachtsparameters, levert geen retourwaarde op en wordt beschikbaar gesteld via het headerbestand Com.h ([SWS_Com_00130]).

Gelijktijdigheid en beperkingen

Wat betreft de aanroepcontext is de functie gedefinieerd als niet-re-entrant (Non Reentrant) ([SWS_Com_00130]). Een parallelle of meervoudige aanroep zonder voorafgaande herinitialisatie is daarom niet toegestaan.

Zusammenspiel en levenscyclus

Door de deïnitialisatie worden alle eerder gestarte I-PDU-groepen gestopt ([SWS_Com_00130]). Voor een latere hervatting van de communicatie gelden de volgende volgordevoorwaarden:

• De module moet opnieuw worden geïnitialiseerd via de synchrone, niet-re-entrante service Com_Init onder overdracht van de configuratiepointer config ([SWS_Com_00432]).
• Aangezien de inter-ECU-communicatie na de aanroep van Com_Init gedeactiveerd blijft ([SWS_Com_00432]), moeten de benodigde I-PDU-groepen aansluitend opnieuw expliciet worden gestart ([SWS_Com_00130]).

De synchrone functie Com_IpduGroupStart (service-ID 0x03, header Com.h) dient voor het starten van een voorgeconfigureerde I-PDU-groep [SWS_Com_91001]. Na de aanroep wordt de overdracht van de bijbehorende I-PDU's geactiveerd; cyclische I-PDU's worden voortaan bijvoorbeeld cyclisch verzonden [SWS_Com_91001].

Gebruik en parameters

De functie heeft geen retourwaarde en accepteert twee invoerparameters [SWS_Com_91001]:

• IpduGroupId: Eenduidige identificatie van de te starten voorgeconfigureerde I-PDU-groep [SWS_Com_91001].
• initialize: Een booleaanse vlag voor het aanvragen van de gegevensinitialisatie van de I-PDU's van deze groep voorafgaand aan de start [SWS_Com_91001].

Als initialize op true is gezet, moeten alle I-PDU's van de groep voorafgaand aan de start worden ge(re-)initialiseerd [SWS_Com_91001]. De I-PDU's gedragen zich vervolgens zoals direct na een opstart van de COM-module [SWS_Com_91001]. Dit omvat in het bijzonder de herinitialisatie van de eerdere waarde (old_value) van filterobjecten en de schaduwbuffers voor signaalgroepen [SWS_Com_91001].

Gelijktijdigheid en beperkingen

Wat betreft gelijktijdigheid is Com_IpduGroupStart re-entrant voor verschillende I-PDU-groepen, maar expliciet niet-re-entrant voor dezelfde I-PDU-groep [SWS_Com_91001].

Gebruik

De functie Com_IpduGroupStop dient voor het stoppen van een voorgeconfigureerde I-PDU-groep in de AUTOSAR COM-module [SWS_Com_91002]. De declaratie is beschikbaar via het headerbestand Com.h en heeft de service-ID 0x04 [SWS_Com_91002].

• Aanroepsyntaxis: void Com_IpduGroupStop (Com_IpduGroupIdType IpduGroupId) [SWS_Com_91002].
• Parameters: Als enige parameter wordt de ingangsparameter IpduGroupId van het type Com_IpduGroupIdType doorgegeven, die de identifier van de te stoppen I-PDU-groep vastlegt [SWS_Com_91002]. Aanvullende in-/uitgangs- (inout) of uitgangsparameters (out) bestaan niet [SWS_Com_91002].
• Retourwaarde: De interface levert geen retourwaarde op (void) [SWS_Com_91002].
• Uitvoeringsgedrag: De aanroep wordt synchroon verwerkt [SWS_Com_91002]. Na de aanroep van Com_IpduGroupStop wordt de communicatie van de desbetreffende groep gestopt; dit leidt er bijvoorbeeld toe dat cyclische I-PDU's van de groep niet meer worden uitgezonden [SWS_Com_91002].

Gelijktijdigheid en beperkingen

Met betrekking tot concurrency en re-entrantie is vastgelegd dat Com_IpduGroupStop re-entrant is voor verschillende I-PDU-groepen, maar voor dezelfde I-PDU-groep niet re-entrant mag worden uitgevoerd [SWS_Com_91002]. Wordt de functie in multitasking- of multicore-omgevingen aangeroepen, dan moet de aanroepende software waarborgen dat concurrerende aanroepen voor een en dezelfde groeps-ID uitgesloten zijn.

De synchrone functie Com_EnableReceptionDM dient ertoe om de ontvangsttermijnbewaking (Reception Deadline Monitoring) voor alle I-PDU's binnen een vooraf opgegeven I-PDU-groep te activeren [SWS_Com_91004].

Gebruik en aanroepcontext: De functie is gedeclareerd via het headerbestand Com.h en heeft de service-ID 0x06 [SWS_Com_91004]. Als enige overdrachtsparameter verwacht de signatuur void Com_EnableReceptionDM (Com_IpduGroupIdType IpduGroupId) de invoerparameter IpduGroupId van het type Com_IpduGroupIdType, die de identifier vertegenwoordigt van de I-PDU-groep voor de daarin opgenomen I-PDU's waarvan de termijnbewaking moet worden ingeschakeld [SWS_Com_91004]. De uitvoering vindt synchroon plaats [SWS_Com_91004]. Er bestaan in-/uitvoerparameters noch uitvoerparameters, en er wordt geen retourwaarde geleverd (retourtype void) [SWS_Com_91004].

Concurrency en beperkingen: Met betrekking tot de concurrency is Com_EnableReceptionDM re-entrant voor verschillende I-PDU-groepen, maar niet re-entrant voor dezelfde I-PDU-groep [SWS_Com_91004]. Concurrerende aanroepen voor dezelfde groeps-ID zijn daarom niet toegestaan en moeten in de aanroepcontext worden vermeden [SWS_Com_91004].

De synchrone functie Com_DisableReceptionDM deactiveert de ontvangstdeadlinebewaking (Reception Deadline Monitoring) voor alle I-PDU's binnen de doorgegeven I-PDU-groep [SWS_Com_91003].

Gebruik

De aanroep vindt plaats via de interface void Com_DisableReceptionDM(Com_IpduGroupIdType IpduGroupId) met de identifier van de desbetreffende I-PDU-groep als ingangsparameter IpduGroupId [SWS_Com_91003]. De functie heeft in-/uitgangs- noch uitgangsparameters en levert geen retourwaarde (void) [SWS_Com_91003]. De dienst is gedeclareerd met de service-ID 0x05 in het headerbestand Com.h [SWS_Com_91003].

Gelijktijdigheid en beperkingen

Wat betreft het concurrencygedrag is de dienst re-entrant voor verschillende I-PDU-groepen, maar mag voor dezelfde I-PDU-groep niet gelijktijdig (non-reentrant) worden aangeroepen [SWS_Com_91003].

De functie Com_SendSignal dient voor het bijwerken van een door SignalId geïdentificeerd signaalobject met de gegevens waarnaar de pointer SignalDataPtr verwijst [SWS_Com_00197]. De aanroep wordt asynchroon afgehandeld [SWS_Com_00197].

Retourwaarden en foutafhandeling

De functie retourneert een status van het type uint8 [SWS_Com_00197]:

• E_OK: de service is geaccepteerd [SWS_Com_00197].
• COM_SERVICE_NOT_AVAILABLE: de bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt als gevolg van een ontwikkelingsfout [SWS_Com_00197].
• COM_BUSY: treedt op wanneer de TP-buffer vergrendeld is voor de verwerking van grote gegevenstypen [SWS_Com_00197].

Gelijktijdigheid en beperkingen

Wat betreft de reentrantie is Com_SendSignal voor hetzelfde signaal niet-reentrant, maar mag voor verschillende signalen gelijktijdig worden aangeroepen [SWS_Com_00197]. De interface wordt beschikbaar gesteld via de header Com.h [SWS_Com_00197].

Interactie en configuratie

Als voor een signaalgroep de configuratie ComSignalGroupArrayAccess is gedefinieerd, wordt de aanroep van Com_SendSignal voor de groepssignalen van deze signaalgroep niet ondersteund [SWS_Com_00843].

De Classic-AUTOSAR-functie Com_SendDynSignal dient voor het bijwerken van een signaalobject met dynamische lengte aan de hand van de doorgegeven payload ([SWS_Com_00627]). De service heeft de Service-ID 0x21 en werkt asynchroon ([SWS_Com_00627]). Als ingangsparameter verwacht de interface de identifier van het doelsignaal (SignalId), een pointer naar de over te dragen signaal-payload (SignalDataPtr) evenals de actuele lengte van het dynamische signaal (Length); uitgangsparameters zijn niet aanwezig ([SWS_Com_00627]).

De retourwaarde van het type uint8 meldt het resultaat van de orderacceptatie ([SWS_Com_00627]):

• E_OK: De service-aanroep is succesvol geaccepteerd ([SWS_Com_00627]).
• E_NOT_OK: De parameter Length overschrijdt de voor dit signaal geconfigureerde maximumlengte ComSignalLength ([SWS_Com_00627]).
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de dienst is mislukt als gevolg van een ontwikkelingsfout ([SWS_Com_00627]).
• COM_BUSY: De TP-buffer is vergrendeld ([SWS_Com_00627]).

Met betrekking tot concurrency is Com_SendDynSignal re-entrant voor verschillende signalen, maar niet re-entrant voor hetzelfde signaal ([SWS_Com_00627]). De functiedeclaratie is beschikbaar via de header Com.h ([SWS_Com_00627]).

De synchrone functie Com_ReceiveSignal kopieert de gegevens van het via SignalId gespecificeerde signaal naar het via de pointer SignalDataPtr bereitgestelde geheugenadres ([SWS_Com_00198]).

Gebruik en semantiek

De aanroep verwerkt de signaaloverdracht synchroon en accepteert als invoerparameter de identifier SignalId (van het type Com_SignalIdType) en als uitvoerparameter de pointer SignalDataPtr (void*) naar de doelbuffer ([SWS_Com_00198]). De interface is beschikbaar via de header Com.h ([SWS_Com_00198]).

Retourwaarden en foutafhandeling

De retourwaarde van het type uint8 signaleert het resultaat van de functie-uitvoering ([SWS_Com_00198]):

• E_OK: De service is met succes geaccepteerd en uitgevoerd ([SWS_Com_00198]).
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de service is mislukt als gevolg van een ontwikkelingsfout ([SWS_Com_00198]).
• COM_BUSY: Treedt op als de TP-buffer voor de verwerking van grote datatypes is vergrendeld ([SWS_Com_00198]).

Gelijktijdigheid en beperkingen

Wat betreft re-entrantie is Com_ReceiveSignal niet re-entrant voor hetzelfde signaal, maar wel re-entrant voor verschillende signalen ([SWS_Com_00198]). Bij parallelle toegang tot identieke signaal-ID's moeten aanroepers derhalve voor een passende synchronisatie zorgen.

Bovendien geldt er een belangrijke configuratiebeperking: als voor een signaalgroep array-gebaseerde toegang ComSignalGroupArrayAccess is geconfigureerd, wordt de aanroep van Com_ReceiveSignal voor de opgenomen groepssignalen van deze signaalgroep niet ondersteund ([SWS_Com_00843]).

Gebruik en semantiek

De synchrone functie Com_ReceiveDynSignal dient voor de ontvangst van een signaal met dynamische lengte aan de hand van zijn SignalId [SWS_Com_00690]. De ontvangen signaalgegevens worden gekopieerd naar de geheugenlocatie waarnaar SignalDataPtr wijst [SWS_Com_00690]. Via de in-outparameter Length geeft de aanroeper als invoerwaarde de maximaal opneembare lengte door; na een succesvolle kopieerbewerking wordt daarin de werkelijke lengte van het ontvangen dynamische signaal opgeslagen [SWS_Com_00690].

Retourwaarden en foutafhandeling

De functie retourneert een statuswaarde van het type uint8 [SWS_Com_00690]:

• E_OK: De service-aanroep is geaccepteerd en de gegevens zijn succesvol gekopieerd [SWS_Com_00690].
• E_NOT_OK: De ter beschikking gestelde buffer is te klein, omdat de invoerwaarde van Length kleiner is dan de werkelijke lengte van het ontvangen signaal [SWS_Com_00690].
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de service is mislukt als gevolg van een ontwikkelingsfout [SWS_Com_00690].
• COM_BUSY: De TP-buffer is momenteel vergrendeld [SWS_Com_00690].

Gelijktijdigheid en integratie

Wat betreft re-entrantie kan Com_ReceiveDynSignal voor hetzelfde signaal niet re-entrant, maar voor verschillende signalen wel re-entrant worden aangeroepen [SWS_Com_00690]. De declaratie is beschikbaar via Com.h [SWS_Com_00690].

De asynchrone functie Com_SendSignalGroup dient ertoe de inhoud van de toegewezen shadow-buffer naar de bijbehorende I-PDU te kopiëren [SWS_Com_00200]. Als invoerparameter accepteert deze de identifier SignalGroupId van de te verzenden signaalgroep [SWS_Com_00200].

Retourwaarden en foutafhandeling

De retourwaarde geeft de uitvoeringsstatus van de service aan [SWS_Com_00200]:

• E_OK: De service-aanroep is met succes geaccepteerd [SWS_Com_00200].
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de service is mislukt als gevolg van een ontwikkelingsfout [SWS_Com_00200].
• COM_BUSY: De TP-buffer is tijdelijk vergrendeld voor de overdracht van grote datatypes [SWS_Com_00200].

Gelijktijdigheid en beperkingen

Wat betreft concurrency is de aanroep niet re-entrant voor hetzelfde groepssignaal, maar wel re-entrant voor verschillende groepssignalen [SWS_Com_00200]. Interpretatie: De beperking heeft vermoedelijk betrekking op gelijktijdige toegang tot dezelfde signaalgroep. Vraag Q-2f3a6da092b51794 (open) Bovendien wordt de aanroep van Com_SendSignalGroup voor een signaalgroep niet ondersteund als hiervoor ComSignalGroupArrayAccess is geconfigureerd [SWS_Com_00843].

Samenspel

De AUTOSAR-COM-module behandelt een aanroep van Com_SendSignalGroupArray gelijkwaardig aan Com_SendSignalGroup wat betreft de overdrachtseigenschappen, de selectie van de I-PDU-overdrachtsmodus en de signaalstroom [SWS_Com_00847].

Gebruik

De synchrone functie Com_ReceiveSignalGroup dient voor de ontvangst van signaalgroepen. Deze kopieert de gegevens van de ontvangen signaalgroep uit de desbetreffende I-PDU naar de toegewezen schaduwbuffer (Shadow Buffer) [SWS_Com_00201]. Als invoerparameter verwacht de functie de identifier van de signaalgroep SignalGroupId van het type Com_SignalGroupIdType [SWS_Com_00201]. De service is gedeclareerd in het headerbestand Com.h [SWS_Com_00201].

Foutafhandeling en retourwaarden

De service retourneert een statuswaarde van het type uint8 die informatie geeft over het succes of de foutoorzaak [SWS_Com_00201]:

• E_OK: De service is succesvol geaccepteerd en de signaalgroep is gekopieerd [SWS_Com_00201].
• COM_SERVICE_NOT_AVAILABLE: de bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt als gevolg van een ontwikkelingsfout [SWS_Com_00201].
• COM_BUSY: De service meldt deze toestand indien de TP-buffer voor de verwerking van grote datatypen is vergrendeld [SWS_Com_00201].

Gelijktijdigheid en beperkingen

Wat betreft het concurrencygedrag is Com_ReceiveSignalGroup uitgevoerd als niet-re-entrant voor dezelfde signaalgroep, maar re-entrant voor verschillende signaalgroepen [SWS_Com_00201].

Bovendien bestaat er een belangrijke beperking bij de interactie met arraytoegang: Indien voor een signaalgroep de configuratie ComSignalGroupArrayAccess (ECUC_Com_10003) is gedefinieerd, wordt de aanroep van Com_ReceiveSignalGroup voor deze signaalgroep volgens de specificatie niet ondersteund [SWS_Com_00843].

De asynchrone functie Com_SendSignalGroupArray kopieert de gegevens van een signaalgroep via de pointer SignalGroupArrayPtr rechtstreeks naar de toegewezen I-PDU [SWS_Com_00851]. De doorgegeven gegevens moeten daarbij exact overeenkomen met de array-representatie van de betreffende signaalgroep [SWS_Com_00851], [SWS_Com_00852].

Als invoerparameters worden de identifier van de signaalgroep (SignalGroupId) en de referentie naar de signaalgroep-array (SignalGroupArrayPtr) doorgegeven [SWS_Com_00851]. De service levert de volgende retourwaarden [SWS_Com_00851]:

• E_OK: De serviceaanroep is succesvol geaccepteerd.
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt door een ontwikkelingsfout.
• COM_BUSY: De transportprotocolbuffer (TP-buffer) is vergrendeld voor de verwerking van grote gegevenstypen.

Wat betreft gelijktijdigheid is de functie niet-re-entrant voor dezelfde signaalgroep, maar mag deze wel re-entrant worden aangeroepen voor verschillende signaalgroepen [SWS_Com_00851]. De aanroep is alleen beschikbaar wanneer de configuratieschakelaar ComEnableSignalGroupArrayApi is geactiveerd [SWS_Com_00853].

Wat betreft de overdrachtseigenschappen van signaalgroepen, de selectie van de I-PDU-overdrachtsmodus en de signaalstroom wordt Com_SendSignalGroupArray door de AUTOSAR COM-module volledig analoog aan Com_SendSignalGroup behandeld [SWS_Com_00847].

Gebruik en configuratie

De synchrone functie Com_ReceiveSignalGroupArray kopieert de ontvangen signaalgroep als byte-array-representatie uit de I-PDU naar het geheugengebied waarnaar SignalGroupArrayPtr verwijst [SWS_Com_00854], [SWS_Com_00855]. De functie is uitsluitend beschikbaar wanneer de configuratieschakelaar ComEnableSignalGroupArrayApi is geactiveerd [SWS_Com_00856]. Deze ondersteunt ontvangstfiltering en Transmission Mode Selection met de filters ALWAYS, NEVER, MASKED_NEW_EQUALS_X, MASKED_NEW_DIFFERS_X, MASKED_NEW_DIFFERS_MASKED_OLD en ONE_EVERY_N [SWS_Com_00848].

Gegevenskopiëren en foutafhandeling

Bij de aanroep wordt de SignalGroupId en een pointer naar de doelarray doorgegeven, op wiens positie de AUTOSAR COM-module de gegevens van de I-PDU kopieert [SWS_Com_00849]. Zelfs als de I-PDU-groep gestopt is en de service COM_SERVICE_NOT_AVAILABLE retourneert, kopieert de module altijd de laatst bekende gegevens of de initiële waarden ComSignalInitValues, indien er eerder nog geen gegevens zijn geschreven [SWS_Com_00857].

Retourwaarden en concurrency

Mogelijke retourwaarden van de service zijn [SWS_Com_00854]:

• E_OK: De dienst is met succes geaccepteerd.
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de service is mislukt vanwege een ontwikkelingsfout.
• COM_BUSY: De TP-buffer is vergrendeld voor de verwerking van grote datatypes.

Wat betreft gelijktijdigheid is de functie re-entrant voor verschillende signaalgroepen, maar niet-re-entrant voor dezelfde signaalgroep [SWS_Com_00854].

De synchrone functie Com_ReceiveSignalWithMetaData dient voor het uitlezen van ontvangen signaalgegevens samen met hun metadata uit de communicatiemodule Com [SWS_Com_91005]. Bij aanroep kopieert de service de gegevens van het via de SignalId geadresseerde signaal naar de geheugenlocatie waarnaar SignalDataPtr verwijst, en slaat de ontvangen metadata op de positie MetaDataPtr op [SWS_Com_91005].

Parameters en aanroepcontext

De interface is beschikbaar via de header Com.h en wordt geïdentificeerd via de Service-ID 0x49 [SWS_Com_91005]. De parameterstructuur is als volgt opgebouwd:

• SignalId (in): ID van het te ontvangen signaal [SWS_Com_91005].
• SignalDataPtr (out): pointer naar de geheugenlocatie voor het opslaan van de ontvangen signaalgegevens [SWS_Com_91005].
• MetaDataPtr (out): pointer naar het geheugenbereik voor het opnemen van de signaal-metadata [SWS_Com_91005].

De functie levert een retourwaarde van het type uint8 op, waarvoor in deze standaardsectie geen specifieke foutwaarden zijn gedocumenteerd [SWS_Com_91005].

Gelijktijdigheid en beperkingen

Wat betreft de reentrantie is de service reentrant voor verschillende signalen, maar niet-reentrant voor hetzelfde signaal [SWS_Com_91005]. Bij parallelle of onderbrekende aanroepen met identieke SignalId is daarom vermoedelijk een externe beveiliging door de aanroeper vereist om dataconsistentie te garanderen. Vraag Q-51cbdce3d4f59f24 (open)

Gebruik en semantiek

De functie Com_ReceiveDynSignalWithMetaData wordt beschikbaar gesteld via het headerbestand Com.h en dient voor de synchrone ontvangst van signalen met dynamische lengte inclusief hun metagegevens [SWS_Com_91006]. Bij de aanroep kopieert de service de gegevens van het via SignalId geïdentificeerde signaal naar de door SignalDataPtr gerefereerde buffer [SWS_Com_91006]. De ontvangen metagegevens worden opgeslagen op de pointer MetaDataPtr, terwijl de werkelijke lengte van het ontvangen dynamische signaal op de positie van Length wordt geschreven [SWS_Com_91006].

Retourwaarden en foutafhandeling

De service retourneert een statuswaarde van het type uint8 [SWS_Com_91006]:

• E_OK: De ontvangstservice is succesvol geaccepteerd [SWS_Com_91006].
• E_NOT_OK: Treedt op wanneer de doorgegeven waarde van Length kleiner is dan de werkelijke lengte van het ontvangen dynamische signaal [SWS_Com_91006]. Interpretatie: De aanroeper moet via Length vooraf de buffergrootte opgeven, zodat de parameter feitelijk als gecombineerde in- en uitvoer fungeert. Vraag Q-8ad420c74748f219 (open)
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt vanwege een ontwikkelingsfout [SWS_Com_91006].
• COM_BUSY: De TP-buffer is momenteel vergrendeld [SWS_Com_91006].

Gelijktijdigheid en beperkingen

Met betrekking tot concurrency is de functie re-entrant voor verschillende signalen, maar mag deze voor hetzelfde signaal niet re-entrant worden aangeroepen [SWS_Com_91006]. Parallelle aanroepen voor dezelfde SignalId moeten daarom op aanroepersniveau worden gesynchroniseerd.

De synchrone functie Com_ReceiveSignalGroupWithMetaData dient voor de ontvangst van een signaalgroep inclusief bijbehorende metagegevens via de interface Com.h [SWS_Com_91007]. Deze neemt als ingangsparameter de identifier SignalGroupId aan en kopieert de ontvangen gegevens van de signaalgroep vanuit de I-PDU naar de lokale shadow-buffer [SWS_Com_91007]. Tegelijkertijd slaat de service de ontvangen metagegevens op op het bestemmingsadres dat wordt gerefereerd via de uitgangsparameter MetaDataPtr [SWS_Com_91007].

Het fout- en retourgedrag omvat drie statuswaarden: E_OK signaleert de succesvolle acceptatie van de service [SWS_Com_91007]. De retourwaarde COM_SERVICE_NOT_AVAILABLE geeft aan dat de bijbehorende I-PDU-groep is gestopt of dat er sprake is van een ontwikkelingsfout [SWS_Com_91007]. Treedt de foutcode COM_BUSY op, dan is de TP-buffer vergrendeld voor de verwerking van grote datatypes [SWS_Com_91007]. Met betrekking tot concurrency is de functie re-entrant voor verschillende signaalgroepen, maar niet re-entrant voor dezelfde signaalgroep [SWS_Com_91007]. Aangezien de specificatie geen ISR-beperkingen noemt, vindt de aanroep vermoedelijk synchroon op taakniveau plaats door de bovenliggende softwarecomponent. Vraag Q-a23cf67bae724ae1 (open)

In samenspel breidt de functie het ontvangstpad uit met metagegevens analoog aan Com_ReceiveSignalWithMetaData voor individuele signalen [SWS_Com_91005]. De beschikbaar gestelde metagegevens corresponderen met de eerder via Com_RxIndication op de interface ontvangen PDU-informatie [SWS_Com_00123]. Voor het signaleren van ongeldige gegevensinhoud kan in het totale proces bovendien Com_InvalidateSignalGroup worden gebruikt [SWS_Com_00557].

Gebruik

De synchrone service Com_ReceiveSignalGroupArrayWithMetaData (Service-ID 0x4c, beschikbaar via Com.h) kopieert de ontvangen signaalgroep-array-representatie vanuit de I-PDU naar de geheugenlocatie die via de pointer SignalGroupArrayPtr ter beschikking wordt gesteld [SWS_Com_91008]. Tegelijkertijd worden de ontvangen metagegevens geschreven naar de positie die door de parameter MetaDataPtr is aangegeven [SWS_Com_91008]. De functie heeft geen retourwaarde (void) [SWS_Com_91008].

Foutafhandeling

De specificatie definieert voor deze service geen retourwaarden en vermeldt geen specifieke foutcodes [SWS_Com_91008]. Interpretatie: Eventuele fouttoestanden bij aanroepparameters worden vermoedelijk intern opgevangen en afgehandeld via de foutrapportage van de module; concrete DET- of DEM-meldingen blijken echter niet uit het specificatie-uittreksel. Vraag (open)

Gelijktijdigheid en beperkingen

Wat betreft concurrency is de functie re-entrant voor verschillende signaalgroepen, maar niet re-entrant voor dezelfde signaalgroep [SWS_Com_91008]. Parallelle aanroepen met identieke SignalGroupId moeten aan de zijde van de aanroeper worden voorkomen. Interpretatie: Aanroepers zijn vermoedelijk bovendien verplicht om doelbuffers van voldoende grootte beschikbaar te stellen, aangezien de interface geen lengteparameters bevat. Vraag (open)

Samenspel

Het beschikbaar stellen van de gegevens in de PDU-buffer vereist dat er vooraf een ontvangstindicatie via Com_RxIndication heeft plaatsgevonden, die ook de metagegevens aan de COM-module levert [SWS_Com_00123]. De functie breidt de ontvangstinterfaces voor metagegevens uit analoog aan Com_ReceiveSignalWithMetaData voor individuele signalen [SWS_Com_91005] en verschilt van het reguliere ophalen van signalen via Com_ReceiveSignal [SWS_Com_00198].

De functie Com_SendSignalWithMetaData ([SWS_Com_91009]) dient voor het asynchroon bijwerken van een door SignalId gespecificeerd signaalobject met payload via SignalDataPtr en bijbehorende metagegevens via MetaDataPtr. De service is beschikbaar via de header Com.h.

• Aanroep en concurrency: De aanroep vindt asynchroon plaats ([SWS_Com_91009]). De functie is re-entrant voor verschillende signalen, maar niet re-entrant voor dezelfde signaalidentifier (SignalId) ([SWS_Com_91009]).
• Retourwaarden en foutafhandeling: De functie retourneert een statuswaarde van het type uint8 ([SWS_Com_91009]):
  • E_OK: Het verzendverzoek is succesvol door de module geaccepteerd ([SWS_Com_91009]).
  • COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt vanwege een ontwikkelingsfout ([SWS_Com_91009]).
  • COM_BUSY: De TP-buffer is geblokkeerd voor de verwerking van grote datatypen ([SWS_Com_91009]).
• Samenspel: In tegenstelling tot de basisverzenddienst Com_SendSignal ([SWS_Com_00197]) geeft deze functie expliciete metagegevens door. Deze vormt de verzendzijdige tegenhanger van de ontvangstservice Com_ReceiveSignalWithMetaData ([SWS_Com_91005]) en vult I-PDU-gerelateerde metagegevensservices zoals Com_TriggerIPDUSendWithMetaData ([SWS_Com_00858]) aan.

Gebruik en semantiek

De functie Com_SendDynSignalWithMetaData dient voor het asynchroon bijwerken van een via SignalId (type Com_SignalIdType) geïdentificeerd signaalobject met signaalgegevens van dynamische lengte en de bijbehorende metagegevens [SWS_Com_91010]. De over te dragen payload wordt gerefereerd via de pointer SignalDataPtr (type void*), terwijl MetaDataPtr (type uint8*) verwijst naar de metagegevens [SWS_Com_91010]. Via de parameter Length (type uint16) wordt de werkelijke lengte van het te verzenden dynamische signaal doorgegeven [SWS_Com_91010].

Retourwaarden en foutafhandeling

De retourwaarde van het type uint8 signaleert of de service is geaccepteerd of welke fout er is opgetreden [SWS_Com_91010]:

• E_OK: De service-aanroep is succesvol geaccepteerd voor verwerking [SWS_Com_91010].
• E_NOT_OK: De doorgegeven Length overschrijdt de voor dit signaal geconfigureerde ComSignalLength [SWS_Com_91010].
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt door een ontwikkelingsfout [SWS_Com_91010].
• COM_BUSY: De TP-buffer is momenteel vergrendeld, waardoor het signaal niet kan worden verzonden [SWS_Com_91010].

Gelijktijdigheid en integratie

Met betrekking tot concurrency is de functie re-entrant voor verschillende signalen, maar niet re-entrant voor hetzelfde signaal [SWS_Com_91010]. De interface heeft de Service-ID 0x4e en wordt in de module Com via het headerbestand Com.h ter beschikking gesteld [SWS_Com_91010].

De functie Com_SendSignalGroupWithMetaData (in het datamodel aangeduid als Data) dient voor de asynchrone overdracht van een signaalgroep samen met metagegevens naar de module Com [SWS_Com_91011]. Bij de aanroep kopieert de service de actuele inhoud van de toegewezen shadow-buffer naar de bijbehorende I-PDU, waarbij de metagegevens beschikbaar worden gesteld via de pointer MetaDataPtr [SWS_Com_91011].

De overdrachtsparameters omvatten de identifier van de signaalgroep (SignalGroupId) evenals de pointer naar de metagegevens (MetaDataPtr) [SWS_Com_91011]. De retourwaarden melden het resultaat van het serviceverzoek:

• E_OK: De service is succesvol geaccepteerd [SWS_Com_91011].
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de uitvoering is mislukt door een ontwikkelingsfout [SWS_Com_91011].
• COM_BUSY: De TP-buffer is vergrendeld voor de overdracht van grote datatypes [SWS_Com_91011].

Wat betreft concurrency is de aanroep re-entrant voor verschillende signalen, maar niet re-entrant voor hetzelfde groepssignaal; dit heeft vermoedelijk analoog aan de parameter SignalGroupId betrekking op de desbetreffende signaalgroep [SWS_Com_91011]. Vraag Q-91171d77370ae50a (open) In het samenspel met de module Com vormt de service een aanvulling op het verzenden van afzonderlijke signalen zoals Com_SendSignal [SWS_Com_00197] evenals het invalideren van signaalgroepen via Com_InvalidateSignalGroup [SWS_Com_00557]. Bovendien correspondeert deze met de ontvangstservice Com_ReceiveSignalWithMetaData [SWS_Com_91005] en de PDU-gebaseerde verzendaanroep Com_TriggerIPDUSendWithMetaData [SWS_Com_00858].

Gebruik en parameters

De functie Com_SendSignalGroupArrayWithMetaData dient voor het asynchroon overdragen van een signaalgroep samen met bijbehorende metagegevens [SWS_Com_91012]. Bij de aanroep kopieert de service de inhoud van de doorgegeven pointer SignalGroupArrayPtr direct naar de toegewezen I-PDU [SWS_Com_91012]. De ter beschikking gestelde gegevens moeten daarbij verplicht overeenkomen met de array-representatie van de signaalgroep, die via de parameter SignalGroupId van het type Com_SignalGroupIdType wordt geïdentificeerd [SWS_Com_91012]. Aanvullende metagegevens van de signaalgroep worden via de pointer MetaDataPtr aan de communicatielaag doorgegeven [SWS_Com_91012].

Retourwaarden en foutafhandeling

De functie retourneert een statuswaarde van het type uint8, die het succes van de overdracht of de desbetreffende foutoorzaak aangeeft [SWS_Com_91012]:

• E_OK: De service-aanroep is succesvol geaccepteerd door de COM-laag [SWS_Com_91012].
• COM_SERVICE_NOT_AVAILABLE: De bijbehorende I-PDU-groep is gestopt of de aanroep is mislukt vanwege een ontwikkelingsfout [SWS_Com_91012].
• COM_BUSY: De buffer van het transportprotocol (TP-buffer) is vergrendeld voor de verwerking van grote datatypes [SWS_Com_91012].

Gelijktijdigheid en beperkingen

Volgens de specificatie is de service geclassificeerd als niet re-entrant (Non Reentrant), waardoor gelijktijdige of onderbrekende aanroepen niet toegestaan zijn [SWS_Com_91012]. De interface heeft de Service-ID 0x50 en wordt via het headerbestand Com.h beschikbaar gesteld [SWS_Com_91012].

De functie Com_InvalidateSignal dient voor het ongeldig verklaren van een signaal in de communicatiemodule [SWS_Com_00203]. Deze stelt de waarde van het meegegeven signaal in op de in de configuratie vastgelegde ongeldigheidswaarde Com Signal Data Invalid Value [SWS_Com_00203]. De verwerking vindt asynchroon plaats [SWS_Com_00203]. Als enige overdrachtsparameter wordt de invoerparameter SignalId voor de identificatie van het signaal doorgegeven; er bestaan geen invoer-/uitvoer- of uitvoerparameters [SWS_Com_00203].

Als retourwaarde levert de aanroep een status van het type uint8 op, die het acceptatie- en foutgedrag weergeeft [SWS_Com_00203]:

• E_OK: De invalidation-service is succesvol geaccepteerd [SWS_Com_00203].
• COM_SERVICE_NOT_AVAILABLE: De service is niet beschikbaar. Dit treedt op wanneer de bijbehorende I-PDU-groep is gestopt, wanneer voor de opgegeven SignalId geen Com Signal Data Invalid Value is geconfigureerd, of wanneer de uitvoering faalt als gevolg van een ontwikkelfout [SWS_Com_00203].
• COM_BUSY: De service kan momenteel niet worden uitgevoerd omdat de TP-buffer geblokkeerd is [SWS_Com_00203].

Met betrekking tot de gelijktijdigheid is Com_InvalidateSignal niet re-entrant voor hetzelfde signaal, maar mag deze voor verschillende signalen parallel en re-entrant worden uitgevoerd [SWS_Com_00203]. De service is gedeclareerd onder de service-ID 0x10 en beschikbaar via de header Com.h [SWS_Com_00203].

De functie Com_InvalidateSignalGroup dient ertoe alle groepssignalen van de meegegeven signaalgroep in te stellen op hun respectievelijk geconfigureerde ComSignalDataInvalidValue-waarden en de signaalgroep daarmee te invalideren [SWS_Com_00557].

Gebruik en semantiek

Als invoerparameter verwacht de service de ID van de te invalideren signaalgroep (SignalGroupId van het type Com_SignalGroupIdType) [SWS_Com_00557]. De aanroep wordt asynchroon verwerkt en levert een statuswaarde van het type uint8 op [SWS_Com_00557].

Retourwaarden en foutafhandeling

De volgende retourwaarden zijn gespecificeerd [SWS_Com_00557]:

• E_OK: Het verzoek tot invalidatie is succesvol geaccepteerd.
• COM_SERVICE_NOT_AVAILABLE: De service is niet beschikbaar omdat de bijbehorende I-PDU-groep is gestopt, voor geen van de groepssignalen een ComSignalDataInvalidValue is geconfigureerd of de aanroep mislukt als gevolg van een ontwikkelingsfout.
• COM_BUSY: De buffer van het transportprotocol (TP-buffer) is momenteel vergrendeld.

Gelijktijdigheid en re-entrantie

De functie is niet re-entrant voor dezelfde signaalgroep, maar mag voor verschillende signaalgroepen gelijktijdig (re-entrant) worden aangeroepen [SWS_Com_00557]. De declaratie is beschikbaar via Com.h [SWS_Com_00557].

De synchrone functie Com_TriggerIPDUSend initieert de overdracht van de door de parameter PduId geïdentificeerde I-PDU [SWS_Com_00348]. Deze is beschikbaar via de header Com.h [SWS_Com_00348].

Aanroepvoorwaarden en retourwaarden

De aanroep initieert de verzending alleen wanneer de desbetreffende I-PDU is gestart [SWS_Com_00861]. Dienovereenkomstig differentieert de retourwaarde van het type Std_ReturnType de status van de I-PDU [SWS_Com_00348]:

• E_OK: De I-PDU is succesvol geïnitieerd voor overdracht [SWS_Com_00348].
• E_NOT_OK: De I-PDU bevindt zich in de gestopte toestand, zodat de overdracht niet kon worden geïnitieerd [SWS_Com_00348].

Buffer- en concurrencygedrag

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Com_00348]. Voor grote I-PDU's is voorzien in een buffermechanisme: als een grote I-PDU via Com_TriggerIPDUSend wordt getriggerd terwijl de buffer ervan vergrendeld is, buffert AUTOSAR COM het verzendverzoek en draagt de I-PDU pas over zodra de buffer weer beschikbaar is [SWS_Com_00867].

De functie Com_TriggerIPDUSendWithMetaData dient ertoe de overdracht van een I-PDU synchroon te initiëren en vooraf de interne metadata daarvan in de AUTOSAR COM-module te actualiseren [SWS_Com_00858]. De aanroep verwacht als parameter PduId de id van de te verzenden I-PDU en met MetaData een pointer naar de beschikbaar te stellen metadata [SWS_Com_00858]. De COM-module kopieert de gegevens vanaf het gerefereerde adres met inachtneming van de globaal geconfigureerde lengte van het metadatatype van de I-PDU naar haar interne gegevensbeheer en initieert onmiddellijk daarna de overdracht [SWS_Com_00858].

Conform [SWS_Com_00862] mag de COM-module de overdracht van de I-PDU echter alleen dan initiëren wanneer de I-PDU zich in de toestand gestart bevindt. Is de I-PDU daarentegen gestopt, dan blijft het activeren van de overdracht achterwege.

Het resultaat van de uitvoering wordt gesignaleerd via de retourwaarde:

• E_OK: De overdracht van de I-PDU is succesvol geactiveerd [SWS_Com_00858].
• E_NOT_OK: De I-PDU is gestopt; de overdracht kon niet worden geïnitieerd [SWS_Com_00858].

Specifieke foutcodes voor DET of DEM zijn voor deze service niet gedocumenteerd in de payload.

Met betrekking tot gelijktijdigheid is de interface gedefinieerd als niet-re-entrant (Non Reentrant) [SWS_Com_00858], waardoor parallelle aanroepen uitgesloten dan wel gesynchroniseerd moeten worden. Vermoedelijk ligt het binnen de verantwoordelijkheid van de oproeper om te zorgen voor de geldigheid van de pointer MetaData en een toereikende buffergrootte overeenkomstig de geconfigureerde metadatalengte. Vraag Q-66c6abae0bbde275 (open)

De synchrone interface Com_SwitchIpduTxMode dient voor het omschakelen van de overdrachtsmodus van een I-PDU en is gespecificeerd in de header Com.h onder de service-ID 0x27 [SWS_Com_00784]. Als parameters worden de identifier van de betreffende I-PDU (PduId) en de gewenste overdrachtsmodus als booleaanse waarde (Mode) meegegeven; een retourwaarde of uitvoerparameter is niet aanwezig [SWS_Com_00784]. De aanroep schakelt de overdrachtseigenschappen synchroon en direct tijdens de uitvoering om [SWS_Com_00784].

Voor de werking van de moduswijziging definieert de specificatie twee gevallen:

• Als de overdrachtsmodus door de aanroep verandert, treedt de nieuwe bedrijfsmodus voor de gerefereerde I-PDU onmiddellijk in werking [SWS_Com_00784], [SWS_Com_00239].
• Was de gevraagde overdrachtsmodus voor de betreffende I-PDU al actief, dan blijft de aanroep volledig zonder effect [SWS_Com_00784].

Wat betreft het verdere verloop van de verzending geldt voor het samenspel met de cyclische verzending: als de overdrachtsmodus van een I-PDU expliciet via Com_SwitchIpduTxMode wordt ingesteld, vertraagt de AUTOSAR-COM-module de daaropvolgende cyclische verzendingen van deze I-PDU met de tijdsverschuiving ComTxModeTimeOffset [SWS_Com_00881].

Wat betreft concurrency is de functie re-entrant ontworpen voor verschillende I-PDU-instanties [SWS_Com_00784]. Een gelijktijdige of parallelle aanroep voor dezelfde PduId is daarentegen gedefinieerd als niet re-entrant en moet door de aanroeper worden voorkomen [SWS_Com_00784].

De synchrone functie [SWS_Com_00001] dient voor het synchroon opvragen en kopiëren van SDU-gegevens van een te verzenden zend-PDU (TxPduId) naar de door de aanroeper bereitgestelde buffer. De aanroeper geeft via de invoer- en uitvoerparameter PduInfoPtr zowel het doeladres SduDataPtr als de maximaal beschikbare buffercapaciteit in SduLength mee. Indien de SDU-gegevens volledig in de buffer passen, worden ze gekopieerd, wordt PduInfoPtr->SduLength bijgewerkt naar het daadwerkelijk gekopieerde aantal bytes en wordt de service succesvol afgesloten met E_OK [SWS_Com_00001].

Foutafhandeling en randvoorwaarden

De functie breekt de uitvoering af, kopieert geen gegevens en retourneert E_NOT_OK als een van de volgende voorwaarden van toepassing is:

• De bereitgestelde buffergrootte in PduInfoPtr->SduLength is kleiner dan de werkelijke PDU-lengte [SWS_Com_00001], [SWS_Com_00869]. In dit geval blijft PduInfoPtr ongewijzigd [SWS_Com_00001].
• De desbetreffende I-PDU bevindt zich in de toestand gestopt [SWS_Com_00884].

In geval van een fout (E_NOT_OK) mag de aanroeper de pointer PduInfoPtr niet evalueren of verder gebruiken, omdat deze naar ongeldige gegevens kan verwijzen of een NULL-pointer kan zijn [SWS_Com_00001].

Concurrency

Wat betreft gelijktijdigheid is de interface voor verschillende PDU-ID's ontworpen als re-entrant, maar mag voor dezelfde TxPduId niet gelijktijdig worden aangeroepen [SWS_Com_00001].

De functie Com_RxIndication dient voor het signaleren en overdragen van een ontvangen PDU van een onderliggende communicatie-interfacemodule aan de AUTOSAR-COM-module [SWS_Com_00123]. De functiedeclaratie wordt beschikbaar gesteld via het headerbestand Com.h en heeft de Service-ID 0x42 [SWS_Com_00123].

De aanroep vindt plaats met synchrone semantiek en levert geen retourwaarde op (void) [SWS_Com_00123]. De interface definieert noch invoer-/uitvoerparameters noch zuivere uitvoerparameters, maar uitsluitend twee invoerparameters [SWS_Com_00123]:

• RxPduId (gegevenstype PduIdType): representeert de unieke identifier van de ontvangen PDU [SWS_Com_00123].
• PduInfoPtr (pointer naar constante PduInfoType): verwijst naar de datastructuur die de lengte van de ontvangen PDU (SduLength), een pointer naar de buffer met de PDU-gegevens (SduDataPtr) en bijbehorende metadata bevat [SWS_Com_00123].

Wat betreft het concurrencygedrag is Com_RxIndication gedefinieerd als reentrant voor aanroepen met verschillende PDU-ID's, maar uitdrukkelijk als niet-reentrant voor dezelfde PDU-ID [SWS_Com_00123]. Interpretatie: aanroepende modules van de onderliggende communicatie-interface zijn daarom vermoedelijk verplicht om concurrerende aanroepen voor identieke PDU-ID's te synchroniseren of te serialiseren om dataconsistentie te waarborgen. Vraag Q-f3b6194f96c15091 (open)

De synchrone servicefunctie Com_TpRxIndication wordt aangeroepen zodra een I-PDU via de TP-API is ontvangen [SWS_Com_00650]. Deze informeert de AUTOSAR COM-module over de afronding en het resultaat van het ontvangstproces. Via de parameter id wordt de betreffende I-PDU geïdentificeerd, terwijl de parameter result aangeeft of de overdracht succesvol was of is mislukt [SWS_Com_00650]. De functie heeft geen retourwaarde en is gedefinieerd in header Com.h met de service-ID 0x45 [SWS_Com_00650]. Als aanroeper fungeert vermoedelijk een onderliggende transportlaag zoals de PduR- of een TP-module. Vraag Q-d7006169cd162db4 (open)

Foutafhandeling

Als Com_TpRxIndication wordt aangeroepen met de resultaatwaarde E_NOT_OK voor de parameter result, behandelt de COM-module alle signalen van de ontvangen grote I-PDU exact als ongeldig geworden signalen [SWS_Com_00838]. De module voert in dit foutgeval alle geconfigureerde ComDataInvalidActions uit voor alle aanwezige signalen en signaalgroepen [SWS_Com_00838].

Gelijktijdigheid en randvoorwaarden

De functie is gespecificeerd als re-entrant en werkt synchroon [SWS_Com_00650]. Deze kan daarom parallel worden aangeroepen voor verschillende I-PDU's, maar moet in de context van de aanroepende instantie zonder vertraging worden afgehandeld.

De synchrone callback-functie Com_TxConfirmation wordt gedeclareerd via de header Com.h en dient als centrale bevestigingsinterface van de AUTOSAR-COM-module [SWS_Com_00124]. Een onderliggende communicatie-interfacemodule meldt daarmee de succesvolle overdracht van een PDU of het mislukken van het zendproces terug aan de module Com [SWS_Com_00124].

Aanroepcontext en parameters

De functie wordt synchroon uitgevoerd, heeft het service-ID 0x40 en levert geen retourwaarde op (void) [SWS_Com_00124]. Deze verwacht twee invoerparameters:

• TxPduId (type PduIdType): Eenduidige identificatie van de PDU waarvan de overdracht is voltooid of mislukt [SWS_Com_00124].
• result (type Std_ReturnType): Resultaatstatus van het verzendproces [SWS_Com_00124]. De waarde E_OK bevestigt de voltooide overdracht van de PDU, terwijl E_NOT_OK het mislukken van de PDU-overdracht signaleert [SWS_Com_00124].

Gelijktijdigheid en beperkingen

Com_TxConfirmation is re-entrant voor verschillende PDU-ID's, maar niet re-entrant voor dezelfde PDU-ID [SWS_Com_00124]. Interpretatie: aanroepers vanuit de onderliggende laag zullen opeenvolgende of onderbrekende aanroepen met dezelfde TxPduId vanuit verschillende uitvoeringscontexten moeten vermijden, zodat de interne verwerkingsstatus van de module Com consistent blijft. Vraag Q-146c1c92403b64fa (open)

Foutafhandeling

De specificatie definieert voor deze service geen specifieke retourwaarden en vermeldt geen afzonderlijke DET- of DEM-foutmeldingen [SWS_Com_00124]. Foutieve overdrachten worden uitsluitend via de parameter result met de foutwaarde E_NOT_OK aan de module Com doorgegeven [SWS_Com_00124].

Gebruik en semantiek

De functie Com_TpTxConfirmation wordt aangeroepen nadat een I-PDU op het netwerk is overgedragen, om de COM-module te informeren over het resultaat van het verzendproces [SWS_Com_00725]. Via de parameter id van het type PduIdType wordt de overgedragen I-PDU geïdentificeerd, terwijl result van het type Std_ReturnType aangeeft of de overdracht succesvol was dan wel is mislukt [SWS_Com_00725]. De functie heeft geen retourwaarde (void) en heeft een synchrone uitvoeringssemantiek [SWS_Com_00725]. Deze is beschikbaar via het headerbestand Com.h en bezit het service-ID 0x48 [SWS_Com_00725].

Foutafhandeling

Foutoverdracht op deze interface vindt uitsluitend plaats via de parameter result, die het slagen of mislukken van de I-PDU-overdracht weergeeft [SWS_Com_00725]. Specifieke foutcodes en foutmeldingen aan de Default Error Tracer (DET) of de Diagnostic Event Manager (DEM) module zijn in de functiespecificatie niet opgenomen [SWS_Com_00725].

Gelijktijdigheid en randvoorwaarden

De interface is gespecificeerd als re-entrant en mag zodoende parallel worden uitgevoerd [SWS_Com_00725]. Als temporele randvoorwaarde geldt dat de aanroep pas mag plaatsvinden na voltooiing van de overdracht van de I-PDU op het netwerk [SWS_Com_00725]. Interpretatie: op basis van de naamgevingsconventie en modulestructuur zal de aanroep typisch worden geïnitieerd door een onderliggende transportprotocolmodule. Vraag Q-8320e76ff63f62ce (open)

De synchrone en re-entrante functie Com_StartReception (beschikbaar via Com.h, service-ID 0x46) wordt aangeroepen aan het begin van de ontvangst van een N-SDU, die ongefragmenteerd als Single Frame (SF) of gefragmenteerd via een First Frame (FF) met daaropvolgende Consecutive Frames (CF) wordt overgedragen [SWS_Com_00691].

Via de parameter id wordt de I-PDU geïdentificeerd en TpSduLength geeft de totale lengte van de te ontvangen N-SDU aan [SWS_Com_00691]. De pointer info verwijst naar payload en nuttige lengte van het eerste respectievelijk afzonderlijke frame en naar bijbehorende metadata; als er noch framedata noch metadata beschikbaar zijn, wordt NULL_PTR meegegeven [SWS_Com_00691]. Via de uitvoerparameter bufferSizePtr stelt de functie de beschikbare buffergrootte ter beschikking, die de transportprotocolmodule gebruikt voor het bepalen van de Block Size (BS) [SWS_Com_00691]. Wordt de service met een TpSduLength van 0 aangeroepen, dan levert deze de actueel maximaal beschikbare buffergrootte [SWS_Com_00691].

Het resultaat van het verzoek wordt geretourneerd als BufReq_ReturnType [SWS_Com_00691]:

• BUFREQ_OK: De verbinding wordt geaccepteerd en de ontvangst wordt voortgezet; bufferSizePtr geeft de beschikbare buffer aan of signaleert 0 als er geen buffer met de gevraagde grootte beschikbaar is [SWS_Com_00691].
• BUFREQ_E_NOT_OK: De verbinding wordt geweigerd en de ontvangst wordt afgebroken; de waarde van bufferSizePtr blijft ongewijzigd [SWS_Com_00691].
• BUFREQ_E_OVFL: Er kan geen buffer met de vereiste lengte ter beschikking worden gesteld, waarna de ontvangst afbreekt; bufferSizePtr blijft ongewijzigd [SWS_Com_00691].

Gebruik en aanroepsemantiek

De synchrone functie Com_CopyRxData wordt aangeroepen om de ontvangen data van een I-PDU-segment (N-PDU) over te dragen aan de bovenliggende laag [SWS_Com_00692]. Bij gesegmenteerde overdrachten stelt elke opeenvolgende aanroep van deze interface telkens het volgende deel van de totale I-PDU-data ter beschikking [SWS_Com_00692].

Parameters en bufferbeheer

• id: Identificeert de ontvangen I-PDU uniek [SWS_Com_00692].
• info: Pointer naar een structuur van het type PduInfoType. Deze draagt via SduDataPtr de pointer naar de bronbuffer over en via SduLength het aantal te kopiëren bytes [SWS_Com_00692]. Het opgeven van 0 voor SduLength dient ertoe de actueel beschikbare buffergrootte van de bovenliggende laag op te vragen; in dit zuivere query-geval mag SduDataPtr op NULL_PTR zijn ingesteld [SWS_Com_00692].
• bufferSizePtr: Pointer naar een variabele van het type PduLengthType waarin de na het kopiëren resterende grootte van de ontvangstbuffer wordt geschreven [SWS_Com_00692].

Retourwaarden en eigenschappen

De functie retourneert een status van het type BufReq_ReturnType [SWS_Com_00692]:

• BUFREQ_OK: De data zijn succesvol naar de doelbuffer gekopieerd [SWS_Com_00692].
• BUFREQ_E_NOT_OK: Het kopiëren van de data is mislukt omdat er een fout is opgetreden [SWS_Com_00692].

De interface heeft service-ID 0x44, is gespecificeerd als re-entrant en is beschikbaar via de header Com.h [SWS_Com_00692].

De synchrone en re-entrante functie Com_CopyTxData wordt aangeroepen door onderliggende modules (zoals transportprotocollen) om verzendgegevens voor segmenten (N-PDU's) van een I-PDU stapsgewijs op te halen uit de verzendbuffer van de COM-module [SWS_Com_00693].

Gebruik en parameters

Elke aanroep stelt het volgende deel van de I-PDU-gegevens beschikbaar [SWS_Com_00693]:

• id: Identificeert de over te dragen I-PDU [SWS_Com_00693].
• info: Geeft via SduDataPtr de doelbuffer en via SduLength het aantal te kopiëren bytes aan. Een lengte van 0 is toegestaan om statuswijzigingen via retry door te geven of de beschikbare hoeveelheid gegevens op te vragen; in dit geval mag SduDataPtr een NULL_PTR zijn [SWS_Com_00693].
• retry: Bevestigt verzonden gegevens of initieert heroverdrachten. Als retry een NULL_PTR is, mogen gegevens direct na het kopiëren uit de buffer worden verwijderd. Als retry naar een RetryInfoType-structuur wijst, bestuurt TpDataState het bufferbehoud: TP_CONFPENDING laat gegevens voor fouthandeling in de buffer staan, TP_DATACONF bevestigt vóór de aanroep gekopieerde gegevens voor verwijdering, en TP_DATARETRY kopieert eerder gelezen gegevens vanaf de offset TxTpDataCnt opnieuw [SWS_Com_00693].
• availableDataPtr: Geeft het resterende aantal beschikbare bytes in de verzendbuffer terug, wat bijvoorbeeld dynamische transportprotocollen (zoals FrIsoTp) in staat stelt de opvolgende segmentgroottes te bepalen [SWS_Com_00693].

Retourwaarden en foutafhandeling

Het functieresultaat signaleert het slagen van het bufferverzoek via BufReq_ReturnType [SWS_Com_00693]:

• BUFREQ_OK: Gegevens zijn volledig zoals gevraagd naar de doelbuffer gekopieerd [SWS_Com_00693].
• BUFREQ_E_BUSY: De gevraagde hoeveelheid gegevens staat niet gereed in de verzendbuffer. Er worden geen gegevens gekopieerd en de onderliggende module mag de aanroep op een later tijdstip herhalen [SWS_Com_00693].
• BUFREQ_E_NOT_OK: Het verzoek is mislukt; er zijn geen gegevens gekopieerd [SWS_Com_00693].

Gebruik

De synchrone functie Com_MainFunctionRx verzorgt de interne ontvangstverwerking van de AUTOSAR COM-module voor bewerkingen die niet direct worden afgehandeld in de uitvoeringscontext van door de PDU-router (PduR) aangeroepen API's zoals Com_RxIndication [SWS_Com_00398]. Deze heeft noch ingangs- noch uitgangsparameters en levert geen retourwaarde op [SWS_Com_00398]. De declaratie vindt plaats via de header SchM_Com.h; de aanroepcontext zal daarom typisch periodiek plaatsvinden via de Schedule Manager (SchM) [SWS_Com_00398]. Vraag Q-48d121e36f62c6de (open)

Foutafhandeling en initialisatie

Als de functie vóór de module-initialisatie door Com_Init of na een aanroep van Com_DeInit wordt uitgevoerd, wordt in tegenstelling tot bij de meeste reguliere COM-API's geen fout COM_E_UNINIT (0x02) gegenereerd, aangezien Com_MainFunctionRx hiervan expliciet is uitgezonderd [SWS_Com_00804]. Er bestaan geen specifieke fout- of retourcodes voor deze interface [SWS_Com_00398].

Gelijktijdigheid en multi-instantie-werking

Met betrekking tot de uitvoeringscontext en de re-entrantie gelden de volgende voorschriften [SWS_Com_00398]:

• Re-entrantie: De functie is niet-re-entrant voor dezelfde instantie, maar mag wel parallel worden aangeroepen voor verschillende instanties [SWS_Com_00398].
• Instantiespecifieke verschijningsvorm: Voor elke in de ECU-configuratie gedefinieerde container ComMainFunctionRx wordt een zelfstandige functie geïmplementeerd in de vorm Com_MainFunctionRx_<shortName>, waarbij <shortName> overeenkomt met de short name van de configuratiecontainer [SWS_Com_00398].

Gebruik en werking

De functie Com_MainFunctionTx voert de verzendactiviteiten van de AUTOSAR COM-module uit die niet direct binnen de door de RTE aangeroepen COM-functies (zoals bijvoorbeeld Com_SendSignal) worden afgehandeld ([SWS_Com_00399]). De uitvoering gebeurt synchroon. Deze bevat noch invoer-, invoer-/uitvoer- noch uitvoerparameters en levert geen retourwaarde op ([SWS_Com_00399]). De interface wordt gedeclareerd via SchM_Com.h; interpretatie: op grond van deze header-toewijzing ligt de aanroepcontext vermoedelijk in het schedule-management (SchM). Vraag Q-c33cfcf81700bcc5 (open)

Voor elke geconfigureerde container van een Com Main Function Tx in de ECU-configuratie dient een specifieke instantiefunctie volgens het naamschema Com_MainFunctionTx_<shortName> te worden geïmplementeerd, waarbij <shortName> overeenkomt met de korte naam van de configuratiecontainer ([SWS_Com_00399]).

Gelijktijdigheid en beperkingen

Wat betreft re-entrantie is Com_MainFunctionTx ontworpen als re-entrant voor verschillende instanties, maar mag deze niet re-entrant worden aangeroepen voor dezelfde instantie ([SWS_Com_00399]).

Foutafhandeling en initialisatiestatus

Volgens [SWS_Com_00804] leidt het aanroepen van COM-services vóór de initialisatie via Com_Init of na de de-initialisatie via Com_DeInit regulier tot de fout COM_E_UNINIT (0x02). Com_MainFunctionTx is hiervan echter expliciet uitgezonderd en genereert in deze toestanden geen dergelijke initialisatiefout ([SWS_Com_00804]).

De hoofdfunctie Com_MainFunctionRouteSignals (service-ID 0x1a) dient in de AUTOSAR COM-module als centrale synchrone interface voor signaaldoorzending ([SWS_Com_00400]). De taak ervan bestaat erin het signaalgateway-gedeelte van de COM-module aan te roepen, zodat ontvangen signalen die bestemd zijn voor routering worden doorgezonden naar hun geconfigureerde doelen ([SWS_Com_00400]).

Aanroep en semantiek

De parameterloze C-interface heeft de signatuur void Com_MainFunctionRouteSignals(void) ([SWS_Com_00400]). Deze wordt synchroon uitgevoerd en heeft noch parameters voor invoer, invoer/uitvoer of uitvoer noch een retourwaarde ([SWS_Com_00400]). De declaratie van de hoofdfunctie wordt beschikbaar gesteld via het headerbestand SchM_Com.h ([SWS_Com_00400]). Interpretatie: wegens deze beschikbaarstelling via SchM_Com.h zal de geplande aanroep in taakcontext vermoedelijk periodiek plaatsvinden door de BSW-scheduler (SchM). Vraag Q-0f0b57034d6d6bf1 (open)

Instantiëring en re-entrantie

Voor integratie, naamgeving en gelijktijdigheid definieert [SWS_Com_00400] de volgende bindende eisen:

• Instantiespecifieke implementatie: Voor elke in de ECU-configuratie aanwezige instantie van de configuratiecontainer ComMainFunctionRouteSignals moet een eigen functie volgens het naamschema Com_MainFunctionRouteSignals_<shortName> worden geïmplementeerd ([SWS_Com_00400]). Daarbij komt <shortName> overeen met de korte naam van de betreffende configuratiecontainer.
• Re-entrantiegedrag: De functie is re-entrant voor aanroepen van verschillende instanties ([SWS_Com_00400]). Voor een en dezelfde instantie is deze echter expliciet niet-re-entrant en mag daarom niet gelijktijdig worden uitgevoerd ([SWS_Com_00400]).

De callback-functie Com_CbkTxAck dient in de module Com voor de melding over het succesvol verzenden van een bericht [SWS_Com_00468]. Deze representeert meldingsklasse 2 (notification class 2) en wordt direct na de succesvolle overdracht van de I-PDU aangeroepen die het desbetreffende bericht bevat [SWS_Com_00468].

Voor de aanroepcontext en de interface-eigenschappen gelden volgens de specificatie de volgende richtlijnen [SWS_Com_00468]:

• Signatuur en parameters: De callback-functie heeft de signatuur void Com_CbkTxAck (void). Deze accepteert geen ingangs-, in-/uitgangs- of uitgangsparameters en levert geen retourwaarde op [SWS_Com_00468].
• Synchroniciteit: De aanroep is als synchroon (Synchronous) gespecificeerd [SWS_Com_00468].
• Re-entrantie: Het re-entrantiegedrag is geclassificeerd als don't care [SWS_Com_00468].
• Configuratie: De interface is als configureerbaar (configurable) gedeclareerd [SWS_Com_00468]. Interpretatie: De daadwerkelijke naam van de callback-functie wordt vermoedelijk in de configuratietool bericht- of signaalspecifiek geparametriseerd. Vraag Q-3670b7b04fd7c74c (open)

Specifieke foutcodes, foutreacties evenals meldingen aan DET of DEM zijn voor dit element in de specificatie niet gedefinieerd [SWS_Com_00468]. Ook verdere volgordevoorwaarden ten opzichte van andere aanroepen worden niet vermeld [SWS_Com_00468].

De callback-functie Com_CbkTxErr wordt synchroon aangeroepen wanneer een overdracht niet mogelijk is omdat de bijbehorende I-PDU-groep is gestopt [SWS_Com_00491]. Deze komt overeen met meldingsklasse 4 volgens de onderliggende specificaties [SWS_Com_00491].

Aanroep en semantiek

• Signatuur en parameters: De functie heeft geen invoer-, in-/uitvoer- of uitvoerparameters (void Com_CbkTxErr (void)) en levert geen retourwaarde op [SWS_Com_00491].
• Uitvoeringsgedrag: De aanroep vindt synchroon plaats („Synchronous”), terwijl voor de re-entrantie „don't care” is gespecificeerd [SWS_Com_00491].
• Beschikbaarheid: De callback-interface is configureerbaar („configurable”) [SWS_Com_00491].

Foutafhandeling en wisselwerking

De functie dient er specifiek voor om de foutsituatie van een verhinderd verzendverzoek als gevolg van een gestopte I-PDU-groep aan de aanroepende resp. bovenliggende laag te signaleren [SWS_Com_00491]. Aangezien er geen parameters worden doorgegeven, is de context van het betreffende signaal of de I-PDU vermoedelijk via de configuratie of modulespecifieke toewijzingen vastgelegd. Vraag Q-d7153324d2eb2995 (open)

Gebruik en aanroepcontext

De callback-functie Com_CbkTxTOut dient als meldingsinterface over het uitblijven van een succesvolle overdracht. Volgens [SWS_Com_00554] wordt deze direct aangeroepen nadat het mechanisme voor deadlinebewaking (deadline monitoring mechanism) een overdrachtsfout van een bericht heeft gedetecteerd. De aanroep vindt synchroon plaats en komt overeen met meldingsklasse 4. Aangezien de signatuur void Com_CbkTxTOut(void) geen overdrachts- of retourwaarden heeft, vindt de signalering naar de bovenliggende laag parameterloos plaats.

Gelijktijdigheid en configuratie

Wat betreft re-entrantie is de functie volgens [SWS_Com_00554] gespecificeerd met don't care. Vermoedelijk is het daarom aan de aangeroepen applicatiesoftware om passende maatregelen voor thread-safety te nemen als bewakingsgebeurtenissen gelijktijdig kunnen optreden. Vraag Q-793a6c18d81de85e (open) De beschikbaarheid van de callback-functie is in de communicatiemodule configureerbaar en wordt aangepast aan de respectievelijke bewakingsvereisten.

Foutafhandeling

In [SWS_Com_00554] zijn voor Com_CbkTxTOut geen afzonderlijke DET- of DEM-foutmeldingen en geen retourwaarden voor foutbevestiging gedefinieerd. Het activeren van de callback vormt zelf de foutreactie op een overschreden verzendtermijn.

De callback-functie Com_CbkRxAck dient in de AUTOSAR COM-module als configureerbare ontvangstbevestiging en representeert meldingsklasse 1 conform [17] [SWS_Com_00555]. De COM-module roept deze callback-routine direct aan nadat een ontvangen bericht succesvol in het daarvoor bestemde ontvangstberichtobject is geplaatst en opgeslagen [SWS_Com_00555].

Gebruik en aanroepcontext

• Synchroon uitvoeringsgedrag: De functie is gespecificeerd als synchroon [SWS_Com_00555]. Deze wordt direct tijdens de opslagprocedure uitgevoerd, zodat de aanroepende context van de COM-module wacht op de uitvoering van de callback.
• Parameters en retourwaarden: Volgens de signatuur void Com_CbkRxAck (void) worden er geen ingangsparameters, geen in-/uitgangsparameters en geen uitgangsparameters doorgegeven [SWS_Com_00555]. De functie levert bovendien geen retourwaarde terug aan de aanroepende module [SWS_Com_00555].
• Beschikbaarheid: Het aanroepmechanisme staat het systeem ter beschikking als configureerbare interface [SWS_Com_00555].

Gelijktijdigheid en foutafhandeling

Voor de re-entrantie is de eigenschap „don't care” vastgelegd [SWS_Com_00555]. Dit duidt er vermoedelijk op dat de COM-specificatie geen eisen stelt aan een re-entrante aanroep en dat beveiligingsmechanismen tegen gelijktijdige toegang onder de verantwoordelijkheid van de gebruiker vallen. Vraag (open) Aangezien noch retourwaarden noch specifieke foutcodes of foutmeldingen voor DET of DEM zijn gedefinieerd [SWS_Com_00555], moeten eventuele fouten bij de verwerking vermoedelijk volledig lokaal binnen de callback-functie worden afgehandeld.

Gebruik en semantiek

De callback-functie Com_CbkRxTOut dient voor de melding over het uitblijven van een verwacht bericht. Volgens [SWS_Com_00556] wordt deze direct aangeroepen zodra het deadline-monitoring-mechanisme van de module een fout bij de berichtontvangst vaststelt. Deze melding komt overeen met meldingsklasse 3 („notification class 3 of [17]”) en is beschikbaar als configureerbare interface [SWS_Com_00556].

De aanroep vindt synchroon plaats (Synchronous) zonder overdrachtsparameters en zonder retourwaarde (void Com_CbkRxTOut(void)) [SWS_Com_00556]. De functie signaleert aan de aanroepende ontvanger resp. de bovenliggende softwarelaag dus puur de time-out-gebeurtenis zelf, zonder contextgegevens direct in de aanroep te verzenden.

Gelijktijdigheid en beperkingen

Voor de re-entrantie van de functie is in de specificatie don't care vastgelegd [SWS_Com_00556]. Aangezien de aanroep direct en synchroon na de foutdetectie plaatsvindt, moet de implementatie van de callback-routine vermoedelijk zo worden ontworpen dat deze non-blocking verloopt, om de deadline-monitoring van de COM-module niet ontoelaatbaar te vertragen. Vraag Q-88055efc50f5843b (open)

De callback-functie Com_CbkInv meldt bovenliggende softwarelagen over de ontvangst van foutieve of ongeldige communicatiegegevens in de AUTOSAR COM-module [SWS_Com_00536]. Deze wordt direct na de ontvangst van een ongeldig signaal respectievelijk een ongeldige signaalgroep aangeroepen en informeert de ontvanger over de aanwezigheid van een ongeldige signaalwaarde [SWS_Com_00536].

De interface heeft de signatuur void Com_CbkInv(void), accepteert derhalve geen overdrachtsparameters en levert geen retourwaarde aan de aanroeper [SWS_Com_00536]. De aanroep vindt synchroon plaats, terwijl het re-entrantiegedrag in de specificatie is aangegeven met „don't care” [SWS_Com_00536]. Aangezien er geen parameters voor de identificatie van het betreffende signaal worden doorgegeven, dient de identifier Com_CbkInv vermoedelijk als configureerbare signatuursjabloon voor signaalspecifieke meldingen. Vraag Q-6e02e6bcf324eb93 (open)

Met betrekking tot de integratie en het systeemgedrag gelden de volgende randvoorwaarden:

• De beschikbaarstelling van de functie is configureerbaar, waardoor de melding desgewenst per signaal of signaalgroep kan worden geactiveerd [SWS_Com_00536].
• Functioneel correspondeert de functie met eis SWS_Com_00680 voor de invalidatieafhandeling van ontvangen signalen in de COM-module [SWS_Com_00536].
• Specifieke foutafhandelingsroutines, foutcodes of foutmeldingen aan ontwikkelings- of diagnosemodules zoals DET of DEM zijn voor deze interface niet aangewezen [SWS_Com_00536].

De configureerbare callback-functie Com_CbkCounterErr dient voor het signaleren van fouten bij de I-PDU-tellerbewaking conform [SWS_Com_00726]. Deze wordt direct en synchroon door de AUTOSAR COM-module aangeroepen wanneer bij een ontvangen I-PDU een tellerwaarde wordt gedetecteerd die niet overeenkomt met de verwachte tellerwaarde. Dit maakt een vroegtijdige detectie van volgordefouten bij de berichtontvangst mogelijk.

De interface heeft geen retourwaarde (void) en geeft bij de aanroep drie invoerparameters door voor foutanalyse ([SWS_Com_00726]):

• ComPduId (PduIdType): Identifier van de betreffende I-PDU waarbij de tellerfout is opgetreden.
• ExpectedCounter (uint8): De door de COM-module verwachte tellerwaarde van de I-PDU.
• ReceivedCounter (uint8): De daadwerkelijk in het ontvangen bericht aangetroffen tellerwaarde.

Wat betreft gelijktijdigheid is de re-entrantie van de functie in de specificatie gedeclareerd als "don't care" ([SWS_Com_00726]). Specifieke DET- of DEM-foutmeldingen zijn voor deze interface in [SWS_Com_00726] niet voorgeschreven. Aangezien de callback-functie als configureerbaar is gedefinieerd, zal deze vermoedelijk in een bovenliggende laag zoals de applicatie worden geïmplementeerd om applicatiespecifiek te reageren op overdrachtsfouten of pakketverlies. Interpretatie: aangezien de aanroep direct en synchroon in de context van de COM-ontvangstverwerking plaatsvindt ([SWS_Com_00726]), mag de aangeroepen routine vermoedelijk geen blokkerende operaties uitvoeren. Vraag Q-a745eb5416fc156b (open)

De callbackfunctie Com_CbkTxPrep dient als melding dat de signalen respectievelijk signaalgroepen van een toegewezen instantie van Com_MainFunctionTx nu voor verzending worden voorbereid [SWS_Com_91013]. De uitvoering van de functie vindt synchroon met de aanroepende instantie plaats [SWS_Com_91013]. Conform haar signatuur void Com_CbkTxPrep(void) accepteert zij invoerparameters noch in- en uitvoerparameters of uitvoerparameters en heeft zij geen retourwaarde [SWS_Com_91013].

De beschikbaarstelling van de interface is mogelijk via een configuratie [SWS_Com_91013]. Voor zover de configuratieparameter ComPreparationNotification is geconfigureerd, moet de betreffende functie Com_CbkTxPrep binnen de bijbehorende MainFunctionTx worden aangeroepen [SWS_Com_00886]. Daarbij moet dwingend aan een vaste temporele volgordevoorwaarde worden voldaan: de aanroep moet volledig plaatsvinden voordat de eigenlijke verwerking van de I-PDU's binnen de Tx-hoofdfunctie wordt gestart [SWS_Com_00886].

Wat betreft het concurrencygedrag en mogelijke beperkingen is Com_CbkTxPrep gespecificeerd als niet re-entrant (Non Reentrant) [SWS_Com_91013]. De aanroepcontext is vast verbonden aan het verloop van de betreffende instantie van MainFunctionTx [SWS_Com_91013]. Aangezien de callback direct vóór aanvang van de I-PDU-verwerking moet worden uitgevoerd, is de functie synchroon in de overeenkomstige zendroutine opgenomen [SWS_Com_00886].

De functie Com_RxIpduCallout is een configureerbare callout aan de ontvangerszijde die dient voor de implementatie van gebruikersspecifieke ontvangstfiltermechanismen voor I-PDU's [SWS_Com_00700]. De uitvoering verloopt synchroon en wat betreft re-entrantie is de interface gespecificeerd als don't care [SWS_Com_00700].

Aan de aanroep worden de identifier en de gegevens van de ontvangen PDU doorgegeven [SWS_Com_00700]:

• PduId: Identificator van de ontvangen I-PDU [SWS_Com_00700].
• PduInfoPtr: Pointer naar een PduInfoType-structuur die de lengte (SduLength) en een pointer naar de payload (SduDataPtr) van de ontvangen I-PDU beschikbaar stelt [SWS_Com_00700].

Met betrekking tot de gegevensbeschikbaarstelling vereist [SWS_Com_00816] dat de module AUTOSAR COM alle gegevens van de ontvangen I-PDU volledig doorzendt naar Com_RxIpduCallout, exact zoals ze door de PDU-routerlaag (PduR) beschikbaar zijn gesteld.

Via de booleaanse retourwaarde bestuurt de callout de opvolgende verwerking van de I-PDU in de COM-module [SWS_Com_00700]:

• true: De ontvangen I-PDU wordt normaal verder verwerkt [SWS_Com_00700].
• false: De I-PDU wordt niet verder verwerkt en zodoende verworpen [SWS_Com_00700].

Specifieke foutcodes, terugmeldcode-constanten of DET- en DEM-meldingen zijn voor deze callout niet voorzien in de specificatie [SWS_Com_00700].

De functie Com_TxIpduCallout dient als configureerbare callout aan zenderzijde en wordt synchroon aangeroepen om een gebruikersspecifieke voorverwerking of transmissiefiltering van een uitgaande I-PDU uit te voeren [SWS_Com_00346].

Parameters en retourwaarde

• PduId (in): Geeft de identifier van de te verzenden I-PDU door [SWS_Com_00346].
• PduInfoPtr (inout): Bevat de payloadlengte (SduLength) alsmede een pointer naar de payload (SduDataPtr) van de I-PDU [SWS_Com_00346]. Hiermee kunnen de I-PDU-gegevens vóór verzending worden geïnspecteerd of gewijzigd.
• Retourwaarde (boolean): Stuurt de verdere verwerking van de I-PDU aan [SWS_Com_00346]. Een retourwaarde van true initieert de reguliere verzending van de I-PDU, terwijl false elke verdere verwerking en daarmee de transmissie afbreekt [SWS_Com_00346].

Gelijktijdigheid en configuratie

De callout heeft de service-ID 0x29 en de re-entrantie ervan is aan de specificatiezijde gedefinieerd als „don't care” [SWS_Com_00346]. Interpretatie: Aangezien de re-entrantie onbeperkt is, zouden aanroepen afhankelijk van de initiërende zendopdracht in verschillende task-contexten kunnen plaatsvinden, waardoor gebruikersimplementaties bij gedeelde resources thread-safe moeten zijn. Vraag Q-3ce35701879bb60c (open)

Het enumeratietype Com_StatusType definieert de statuswaarde voor de AUTOSAR COM-module en wordt beschikbaar gesteld via het headerbestand Com.h [SWS_Com_00819]. Dit type dient als retourwaarde van de API-service Com_GetStatus(), waarmee aanroepers de actuele initialisatie- en bedrijfstoestand van de communicatiemodule kunnen opvragen [SWS_Com_00819].

Het gespecificeerde waardebereik van Com_StatusType onderscheidt precies twee toestanden [SWS_Com_00819]:

• COM_UNINIT: Geeft aan dat de AUTOSAR COM-module niet geïnitialiseerd of niet bruikbaar is [SWS_Com_00819]. Deze toestand heeft verplicht de numerieke waarde 0x00 (respectievelijk waarde 0) en vormt de bindende standaardwaarde direct na een reset van het systeem [SWS_Com_00819].
• COM_INIT: Signaleert dat de AUTOSAR COM-module correct is geïnitialiseerd en zodoende bedrijfsklaar en bruikbaar is [SWS_Com_00819].

Voor de aanroepende software dient de evaluatie van deze retourwaarde ter controle van de inzetbaarheid van de communicatiemodule voorafgaand aan het gebruik ervan [SWS_Com_00819]. Zolang de service Com_GetStatus() de waarde COM_UNINIT retourneert, geldt de COM-module als niet geïnitialiseerd of niet bruikbaar [SWS_Com_00819]. Pas wanneer de status de waarde COM_INIT heeft, is de module geïnitialiseerd en bedrijfsklaar [SWS_Com_00819]. Verdere foutcodes of retourwaarden zijn voor dit enumeratietype niet gespecificeerd [SWS_Com_00819].