sys.h File Reference

Sys driver header. More...

#include "sys_cfg.h"
#include "fstd_types.h"
#include <stdint.h>

Include dependency graph for sys.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	SYS_STATE_s

Enumerations
enum	SYS_CHECK_e { SYS_CHECK_OK , SYS_CHECK_BUSY , SYS_CHECK_NOT_OK }
enum	SYS_FSM_STATES_e {   SYS_FSM_STATE_DUMMY , SYS_FSM_STATE_HAS_NEVER_RUN , SYS_FSM_STATE_UNINITIALIZED , SYS_FSM_STATE_INITIALIZATION ,   SYS_FSM_STATE_RUNNING , SYS_FSM_STATE_ERROR }
enum	SYS_FSM_SUBSTATES_e {   SYS_FSM_SUBSTATE_DUMMY , SYS_FSM_SUBSTATE_ENTRY , SYS_FSM_SUBSTATE_INITIALIZATION_SBC , SYS_FSM_SUBSTATE_INITIALIZATION_BOOT_MESSAGE ,   SYS_FSM_SUBSTATE_INITIALIZATION_INTERLOCK , SYS_FSM_SUBSTATE_INITIALIZATION_CONTACTORS , SYS_FSM_SUBSTATE_INITIALIZATION_BALANCING , SYS_FSM_SUBSTATE_INITIALIZATION_INSULATION_GUARD ,   SYS_FSM_SUBSTATE_INITIALIZATION_FIRST_MEASUREMENT_CYCLE , SYS_FSM_SUBSTATE_INITIALIZATION_CHECK_CURRENT_SENSOR , SYS_FSM_SUBSTATE_INITIALIZATION_MISC , SYS_FSM_SUBSTATE_INITIALIZATION_BMS ,   SYS_FSM_SUBSTATE_RUNNING }
enum	SYS_STATEMACH_e {   SYS_STATEMACH_UNINITIALIZED , SYS_STATEMACH_INITIALIZATION , SYS_STATEMACH_SYSTEM_BIST , SYS_STATEMACH_INITIALIZED ,   SYS_STATEMACH_INITIALIZE_SBC , SYS_STATEMACH_INITIALIZE_CAN , SYS_STATEMACH_INITIALIZE_INTERLOCK , SYS_STATEMACH_INITIALIZE_CONTACTORS ,   SYS_STATEMACH_INITIALIZE_BALANCING , SYS_STATEMACH_INITIALIZE_BMS , SYS_STATEMACH_RUNNING , SYS_STATEMACH_FIRST_MEASUREMENT_CYCLE ,   SYS_STATEMACH_INITIALIZE_MISC , SYS_STATEMACH_CHECK_CURRENT_SENSOR_PRESENCE , SYS_STATEMACH_INITIALIZE_IMD , SYS_STATEMACH_ERROR }
enum	SYS_STATEMACH_SUB_e {   SYS_ENTRY , SYS_CHECK_ERROR_FLAGS , SYS_CHECK_STATE_REQUESTS , SYS_WAIT_INITIALIZATION_SBC ,   SYS_WAIT_INITIALIZATION_INTERLOCK , SYS_WAIT_INITIALIZATION_CONT , SYS_WAIT_INITIALIZATION_BAL , SYS_WAIT_INITIALIZATION_BAL_GLOBAL_ENABLE ,   SYS_WAIT_INITIALIZATION_IMD , SYS_WAIT_INITIALIZATION_BMS , SYS_WAIT_FIRST_MEASUREMENT_CYCLE , SYS_WAIT_CURRENT_SENSOR_PRESENCE ,   SYS_SBC_INITIALIZATION_ERROR , SYS_CONT_INITIALIZATION_ERROR , SYS_BAL_INITIALIZATION_ERROR , SYS_ILCK_INITIALIZATION_ERROR ,   SYS_IMD_INITIALIZATION_ERROR , SYS_BMS_INITIALIZATION_ERROR , SYS_MEAS_INITIALIZATION_ERROR , SYS_CURRENT_SENSOR_PRESENCE_ERROR }
enum	SYS_STATE_REQUEST_e { SYS_STATE_INITIALIZATION_REQUEST , SYS_STATE_ERROR_REQUEST , SYS_STATE_NO_REQUEST }
enum	SYS_RETURN_TYPE_e {   SYS_OK , SYS_BUSY_OK , SYS_REQUEST_PENDING , SYS_ILLEGAL_REQUEST ,   SYS_ALREADY_INITIALIZED , SYS_ILLEGAL_TASK_TYPE }

