view 1wire.c @ 78:4c1db877452b

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

/*
 * Various 1 wire routines
 * Search routine is copied from the Dallas owpd library with mods
 * available from here http://www.ibutton.com/software/1wire/wirekit.html
 *
 * $Id$
 *
 * Copyright (c) 2004
 *      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.
 */

/* 
 * No user servicable parts inside
 *
 * Modify 1wire-config.h
 */

#include <stdio.h>
#include <stdint.h>
#include "1wire-config.h"
#include "1wire.h"

static uint8_t OW_LastDevice = 0;
static uint8_t OW_LastDiscrepancy = 0;
static uint8_t OW_LastFamilyDiscrepancy = 0;

const PROGMEM char *OWProgROM_Status[] = {
    "OK",
    "no HW support",
    "Invalid params",
    "module missing/broken"
};

/*-----------------------------------------------------------------------------
 * Configure the IO port as we need
 */
void
OWInit(void) {
    OWBUSINIT();
    OWSETBUSHIGH();
}

/*-----------------------------------------------------------------------------
 * Generate a 1-Wire reset, return 0 if presence pulse was found, 1 if it
 * wasn't, or 2 if the line appears to be being held low.
 * 
 * (NOTE: Does not handle alarm presence from DS2404/DS1994)
 *
 * XXX: should use #defines
 */
uint8_t
OWTouchReset(void) {
    uint8_t	i;
    
    OWDELAY_G;

    /* Check the bus isn't being held low (ie it's broken) Do it after
     * the delay so we guarantee we don't see a slave from a previous
     * comms attempt
     */
#if 1
    OWSETREAD();
    if(OWREADBUS() == 0)
	return 2;
#endif

    OWSETBUSLOW();
    OWDELAY_H;
    OWSETBUSHIGH();
    OWDELAY_I;

    OWSETREAD();
    i = OWREADBUS();

    OWDELAY_J;
    return(i);
}

/*-----------------------------------------------------------------------------
 * Send a 1-wire write bit.
 */
void
OWWriteBit(uint8_t bit) {
    OWDELAY_I;
    
    if (bit) {
	OWSETBUSLOW();
	OWDELAY_A;
	OWSETBUSHIGH();
	OWDELAY_B;
    } else {
	OWSETBUSLOW();
	OWDELAY_C;
	OWSETBUSHIGH();
	OWDELAY_D;
    }
}

/*-----------------------------------------------------------------------------
 * Read a bit from the 1-wire bus and return it.
 */
uint8_t
OWReadBit(void) {
    uint8_t	i;
    
    OWDELAY_I;
    
    OWSETBUSLOW();
    OWDELAY_A;
    OWSETBUSHIGH();
    OWDELAY_E;
    OWSETREAD();
    i = OWREADBUS();
    OWDELAY_F;
    return(i);
}

/*-----------------------------------------------------------------------------
 * Write a byte to the 1-wire bus
 */
void
OWWriteByte(uint8_t data) {
    uint8_t i;
    
    /* Send LSB first */
    for (i = 0; i < 8; i++) {
	OWWriteBit(data & 0x01);
	data >>= 1;
    }
}

/*-----------------------------------------------------------------------------
 * Read a byte from the 1-wire bus
 */
uint8_t
OWReadByte(void) {
    int i, result = 0;
    
    for (i = 0; i < 8; i++) {
	result >>= 1;
	if (OWReadBit())
	    result |= 0x80;
    }
    return(result);
}

/*-----------------------------------------------------------------------------
 * Write a 1-wire data byte and return the sampled result.
 */
uint8_t
OWTouchByte(uint8_t data) {
    uint8_t i, result = 0;
    
    for (i = 0; i < 8; i++) {
	result >>= 1;
	
	/* If sending a 1 then read a bit, otherwise write a 0 */
	if (data & 0x01) {
	    if (OWReadBit())
		result |= 0x80;
	} else
	    OWWriteBit(0);
	
	data >>= 1;
    }

    return(result);
}

