SNIP_CLASSIC_OS_SECTION_8_4_31_ModifyPeripheral8_ModifyPeripheral16_ModifyPeripheral32
Wortlaut
8.4.31 ModifyPeripheral8, ModifyPeripheral16, ModifyPeripheral32
[SWS_Os_91016] Definition of API function ModifyPeripheral8
Upstream requirements: SRS_Os_11005
⌈
Service Name
ModifyPeripheral8
Syntax
StatusType ModifyPeripheral8 (
AreaIdType Area,
uint8* Address,
uint8 Clearmask,
uint8 Setmask
)
Service ID [hex]
0x2e
Sync/Async
Synchronous
Reentrancy
Reentrant
Area
hardware peripheral area reference
Address
memory address
Clearmask
memory address will be modified by an bit-AND
Parameters (in)
Setmask
memory address will be modified by an bit-OR
Parameters (inout)
None
Parameters (out)
None
Return value
StatusType
E_OK No error
E_OS_ID Area id is out of range (EXTENDED status)
E_OS_VALUE Address does not belong to given Area
(EXTENDED status)
E_OS_CALLEVEL Wrong call context of the API function
(EXTENDED status)
E_OS_ACCESS The calling task or ISR is not allowed to access
the given
Description
This service modifies a given memory location (<memory address>) with the formula:
*<Address> = ((*<Address> & <clearmask>) | <setmask>)
Available via
Os.h
⌋
[SWS_Os_91018] Definition of API function ModifyPeripheral16
Upstream requirements: SRS_Os_11005
⌈
Service Name
ModifyPeripheral16
Syntax
StatusType ModifyPeripheral16 (
AreaIdType Area,
uint16* Address,
uint16 Clearmask,
uint16 Setmask
)
Service ID [hex]
0x35
Sync/Async
Synchronous
Reentrancy
Reentrant
Area
hardware peripheral area reference
Parameters (in)
Address
memory address
▽
△
Clearmask
memory address will be modified by an bit-AND
Setmask
memory address will be modified by an bit-OR
Parameters (inout)
None
Parameters (out)
None
Return value
StatusType
E_OK No error
E_OS_ID Area id is out of range (EXTENDED status)
E_OS_VALUE Address does not belong to given Area
(EXTENDED status)
E_OS_CALLEVEL Wrong call context of the API function
(EXTENDED status)
E_OS_ACCESS The calling task or ISR is not allowed to access
the given
Description
This service modifies a given memory location (<memory address>) with the formula:
*<Address> = ((*<Address> & <clearmask>) | <setmask>)
Available via
Os.h
⌋
[SWS_Os_91017] Definition of API function ModifyPeripheral32
Upstream requirements: SRS_Os_11005
⌈
Service Name
ModifyPeripheral32
Syntax
StatusType ModifyPeripheral32 (
AreaIdType Area,
uint32* Address,
uint32 Clearmask,
uint32 Setmask
)
Service ID [hex]
0x2f
Sync/Async
Synchronous
Reentrancy
Reentrant
Area
hardware peripheral area reference
Address
memory address
Clearmask
memory address will be modified by an bit-AND
Parameters (in)
Setmask
memory address will be modified by an bit-OR
Parameters (inout)
None
Parameters (out)
None
Return value
StatusType
E_OK No error
E_OS_ID Area id is out of range (EXTENDED status)
E_OS_VALUE Address does not belong to given Area
(EXTENDED status)
E_OS_CALLEVEL Wrong call context of the API function
(EXTENDED status)
E_OS_ACCESS The calling task or ISR is not allowed to access
the given
Description
This service modifies a given memory location (<memory address>) with the formula:
*<Address> = ((*<Address> & <clearmask>) | <setmask>)
Available via
Os.h
⌋
Versionen & Provenienz · Zugeordnete Anforderungen
Diese Angaben zeigt der Versions-Explorer.
Begründung & Zuweisungs-Evidenz
Explicit mention of SWS_Os_91018 in the text of document AUTOSAR_CP_SWS_OS.pdf.
Dokumenten-Herkunft & Rückverfolgbarkeit
| Spezifikations-Dokument | SWS_OS.pdf |
|---|---|
| Dokumentseite | Seite 209 |
| Ziel-Modul | os (classic) |
| Ziel-Anforderung | SWS_Os_91018 |
| Semantische Rolle | constitutive |
| Automatisierungs-Konfidenz | 0.98 |