Functions
SYS_RETURN_TYPE_e	SYS_SetStateRequest (SYS_STATE_REQUEST_e stateRequest)
	sets the current state request of the state variable sys_state. More...
STD_RETURN_TYPE_e	SYS_Trigger (SYS_STATE_s *pSystemState)
	tick function, call this to advance the state machine More...
void	SYS_GeneralMacroBist (void)

Variables
SYS_STATE_s	sys_state

Detailed Description

Sys driver header.

Copyright

© 2010 - 2023, Fraunhofer-Gesellschaft zur Foerderung der angewandten Forschung e.V. All rights reserved.

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

2020-02-24 (date of creation)

Updated

2023-02-23 (date of last update)

Version

v1.5.1

Prefix

SYS

Definition in file sys.h.

Enumeration Type Documentation

SYS_CHECK_e

enum SYS_CHECK_e

Symbolic names for busyness of the system

Enumerator
SYS_CHECK_OK	system ok
SYS_CHECK_BUSY	system busy
SYS_CHECK_NOT_OK	system not ok

Definition at line 69 of file sys.h.

SYS_FSM_STATES_e

enum SYS_FSM_STATES_e

States of the state machine

Enumerator
SYS_FSM_STATE_DUMMY	dummy state - always the first state
SYS_FSM_STATE_HAS_NEVER_RUN	never run state - always the second state
SYS_FSM_STATE_UNINITIALIZED	uninitialized state
SYS_FSM_STATE_INITIALIZATION	initializing the state machine
SYS_FSM_STATE_RUNNING	operational mode of the state machine
SYS_FSM_STATE_ERROR	state for error processing

Definition at line 76 of file sys.h.

SYS_FSM_SUBSTATES_e

enum SYS_FSM_SUBSTATES_e

Substates of the state machine

Enumerator
SYS_FSM_SUBSTATE_DUMMY	dummy state - always the first substate
SYS_FSM_SUBSTATE_ENTRY	entry state - always the second substate
SYS_FSM_SUBSTATE_INITIALIZATION_SBC	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_BOOT_MESSAGE	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_INTERLOCK	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_CONTACTORS	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_BALANCING	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_INSULATION_GUARD	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_FIRST_MEASUREMENT_CYCLE	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_CHECK_CURRENT_SENSOR	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_MISC	TODO
SYS_FSM_SUBSTATE_INITIALIZATION_BMS	TODO
SYS_FSM_SUBSTATE_RUNNING	fist running substate

Definition at line 86 of file sys.h.

SYS_RETURN_TYPE_e

enum SYS_RETURN_TYPE_e

Possible return values when state requests are made to the SYS statemachine

Enumerator
SYS_OK	sys --> ok
SYS_BUSY_OK	sys busy --> ok
SYS_REQUEST_PENDING	requested to be executed
SYS_ILLEGAL_REQUEST	Request can not be executed
SYS_ALREADY_INITIALIZED	Initialization of LTC already finished
SYS_ILLEGAL_TASK_TYPE	Illegal

Definition at line 157 of file sys.h.

SYS_STATE_REQUEST_e

enum SYS_STATE_REQUEST_e

State requests for the SYS statemachine

Enumerator
SYS_STATE_INITIALIZATION_REQUEST	initialization request
SYS_STATE_ERROR_REQUEST	error state requested
SYS_STATE_NO_REQUEST	no request

Definition at line 150 of file sys.h.

SYS_STATEMACH_e

enum SYS_STATEMACH_e

States of the SYS state machine