/*-----------------------------------------------------------------------------
 * Write a block of bytes to the 1-wire bus and return the sampled result in
 * the same buffer
 */
void
OWBlock(uint8_t *data, int len) {
    int i;
    
    for (i = 0; i < len; i++)
	data[i] = OWTouchByte(data[i]);
}


/*-----------------------------------------------------------------------------
 * Send a 1 wire command to a device, or all if no ROM ID provided
 * Returns same values as OWTouchReset
 */
uint8_t
OWSendCmd(uint8_t *ROM, uint8_t cmd) {
    uint8_t	i;

    if ((i = OWTouchReset()) != 0)
	return i;
    
    if (ROM == NULL)
	OWWriteByte(OW_SKIP_ROM_CMD);
    else {
	OWWriteByte(OW_MATCH_ROM_CMD);
	for (i = 0; i < 8; i++)
	    OWWriteByte(ROM[i]);
    }
    OWWriteByte(cmd);

    return 0;
}

/*-----------------------------------------------------------------------------
 * Search algorithm from App note 187 (and 162)
 *
 * OWFirst/OWNext return..
 *         1 when something is found,
 *         0 no more modules
 *	   -1 if no presence pulse,
 *         -2 if bad CRC,
 *         -3 if bad wiring.
 */
uint8_t
OWFirst(uint8_t *ROM, uint8_t do_reset, uint8_t alarm_only) {
    /* Reset state */
    OW_LastDiscrepancy = 0;
    OW_LastDevice = 0;
    OW_LastFamilyDiscrepancy = 0;
    
    /* Go looking */
    return (OWNext(ROM, do_reset, alarm_only));
}

/* Returns 1 when something is found, 0 if nothing left */
uint8_t
OWNext(uint8_t *ROM, uint8_t do_reset, uint8_t alarm_only) {
    uint8_t	bit_test, search_direction, bit_number;
    uint8_t	last_zero, rom_byte_number, rom_byte_mask;
    uint8_t	lastcrc8, crcaccum;
    int8_t	next_result;

    /* Init for search */
    bit_number = 1;
    last_zero = 0;
    rom_byte_number = 0;
    rom_byte_mask = 1;
    next_result = OW_NOMODULES;
    lastcrc8 = 0;
    crcaccum = 0;

    /* if the last call was not the last one */
    if (!OW_LastDevice) {
	/* check if reset first is requested */
	if (do_reset) {
	    /* reset the 1-wire
	     * if there are no parts on 1-wire, return 0 */
	    OWPUTSP(PSTR("Resetting\r\n"));
	    switch (OWTouchReset()) {
		case 0:
		    OWPUTSP(PSTR("Found device(s)\r\n"));
		    break;
		    
		case 1:
		    /* reset the search */
		    OW_LastDiscrepancy = 0;
		    OW_LastFamilyDiscrepancy = 0;
		    OWPUTSP(PSTR("No devices on bus\r\n"));
		    return OW_NOPRESENCE;
		    break;
		
		case 2:
		    /* reset the search */
		    OW_LastDiscrepancy = 0;
		    OW_LastFamilyDiscrepancy = 0;
		    OWPUTSP(PSTR("Bus appears to be being held low\r\n"));
		    return OW_BADWIRE;
		break;
		    
	    }
	}

	/* If finding alarming devices issue a different command */
	if (alarm_only)
	    OWWriteByte(OW_SEARCH_ALRM_CMD);	/* issue the alarming search command */
	else
	    OWWriteByte(OW_SEARCH_ROM_CMD);	/* issue the search command */

	/* pause before beginning the search */
	OWDELAY_I;
	OWDELAY_I;
	OWDELAY_I;
	
	/* loop to do the search */
	do {
	    /* read a bit and its compliment */
	    bit_test = OWReadBit() << 1;
	    bit_test |= OWReadBit();

	    OWPRINTFP(PSTR("bit_test = %d\r\n"), bit_test);

	    /* check for no devices on 1-wire */
	    if (bit_test == 3)
		return(OW_BADWIRE);

	    /* all devices coupled have 0 or 1 */
	    if (bit_test > 0)
		search_direction = !(bit_test & 0x01);  /* bit write value for search */
	    else {
		/* if this discrepancy is before the Last Discrepancy
		 * on a previous OWNext then pick the same as last time */
		if (bit_number < OW_LastDiscrepancy)
		    search_direction = ((ROM[rom_byte_number] & rom_byte_mask) > 0);
		else
		    /* if equal to last pick 1, if not then pick 0 */
		    search_direction = (bit_number == OW_LastDiscrepancy);

		/* if 0 was picked then record its position in LastZero */
		if (search_direction == 0) {
		    last_zero = bit_number;

		    /* check for Last discrepancy in family */
		    if (last_zero < 9)
			OW_LastFamilyDiscrepancy = last_zero;
		}
	    }

	    /* set or clear the bit in the ROM byte rom_byte_number
	     * with mask rom_byte_mask */
	    if (search_direction == 1)
		ROM[rom_byte_number] |= rom_byte_mask;
	    else
		ROM[rom_byte_number] &= ~rom_byte_mask;

	    /* serial number search direction write bit */
	    OWWriteBit(search_direction);

	    /* increment the byte counter bit_number
	     * and shift the mask rom_byte_mask */
	    bit_number++;
	    rom_byte_mask <<= 1;

	    /* if the mask is 0 then go to new ROM byte rom_byte_number
	     * and reset mask */
	    if (rom_byte_mask == 0) {
		OWCRC(ROM[rom_byte_number], &crcaccum);  /* accumulate the CRC */
		lastcrc8 = crcaccum;
		  
		rom_byte_number++;
		rom_byte_mask = 1;
	    }
	} while (rom_byte_number < 8);  /* loop until through all ROM bytes 0-7 */

	/* if the search was successful then */
	if (!(bit_number < 65) || lastcrc8) {
	    if (lastcrc8) {
		OWPRINTFP(PSTR("Bad CRC (%d)\r\n"), lastcrc8);
		next_result = OW_BADCRC;
	    } else {
		/*  search successful so set LastDiscrepancy,LastDevice,next_result */
		OW_LastDiscrepancy = last_zero;
		OW_LastDevice = (OW_LastDiscrepancy == 0);
		OWPRINTFP(PSTR("Last device = %d\r\n"), OW_LastDevice);
		next_result = OW_FOUND;
	    }
	}
    }

    /* if no device found then reset counters so next 'next' will be
     * like a first */
    if (next_result != OW_FOUND || ROM[0] == 0) {
	OW_LastDiscrepancy = 0;
	OW_LastDevice = 0;
	OW_LastFamilyDiscrepancy = 0;
    }

    if (next_result == OW_FOUND && ROM[0] == 0x00)
	next_result = OW_BADWIRE;
   
    return next_result;

}

uint8_t PROGMEM dscrc_table[] = { 
    0, 94, 188, 226, 97, 63, 221, 131, 194, 156, 126, 32, 163, 253, 31, 65,
    157, 195, 33, 127, 252, 162, 64, 30, 95, 1, 227, 189, 62, 96, 130, 220,
    35, 125, 159, 193, 66, 28, 254, 160, 225, 191, 93, 3, 128, 222, 60, 98,
    190, 224, 2, 92, 223, 129, 99, 61, 124, 34, 192, 158, 29, 67, 161, 255,
    70, 24, 250, 164, 39, 121, 155, 197, 132, 218, 56, 102, 229, 187, 89, 7,
    219, 133,103, 57, 186, 228, 6, 88, 25, 71, 165, 251, 120, 38, 196, 154,
    101, 59, 217, 135, 4, 90, 184, 230, 167, 249, 27, 69, 198, 152, 122, 36,
    248, 166, 68, 26, 153, 199, 37, 123, 58, 100, 134, 216, 91, 5, 231, 185,
    140,210, 48, 110, 237, 179, 81, 15, 78, 16, 242,  172, 47, 113,147, 205,
    17, 79, 173, 243, 112, 46, 204, 146, 211,141, 111, 49, 178, 236, 14, 80,
    175, 241, 19, 77, 206, 144, 114, 44, 109, 51, 209, 143, 12, 82,176, 238,
    50, 108, 142, 208, 83, 13, 239, 177, 240, 174, 76, 18, 145, 207, 45, 115,
    202, 148, 118, 40, 171, 245, 23, 73, 8, 86, 180, 234, 105, 55, 213, 139,
    87, 9, 235, 181, 54, 104, 138, 212, 149, 203, 41, 119, 244, 170, 72, 22,
    233, 183, 85, 11, 136, 214, 52, 106, 43, 117, 151, 201, 74, 20, 246, 168,
    116, 42, 200, 150, 21, 75, 169, 247, 182, 232, 10, 84, 215, 137, 107, 53
};

/*-----------------------------------------------------------------------------
 * Update *crc based on the value of x
 */
void
OWCRC(uint8_t x, uint8_t *crc) {
    *crc = pgm_read_byte(&dscrc_table[(*crc) ^ x]);
}

/*-----------------------------------------------------------------------------
 * Program a DS2502's memory
 *
 * Arguments
 * ROM - ROM ID (or NULL to send SKIP_ROM)
 * start  - Start address (bytes)
 * len    - Length of data to write
 * data   - Data to write
 * exact  - If true, only accept exact matches for programming,
 *          otherwise only ensure the bits we requested were 
 *          programmed [to 0]
 * status - If true program status rather than memory
 *
 * Returns..
 *  0 if all is OK
 *  1 if the programming is not possible
 *  2 if the parameters were invalid
 *  3 if the DS2502 didn't respond appropriately (also happens if the
 *  module doesn't exist)
 */
#if defined(OWSETVPPON) && defined(OWSETVPPOFF)
uint8_t
OWProgROM(uint8_t *ROM, uint8_t start, uint8_t len, uint8_t *data, uint8_t exact, uint8_t status) {
    uint8_t	crc, i, tmp;
    
    /* Stupid programmer detection */
    if (status) {
	if (start + len > 3)
	    return(2);
    } else {
	if (start  + len > 127)
	    return(2);
    }
    
    if (len < 1)
	return(2);
    
    OWDELAY_I;
    if (OWTouchReset() != 0) {
	cons_putsP(PSTR("No presence pulse\r\n"));
	return(3);
    }
    
    crc = 0;
    
    /* Send the command */
    if (status) {
	OWSendCmd(ROM, OW_WRITE_STATUS);
	OWCRC(OW_WRITE_STATUS, &crc);
    } else {
	OWSendCmd(ROM, OW_WRITE_MEMORY);
	OWCRC(OW_WRITE_MEMORY, &crc);
    }
    
    /* And the start address
     * (2 bytes even though one would do)
     */
    OWWriteByte(start);
    OWCRC(start, &crc);

    OWWriteByte(0x00);
    OWCRC(0x00, &crc);

    for (i = 0; i < len; i++) {
	cons_putsP(PSTR("Programming "));
	cons_puts_hex(data[i]);
	cons_putsP(PSTR(" to "));
	cons_puts_hex(start + i);
	cons_putsP(PSTR("\r\n"));

	OWWriteByte(data[i]);
	OWCRC(data[i], &crc);
    
	tmp = OWReadByte();
	
	if (crc != tmp) {
	    cons_putsP(PSTR("CRC mismatch "));
	    cons_puts_hex(crc);
	    cons_putsP(PSTR(" vs "));
	    cons_puts_hex(tmp);
	    cons_putsP(PSTR("\r\n"));

	    OWTouchReset();
	    return(3);
	}
	
	OWSETVPPON();
	OWDELAY_H;
	OWSETVPPOFF();

	tmp = OWReadByte();

	/* Check the bits we turned off are off */
/*
        for (i = 0; i < 8; i++)
	    if (!(data[i] & 1 << i) && (tmp & 1 << i))
	        return(-3);
*/
	if ((!data[i] & tmp) != 0) {
	    cons_putsP(PSTR("Readback mismatch "));
	    cons_puts_hex(data[i]);
	    cons_putsP(PSTR(" vs "));
	    cons_puts_hex(data[i]);
	    cons_putsP(PSTR("\r\n"));
	    
	    OWTouchReset();
	    return(3);
	}
	
	/* The DS2502 loads it's CRC register with the address of the
	 * next byte */
	crc = 0;
	OWCRC(start + i + 1, &crc);
    }

    return(0);
}
#else
uint8_t
OWProgROM(uint8_t *ROM __attribute((unused)), uint8_t start __attribute((unused)), uint8_t len __attribute((unused)), uint8_t *data __attribute((unused)), uint8_t exact __attribute((unused)), uint8_t status __attribute((unused))) {
    return(1);
}
#endif

