Figure 11: UML sequence diagram NvM_SetDataIndex

1. Diagrammtyp & Architektur-Kontext

• Klassifikation: UML-Sequenzdiagramm (sd NvM_SetDataIndex).
• 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):
  • SW Component: Software-Komponente der Applikationsschicht (ASW) bzw. BSW-Komponente (z. B. Diag / Dem). Interagiert standardmäßig über den RTE-Port NvM_Service (ClientServerInterface NvM_Service mit Operation SetDataIndex) oder per direktem C-API-Aufruf.
  • NvM::NvM: BSW-Modul NVRAM Manager (Modulpaket NvM), dargestellt mit Dekompositionssymbol (Sub-Interaction / interne Realisierung).
• Schnittstellen & Parameter:
  • Synchroner Aufruf: NvM_SetDataIndex(BlockId, DataIndex)
    • BlockId: Identifikator des NVRAM-Blocks (NvM_BlockIdType).
    • DataIndex: Zu selektierender Index des Datensatzes (uint8, Wertebereich 0 .. (NvMDatasetBlockCount - 1) bzw. NV/ROM-Datensätze).
  • Rückgabewert: Impliziter synchroner Return (Std_ReturnType: E_OK / E_NOT_OK).

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.