Units.h File Reference

#include <stdint.h>
#include <stdbool.h>

Include dependency graph for Units.h:

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

Go to the source code of this file.

Classes
struct	UnitDefinition

Enumerations
enum	UnitDataType {   UNIT_TYPE_FLOAT , UNIT_TYPE_INT16 , UNIT_TYPE_INT32 , UNIT_TYPE_UINT16 ,   UNIT_TYPE_UINT32 , UNIT_TYPE_BOOL , UNIT_TYPE_ENUM }
enum	UnitCategory {   UNIT_CATEGORY_VOLTAGE , UNIT_CATEGORY_CURRENT , UNIT_CATEGORY_PRESSURE , UNIT_CATEGORY_TEMPERATURE ,   UNIT_CATEGORY_POSITION , UNIT_CATEGORY_SPEED , UNIT_CATEGORY_TIME , UNIT_CATEGORY_FREQUENCY ,   UNIT_CATEGORY_DIMENSIONLESS , UNIT_CATEGORY_STATUS }
enum	UnitId {   UNIT_VOLTS = 0 , UNIT_MILLIVOLTS , UNIT_AMPERES , UNIT_MILLIAMPERES ,   UNIT_PSI , UNIT_BAR , UNIT_PASCAL , UNIT_CELSIUS ,   UNIT_FAHRENHEIT , UNIT_KELVIN , UNIT_PERCENT , UNIT_DEGREES ,   UNIT_RADIANS , UNIT_RPM , UNIT_HZ , UNIT_KMH ,   UNIT_MPH , UNIT_MS , UNIT_SECONDS , UNIT_MILLISECONDS ,   UNIT_MICROSECONDS , UNIT_BOOLEAN , UNIT_ENUM , UNIT_PERCENTAGE ,   UNIT_DIMENSIONLESS , UNIT_COUNT }

Functions
const UnitDefinition *	getUnitDefinition (UnitId unit_id)
UnitId	getUnitIdBySymbol (const char *symbol)
bool	validateUnitValue (UnitId unit_id, float value)
float	convertUnits (float value, UnitId from_unit, UnitId to_unit)
void	initUnits (void)

Enumeration Type Documentation

UnitCategory

enum UnitCategory

Enumerator
UNIT_CATEGORY_VOLTAGE
UNIT_CATEGORY_CURRENT
UNIT_CATEGORY_PRESSURE
UNIT_CATEGORY_TEMPERATURE
UNIT_CATEGORY_POSITION
UNIT_CATEGORY_SPEED
UNIT_CATEGORY_TIME
UNIT_CATEGORY_FREQUENCY
UNIT_CATEGORY_DIMENSIONLESS
UNIT_CATEGORY_STATUS

Definition at line 17 of file Units.h.

             {
    UNIT_CATEGORY_VOLTAGE,
    UNIT_CATEGORY_CURRENT,
    UNIT_CATEGORY_PRESSURE,
    UNIT_CATEGORY_TEMPERATURE,
    UNIT_CATEGORY_POSITION,
    UNIT_CATEGORY_SPEED,
    UNIT_CATEGORY_TIME,
    UNIT_CATEGORY_FREQUENCY,
    UNIT_CATEGORY_DIMENSIONLESS,
    UNIT_CATEGORY_STATUS
} UnitCategory;

UnitDataType

enum UnitDataType

Enumerator
UNIT_TYPE_FLOAT
UNIT_TYPE_INT16
UNIT_TYPE_INT32
UNIT_TYPE_UINT16
UNIT_TYPE_UINT32
UNIT_TYPE_BOOL
UNIT_TYPE_ENUM

Definition at line 7 of file Units.h.

             {
    UNIT_TYPE_FLOAT,
    UNIT_TYPE_INT16,
    UNIT_TYPE_INT32,
    UNIT_TYPE_UINT16,
    UNIT_TYPE_UINT32,
    UNIT_TYPE_BOOL,
    UNIT_TYPE_ENUM
} UnitDataType;