/* 
 * OWGetTemp
 *
 * Get the temperature from a 1wire bus module
 *
 * Returns temperature in hundredths of a degree or OW_TEMP_xxx on
 * error.
 */
int16_t
OWGetTemp(uint8_t *ROM) {
    int8_t	i;
    uint8_t	crc, buf[9];
    int16_t	temp;
    int16_t	tfrac;
    
    if (ROM[0] != OW_FAMILY_TEMP)
	return OW_TEMP_WRONG_FAM;
    
    switch (OWSendCmd(ROM, OW_CONVERTT_CMD)) {
	case 0:
	    break;
	    
	case 1:
	case 2:
	    return OW_TEMP_NO_ROM;
    }

    i = 0;

    /* Wait for the conversion */
    while (OWReadBit() == 0)
	i = 1;

    /* Check that we talked to a module and it did something  */
    if (i == 0) {
	return OW_TEMP_NO_ROM;
    }
    
    OWSendCmd(ROM, OW_RD_SCR_CMD);
    crc = 0;
    for (i = 0; i < 8; i++) {
	buf[i] = OWReadByte();
	OWCRC(buf[i], &crc);
    }
    buf[i] = OWReadByte();
    if (crc != buf[8])
	return OW_TEMP_CRC_ERR;
    temp = buf[0];
    if (buf[1] & 0x80)
	temp -= 256;

    /* Chop off 0.5 degree bit */
    temp >>= 1;

    /* Calulate the fractional remainder */
    tfrac = buf[7] - buf[6];

    /* Work in 100'th of degreess to save on floats */
    tfrac *= (int16_t)100;

    /* Divide by count */
    tfrac /= buf[7];

    /* Subtract 0.25 deg from temp */
    tfrac += 75;
    if (tfrac < 100)
	temp--;
    else
	tfrac -= 100;

    i = temp;
    temp *= 100;
    temp += tfrac;

    return(temp);
}

/*
 * OWTempStatusStr
 *
 * Return a string for each OW_TEMP_xxx error code
 *
 * shrt = 1 returns short strings
 *
 */
const char *
OWTempStatusStr(int16_t val, uint8_t shrt) {
    if (val > OW_TEMP_BADVAL) {
        if (shrt)
            return PSTR("OK");
        else
            return PSTR("OK");
    }

    switch (val) {
        case OW_TEMP_WRONG_FAM:
            if (shrt)
                return PSTR("WrFam");
            else
                return PSTR("Wrong family");
            break;
        case OW_TEMP_CRC_ERR:
            if (shrt)
                return PSTR("CRCErr");
            else
                return PSTR("CRC Error");
            break;
        case OW_TEMP_NO_ROM:
            if (shrt)
                return PSTR("NoROM");
            else
                return PSTR("ROM did not reply");
            break;
        default:
            if (shrt)
                return PSTR("???");
            else
                return PSTR("Unknown error code");
            break;
    }
}