Diagnostic Log and Trace (DLT)

De synchrone en niet-re-entrante functie Dlt_Init (service-ID 0x01, beschikbaar via het headerbestand Dlt.h) initialiseert de module Diagnostic Log and Trace (DLT) in het Classic-platform [SWS_Dlt_00239]. Deze neemt via de parameter config een pointer naar de modulespecifieke configuratiestructuur van het type Dlt_ConfigType aan en levert geen retourwaarde op [SWS_Dlt_00239].

Voor de oproepcontext en het tijdsverloop in samenhang met andere BSW-modules gelden specifieke randvoorwaarden:

• Initialisatievolgorde: De DLT-module gebruikt de NVRam Manager en moet zeer laat in de opstartfase van de regeleenheid worden geïnitialiseerd [SWS_Dlt_00239]. De oproep van de functie Dlt_Init dient dwingend pas na de volledige initialisatie van de NVRam Manager plaats te vinden [SWS_Dlt_00239].
• Persistente gegevens: Wanneer de configuratieparameter DltGeneralNvRAMSupport op TRUE is ingesteld, gebruikt de DLT-module in Dlt_Init de interface NvM_ReadBlock van de NVRAM Manager om persistente waarden voor vereiste variabelen te herstellen [SWS_Dlt_00453].
• Bufferverwerking: Zodra de module door Dlt_Init is geïnitialiseerd en de optionele timer DltGeneralStartUpDelayTimer is verstreken, worden alle tussentijds gebufferde Log and Trace-gegevens verwerkt en volgens specificatie verzonden [SWS_Dlt_00005].

Omdat de functie als niet-re-entrant is gespecificeerd, moet de aanroepende context waarborgen dat Dlt_Init tijdens de uitvoering niet parallel of onderbrekend opnieuw wordt betreden [SWS_Dlt_00239].

De synchrone en re-entrante functie Dlt_SendTraceMessage dient voor basissoftwaremodules (BSW) en softwarecomponenten (SW-C) voor de overdracht van traceparameters naar de Dlt-module [SWS_Dlt_00243].

Parameters en aanroepcontext

Bij de aanroep worden de module- resp. poort-ID via sessionId, metadata voor berichtfiltering via traceInfo en de payloadbuffer via traceData inclusief lengteopgave traceDataLength doorgegeven [SWS_Dlt_00243]. De module kan traceberichten al bufferen, zelfs als Dlt nog niet is geïnitialiseerd [SWS_Dlt_00003].

Retourwaarden en foutafhandeling

De service signaleert de status via specifieke retourwaarden [SWS_Dlt_00243]:

• E_OK: De operatie is succesvol uitgevoerd.
• DLT_E_MSG_TOO_LARGE: Het bericht overschrijdt de toegestane grootte van alle toegewezen logkanalen.
• DLT_E_NO_BUFFER: Onvoldoende buffergeheugen; het bericht kan voor ten minste één logkanaal niet worden gebufferd.
• DLT_E_UNKNOWN_SESSION_ID: De doorgegeven sessionId is onbekend bij de module.

Interactie met hookfuncties

Aangezien Dlt_SendTraceMessage als interface voor SW-C's is gespecificeerd, bestaat er voor gegenereerde hookfuncties een equivalente interne implementatie [SWS_Dlt_00285], die traceberichten in de non-verbose modus verzendt [SWS_Dlt_00277].

De synchrone en re-entrante functie Dlt_SendLogMessage (service-ID 0x03) dient voor basissoftwaremodules (BSW) en softwarecomponenten (SW-C) als gestandaardiseerde interface voor het verzenden van logberichten [SWS_Dlt_00241]. De aanroep geschiedt via het headerbestand Dlt.h en vanwege de re-entrantie is de functie ontworpen voor gelijktijdig gebruik [SWS_Dlt_00241].

Bij de aanroep van de functie zijn vier overdrachtsparameters vereist, terwijl er geen uitvoerparameters worden gebruikt [SWS_Dlt_00241]:

• sessionId: Representeert de sessie-identificatie. Voor SW-C's is deze parameter als poortgerelateerde argumentwaarde onzichtbaar, terwijl BSW-modules direct hun modulenummer doorgeven.
• logInfo: Pointer naar een constante structuur die de relevante metadata voor het filteren van het logbericht bevat.
• logData: Pointer naar de byte-array met de te loggen gegevens, die de eigenlijke nuttige lading (payload) van het bericht vormt.
• logDataLength: Numerieke lengte van de databuffer logData.

De foutafhandeling vindt direct plaats via de retourwaarde van het type Std_ReturnType, die het slagen van de bewerking of specifieke fouttoestanden aangeeft [SWS_Dlt_00241]:

• DLT_OK: Het logbericht is succesvol geaccepteerd en verwerkt.
• DLT_E_MSG_TOO_LARGE: Het bericht overschrijdt de maximaal toegestane buffergrootte voor alle toegewezen logkanalen.
• DLT_E_NO_BUFFER: Het bericht kon op geen van de toegewezen logkanalen worden gebufferd.
• DLT_E_UNKNOWN_SESSION_ID: De doorgegeven sessie-ID is ongeldig of niet bekend bij de module.

Gebruik

De synchrone functie Dlt_UnregisterContext (service-ID 0x16) wordt beschikbaar gesteld via het headerbestand Dlt.h en moet worden aangeroepen wanneer een softwaremodule wordt gestopt [SWS_Dlt_00769]. Deze dient voor het afmelden van een eerder geregistreerde context van een applicatie.

De functie verwacht drie invoerparameters [SWS_Dlt_00769]:

• sessionId: Modulenummer; komt overeen met de module-ID binnen de BSW of de poortspecifiek gedefinieerde argumentwaarde binnen een softwarecomponent (SW-C) [SWS_Dlt_00769].
• appId: De identificatie van de bovenliggende applicatie (Application ID) [SWS_Dlt_00769].
• contextId: De identificatie van de af te melden context (Context ID) [SWS_Dlt_00769].

Retourwaarden en foutafhandeling

De retourwaarde van het type Std_ReturnType verschaft informatie over het resultaat van de uitvoering [SWS_Dlt_00769]:

• E_OK: De aangevraagde bewerking is succesvol voltooid [SWS_Dlt_00769].
• DLT_E_CONTEXT_NOT_YET_REG: De context van de softwaremodule is vooraf niet geregistreerd [SWS_Dlt_00769].
• DLT_E_UNKNOWN_SESSION_ID: De doorgegeven sessie-ID is onbekend [SWS_Dlt_00769].

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als re-entrant en gedraagt zich synchroon [SWS_Dlt_00769]. Aanroepende modules moeten ervoor zorgen dat de doorgegeven sessie-ID geldig is en dat de context vóór het beëindigen daadwerkelijk geregistreerd was, om fouten bij het deregistreren te voorkomen [SWS_Dlt_00769].

Gebruik en aanroepcontext

De synchrone interface Dlt_DetForwardErrorTrace met het service-ID 0x07 dient ertoe gemelde ontwikkelingsfouten uit de Default Error Tracer (DET) door te sturen naar de Dlt-module [SWS_Dlt_00432]. De Dlt-module stelt deze dienst beschikbaar om het vereiste fan-out-vermogen van de DET voor foutmeldingen te waarborgen [SWS_Dlt_00430]. De declaratie van deze C-functie is opgenomen via het headerbestand Dlt_Det.h [SWS_Dlt_00432].

Parameters en interfacespecificatie

De functie accepteert vier verplichte invoerparameters en definieert noch retourwaarden noch uitvoerparameters [SWS_Dlt_00432]:

• moduleId: module-ID van de aanroepende softwaremodule waarin de fout optrad.
• instanceId: identificator van de op index gebaseerde module-instantie (telling begint bij 0; modules met een enkele instantie geven 0 door).
• apiId: identificator van de betreffende API-dienst (gedefinieerd in de specificatie van de aanroepende module).
• errorId: identificator van de vastgestelde ontwikkelingsfout (gedefinieerd in de specificatie van de aanroepende module).

Gelijktijdigheid en foutafhandeling

De uitvoering vindt synchroon met de aanroepende foutregistratie plaats. Als niet-re-entrante functie (Non Reentrant) vereist de interface dwingend dat aan de aanroeperszijde concurrerende uitvoeringen worden vermeden [SWS_Dlt_00432]. Specifieke foutcodes, foutterugmeldingen of afzonderlijke DET- resp. DEM-meldingen zijn voor deze service niet voorzien in de specificatie [SWS_Dlt_00432].

De synchrone functie Dlt_SetTraceStatus dient voor het instellen van de trace-status voor een bepaald tupel van Application-ID en Context-ID [SWS_Dlt_00254]. Deze is gedefinieerd via het headerbestand Dlt.h en bezit de service-ID 0x09 [SWS_Dlt_00254].

Gebruik

Voor de oproep zijn drie invoerparameters vereist [SWS_Dlt_00254]:

• appId: De ID van de softwarecomponent (type Dlt_ApplicationIDType).
• contextId: De ID van de context (type Dlt_ContextIDType).
• newTraceStatus: De nieuw in te stellen trace-status als booleaanse waarde (type boolean).

Foutafhandeling en retourwaarden

De functie geeft synchroon een status van het type Std_ReturnType terug [SWS_Dlt_00254]:

• E_OK: Er is geen fout opgetreden en de status is succesvol overgenomen.
• E_NOT_OK: De trace-status kon niet worden gewijzigd. Specifieke DET-foutmeldingen worden in de functiespecificatie niet genoemd (interpretatie: er is vermoedelijk sprake van een fout bij ongeldige identifiers of een onjuiste modulestatus). Vraag Q-77e190707462c8f1 (open)

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_Dlt_00254]. Daarom mag deze niet gelijktijdig of onderbrekend zonder geschikte synchronisatie door de aanroeper worden uitgevoerd.

Gebruik

De functie Dlt_StoreConfiguration ([SWS_Dlt_00736]) dient voor het opslaan van de actuele Dlt-configuratie in het niet-vluchtige geheugen (NVRAM). De opslag vindt intern plaats via een synchrone oproep van de interface NvM_WriteBlock() van de NVRAM Manager ([SWS_Dlt_00736]). De API wordt beschikbaar gesteld via de header Dlt.h met de service-ID 0x1a.

De functie bezit de signatuur Std_ReturnType Dlt_StoreConfiguration(void) en verwerkt noch invoer-, uitvoer- noch invoer-/uitvoerparameters ([SWS_Dlt_00736]).

Foutafhandeling en retourwaarden

Als synchrone service levert de functie onmiddellijk een statuscode van het type Std_ReturnType terug aan de aanroeper ([SWS_Dlt_00736]):

• E_OK: De configuratie is foutloos overgedragen aan het NVRAM ([SWS_Dlt_00736]).
• E_NOT_OK: Bij het opslaan van de Dlt-configuratie is een fout opgetreden ([SWS_Dlt_00736]).
• DLT_E_NOT_SUPPORTED: De service voor configuratieopslag wordt niet ondersteund door de module ([SWS_Dlt_00736]).

Gelijktijdigheid en beperkingen

Volgens [SWS_Dlt_00736] is Dlt_StoreConfiguration gespecificeerd als niet-re-entrant (Non Reentrant). De functie mag daarom niet gelijktijdig vanuit verschillende taken of contexten worden uitgevoerd, zodat aan de aanroeperszijde voor een sequentiële afhandeling moet worden gezorgd.

Gebruik

De synchrone functie Dlt_ResetToFactoryDefault wordt beschikbaar gesteld via de header Dlt.h en accepteert geen overdrachtsparameters [SWS_Dlt_00739]. Haar primaire doel is het resetten van de Dlt-runtimeconfiguratie: zij stelt het logniveau en de traceerstatus terug naar de persistent opgeslagen standaardwaarden [SWS_Dlt_00739]. Als bovendien de NVRAM-ondersteuning in de Dlt-module is geactiveerd, leidt de aanroep tot het volledig wissen van alle in de NvM opgeslagen Dlt-waarden [SWS_Dlt_00739].

