Colony

/**

 * Copyright (c) 2007 Colony Project

 * Permission is hereby granted, free of charge, to any person

 * obtaining a copy of this software and associated documentation

 * files (the "Software"), to deal in the Software without

 * copies of the Software, and to permit persons to whom the

 * Software is furnished to do so, subject to the following

 * conditions:

 * The above copyright notice and this permission notice shall be

 * included in all copies or substantial portions of the Software.

 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES

 * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

/**

 * @file i2c.c

 * @brief Implemenation of I2C communications protocol

 * In the case where you have master sends and then a master request to the same

 * address, you will not give up control of the line because the send and

 * request addresses are seen as different addresses. In between it will send a

#include "ring_buffer.h"

/**

 *

 * @brief Provides Inter-Interconnected-Communications (I2C)

 * Interface (TWI) module. Any Atmel chip with this hardware should be able to

 * use the software.

 *

 * This code will operate in a multi-master enviornment and can be either a

 * slave or a master at any time (as long as they are not one or the other at

 * the buffer size. The buffer is implemented as a ring buffer.

 *

 * It is implemented using callback functions. Whenever you want to send a packet

 * so you must either buffer the inputs or handle each one separately.

 *

 * On errors we will simply flush the entire buffer.

 * For information on how I2C operates, read the wikipedia article

 * http://en.wikipedia.org/wiki/I2c

 * for a good explanation of how it works.

 * @{

 */

 * @brief Set bit rate 12 = 100kbit/s (max speed setting is 10 for an

 *  8 MHz clock). It is a divider, so the lower the number the faster the speed.

 */

    RING_BUFFER_CLEAR(i2c_write_buff);

    RING_BUFFER_CLEAR(i2c_addr_buff);

    /* enables twi interrupt, automatic ack sending, and all twi hardware */

    TWCR =  (_BV(TWEA) | _BV(TWEN) | _BV(TWIE));

    /* sets the address (it is stored in the 7 most significant bits) and allows

     * global messages to be accepted */

    TWAR = (addr << 1) | 1;

    return 0;

}

        RING_BUFFER_ADD(i2c_write_buff, data[i]);

        RING_BUFFER_ADD(i2c_addr_buff, dest << 1);

    }

    /* re-enable the interrupts */

    sei();

    /* send the start bit, only if this device is not currently master */

    if(!start_flag) {

        start_flag = 1;

        TWCR |= _BV(TWSTA);

        TWCR |= _BV(TWINT);

    }

    return 0;

}

/**

 * @brief Send a master request to the destination

 *

 * @param dest		The destination that we want to receive information from.

 *

 * @return 0 for success, nonzero for failure

int i2c_request(char dest) {

    if(RING_BUFFER_FULL(i2c_write_buff))

        return -1;

    RING_BUFFER_ADD(i2c_write_buff, 0);

    RING_BUFFER_ADD(i2c_addr_buff, (dest << 1) | 1);

    if(!start_flag) {

        start_flag = 1;

        TWCR |= _BV(TWSTA);

        TWCR |= _BV(TWINT);

    }

    return 0;

}

/** @} **/

/**

 * @brief Interrupt to handle I2C interrupts from the I2C hardware.

 * Uses the status codes from the I2C register to handle the events

 * needed to advance in I2C stages. For instance, you will get a bit for

 * receiving a start ack, then a address ack, then a data ack, etc.

 * of what modes the send is in.

 *

 * Errors are handled here as well.

ISR(TWI_vect) {

	static char data_to_send;

	static char addr_to_send = -1;

	char addr, statusCode;

	//Get status code (only upper 5 bits)

	statusCode = (TWSR & 0xF8);

             * ring_buffer will not be empty */

            RING_BUFFER_REMOVE(i2c_addr_buff, addr_to_send);

            RING_BUFFER_REMOVE(i2c_write_buff, data_to_send);

            /* first send the address */

            //Turn off start bits

            TWCR &= ~_BV(TWSTA);

            break;

            TWDR = data_to_send;

            PORTG &= ~_BV(PG2);

            break;

        //Master Transmit - Data sent succesfully

            //If there is still data to send

            if(!RING_BUFFER_EMPTY(i2c_write_buff)) {

                RING_BUFFER_PEEK(i2c_addr_buff, addr);

                //Still data for this address

                if (addr == addr_to_send) {

                    RING_BUFFER_REMOVE(i2c_addr_buff, addr);

            /* there are no bytes to send */

            TWCR |= _BV(TWSTO);

            start_flag = 0;

        //Master Transmit - Slave sends a nack, transmit is done

        case TW_MT_DATA_NACK:

            PORTG |= _BV(PG2);

            TWCR |= _BV(TWSTO);

            start_flag = 0;

            break;

        //Master Receive - Address sent succesfully

        case TW_MR_SLA_ACK:

            PORTG |= _BV(PG2);

            break;

        //Master Receive - Data received succesfully

        case TW_MR_DATA_ACK:

            if(master_recv_function) {

                }

            }

            break;

        case TW_MR_DATA_NACK:

            TWCR |= _BV(TWEA);

            //If there is still data to send

            if(!RING_BUFFER_EMPTY(i2c_write_buff)) {

                TWCR |= _BV(TWSTA);

                break;

            }

            /* there are no bytes to send */

            TWCR |= _BV(TWSTO);

            break;

        //Slave Transmit - Address received

        case TW_ST_SLA_ACK:

            break;

        //Slave Transmit - Nack received, no data requsted

        case TW_ST_DATA_NACK:

            break;

        //Slave Transmit - Data requested, ack received

        case TW_ST_DATA_ACK:

            if (slave_send_function) {

                TWDR = slave_send_function();

            }

            break;

        case TW_SR_SLA_ACK:

            break;

        //Slave Receive - Data received, ack returned

        case TW_SR_DATA_ACK:

            if(slave_recv_function) {

                slave_recv_function(TWDR);

            }

            break;

        case TW_SR_STOP:

            break;

        //Problem on the bus, reset everything

        default:

            TWCR |= _BV(TWSTO);

            start_flag = 0;

            RING_BUFFER_CLEAR(i2c_write_buff);

    }

  /* Toggle TWINT so that it resets and executes the commands */

  TWCR |= _BV(TWINT);

}