UnitId

enum UnitId

Enumerator
UNIT_VOLTS
UNIT_MILLIVOLTS
UNIT_AMPERES
UNIT_MILLIAMPERES
UNIT_PSI
UNIT_BAR
UNIT_PASCAL
UNIT_CELSIUS
UNIT_FAHRENHEIT
UNIT_KELVIN
UNIT_PERCENT
UNIT_DEGREES
UNIT_RADIANS
UNIT_RPM
UNIT_HZ
UNIT_KMH
UNIT_MPH
UNIT_MS
UNIT_SECONDS
UNIT_MILLISECONDS
UNIT_MICROSECONDS
UNIT_BOOLEAN
UNIT_ENUM
UNIT_PERCENTAGE
UNIT_DIMENSIONLESS
UNIT_COUNT

Definition at line 44 of file Units.h.

             {
    UNIT_VOLTS = 0,
    UNIT_MILLIVOLTS,
    UNIT_AMPERES,
    UNIT_MILLIAMPERES,
    UNIT_PSI,
    UNIT_BAR,
    UNIT_PASCAL,
    UNIT_CELSIUS,
    UNIT_FAHRENHEIT,
    UNIT_KELVIN,
    UNIT_PERCENT,
    UNIT_DEGREES,
    UNIT_RADIANS,
    UNIT_RPM,
    UNIT_HZ,
    UNIT_KMH,
    UNIT_MPH,
    UNIT_MS,
    UNIT_SECONDS,
    UNIT_MILLISECONDS,
    UNIT_MICROSECONDS,
    UNIT_BOOLEAN,
    UNIT_ENUM,
    UNIT_PERCENTAGE,
    UNIT_DIMENSIONLESS,
    UNIT_COUNT  // Must be last
} UnitId;

Function Documentation

convertUnits()

float convertUnits	(	float	value,
		UnitId	from_unit,
		UnitId	to_unit
	)

Definition at line 99 of file Units.c.

                                                                  {
    const UnitDefinition* from_def = getUnitDefinition(from_unit);
    const UnitDefinition* to_def = getUnitDefinition(to_unit);
    
    // Only convert within same category
    if (from_def->category != to_def->category) {
        return value;  // No conversion possible
    }
    
    // Convert to base unit, then to target unit
    float base_value = value * from_def->scale_factor;
    return base_value / to_def->scale_factor;
}

Here is the call graph for this function:

getUnitDefinition()

const UnitDefinition * getUnitDefinition

(

UnitId

unit_id

)

Definition at line 78 of file Units.c.

                                                        {
    if (unit_id >= UNIT_COUNT) {
        return &unit_definitions[UNIT_DIMENSIONLESS];  // Fallback
    }
    return &unit_definitions[unit_id];
}

Here is the caller graph for this function:

getUnitIdBySymbol()

UnitId getUnitIdBySymbol

(

const char *

symbol

)

Definition at line 85 of file Units.c.

                                             {
    for (UnitId i = 0; i < UNIT_COUNT; i++) {
        if (strcmp(unit_definitions[i].symbol, symbol) == 0) {
            return i;
        }
    }
    return UNIT_DIMENSIONLESS;  // Fallback
}

initUnits()

void initUnits

(

void

)

Definition at line 74 of file Units.c.

                     {
    sendMessage("Units", MSG_DEBUG, "Units system initialized with %d unit types", UNIT_COUNT);
}

Here is the call graph for this function:

Here is the caller graph for this function:

validateUnitValue()

bool validateUnitValue	(	UnitId	unit_id,
		float	value
	)

Definition at line 94 of file Units.c.

                                                    {
    const UnitDefinition* unit = getUnitDefinition(unit_id);
    return (value >= unit->absolute_min && value <= unit->absolute_max);
}

Here is the call graph for this function:

Here is the caller graph for this function: