foxBMS - Unit Tests  1.2.1
The foxBMS Unit Tests API Documentation
foxmath.c File Reference

mathlib function implementations More...

#include "foxmath.h"
Include dependency graph for foxmath.c:

Go to the source code of this file.

Macros

#define SHIFT_ONE_BYTE   (8u)
 
#define SHIFT_TWO_BYTES   (16u)
 
#define SHIFT_FOUR_BYTES   (32u)
 

Functions

void MATH_StartupSelfTest (void)
 : self test for math functions that can be called at startup More...
 
float MATH_LinearInterpolation (const float x1, const float y1, const float x2, const float y2, const float x_interpolate)
 Linear inter-/extrapolates a third point according to two given points. More...
 
uint16_t MATH_SwapBytesUint16_t (const uint16_t val)
 Swap bytes of uint16_t value. More...
 
uint32_t MATH_SwapBytesUint32_t (const uint32_t val)
 Swap bytes of uint32_t value. More...
 
uint64_t MATH_SwapBytesUint64_t (const uint64_t val)
 Swap bytes of uint64_t value. More...
 
float MATH_MinimumOfTwoFloats (const float value1, const float value2)
 Returns the minimum of the passed float values. More...
 
uint8_t MATH_MinimumOfTwoUint8_t (const uint8_t value1, const uint8_t value2)
 Returns the minimum of the passed uint8_t values. More...
 
uint16_t MATH_MinimumOfTwoUint16_t (const uint16_t value1, const uint16_t value2)
 Returns the minimum of the passed uint16_t values. More...
 
int32_t MATH_AbsInt32_t (const int32_t value)
 Returns the absolute value of passed int32_t value. More...
 
int64_t MATH_AbsInt64_t (const int64_t value)
 Returns the absolute value of passed int64_t value. More...
 

Detailed Description

mathlib function implementations

SPDX-License-Identifier: BSD-3-Clause

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
  2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
  3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

We kindly request you to use one or more of the following phrases to refer to foxBMS in your hardware, software, documentation or advertising materials:

  • ″This product uses parts of foxBMS®″
  • ″This product includes parts of foxBMS®″
  • ″This product is derived from foxBMS®″
Author
foxBMS Team
Date
2018-01-18 (date of creation)
Updated
2021-08-06 (date of last update)
Prefix
MATH

Definition in file foxmath.c.

Macro Definition Documentation

◆ SHIFT_FOUR_BYTES

#define SHIFT_FOUR_BYTES   (32u)

shift four bytes (32 positions)

Definition at line 65 of file foxmath.c.

◆ SHIFT_ONE_BYTE

#define SHIFT_ONE_BYTE   (8u)

shift one byte (8 positions)

Definition at line 59 of file foxmath.c.

◆ SHIFT_TWO_BYTES

#define SHIFT_TWO_BYTES   (16u)

shift two bytes (16 positions)

Definition at line 62 of file foxmath.c.

Function Documentation

◆ MATH_AbsInt32_t()

int32_t MATH_AbsInt32_t ( const int32_t  value)

Returns the absolute value of passed int32_t value.

Parameters
[in]valueinteger value
Returns
absolute value or INT32_MAX if INT32_MIN is passed

Definition at line 152 of file foxmath.c.

◆ MATH_AbsInt64_t()

int64_t MATH_AbsInt64_t ( const int64_t  value)

Returns the absolute value of passed int64_t value.

Parameters
[in]valueinteger value
Returns
absolute value or INT64_MAX if INT64_MIN is passed

Definition at line 160 of file foxmath.c.

◆ MATH_LinearInterpolation()

float MATH_LinearInterpolation ( const float  x1,
const float  y1,
const float  x2,
const float  y2,
const float  x_interpolate 
)

Linear inter-/extrapolates a third point according to two given points.

Parameters
x1x-value of point 1
y1y-value of point 1
x2x-value of point 2
y2y-value of point 2
x_interpolatex value of interpolation point
Returns
interpolated value (float)

Definition at line 84 of file foxmath.c.

◆ MATH_MinimumOfTwoFloats()

float MATH_MinimumOfTwoFloats ( const float  value1,
const float  value2 
)

Returns the minimum of the passed float values.

Parameters
[in]value1value 1
[in]value2value 2
Returns
minimum value

Definition at line 132 of file foxmath.c.

◆ MATH_MinimumOfTwoUint16_t()

uint16_t MATH_MinimumOfTwoUint16_t ( const uint16_t  value1,
const uint16_t  value2 
)

Returns the minimum of the passed uint16_t values.

Parameters
[in]value1value 1
[in]value2value 2
Returns
minimum value

Definition at line 144 of file foxmath.c.

◆ MATH_MinimumOfTwoUint8_t()

uint8_t MATH_MinimumOfTwoUint8_t ( const uint8_t  value1,
const uint8_t  value2 
)

Returns the minimum of the passed uint8_t values.

Parameters
[in]value1value 1
[in]value2value 2
Returns
minimum value

Definition at line 136 of file foxmath.c.

◆ MATH_StartupSelfTest()

void MATH_StartupSelfTest ( void  )

: self test for math functions that can be called at startup

: This self test is intended to be called at startup. It will assert if one of the assumptions is violated. This function can be used to make sure that features of foxmath that are currently not used by the code are working nevertheless as expected.

Definition at line 79 of file foxmath.c.

Here is the call graph for this function:

◆ MATH_SwapBytesUint16_t()

uint16_t MATH_SwapBytesUint16_t ( const uint16_t  val)

Swap bytes of uint16_t value.

Parameters
valvalue to swap bytes: 0x1234 -> 0x3412

Definition at line 107 of file foxmath.c.

◆ MATH_SwapBytesUint32_t()

uint32_t MATH_SwapBytesUint32_t ( const uint32_t  val)

Swap bytes of uint32_t value.

Parameters
valvalue to swap bytes: 0x12345678 -> 0x78563412

Definition at line 111 of file foxmath.c.

◆ MATH_SwapBytesUint64_t()

uint64_t MATH_SwapBytesUint64_t ( const uint64_t  val)

Swap bytes of uint64_t value.

Parameters
valvalue to swap bytes: 0x1122334455667788 -> 0x8877665544332211

Definition at line 119 of file foxmath.c.