BFx Library (Bfx)

This function shall set the logical status of input data as '1' at the requested bit position.

This function shall clear the logical status of the input data to '0' at the requested bit position.

This function shall return the logical status of the input data for the requested bit position.

This function shall set the input data as '1' or '0' as per 'Status' value starting from 'BitStartPn' for the length 'BitLn'.

This function shall return the Bits of the input data starting from 'BitStartPn' for the length of 'Bit Ln'.

This function shall set the data to logical status '1' as per the corresponding Mask bits when set to value 1 and remaining bits will retain their original values.

This function shall clear the logical status to '0' for the input data for all the bit positions as per the mask.

This function shall return TRUE, if all bits defined in Mask value are set in the input Data value. In all other cases this function shall return FALSE.

This function makes a test on the input data and if at least one bit is set as per the mask, then the function shall return TRUE, otherwise it shall return FALSE.

This function tests the number of bits set to 1. If this number is even, it shall return TRUE, otherwise it returns FALSE.

This function toggles all the bits of data (1's Complement Data).

This function toggles the bits of data when the corresponding bit of the mask is enabled and set to 1.

This function shall shift data to the right by ShiftCnt. The most significant bit (left-most bit) is replaced by a '0' bit and the least significant bit (right-most bit) is discarded for every single bit shift cycle.

This function shall shift data to the left by ShiftCnt. The least significant bit (right-most bit) is replaced by a '0' bit and the most significant bit (left-most bit) is discarded for every single bit shift cycle.

This function shall rotate data to the right by ShiftCnt. The least significant bit is rotated to the most significant bit location for every single bit shift cycle.

This function shall rotate data to the left by ShiftCnt. The most significant bit is rotated to the least significant bit location for every single bit shift cycle.

This function shall copy a bit from source data from bit position to destination data at bit position.

This function shall put bits as mentioned in Pattern to the input Data from the specified bit position.

This function shall put all bits defined in Pattern and for which the corresponding Mask bit is set to 1 in the input Data.

This function shall update the bit specified by BitPn of input data as '1' or '0' as per 'Status' value.

Returns the version information of this library.

Arithmetic shift with saturation

Count the number of consecutive ones in Data starting with the most significant bit and return the result.

Count the number of consecutive bits which have the same value as most significant bit in Data, starting with bit at position msb minus one. Put the result in Data. It is the number of leading sign bits minus one, giving the number of redundant sign bits in Data.

Count the number of consecutive zeros in Data starting with the most significant bit and return the result.

Expected functionality: *Data = *Data | (0x01 << BitPn) For Example: Data = 10001010b Bfx_SetBit_u8u8(&Data, 2) The Data will be updated to 10001110b

List of implemented functions Function ID[hex] Function prototype Maximum value of BitPn 0x001 void Bfx_SetBit_u8u8(uint8*, uint8) 7 0x002 void Bfx_SetBit_u16u8(uint16*, uint8) 15 0x003 void Bfx_SetBit_u32u8(uint32*, uint8) 31 0x004 void Bfx_SetBit_u64u8(uint64*, uint8) 63

Expected functionality: *Data = (*Data & ~(0x01 << BitPn)) For Example: Data = 10001010b Bfx_ClrBit_u8u8(&Data, 1) The Data will be updated to 10001000b

List of implemented functions Function ID[hex] Function prototype Maximum value of BitPn 0x006 void Bfx_ClrBit_u8u8(uint8*, uint8) 7 0x007 void Bfx_ClrBit_u16u8(uint16*, uint8) 15 0x008 void Bfx_ClrBit_u32u8(uint32*, uint8) 31 0x009 void Bfx_ClrBit_u64u8(uint64*, uint8) 63

Result = TRUE, ((Data & (0x01 << BitPn)) != 0) Result = FALSE, else For Example: Bfx_GetBit_u8u8(10001010b, 1) returns TRUE

List of implemented functions Function ID[hex] Function prototype maximum value of BitPn 0x00A boolean Bfx_GetBit_u8u8_ u8(uint8,uint8) 7 0x00B boolean Bfx_GetBit_u16u8_ u8(uint16,uint8) 15 0x00C boolean Bfx_GetBit_u32u8_ u8(uint32,uint8) 31 0x00D boolean Bfx_GetBit_u64u8_ u8(uint64,uint8) 63

15 14 13 12 11 10 9 - 2 1 0 1 1 1 0 1 0 0 0 0 0 0 <Bit Start Pn> < BitLn >

List of implemented functions: Function ID[hex] Function prototype Maximum value of Bit Ln Maximum value of Bit StartPn Maximum value for BitStartPn + BitLn 0x020 void Bfx_SetBits_ u8u8u8u8(uint8*, uint8, uint8, uint8) 8 7 8 0x021 void Bfx_SetBits_ u16u8u8u8(uint16*, uint8, uint8, uint8) 16 15 16 0x022 void Bfx_SetBits_ u32u8u8u8(uint32*, uint8, uint8, uint8) 32 31 32 0x023 void Bfx_SetBits_ u64u8u8u8(uint64*, uint8, uint8, uint8) 64 63 64

15 14 13 12 11 10 9 - 2 1 0 1 1 1 0 1 0 0 0 1 1 1 BitStart Pn < BitLn >

List of implemented functions: Function ID[hex] Function prototype Maximum value of Bit Ln Maximum value of Bit StartPn Maximum value for BitStartPn + BitLn 0x026 uint8 Bfx_GetBits_ u8u8u8_ u8(uint8,uint8,uint8) 8 7 8 0x027 uint16 Bfx_GetBits_ u16u8u8_ u16(uint16,uint8,uint8) 16 15 16 0x028 uint32 Bfx_GetBits_ u32u8u8_ u32(uint32,uint8,uint8) 32 31 32 0x029 uint64 Bfx_GetBits_ u64u8u8_ u64(uint64,uint8,uint8) 64 63 64

Expected functionality: *Data = *Data | Mask

List of implemented functions: Function ID[hex] Function prototype 0X02A void Bfx_SetBitMask_u8u8(uint8*, uint8) 0X02B void Bfx_SetBitMask_u16u16(uint16*, uint16) 0X02C void Bfx_SetBitMask_u32u32(uint32*, uint32) 0x02D void Bfx_SetBitMask_u64u64(uint64*, uint64)

This function shall clear the data to logical status '0' as per the corresponding mask bits value when set to 1. The remaining bits shall retain their original values. Expected functionality: *Data = *Data & ~Mask

List of implemented functions: Function ID[hex] Function prototype 0x030 void Bfx_ClrBitMask_u8u8(uint8*, uint8) 0x031 void Bfx_ClrBitMask_u16u16(uint16*, uint16) 0x032 void Bfx_ClrBitMask_u32u32(uint32*, uint32) 0x033 void Bfx_ClrBitMask_u64u64(uint64*, uint64)

Result = TRUE, ((Data & Mask) == Mask) Result = FALSE, all other case

List of implemented functions: Function ID[hex] Function prototype 0x036 boolean Bfx_TstBitMask_u8u8_u8(uint8,uint8) 0x037 boolean Bfx_TstBitMask_u16u16_u8(uint16,uint16) 0x038 boolean Bfx_TstBitMask_u32u32_u8(uint32,uint32) 0x039 boolean Bfx_TstBitMask_u64u64_u8(uint64,uint64)

List of implemented functions: Function ID[hex] Function prototype 0x03A boolean Bfx_TstBitLnMask_u8u8_u8(uint8,uint8) 0x03B boolean Bfx_TstBitLnMask_u16u16_u8(uint16,uint16) 0x03C boolean Bfx_TstBitLnMask_u32u32_u8(uint32,uint32) 0x03D boolean Bfx_TstBitLnMask_u64u64_u8(uint64,uint64)

List of implemented functions: Function ID[hex] Function prototype 0x040 boolean Bfx_TstParityEven_u8_u8(uint8) 0x041 boolean Bfx_TstParityEven_u16_u8(uint16) 0x042 boolean Bfx_TstParityEven_u32_u8(uint32) 0x043 boolean Bfx_TstParityEven_u64_u8(uint64)

List of implemented functions: Function ID[hex] Function prototype 0x046 void Bfx_ToggleBits_u8(uint8*) 0x047 void Bfx_ToggleBits_u16(uint16*) 0x048 void Bfx_ToggleBits_u32(uint32*) 0x049 void Bfx_ToggleBits_u64(uint64*)

List of implemented functions: Function ID[hex] Function prototype 0x04A void Bfx_ToggleBitMask_u8u8(uint8*, uint8) 0x04B void Bfx_ToggleBitMask_u16u16(uint16*, uint16) 0x04C void Bfx_ToggleBitMask_u32u32(uint32*, uint32) 0x04D void Bfx_ToggleBitMask_u64u64(uint64*, uint64)

List of implemented functions: Function ID[hex] Function prototype Maximum value of ShiftCnt 0X050 void Bfx_ShiftBitRt_u8u8(uint8*, uint8) 7 0X051 void Bfx_ShiftBitRt_u16u8(uint16*, uint8) 15 0X052 void Bfx_ShiftBitRt_u32u8(uint32*, uint8) 31 0x053 void Bfx_ShiftBitRt_u64u8(uint64*, uint8) 63

List of implemented functions: Function ID[hex] Function prototype Maximum value of ShiftCnt 0X056 void Bfx_ShiftBitLt_u8u8(uint8*, uint8) 7 0X057 void Bfx_ShiftBitLt_u16u8(uint16*, uint8) 15 0X058 void Bfx_ShiftBitLt_u32u8(uint32*, uint8) 31 0x059 void Bfx_ShiftBitLt_u64u8(uint64*, uint8) 63

List of implemented functions: Function ID[hex] Function prototype Maximum value of ShiftCnt 0X05A void Bfx_RotBitRt_u8u8(uint8*, uint8) 7 0X05B void Bfx_RotBitRt_u16u8(uint16*, uint8) 15 0X05C void Bfx_RotBitRt_u32u8(uint32*, uint8) 31 0x05D void Bfx_RotBitRt_u64u8(uint64*, uint8) 63

List of implemented functions: Function ID[hex] Function prototype Maximum value of ShiftCnt 0X060 void Bfx_RotBitLt_u8u8(uint8*, uint8) 7 0X061 void Bfx_RotBitLt_u16u8(uint16*, uint8) 15 0X062 void Bfx_RotBitLt_u32u8(uint32*, uint8) 31 0x063 void Bfx_RotBitLt_u64u8(uint64*, uint8) 63

List of implemented functions: Function ID[hex] Function prototype Maximum value for SourcePosition and DestinationPosition 0X066 void Bfx_CopyBit_u8u8u8u8(uint8*, uint8, uint8, uint8) 7 0X067 void Bfx_CopyBit_u16u8u16u8(uint16*, uint8, uint16, uint8) 15 0X068 void Bfx_CopyBit_u32u8u32u8(uint32*, uint8, uint32, uint8) 31 0x069 void Bfx_CopyBit_u64u8u64u8(uint64*, uint8, uint64, uint8) 63

List of implemented functions: Function ID[hex] Function prototype Maximum value of Bit Ln Maximum value of Bit StartPn Maximum value for BitStartPn + BitLn 0x070 void Bfx_PutBits_ u8u8u8u8(uint8*, uint8, uint8, uint8) 8 7 8 0x071 void Bfx_PutBits_ u16u8u8u16(uint16*, uint8, uint8, uint16) 16 15 16 0x072 void Bfx_PutBits_ u32u8u8u32(uint32*, uint8, uint8, uint32) 32 31 32 0x073 void Bfx_PutBits_ u64u8u8u64(uint64*, uint8, uint8, uint64) 64 63 64

List of implemented functions: Function ID[hex] Function prototype 0x080 void Bfx_PutBitsMask_u8u8u8(uint8*, uint8, uint8) 0x081 void Bfx_PutBitsMask_u16u16u16(uint16*, uint16, uint16) 0x082 void Bfx_PutBitsMask_u32u32u32(uint32*, uint32, uint32) 0x083 void Bfx_PutBitsMask_u64u64u64(uint64*, uint64, uint64)

List of implemented functions: Function ID[hex] Function prototype Maximum value of BitPn 0x085 void Bfx_PutBit_u8u8u8(uint8*, uint8, boolean) 7 0x086 void Bfx_PutBit_u16u8u8(uint16*, uint8, boolean) 15 0x087 void Bfx_PutBit_u32u8u8(uint32*, uint8, boolean) 31 0x088 void Bfx_PutBit_u64u8u8(uint64*, uint8, boolean) 63

The standardized common published parameters as required b y SRS_BSW_00402 in the General Requirements on Basic Software Modules [3] shall be published within the header file of this module and need to be provided in the BSW Module Description. The according module a b breviation can be found in the List of Basic Software Modules [1] .

If the shift count is greater than or equal to zero, then shift the value in Data by the amount specified by shift count to left. For signed data an arithmetic shift is performed. The vacated bits are filled with zeros and the result is saturated if its sign bit differs from the sign bits that are shifted out. For unsigned data a logical shift is performed. In this case the result is saturated, if the leading one bit is shifted out. If the shift count is less than zero, right-shift the value in Data by the absolute value of the shift count. The vacated bits are filled with the sign-bit (the most significant bit) and bits shifted out are discarded. Note that a shift right by the word width leaves all zeros or all ones in the result, de- pending on the sign-bit. Example of 32 bit signed integer: The range for shift count is -32 to +31, allowing a shift left up to 31 bit positions and a shift right up to 32 bit positions (a shift right by 32 bits leaves all zeros or all ones in the result, depending on the sign bit).

List of Implemented Functions: Function ID[hex] Function prototype Max Shift Left Max Shift Right 0x0F1 Bfx_ShiftBitSat_s8s8_s8 8 8 0X0F2 Bfx_ShiftBitSat_u8s8_u8 8 8 0X0F3 Bfx_ShiftBitSat_s16s8_s16 16 16 0X0F4 Bfx_ShiftBitSat_u16s8_u16 16 16 Function ID[hex] Function prototype Max Shift Left Max Shift Right 0X0F5 Bfx_ShiftBitSat_s32s8_s32 31 32 0X0F6 Bfx_ShiftBitSat_u32s8_u32 31 32 0X0F7 Bfx_ShiftBitSat_s64s8_s64 63 64 0X0F8 Bfx_ShiftBitSat_u64s8_u64 63 64

List of implemented functions: Function ID[hex] Function prototype Maximum return value 0xF0 uint8 Bfx_CountLeadingOnes_u8 (uint8) 8 0xF1 uint8 Bfx_CountLeadingOnes_u16 (uint16) 16 0xF2 uint8 Bfx_CountLeadingOnes_u32 (uint32) 32 0xF3 uint8 Bfx_CountLeadingOnes_u64 (uint64) 64

List of implemented functions: Function ID[hex] Function prototype Maximum return value 0xF4 uint8 Bfx_CountLeadingSigns_s8 (sint8) 8 0xF5 uint8 Bfx_CountLeadingSigns_s16 (sint16) 16 0xF6 uint8 Bfx_CountLeadingSigns_s32 (sint32) 32 0xF7 uint8 Bfx_CountLeadingSigns_s64 (sint64) 64

List of implemented functions: Function ID[hex] Function prototype Maximum return value 0xF8 uint8 Bfx_CountLeadingZeros_u8 (uint8) 8 0xF9 uint8 Bfx_CountLeadingZeros_u16 (uint16) 16 0xFA uint8 Bfx_CountLeadingZeros_u32 (uint32) 32 0xFB uint8 Bfx_CountLeadingZeros_u64 (uint64) 64

Bfx library shall not require initialization phase. A library function may be called at the very first step of ECU initialization, e.g. even by the OS or EcuM, thus the library shall be ready.

Bfx library shall not require a shutdown operation phase.

Bfx API can be directly called from BSW modules or SWC. No port definition is required. It is a pure function call.

Using a library should be documented. if a BSW module or a SWC uses a Library, the developer should add an Implementation-DependencyOnArtifact in the BSW/SWC template. minVersion and maxVersion parameters correspond to the supplier version. In case of AUTOSAR library, these parameters may be left empty because a SWC or BSW module may rely on library behaviour, not on a supplier implementation. However, the SWC or BSW modules shall be compatible with the AUTOSAR platform where they are integrated.

The Bfx library shall be implemented in a way that the code can be shared among callers in different memory partitions.

Usage of macros must be avoided in the context of Library. The library function must be declared as function or as inline function and Macro #define should not be used.

A library function shall not call any BSW module functions, e.g. the DET. A library function can call any other library functions since all library functions are re-entrant but not BSW module functions, as they may not be re-entrant

The library, written in C programming language, should confirm to the MISRA C Standard. Please refer to SWS_BSW_00115 for more details.

All AUTOSAR library Modules should use the AUTOSAR data types (Integers, Boolean) instead of native C data types, unless this library is clearly identified to be compliant only with a platform.

All AUTOSAR library Modules should avoid direct use of compiler and platform specific keyword, unless this library clearly identified to be compliant only with a platform.

All Bit Library modules shall avoid handling user faults and values outside specified range.

Error detection: Function should check at runtime (both in pr o- duction and in development code) the value of input parameters, e specially cases where erroneous value can bring to fatal error or unpredictable result, if they have the values allowed by the function specification. All the error cases shall be listed in SWS and the function should return a spec i fied value (in SWS) that is not configurable. This value is dependant of the function and the error case so it is determined case by case. If values passed to the library routines are not in valid range, out of boundary cond i- tion and out of the function specification, then such e rror are not detected in the l i- brary routines

A library function can only call library functions: The functions shall not call the DET in case of error.

The Bfx module shall provide the following files: • C files, Bfx_<name>.c used to implement the library. All C files shall be prefixed with 'Bfx'. Header file Bfx.h provides all public function prototypes and types defined by the BFX library specification

Implementation & grouping of routines with respect to C files shall be done according to one of the options described below.

: Section 7.1 "Error Handling" of the document "General Specifi- cation of Basic Software Modules" describes the error handling of the Basic Software in detail. Above all, it constitutes a classification scheme consisting of five error types which may occur in BSW modules.

If source code for caller and callee of Bfx_GetVersionInfo is avail- able, the Bfx library should realize Bfx_GetVersionInfo as a macro defined in the mod- ule's header file.

The Bfx library shall not have any configuration options that may affect the functional behavior of the routines. i.e. for a given set of input parameters, the outputs shall be always the same. For example, the returned value in case of error shall not be configurable.

These requirements are not applicable to this specification.

Module Header File Imported Type Std Std_Types.h Std_VersionInfoType