view tempctrl.c @ 78:4c1db877452b

Add small note.
author Daniel O'Connor <darius@dons.net.au>
date Tue, 23 Apr 2013 20:46:37 +0930
parents aaf0603d7f88
children 05ba84c7da97
line wrap: on
line source

/*
 * Temperature control logic, copied from AVR version
 *
 * Copyright (c) 2012
 *      Daniel O'Connor <darius@dons.net.au>.  All rights reserved.
 *
 * 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.
 *
 * THIS SOFTWARE IS PROVIDED BY AUTHOR 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 AUTHOR 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.
 */

#include <assert.h>
#include <ctype.h>
#include <stdio.h>
#include <stdint.h>
#include <stdlib.h>
#include <string.h>
#include <sys/time.h>
#include <time.h>
#include "stm32f10x.h"

#include "1wire.h"
#include "ff.h"
#include "flash.h"
#include "tempctrl.h"

#define TEMPCTRL_FLASH_ADDRESS 	0	/* First sector */

/* Holds all the settings needed */
typedef struct {
    uint8_t	fermenter_ROM[8];
    uint8_t	fridge_ROM[8];
    uint8_t	ambient_ROM[8];
    int16_t	target_temp;
    uint16_t	hysteresis;
    /* How much to under/overshoot on heating/cooling */
    int16_t	minheatovershoot;
    int16_t	mincoolovershoot;

    /* Minimum time the cooler can be on/off */
    int16_t	mincoolontime;
    int16_t	mincoolofftime;

    /* Minimum time the heater can be on/off */
    int16_t	minheatontime;
    int16_t	minheatofftime;

#define TC_MODE_AUTO	'a'	/* Automatic control */
#define TC_MODE_HEAT	'h'	/* Force heating */
#define TC_MODE_COOL	'c'	/* Force cooling */
#define TC_MODE_IDLE	'i'	/* Force idle */
#define TC_MODE_NOTHING	'n'	/* Do nothing (like idle but log nothing) */
    char	mode;
    
    /* GPIO port the heater & cooler are on */
    char	coolport;
    uint16_t	coolpin;
    uint8_t	coolinv;
    
    char 	heatport;
    uint16_t	heatpin;
    uint8_t	heatinv;

    /* Check/stale times */
    int16_t	check_interval;
    int16_t	stale_factor;

    char	logfilefmt[64];

    uint8_t	pad[1]; /* Pad to multiple of 4 bytes */
} tc_settings_t;

/* Current settings in RAM */
static tc_settings_t	tc_settings;

/* Defaults that are shoved into SPI flash if it isn't inited */
const tc_settings_t	default_tc_settings = {
    .fermenter_ROM = { 0x10, 0x4c, 0x7d, 0x53, 0x01, 0x08, 0x00, 0xff },
    .fridge_ROM =  { 0x10, 0x6d, 0x40, 0x53, 0x01, 0x08, 0x00, 0x16 },
    .ambient_ROM = { 0x10, 0x76, 0x05, 0x53, 0x01, 0x08, 0x00, 0x8e },
    .target_temp = 1000,
    .hysteresis = 100,
    .minheatovershoot = 50,
    .mincoolovershoot = -50,
    .mincoolontime = 300,
    .mincoolofftime = 600,
    .minheatontime = 60,
    .minheatofftime = 60,
    .mode = TC_MODE_AUTO,
    .coolport = 'E',
    .coolpin = 4,
    .coolinv = 1,
    .heatport = 'E',
    .heatpin = 5,
    .heatinv = 1,
    .check_interval = 10,
    .stale_factor = 3,
    .logfilefmt = "/%Y%M%D.log"
};

/* Local variable declarations */

/* Local function prototypes */
static void		tempctrl_load_or_init_settings(void);
static void		tempctrl_default_settings(void);
static int		tempctrl_write_settings(void);
static void		setstate(char state);
static const char *	state2long(char s);
static int		fmttemp(char *buf, const char *name, int tmp, const char *trailer);
static GPIO_TypeDef	*char2port(char port);

/* 
 * tempctrl_init
 *
 */
void
tempctrl_init(void) {
    tempctrl_load_or_init_settings();
    setstate('i');
}

/* 
 * tempctrl_update
 *
 * Should be called in a normal context, could run things that take a long time.
 * (ie 1wire bus stuff)
 *
 */
void
tempctrl_update(void) {
    /* State variables */
    static int32_t	checktime = 0;		// Time of next check
    static int32_t	lastdata = INT32_MIN;	// Last time we got data

    static int16_t	fermenter_temp = 0;	// Fermenter temperature
    static int16_t	fridge_temp = 0;	// Fridge temperature
    static int16_t	ambient_temp = 0;	// Ambient temperature
    static int32_t	lastheaton = INT32_MIN;	// Last time the heater was on
    static int32_t	lastheatoff = INT32_MIN;// Last time the heater was off
    static int32_t	lastcoolon = INT32_MIN;	// Last time the cooler was on
    static int32_t	lastcooloff = INT32_MIN;// Last time the cooler was off
    static char		currstate = 'i';	// Current state
    /* We init to times to INT32_MIN so that things function properly when
     * now < settings.minheat/cool/on/offtime */
    
    /* Temporary variables */
    int32_t		tempt;
    int16_t		diff;
    char		nextstate;
    int			forced;
    int			stale;
    time_t		t;
    struct tm		tm;
    char		linebuf[90], *p;
    FRESULT		fserr;
    FIL			f;
    char		fbuf[20];
    
    t = time(NULL);
    stale = 0;
    tempt = 0;
    
    /* Time to check temperatures? */
    if (t < checktime)
	return;
    
    checktime = t + tc_settings.check_interval;

    /* Don't do any logging, just force idle and leave */
    if (tc_settings.mode == TC_MODE_NOTHING) {
	nextstate = 'i';
	goto skip;
    }
    
    /* Update our temperatures
     * Can take a while (800ms each!)
     */
    tempt = OWGetTemp(tc_settings.fermenter_ROM);
    fridge_temp = OWGetTemp(tc_settings.fridge_ROM);
    ambient_temp = OWGetTemp(tc_settings.ambient_ROM);
    
    /* We only care about this one, only update the value we decide on
     * only if it is valid
     */
    if (tempt > OW_TEMP_BADVAL) {
	fermenter_temp = tempt;
	lastdata = t;
    }
    
    /* Check for stale data */
    if (lastdata + (tc_settings.check_interval * tc_settings.stale_factor) < t)
	stale = 1;

    /* Default to remaining as we are */
    nextstate = '-';

    /* Temperature diff, -ve => too cold, +ve => too warm */
    diff = fermenter_temp - tc_settings.target_temp;

    switch (currstate) {
	case 'i':
	    /* If we're idle then only heat or cool if the temperate difference is out of the
	     * hysteresis band and the heater/cooler have been off long enough
	     */
	    if (abs(diff) > tc_settings.hysteresis) {
		if (diff < 0 && tc_settings.minheatofftime + lastheatoff < t)
		    nextstate = 'h';
		else if (diff > 0 && tc_settings.mincoolofftime + lastcooloff < t)
		    nextstate = 'c';
	    }
	    break;
	    
	case 'c':
	    /* Work out if we should go idle (based on min on time & overshoot) */
	    if (diff + tc_settings.mincoolovershoot < 0 &&
		tc_settings.mincoolontime + lastcoolon < t)
		nextstate = 'i';
	    break;

	case 'h':
	    if (diff - tc_settings.minheatovershoot > 0 &&
		tc_settings.minheatontime + lastheaton < t)
		nextstate = 'i';
	    break;

	default:
	    printf("\nUnknown state %c, going to idle\n", currstate);
	    nextstate = 'i';
	    break;
    }

    /* Override if we have stale data */
    if (stale)
	nextstate = 'i';
    
    /* Handle state forcing */
    if (tc_settings.mode != TC_MODE_AUTO)
	forced = 1;
    else
	forced = 0;
    
    if (tc_settings.mode == TC_MODE_IDLE)
	nextstate = 'i';
    else if (tc_settings.mode == TC_MODE_HEAT)
	nextstate = 'h';
    else if (tc_settings.mode == TC_MODE_COOL)
	nextstate = 'c';

    /* Keep track of when we last turned things on or off */
  skip:
    switch  (nextstate) {
	case 'c':
	    if (currstate == 'h')
		lastheatoff = t;
	    lastcoolon = t;
	    break;

	case 'h':
	    if (currstate == 'c')
		lastcooloff = t;
	    lastheaton = t;
	    break;

	default:
	    if (currstate == 'c')
		lastcooloff = t;
	    if (currstate == 'h')
		lastheatoff = t;
    }
    
    if (nextstate != '-')
	currstate = nextstate;

    
    if (tc_settings.mode != TC_MODE_NOTHING) {
	localtime_r(&t, &tm);
	p = linebuf;
	p += strftime(p, sizeof(linebuf) - 1, "%Y/%m/%d %H:%M:%S: ", &tm);
	p += fmttemp(p, "Tr", tc_settings.target_temp, ", ");
	p += fmttemp(p, "Fm", tempt, ", ");
	p += fmttemp(p, "Fr", fridge_temp, ", ");
	p += fmttemp(p, "Am", ambient_temp, ", ");
	sprintf(p, "St: %s, Fl: %s%s\n", state2long(currstate), 
		forced ? "F" : "", 
		stale ? "S" : "");
	fputs(linebuf, stdout);
	if (tc_settings.logfilefmt[0] != '\0') {
	    strftime(fbuf, sizeof(fbuf) - 1, tc_settings.logfilefmt, &tm);
	    
	    if ((fserr = f_open(&f, fbuf, FA_WRITE | FA_OPEN_ALWAYS)) != FR_OK) {
		printf("Failed to open file: %d\n", fserr);
		goto openerr;
	    }

	    if ((fserr = f_lseek(&f, f_size(&f))) != FR_OK) {
		printf("Failed to seek to end of file: %d\n", fserr);
		goto openerr;
	    }
	
	    f_puts(linebuf, &f);
	    f_close(&f);
	}
    }

  openerr:
    setstate(currstate);
}

/*
 * Format a temperature (or short error code) with specified trailer
 */
static int
fmttemp(char *buf, const char *name, int tmp, const char *trailer) {
    if (tmp > OW_TEMP_BADVAL)
	return sprintf(buf, "%s: %d.%02d%s", name, GETWHOLE(tmp), GETFRAC(tmp), trailer);
    else
	return sprintf(buf, "%s: %s%s", name, OWTempStatusStr(tmp, 1), trailer);
}

/* Read the settings from SPI flash
 * If the CRC fails then reload from onboard flash
 */
static void
tempctrl_load_or_init_settings(void) {
    if (!flashreadblock(TEMPCTRL_FLASH_ADDRESS, sizeof(tc_settings), &tc_settings)) {
	fputs("CRC fails, loading defaults\n", stdout);
	tempctrl_default_settings();
	if (tempctrl_write_settings())
	    fputs("Failed to write settings\n", stdout);
    }
}

/* Load in the defaults from flash */
static void
tempctrl_default_settings(void) {
    memcpy(&tc_settings, &default_tc_settings, sizeof(tc_settings_t));
}

/* Write the current settings out to SPI flash */
static int
tempctrl_write_settings(void) {
    return flashwriteblock(TEMPCTRL_FLASH_ADDRESS, sizeof(tc_settings), &tc_settings);
}

/* Set the relays to match the desired state */
static void
setstate(char state) {
    uint8_t cool, heat;
    
    switch (state) {
	case 'c':
	    cool = 1;
	    heat = 0;
	    break;

	case 'h':
	    cool = 0;
	    heat = 1;
	    break;

	default:
	    printf("Unknown state %c, setting idle\n", state);
	    /* fallthrough */

	case 'i':
	    cool = 0;
	    heat = 0;
	    break;
    }
    
    if (cool ^ tc_settings.coolinv)
	GPIO_SetBits(char2port(tc_settings.coolport), 1 << tc_settings.coolpin);
    else
	GPIO_ResetBits(char2port(tc_settings.coolport), 1 << tc_settings.coolpin);

    if (heat ^ tc_settings.heatinv)
	GPIO_SetBits(char2port(tc_settings.heatport), 1 << tc_settings.heatpin);
    else
	GPIO_ResetBits(char2port(tc_settings.heatport), 1 << tc_settings.heatpin);
}

/* Handle user command
 *
 */
void
tempctrl_cmd(int argc, char **argv) {
    int16_t	data;
    uint8_t 	ROM[8];
    
    if (argc < 1) {
	printf("Unable to parse tc subcommand\n");
	return;
    }
	
    if (!strcasecmp(argv[0], "help")) {
	printf("tc help         This help\n"
	       "tc save         Save settings to EEPROM\n"
	       "tc load         Load or default settings from EEPROM\n"
	       "tc dflt         Load defaults from flash\n"
	       "tc list         List current settings\n"
	       "tc mode [achin] Change control mode, must be one of\n"
	       "                 a    Auto\n"
	       "                 c    Always cool\n"
	       "                 h    Always heat\n"
	       "                 i    Always idle\n"
	       "                 n    Like idle but don't log anything\n"
	       "tc X Y          Set X to Y where X is one of\n"
	       "                 targ Target temperature\n"
	       "                 hys  Hysteresis range\n"
	       "                 mhov Minimum heat overshoot\n"
	       "                 mcov Minimum cool overshoot\n"
	       "                 mcon Minimum cool on time\n"
	       "                 mcoff        Minimum cool off time\n"
	       "                 mhin Minimum heat on time\n"
	       "                 mhoff        Minimum heat off time\n"
	       "tc A B           Set temperature sensor ID\n"
	       "                 Where A is ferm, frg or amb\n"
	       "                 and B is of the form xx:xx:xx:xx:xx:xx:xx:xx\n"
	       "\n"
	       "                Times are in seconds\n"
	       "                Temperatures are in hundredths of degrees Celcius\n"
	    );
	return;
    }
	
    if (!strcasecmp(argv[0], "save")) {
	if (tempctrl_write_settings())
	    fputs("Failed to write settings\n", stdout);
	return;
    }
    if (!strcasecmp(argv[0], "load")) {
	tempctrl_load_or_init_settings();
	return;
    }
    if (!strcasecmp(argv[0], "dflt")) {
	tempctrl_default_settings();
	return;
    }
    if (!strcasecmp(argv[0], "list")) {
	printf("Fermenter ROM ID %02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x\n"
	       "Fridge ROM ID    %02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x\n"
	       "Ambient ROM ID   %02x:%02x:%02x:%02x:%02x:%02x:%02x:%02x\n"
	       "Mode - %c, Target - %d, Hystersis - %d\n"
	       "Min heat overshoot - %d, Min cool overshoot - %d\n"
	       "Min cool on time - %d, Min cool off time - %d\n"
	       "Min heat on time - %d, Min heat off time - %d\n"
	       "Cool: Port %c Pin %d Inv %d, Heat: Port %c Pin %d Inv %d\n"
	       "Log format: %s\n",
	       tc_settings.fermenter_ROM[0], tc_settings.fermenter_ROM[1], tc_settings.fermenter_ROM[2], tc_settings.fermenter_ROM[3], 	
	       tc_settings.fermenter_ROM[4], tc_settings.fermenter_ROM[5], tc_settings.fermenter_ROM[6], tc_settings.fermenter_ROM[7], 	
	       tc_settings.fridge_ROM[0], tc_settings.fridge_ROM[1], tc_settings.fridge_ROM[2], tc_settings.fridge_ROM[3], 
	       tc_settings.fridge_ROM[4], tc_settings.fridge_ROM[5], tc_settings.fridge_ROM[6], tc_settings.fridge_ROM[7], 
	       tc_settings.ambient_ROM[0], tc_settings.ambient_ROM[1], tc_settings.ambient_ROM[2], tc_settings.ambient_ROM[3], 
	       tc_settings.ambient_ROM[4], tc_settings.ambient_ROM[5], tc_settings.ambient_ROM[6], tc_settings.ambient_ROM[7], 
	       tc_settings.mode, tc_settings.target_temp, tc_settings.hysteresis,
	       tc_settings.minheatovershoot, tc_settings.mincoolovershoot,
	       tc_settings.mincoolontime, tc_settings.minheatontime,
	       tc_settings.minheatontime, tc_settings.minheatofftime,
	       tc_settings.coolport, tc_settings.coolpin, tc_settings.coolinv,
	       tc_settings.heatport, tc_settings.heatpin, tc_settings.heatinv,
	       tc_settings.logfilefmt[0] == '\0' ? "none" : tc_settings.logfilefmt
	    );
	return;
    }
    if (!strcasecmp(argv[0], "mode")) {
	if (argc < 2) {
	    fputs("Incorrect number of arguments\n", stdout);
	    return;
	}
	
	switch (argv[1][0]) {
	    case TC_MODE_AUTO:
	    case TC_MODE_HEAT:
	    case TC_MODE_COOL:
	    case TC_MODE_IDLE:
	    case TC_MODE_NOTHING:
		tc_settings.mode = argv[1][0];
		break;
		    
	    default:
		printf("Unknown mode character '%c'\n", argv[1][0]);
		break;
	}
	return;
    }
    if (!strcasecmp(argv[0], "ferm") ||
	!strcasecmp(argv[0], "frg") ||
	!strcasecmp(argv[0], "amb")) {
	if (argc < 2) {
	    fputs("Incorrect number of arguments\n", stdout);
	    return;
	}
	
	if (sscanf(argv[1], "%hhx:%hhx:%hhx:%hhx:%hhx:%hhx:%hhx:%hhx",
		   &ROM[0], &ROM[1], &ROM[2], &ROM[3],
		   &ROM[4], &ROM[5], &ROM[6], &ROM[7]) != 8) {
	    printf("Unable to parse ROM ID\n");
	} else {
	    if (!strcasecmp(argv[0], "ferm"))
		memcpy(&tc_settings.fermenter_ROM, ROM, sizeof(ROM));
	    if (!strcasecmp(argv[0], "frg"))
		memcpy(&tc_settings.fridge_ROM, ROM, sizeof(ROM));
	    if (!strcasecmp(argv[0], "amb"))
		memcpy(&tc_settings.ambient_ROM, ROM, sizeof(ROM));
	}
	return;
    }
    if (!strcasecmp(argv[0], "log")) {
	if (argc == 1)
	    bzero(tc_settings.logfilefmt, sizeof(tc_settings.logfilefmt));
	else {
	    if (strlen(argv[1]) > sizeof(tc_settings.logfilefmt) - 1)
		printf("New path too log (%d > %d)\n", strlen(argv[1]), sizeof(tc_settings.logfilefmt));
	    else
		strcpy(tc_settings.logfilefmt, argv[1]);
	}
	return;
    }
    
    /* Handle setting the multitude of variables
     * It's last to simplify things */
    if (argc < 3) {
	fputs("Incorrect number of arguments for variable/value\n", stdout);
	return;
    }
    
    if (sscanf(argv[2], "%hd", &data) != 1) {
	printf("Unable to parse value for variable\n");
	return;
    }

    if (!strcasecmp(argv[1], "targ")) {
	tc_settings.target_temp = data;
    } else if (!strcasecmp(argv[1], "hys")) {
	tc_settings.hysteresis = data;
    } else if (!strcasecmp(argv[1], "mhov")) {
	tc_settings.minheatovershoot = data;
    } else if (!strcasecmp(argv[1], "mcov")) {
	tc_settings.mincoolovershoot = data;
    } else if (!strcasecmp(argv[1], "mcon")) {
	tc_settings.mincoolontime = data;
    } else if (!strcasecmp(argv[1], "mcoff")) {
	tc_settings.mincoolofftime = data;
    } else if (!strcasecmp(argv[1], "mhon")) {
	tc_settings.minheatontime = data;
    } else if (!strcasecmp(argv[1], "mhoff")) {
	tc_settings.minheatofftime = data;
    } else {
	printf("Unknown setting\n");
    }
}

static const char*
state2long(char s) {
    switch (s) {
	case 'i':
	    return "idle";
	    break;
	    
	case 'c':
	    return "cool";
	    break;
	    
	case 'h':
	    return "heat";
	    break;
	    
	case '-':
	    return "-";
	    break;
	    
	default:
	    return "unknown";
	    break;
    }
}

/* Convert a port name into a number */
static GPIO_TypeDef *
char2port(char port) {
    char p;
    
    p = toupper(port);
    assert(p >= 'A' && p <= 'E');
    
    switch (p) {
	case 'A':
	    return GPIOA;
	case 'B':
	    return GPIOB;
	case 'C':
	    return GPIOC;
	case 'D':
	    return GPIOD;
	case 'E':
	    return GPIOE;
	default:
	    assert(1 == 0); /* Silence GCC warning */
    }
}