Lamp-Da 0.1
A compact lantern project
Loading...
Searching...
No Matches
Namespaces | Typedefs | Functions | Variables
constants.h File Reference

Define the system hardware constants. More...

Go to the source code of this file.

Namespaces

namespace  lampda
 Program scope.
 
namespace  lampda::physical_constants
 Define the board and hardware physical constants.
 

Typedefs

using lampda::byte = uint8_t
 
using lampda::brightness_t = uint16_t
 Define the type of the brightness parameters.
 

Functions

bool lampda::is_cell_voltage_valid (const uint16_t cellVoltage_mv)
 check battery cell voltage against min/max limits
 

Variables

static constexpr uint8_t lampda::BASE_SOFTWARE_VERSION_MAJOR = 1
 Base major software version, common to all systems. increment for every release.
 
static constexpr uint8_t lampda::BASE_SOFTWARE_VERSION_MINOR = 9
 Base minor software version, common to all systems. increment for every release.
 
static constexpr uint8_t lampda::ADC_RES_EXP = 12
 resolution of the ADC, in bits (can be 8, 10, 12 or 14)
 
static const uint32_t lampda::ADC_MAX_VALUE = static_cast<uint32_t>(pow(2, ADC_RES_EXP))
 corresponding ADC max value
 
static constexpr float lampda::internalReferenceVoltage = 3.0f
 internal voltage reference
 
static constexpr uint8_t lampda::USER_WATCHDOG_ID = 0
 user thread watchdog
 
static constexpr uint8_t lampda::POWER_WATCHDOG_ID = 2
 power thread watchdog
 
static constexpr uint8_t lampda::physical_constants::batterySeriesCount = 3
 number of batteries in series for this model
 
static constexpr uint8_t lampda::physical_constants::batteryParellelCount = 1
 number of batteries in parallel for this model
 
static constexpr float lampda::physical_constants::imuToCircuitRotationX_rad = 0.0f * c_degreesToRadians
 
static constexpr float lampda::physical_constants::imuToCircuitRotationY_rad = 0.0f * c_degreesToRadians
 
static constexpr float lampda::physical_constants::imuToCircuitRotationZ_rad = -9.0f * c_degreesToRadians
 
static constexpr float lampda::physical_constants::imuToCircuitPositionX_m = 8.915f / 1000.0f
 
static constexpr float lampda::physical_constants::imuToCircuitPositionY_m = -5.769f / 1000.0f
 
static constexpr float lampda::physical_constants::imuToCircuitPositionZ_m = 0.0f / 1000.0f
 
static constexpr float lampda::physical_constants::batteryChargeC_Rate = 0.33f
 Maximum charge rate.
 
static constexpr float lampda::physical_constants::batteryDischargeC_Rate = 1.0f
 Typical discharge rate.
 
static constexpr uint32_t lampda::physical_constants::batteryCapacity_mAH = batteryParellelCount * 4850
 Battery capacity, in mA*hours.
 
static constexpr uint16_t lampda::physical_constants::minLiionVoltage_mV = 2500
 minimum Li-ion voltage
 
static constexpr uint16_t lampda::physical_constants::typicalLiionVoltage_mV = 3630
 standard 50% charge Li-ion voltage
 
static constexpr uint16_t lampda::physical_constants::maxLiionVoltage_mV = 4200
 Absolute maximum allowed Li-ion voltage.
 
static constexpr uint16_t lampda::physical_constants::minSafeLiionVoltage_mV = 3100
 minimum allowed li-ion voltage safe zone
 
static constexpr uint16_t lampda::physical_constants::maxSafeLiionVoltage_mV = 4100
 maximum allowed li-ion voltage safe zone
 
static constexpr uint16_t lampda::physical_constants::minSingularBatteryVoltage_mV
 with added margins to avoid wrong detection
 
static constexpr uint16_t lampda::physical_constants::maxSingularBatteryVoltage_mV
 with added margins to avoid wrong detection
 
static constexpr float lampda::physical_constants::maxSystemTemp_c = 70.0f
 maximum microcontroler temperature, in degrees
 
static constexpr float lampda::physical_constants::criticalSystemTemp_c = 80.0f
 absolute maximum microcontroler temperature, in degrees
 
static constexpr uint16_t lampda::physical_constants::batteryCritical = 300
 in % *100, critical battery level
 
static constexpr uint16_t lampda::physical_constants::batteryLow = 500
 in % *100, low battery level
 
static constexpr uint32_t lampda::physical_constants::maxVbusWireCurrent_mA = 3000
 maximum current that the USB-C wires can carry
 
static constexpr uint32_t lampda::physical_constants::maxBatteryConnectorCurrent_mA = 3000
 maximum current that the USB-C wires can carry
 
static constexpr uint32_t lampda::physical_constants::maxChargerCurrent_mA = 6000
 maximum current that the power circuit can handle
 
static constexpr uint32_t lampda::physical_constants::maxVbusGateCurrent_mA = 5000
 maximum current that the vbus gate can handle
 
static constexpr uint32_t lampda::physical_constants::maxOutputGateCurrent_mA = 35000
 maximum current that the output gate can handle
 
static constexpr uint16_t lampda::physical_constants::batteryMaxVoltage_mV = maxLiionVoltage_mV * batterySeriesCount
 max voltage of a single li-ion cell
 
static constexpr uint16_t lampda::physical_constants::batteryMaxVoltageSafe_mV = maxSafeLiionVoltage_mV * batterySeriesCount
 max voltage of a li-ion cell to maximise lifetime
 
static constexpr uint16_t lampda::physical_constants::batteryTypicalVoltageSafe_mV = typicalLiionVoltage_mV * batterySeriesCount
 typical pack voltage
 
static constexpr uint16_t lampda::physical_constants::batteryMinVoltage_mV = minLiionVoltage_mV * batterySeriesCount
 min voltage of a single li-ion cell
 
static constexpr uint16_t lampda::physical_constants::batteryMinVoltageSafe_mV = minSafeLiionVoltage_mV * batterySeriesCount
 min voltage of a li-ion cell to maximise lifetime
 
static constexpr float lampda::physical_constants::totalCons_Watt = consWattByMeter * ledStripLength_mm / 1000.0f
 Total maximum power usage of the led strip.
 
static constexpr float lampda::physical_constants::maxStripConsumption_A = 1000.0f * totalCons_Watt / stripInputMaxVoltage_mV
 Maximum led strip current usage, in Amps.
 
static constexpr uint32_t lampda::physical_constants::batteryMaxChargeCurrent_mA
 Battery maximum charge current, in milliAmps.
 
static constexpr uint32_t lampda::physical_constants::batteryEndOfChargeCurrent_mA = batteryCapacity_mAH / 20
 End of charge current (C/20), in milliAmps: in constant voltage phase, the charge is done below this current. The charge current never reaches 0 while the balancer bleeds cells, so a 0 current cannot be used.
 
static constexpr uint32_t lampda::physical_constants::batteryMaxDischargeCurrent_mA
 Battery maximum discharge current, in milliAmps.
 
static constexpr uint32_t lampda::physical_constants::batteryTypicalPower_mWH = batteryCapacity_mAH * batteryTypicalVoltageSafe_mV / 1000
 Battery standard power, in milliWatt*Hours.
 
static constexpr brightness_t lampda::brightness::absoluteMaximumBrightness = 1024
 Maximum brightness value.
 
static constexpr brightness_t lampda::brightness::absoluteMinimumBrightness = 0
 

Detailed Description

Define the system hardware constants.