Figure 13: UML sequence diagram NvM_SetDataIndex

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (rahmenlose Darstellung ohne sd-Kopf).
• Technischer Zweck & Einordnung: Spezifikation des synchronen Interaktionsmusters zur Selektion eines Datensatz-Elements innerhalb eines Dataset-NVRAM-Blocks (NVM_BLOCK_DATASET). Im AUTOSAR-Gesamtsystem (Classic Platform, Memory Stack) gehört der NVRAM Manager (NvM) zu den System Services. Das Diagramm modelliert den Steuerungsfluss beim Umschalten des aktiven Datenindexes für nachfolgende Lese-, Schreib- oder Wiederherstellungsoperationen.

2. Komponenten, Entitäten & Schnittstellen

• Beteiligte Instanzen (Lifelines):
  • NvM User: Aufrufende Instanz (Software-Komponente der Applikationsschicht bzw. BSW-Modul wie Dem oder Dcm).
  • «module» NvM: BSW-Modul NVRAM Manager mit Stereotyp «module» und Dekompositionssymbol.
• Schnittstellen & Parameter:
  • Synchroner Aufruf: NvM_SetDataIndex(Std_ReturnType, NvM_BlockIdType, uint8)
    • Std_ReturnType: Vorangestellter Rückgabetyp in der UML-Aufrufsignatur.
    • NvM_BlockIdType: Identifikator des Ziel-NVRAM-Blocks (BlockId).
    • uint8: Zu selektierender Datensatz-Index (DataIndex).
  • Rückgabewert: Synchrone Rückkehr NvM_SetDataIndex() (Typ Std_ReturnType).

3. Dynamisches Verhalten & Sequenzablauf

1. Trigger: Die SW Component ruft synchron NvM_SetDataIndex(BlockId, DataIndex) auf.
2. Interne Verarbeitung (NvM):
   • Validierung: Prüfung auf Modulinitialisierung (NVM_UNINIT), Gültigkeit der BlockId sowie Zulässigkeit des Block-Management-Typs (muss NVM_BLOCK_DATASET sein).
   • Bereichsprüfung: Validierung von DataIndex gegen die konfigurierte Anzahl an Datensätzen (NvMDatasetBlockCount / ROM-Instanzen).
   • Zustandsprüfung: Prüfung, ob der angeforderte Block aktuell in einer laufenden asynchronen Operation gebunden ist (Busy-Flag im administrativen Block).
   • Aktualisierung: Bei erfolgreicher Validierung wird der Index direkt im internen administrativen Block (NvM_AdminBlockTable) im RAM hinterlegt.
3. Abschluss: Unmittelbare synchrone Rückkehr (Return) zur aufrufenden Komponente ohne Einreihung in die NvM-Job-Queue. Es finden keine Callbacks, keine MemIf- und keine Fls/Fee-Treiberinteraktionen statt.

4. Normative Relevanz & Entwickler-Hinweise

• Synchroner API-Vertrag: NvM_SetDataIndex ist eine rein synchrone Verwaltungsfunktion. Im Gegensatz zu NvM_ReadBlock oder NvM_WriteBlock triggert sie keinen Hintergrundjob und liefert kein asynchrones Callback-Signal.
• Blocktyp-Restriktion: Die Funktion ist normativ ausschließlich für Blöcke des Typs NVM_BLOCK_DATASET zulässig. Für Blöcke vom Typ NVM_BLOCK_NATIVE oder NVM_BLOCK_REDUNDANT ist der Aufruf unzulässig und führt bei aktivem Det (NVM_DEV_ERROR_DETECT == STD_ON) zum Entwicklungsfehler NVM_E_PARAM_BLOCK_TYPE mit Rückgabe E_NOT_OK.
• Nebenläufigkeit & Queueing: Ein Aufruf während einer bereits laufenden asynchronen Bearbeitung desselben Blocks führt zur Ablehnung (E_NOT_OK) und Det-Fehler NVM_E_BLOCK_PENDING, um Inkonsistenzen zwischen selektiertem Datensatz und adressierten Speicherbereichen zu verhindern.
• Konfigurationsabhängigkeit: Die Obergrenze von DataIndex ist streng gekoppelt an die Summe aus NvMDatasetBlockCount und NvMNvramBlockIdentifier/ROM-Blöcken im BSW-Parameterbaum.