Retourwaarden en foutafhandeling

Het resultaat van de bewerking wordt synchroon gesignaleerd via de retourwaarde van het type Std_ReturnType [SWS_Dlt_00739]:

• E_OK: De configuratie is succesvol gereset naar de standaardwaarden [SWS_Dlt_00739].
• E_NOT_OK: Het resetten van de configuratie is mislukt [SWS_Dlt_00739].

Specifieke DET- of DEM-foutmeldingen zijn voor deze service in de onderhavige specificatieomvang niet gedefinieerd.

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-re-entrant (Non Reentrant) (service-ID 0x06) [SWS_Dlt_00739]. Een gelijktijdige of onderbrekende aanroep vanuit verschillende taken of contexten is daarom niet toegestaan en moet door de aanroeper worden voorkomen.

De functie Dlt_RxIndication dient voor de indicatie van een ontvangen PDU vanuit een onderliggende communicatie-interfacemodule aan de DLT-module [SWS_Dlt_00272]. Deze is beschikbaar via de header Dlt.h en heeft het service-ID 0x42 [SWS_Dlt_00272].

De aanroep vindt plaats met synchrone semantiek en levert geen retourwaarde op (void) [SWS_Dlt_00272]. Aan de functie worden twee ingangsparameters doorgegeven:

• RxPduId: identificator van de ontvangen PDU (van het type PduIdType) [SWS_Dlt_00272].
• PduInfoPtr: pointer naar een structuur van het type PduInfoType. Deze bevat de lengte van de ontvangen PDU (SduLength), een pointer naar de buffer met de PDU-payloadgegevens (SduDataPtr) evenals bijbehorende metadata van de PDU [SWS_Dlt_00272].

Wat betreft gelijktijdigheid en de uitvoeringscontext is de functie re-entrant voor verschillende PDU-ID's, maar niet re-entrant voor hetzelfde PDU-ID [SWS_Dlt_00272]. De aanroepende onderliggende module mag dezelfde RxPduId bijgevolg niet gelijktijdig laten verwerken, terwijl parallelle aanroepen met verschillende PDU-ID's toegestaan zijn [SWS_Dlt_00272].

De synchrone functie Dlt_TriggerTransmit dient er conform [SWS_Dlt_00754] voor om SDU-gegevens op verzoek van een onderliggende laag naar een beschikbaar gestelde buffer te kopiëren. Deze is gedeclareerd in Dlt.h en heeft service-ID 0x41.

Bij de aanroep worden de volgende parameters doorgegeven:

• TxPduId: Identificatie van de SDU waarvan de overdracht wordt aangevraagd.
• PduInfoPtr: Pointer naar een structuur van het type PduInfoType. De aanroeper geeft via SduDataPtr de doelbuffer door en via SduLength de maximaal beschikbare buffergrootte.

Binnen de functie controleert de module conform [SWS_Dlt_00754] of de beschikbare gegevens in de doorgegeven buffergrootte passen:

• Passen de gegevens, dan kopieert de functie de payload naar SduDataPtr, werkt SduLength bij met het aantal daadwerkelijk gekopieerde bytes en retourneert E_OK.
• Is de buffer ontoereikend, dan retourneert de functie E_NOT_OK zonder PduInfoPtr te wijzigen.

Als E_NOT_OK wordt geretourneerd, zijn er geen SDU-gegevens gekopieerd. De aanroeper mag PduInfoPtr in dat geval niet verder gebruiken, omdat deze naar ongeldige gegevens kan verwijzen of een NULL-pointer kan zijn [SWS_Dlt_00754].

Wat betreft gelijktijdigheid is Dlt_TriggerTransmit re-entrant voor verschillende PDU-ID's, maar niet re-entrant voor dezelfde TxPduId [SWS_Dlt_00754].

Gebruik en aanroepcontext

De functie Dlt_TxConfirmation dient als bevestigingsinterface van de onderliggende communicatielaag (lower layer communication interface module) naar de module Diagnostic Log and Trace (DLT) toe [SWS_Dlt_00273]. Deze informeert de DLT-module synchroon of een eerder aangevraagde PDU succesvol kon worden overgedragen of dat de overdracht is mislukt [SWS_Dlt_00273]. De functie bezit de service-ID 0x40 en wordt beschikbaar gesteld via het headerbestand Dlt.h [SWS_Dlt_00273].

De interface heeft geen retourwaarde (void) en verwacht twee overdrachtsparameters [SWS_Dlt_00273]:

• TxPduId: De identificatie van de overgedragen PDU van het type PduIdType.
• result: De overdrachtsstatus van het type Std_ReturnType; hierbij signaleert E_OK de succesvolle overdracht en E_NOT_OK een mislukken van de PDU-overdracht.

Foutafhandeling en gelijktijdigheid

Een expliciete foutafhandeling met foutretourwaarden of specifieke DET- resp. DEM-meldingen is voor deze oproep niet gespecificeerd; het mislukken van een verzendproces wordt uitsluitend via de parameterwaarde result = E_NOT_OK aan de DLT-module meegedeeld [SWS_Dlt_00273].

Voor de uitvoering geldt een gedifferentieerde re-entrantievoorwaarde: Dlt_TxConfirmation is re-entrant voor verschillende PDU-ID's, maar niet re-entrant voor dezelfde PDU-ID [SWS_Dlt_00273]. Aanroepende drivers of interfaces moeten daarom waarborgen dat gelijktijdige oproepen met identieke TxPduId uitgesloten zijn, terwijl bevestigingen voor verschillende PDU's gelijktijdig mogen binnenkomen.

De functie Dlt_TpTxConfirmation dient als synchrone bevestigingsfunctie van de Dlt-module na het verzenden van een transport-I-PDU [SWS_Dlt_00756]. Deze is beschikbaar via het headerbestand Dlt.h met service-ID 0x48 [SWS_Dlt_00756].

Gebruik en semantiek

De aanroep vindt plaats nadat een I-PDU op het betreffende netwerk is overgedragen [SWS_Dlt_00756]. De functie heeft de signatuur void Dlt_TpTxConfirmation (PduIdType id, Std_ReturnType result) en levert geen retourwaarde op [SWS_Dlt_00756]:

• id (ingangsparameter, type PduIdType): Eenduidige identificatie van de overgedragen I-PDU [SWS_Dlt_00756].
• result (ingangsparameter, type Std_ReturnType): Geeft de overdrachtsstatus aan en toont of het verzenden van de I-PDU geslaagd is of mislukt [SWS_Dlt_00756].

Gelijktijdigheid en foutafhandeling

De specificatie merkt Dlt_TpTxConfirmation aan als synchroon en re-entrant (Reentrant) [SWS_Dlt_00756]. Specifieke DET- of DEM-foutcodes zijn voor deze service niet gedefinieerd; de foutafhandeling met betrekking tot het verzendproces steunt op de evaluatie van parameter result [SWS_Dlt_00756]. De aanroep zal in de systeemcontext typisch worden geïnitieerd door een onderliggende transportlaag na voltooiing van de PDU-overdracht. Vraag Q-0e5ab7c285316701 (open)

Gebruik en semantiek

De synchrone en re-entrante functie Dlt_CopyTxData dient voor het opvragen van verzendgegevens van een I-PDU-segment (N-PDU) uit de Dlt-module [SWS_Dlt_00516]. Via id wordt de te verzenden I-PDU gespecificeerd, terwijl info de doelbuffer (SduDataPtr) evenals de gewenste bytelengte (SduLength) beschikbaar stelt [SWS_Dlt_00516]. Een overdracht van SduLength = 0 (waarbij SduDataPtr als NULL_PTR mag worden doorgegeven) maakt het mogelijk om zuivere statuswijzigingen via retry over te brengen of de resterende datahoeveelheid in de zendbuffer op te vragen [SWS_Dlt_00516]. Via de uitvoerparameter availableDataPtr meldt de functie de nog beschikbare datahoeveelheid in de Tx-buffer terug, wat bijvoorbeeld TP-modules met een dynamische nuttige-datalengte (zoals FrIsoTp) in staat stelt volgende segmenten te dimensioneren [SWS_Dlt_00516].

Bevestiging en foutoplossing

Via de pointer retry wordt de bevestiging of herhaalde overdracht gestuurd [SWS_Dlt_00516]:

• Is retry een NULL_PTR, dan mogen de gekopieerde gegevens direct na het kopieerproces uit de buffer worden verworpen [SWS_Dlt_00516].
• Geeft TpDataState de waarde TP_CONFPENDING aan, dan moeten eerder gekopieerde gegevens in de buffer blijven voor een eventuele foutoplossing [SWS_Dlt_00516].
• Bij TP_DATACONF gelden alle vóór de aanroep overgedragen gegevens als bevestigd en kunnen ze worden vrijgegeven [SWS_Dlt_00516].
• Bij TP_DATARETRY hervat de module het kopiëren opnieuw vanaf de in TxTpDataCnt doorgegeven byte-offset [SWS_Dlt_00516].

Retourwaarden en randvoorwaarden

Het resultaat van het verzoek wordt gerapporteerd als BufReq_ReturnType [SWS_Dlt_00516]:

• BUFREQ_OK: gegevens zijn volledig zoals vereist naar de doelbuffer gekopieerd [SWS_Dlt_00516].
• BUFREQ_E_BUSY: de vereiste datahoeveelheid is niet beschikbaar; er zijn geen gegevens gekopieerd, een latere nieuwe poging is toegestaan [SWS_Dlt_00516].
• BUFREQ_E_NOT_OK: verzoek mislukt; er zijn geen gegevens gekopieerd [SWS_Dlt_00516].

De interface is beschikbaar via Dlt.h en ontworpen als re-entrant [SWS_Dlt_00516]. De aanroepcontext bevindt zich typisch vermoedelijk in een onderliggende transportprotocolmodule tijdens de gesegmenteerde overdracht. Vraag Q-a81c439e73e0acc0 (open)

De synchrone en re-entrante functie Dlt_StartReception wordt aangeroepen aan het begin van de ontvangst van een N-SDU, die als single frame (SF) of gefragmenteerd over meerdere N-PDU's kan worden ontvangen [SWS_Dlt_91006]. Deze dient ertoe de transportverbinding in de Dlt-module te initiëren en de beschikbare ontvangstbuffer gereed te stellen [SWS_Dlt_91006].

Via parameter id wordt de ontvangen I-PDU geïdentificeerd, terwijl info payload en metadata van het eerste frame overdraagt of op NULL_PTR is ingesteld indien er noch gegevens noch metadata aanwezig zijn [SWS_Dlt_91006]. Via TpSduLength wordt de totale lengte van de N-SDU doorgegeven; als de functie met een lengte van 0 wordt aangeroepen, retourneert deze via bufferSizePtr de momenteel maximaal beschikbare buffergrootte [SWS_Dlt_91006]. Het transportprotocol gebruikt de waarde uit bufferSizePtr voor het berekenen van de Block Size (BS) [SWS_Dlt_91006].

Wordt de verbinding geaccepteerd, dan retourneert de functie BUFREQ_OK; is er onvoldoende buffer beschikbaar voor de aangevraagde grootte, dan signaleert bufferSizePtr een buffergrootte van 0 voor de voortzetting van de ontvangst [SWS_Dlt_91006]. Bij afwijzing van de verbinding breekt BUFREQ_E_NOT_OK de ontvangst af, en bij onvoldoende totaal geheugen wordt BUFREQ_E_OVFL gemeld; in beide foutgevallen blijft bufferSizePtr ongewijzigd [SWS_Dlt_91006].

De functie Dlt_TpRxIndication dient als synchrone ontvangstindicatie nadat een I-PDU via de TP-API is ontvangen [SWS_Dlt_91007]. Deze is gedeclareerd in het headerbestand Dlt.h en heeft service-ID 0x45 [SWS_Dlt_91007].

Gebruik en parameters

De overdracht aan de DLT-module vindt plaats via twee invoerparameters, waarbij de functie geen retourwaarde oplevert [SWS_Dlt_91007]:

