rasProject_01 / weSweetHome  R. 116 2026-05-14
process control       /     RasPi software         by   weinert-automation
Loading...
Searching...
No Matches
sweetHome.c File Reference

Common values for an experimental smart home (lab) project. More...

#include "sweetHome.h"
#include "weBatt.h"
#include <stdio.h>

Functions

void chgFilNames (void)
 Set the current date in event & retain file paths.

Variables

cmdLookUp_t cmdLookUp []
 The common command look up table.
char dayFilNam []
 Path of the table to log a set of values for every day.
char evtFilNam []
 Path of the daily event file.
volatile float fLine
 last valid power line frequency
volatile int invHasUnloadPow
 The miniJoule inverter has battery unload power.
float const loadModUlookup [256]
 Output voltage of electronic battery load module.
float const phPckSwPow [101]
 First (or only) phase packet switching device power look up.
phPckSwSet_t const phPckSwSets [101]
 The packet switch control values.
char retFilNam []
 Path of the daily retain file.
smdX30modbus_t smdX30modbus [ANZmodSLAVES]
 Descriptive and state array for smart meters on Modbus.
volatile int tempTankWater
 Last value of tank water temperature in mgrdC.
volatile uint8_t tempWaterBadCnt
 Tank water temperature bad read count.
valFilVal_t valFilVal
 All process values relevant for log files and HMI.

Detailed Description

Common values for an experimental smart home (lab) project.

Revision history

Function Documentation

◆ chgFilNames()

void chgFilNames ( void )

Set the current date in event & retain file paths.

The current date from actRTmTxt is set into the file names evtFilNam and retFilNam

Variable Documentation

◆ evtFilNam

char evtFilNam[]

Path of the daily event file.

The current date in the format 2025-09-30 has to be set at position EFNY by chgFilNames().
The event file outLog is a text file used for one day for events and currently (see useOutLog4errLog) for errors, also.

See also
dayFilNam EFNY retFilNam

◆ retFilNam

char retFilNam[]

Path of the daily retain file.

The current date in the format 2025-10-20 has to be set at position RFNY by chgFilNames().
The retain file is currently a short binary file for just one day kept in the file name. It contains start values for shortly after midnight for this day, only. It will be read in the case the program would be re-start at that day instead of running on 24-7.
The values stored are (example):

See also
RFNY dayFilNam evtFilNam

◆ dayFilNam

char dayFilNam[]

Path of the table to log a set of values for every day.

This is the text file in csv format where a set of day start values is recorded for every day shortly after midnight.
It will be used "endlessly". To set an end respectively close that diary just rename the file. A new "dayFile" will then be created an used hence on.

See also
evtFilNam retFilNam

◆ cmdLookUp

cmdLookUp_t cmdLookUp[]

The common command look up table.

It must end with an entry {"", 0}.

The current (CGI) program uses linear search for the command mnemonic. Hence, and cause of structure, alphabetic sorting is of no avail.

◆ loadModUlookup

float const loadModUlookup[256]

Output voltage of electronic battery load module.

This table (09.2025) is based on some 95 measurements (Fluke) and linear interpolation over the small gaps. The accuracy is about +/-15mV.

Depending on the (400Hz) PMW signal width 0..255 (/255 * 100% width) the battery load module will deliver about 11 to 14V. These values are taken behind Schottky Diodes under load causing a drop of about 0.4V. If the battery voltage is higher no current will flow.

This current limit (20 A nominally) is implemented by the power supply module. Hence, getting less current respectively power requires a fine control of the PWM signal on Pin POWH.

◆ fLine

volatile float fLine

last valid power line frequency

Last valid power line frequency.

last valid power line frequency

The measurement is taken from the more precise home three phase meter if communicative via Modbus. Otherwise the other meter's value is taken if available. Due to slow Modbus communication the values may be older than two seconds worst case.
This low sampling rate won't comply with VDE-AR-N 4105 cut off rules requiring a 0.1s reaction outside 47.5..51.5Hz. Nevertheless the current experimental set-up is a working proof-of-concept implementation (with very low power) — and a faster frequency measurement could easily be implemented.

Last valid power line frequency.

◆ phPckSwSets

phPckSwSet_t const phPckSwSets[101]

The packet switch control values.

The array holds the number of on and off phases (i.e. 20 ms periods at 50 Hz line frequency) for each percentage of full power. The array length is 101; the index [0..100] is, hence, directly the percentage wanted.

To avoid too visible flicker, for no set (phPckSwSets[i].onPhases, phPckSwSets[i].offPhases) the smaller of the two values would be greater than 4 (80 ms); in most cases it is 1 or 2 (40 ms).

◆ smdX30modbus

Descriptive and state array for smart meters on Modbus.

The number of meters is ANZmodSLAVES.

◆ tempTankWater

volatile int tempTankWater

Last value of tank water temperature in mgrdC.

This value will be the last good .tempTankTop (see valFilVal_t) or the last good .tempPipe. If neither is good for 251 measurements BAD_TEMP_READ (an incredibly high value) will be set.
This last tank water temperature will be checked against a safety limit to allow electric heating as ballast.
The value is in units of 1/1000 grdC.

◆ tempWaterBadCnt

volatile uint8_t tempWaterBadCnt

Tank water temperature bad read count.

This last tank water temperature will be checked against a safety limit to allow electric heating as ballast.

In case of too many bad reads the value must be fixed at 253

◆ invHasUnloadPow

volatile int invHasUnloadPow

The miniJoule inverter has battery unload power.

Or at least may still have due to step up converter capacitors.