3.1.8. waf_tools.bms_config_generate

Generate foxBMS configuration headers and environment flags.

This waf tool generates C header files containing #define directives derived from the validated BMS system configuration (bms.json). It also sets the corresponding waf environment variables so that build steps can conditionally include source files and apply compiler flags based on the active hardware and software configuration.

The tool covers the following configuration domains:

  • Aerosol sensor - Manufacturer/model detection and support defines.

  • Algorithm - State estimation method selection (SOC, SOE, SOF, SOH).

  • Balancing strategy - Active balancing algorithm selection.

  • Current sensor - Manufacturer, model, and communication type.

  • IMD sensor - Insulation monitoring device selection and type.

  • Redundancy - Redundant measurement path enable/disable.

  • Debug interfaces - UART support toggle.

  • RTOS - Real-time OS selection and addon configuration (e.g. TCP).

  • BMS-Slave - Analog front-end IC, driver type, and temperature sensor.

  • MCU - Cache enable/disable.

Additionally, the module provides @conf-decorated helper functions that allow build scripts to query the active sensor/device configuration (e.g. is_current_sensor_lem_cab500(), is_imd_bender_iso165c()).

3.1.8.1. Usage

  1. Validate the configuration and set environment variables:

    bms_config_node = bld.srcnode.find_node(bld.env.BMS_CONFIG)
system = bms_config_validate.validate_bms_configuration(bld, bms_config_node)
bms_config_generate.set_env_variables(bld, system)

  2. Declare task generators with the foxbms_config feature for each configuration domain:

    contents = [
        "aerosol_sensor",
        "algorithm",
        "balancing_strategy",
        "current_sensor",
        "imd_sensor",
        "redundant_v_t_measurement",
        "debug",
        "rtos",
        "bms_slave",
    ]
    for content in contents:
        bld(
            features="foxbms_config",
            bms_config_node=bms_config_node,
            system=system,
            content=content,
            target=content,
        )

    Each task generator produces a foxbms_config_<target>.h header file in the build directory.

3.1.8.2. Dependencies

Functions

create_foxbms_config(self)

Process the foxbms_config feature on a task generator.

is_aerosol_sensor_honeywell_bas6c_x00(ctx)

Determine whether the aerosol sensor is Honeywell BAS6C-X00.

is_bms_slave_debug_can(ctx)

Determine whether the BMS-Slave is Debug CAN.

is_current_sensor_isabellenhuette_ivt_s(ctx)

Determine whether the current sensor is Isabellenhuette IVT-S.

is_current_sensor_lem_cab500(ctx)

Determine whether the current sensor is LEM CAB500.

is_imd_bender_ir155(ctx)

Determine whether the IMD is Bender IR155.

is_imd_bender_iso165c(ctx)

Determine whether the IMD is Bender iso165c.

is_imd_none(ctx)

Determine whether no IMD device shall be used.

set_aerosol_sensor(bld, system)

Configure aerosol sensor defines and environment variables.

set_algorithm(bld, system)

Configure state estimation algorithm defines and environment variables.

set_balancing_strategy(bld, system)

Configure balancing strategy defines and environment variables.

set_bms_slave(bld, system)

Configure BMS-Slave defines and environment variables.

set_current_sensor(bld, system)

Configure current sensor defines and environment variables.

set_debug(bld, system)

Configure debug interface defines and environment variables.

set_env_variables(bld, system)

Set all build environment variables based on the system configuration.

set_imd_sensor(bld, system)

Configure insulation monitoring device defines and environment variables.

set_mcu(bld, system)

Configure MCU defines and environment variables.

set_redundant_v_t_measurement(bld, system)

Configure redundancy defines and environment variables.

set_rtos(bld, system)

Configure RTOS defines and environment variables.

Classes

CreateFoxbmsConfig(*k, **kw)

Waf task that generates a foxBMS configuration header file.