• id (type PduIdType): Duidt de identificatie van de ontvangen I-PDU aan [SWS_Dlt_91007].
• result (type Std_ReturnType): Geeft het resultaat van de ontvangst aan en toont of de overdracht succesvol was [SWS_Dlt_91007].

Gelijktijdigheid en beperkingen

De interface is gedefinieerd als synchroon en re-entrant [SWS_Dlt_91007]. Er bestaan noch in-/uitgangs- noch zuivere uitgangsparameters [SWS_Dlt_91007].

Foutafhandeling en wisselwerking

Het resultaat van het transport wordt uitsluitend via het argument result aan de DLT-module gesignaleerd; specifieke foutcodes, DET- of DEM-meldingen zijn niet gespecificeerd [SWS_Dlt_91007].

Interpretatie: De aanroep zal vermoedelijk plaatsvinden door een onderliggende transportprotocolcomponent zodra een DLT-bericht volledig is binnengekomen of de overdracht wordt afgebroken [SWS_Dlt_91007]. Vraag Q-7d9c8564a2404acf (open)

Gebruik en semantiek

De synchrone functie Dlt_CopyRxData wordt aangeroepen om ontvangen gegevens van een I-PDU-segment (N-PDU) aan de bovenste laag over te dragen [SWS_Dlt_91008]. Elke aanroep stelt het telkens volgende deel van de I-PDU-gegevens beschikbaar, waarbij de resterende buffergrootte naar de via bufferSizePtr gereferentieerde geheugenlocatie wordt geschreven [SWS_Dlt_91008]. De declaratie is beschikbaar via de header Dlt.h [SWS_Dlt_91008].

Parameters en bufferopvraging

Via invoerparameter id wordt de ontvangen I-PDU geïdentificeerd [SWS_Dlt_91008]. Pointer info stelt via SduDataPtr de bronbuffer en via SduLength het aantal te kopiëren bytes beschikbaar [SWS_Dlt_91008]. Wordt SduLength met de waarde 0 doorgegeven, dan dient de aanroep puur voor het opvragen van de momenteel in de bovenliggende module beschikbare buffer; in dat geval mag SduDataPtr een NULL_PTR zijn [SWS_Dlt_91008]. Uitvoerparameter bufferSizePtr retourneert de na het kopieerproces nog vrije ontvangstbuffergrootte [SWS_Dlt_91008].

Concurrency en retourwaarden

De functie is ontworpen als re-entrant en heeft service-ID 0x44 [SWS_Dlt_91008]. De retourwaarde van het type BufReq_ReturnType signaleert het resultaat van het kopieerproces: Bij succesvolle overname van gegevens retourneert de service BUFREQ_OK, terwijl in geval van een fout BUFREQ_E_NOT_OK wordt gemeld [SWS_Dlt_91008].

Gebruik en aanroepcontext

De functie Dlt_TxFunction is conform de specificatie [SWS_Dlt_91005] gedefinieerd als service met service-ID 0x80 en beschikbaar via de header SchM_Dlt.h. Haar interfacesignatuur luidt void Dlt_TxFunction (void) [SWS_Dlt_91005]. De declaratie in SchM_Dlt.h duidt er als interpretatie op dat de aanroep door de BSW-scheduler in de context van een cyclische task plaatsvindt en niet rechtstreeks door toepassingssoftwarecomponenten zou moeten worden aangeroepen.

Parameters en retourwaarden

Conform [SWS_Dlt_91005] accepteert de functie geen overdrachtsparameters en levert zij geen retourwaarde op (void). Gelet op de naam is de functie vermoedelijk verantwoordelijk voor de cyclische verwerking en overdracht van openstaande te verzenden Dlt-berichten. Vraag (open) Omdat er geen retourwaarden zijn gespecificeerd, vindt foutafhandeling vermoedelijk puur module- dan wel statusintern plaats.

Beperkingen

Aangezien de payload geen gegevens over re-entrantie of speciale ontwikkelingsfouten bevat, moeten aanroepintervallen en tasktoewijzingen via de configuratie van de schedule manager worden afgestemd. Verdere foutcodes of DET-invoer zijn in [SWS_Dlt_91005] niet vermeld.