Enumerator
SYS_STATEMACH_UNINITIALIZED
SYS_STATEMACH_INITIALIZATION
SYS_STATEMACH_SYSTEM_BIST	run a built-in self-test
SYS_STATEMACH_INITIALIZED
SYS_STATEMACH_INITIALIZE_SBC
SYS_STATEMACH_INITIALIZE_CAN	initialize CAN module
SYS_STATEMACH_INITIALIZE_INTERLOCK
SYS_STATEMACH_INITIALIZE_CONTACTORS
SYS_STATEMACH_INITIALIZE_BALANCING
SYS_STATEMACH_INITIALIZE_BMS
SYS_STATEMACH_RUNNING
SYS_STATEMACH_FIRST_MEASUREMENT_CYCLE
SYS_STATEMACH_INITIALIZE_MISC
SYS_STATEMACH_CHECK_CURRENT_SENSOR_PRESENCE
SYS_STATEMACH_INITIALIZE_IMD	initialize IMD module
SYS_STATEMACH_ERROR	Error-State

Definition at line 105 of file sys.h.

SYS_STATEMACH_SUB_e

enum SYS_STATEMACH_SUB_e

Substates of the SYS state machine

Enumerator
SYS_ENTRY	Substate entry state
SYS_CHECK_ERROR_FLAGS	Substate check if any error flag set
SYS_CHECK_STATE_REQUESTS	Substate check if there is a state request
SYS_WAIT_INITIALIZATION_SBC	Substate to wait for initialization of the sbc state machine
SYS_WAIT_INITIALIZATION_INTERLOCK	Substate to wait for initialization of the interlock state machine
SYS_WAIT_INITIALIZATION_CONT	Substate to wait for initialization of the contactor state machine
SYS_WAIT_INITIALIZATION_BAL	Substate to wait for initialization of the balancing state machine
SYS_WAIT_INITIALIZATION_BAL_GLOBAL_ENABLE	Substate to enable/disable balancing globally
SYS_WAIT_INITIALIZATION_IMD	Substate to wait for initialization of the imd state machine
SYS_WAIT_INITIALIZATION_BMS	Substate to wait for initialization of the bms state machine
SYS_WAIT_FIRST_MEASUREMENT_CYCLE	Substate to wait for first measurement cycle to complete
SYS_WAIT_CURRENT_SENSOR_PRESENCE	Substate to wait for first measurement cycle to complete
SYS_SBC_INITIALIZATION_ERROR	Substate error of SBC initialization
SYS_CONT_INITIALIZATION_ERROR	Substate error of contactor state machine initialization
SYS_BAL_INITIALIZATION_ERROR	Substate error of balancing state machine initialization
SYS_ILCK_INITIALIZATION_ERROR	Substate error of contactor state machine initialization
SYS_IMD_INITIALIZATION_ERROR	Substate error of bms state machine initialization
SYS_BMS_INITIALIZATION_ERROR	Substate error of bms state machine initialization
SYS_MEAS_INITIALIZATION_ERROR	Substate error if first measurement cycle does not complete
SYS_CURRENT_SENSOR_PRESENCE_ERROR	Substate error if first measurement cycle does not complete

Definition at line 126 of file sys.h.

Function Documentation

SYS_GeneralMacroBist()

void SYS_GeneralMacroBist

(

void

)

built-in self-test for the macros in general.h

Definition at line 663 of file sys.c.

SYS_SetStateRequest()

SYS_RETURN_TYPE_e SYS_SetStateRequest

(

SYS_STATE_REQUEST_e

stateRequest

)

sets the current state request of the state variable sys_state.

This function is used to make a state request to the state machine, e.g., start voltage measurement, read result of voltage measurement, re-initialization. It calls SYS_CheckStateRequest() to check if the request is valid. The state request is rejected if is not valid. The result of the check is returned immediately, so that the requester can act in case it made a non-valid state request.

Parameters

stateRequest

state requested to set

Returns

If the request was successfully set, it returns the SYS_OK, else the current state of requests (type SYS_STATE_REQUEST_e)

Definition at line 614 of file sys.c.

Here is the call graph for this function:

SYS_Trigger()

STD_RETURN_TYPE_e SYS_Trigger

(

SYS_STATE_s *

pSystemState

)

tick function, call this to advance the state machine

This function contains the sequence of events in the SYS state machine. It must be called time-triggered, every 10ms.

Definition at line 671 of file sys.c.

Here is the call graph for this function:

Variable Documentation

sys_state

SYS_STATE_s sys_state

extern

contains the state of the contactor state machine

Definition at line 98 of file sys.c.