device.hh revision 10800
111666Stushar@ece.gatech.edu/* 211666Stushar@ece.gatech.edu * Copyright (c) 2012 ARM Limited 311666Stushar@ece.gatech.edu * All rights reserved 411666Stushar@ece.gatech.edu * 511666Stushar@ece.gatech.edu * The license below extends only to copyright in the software and shall 611666Stushar@ece.gatech.edu * not be construed as granting a license to any other intellectual 711666Stushar@ece.gatech.edu * property including but not limited to intellectual property relating 811666Stushar@ece.gatech.edu * to a hardware implementation of the functionality of the software 911666Stushar@ece.gatech.edu * licensed hereunder. You may use the software subject to the license 1011666Stushar@ece.gatech.edu * terms below provided that you ensure that this notice is replicated 1111666Stushar@ece.gatech.edu * unmodified and in its entirety in all distributions of the software, 1211666Stushar@ece.gatech.edu * modified or unmodified, in source code or in binary form. 1311666Stushar@ece.gatech.edu * 1411666Stushar@ece.gatech.edu * Redistribution and use in source and binary forms, with or without 1511666Stushar@ece.gatech.edu * modification, are permitted provided that the following conditions are 1611666Stushar@ece.gatech.edu * met: redistributions of source code must retain the above copyright 1711666Stushar@ece.gatech.edu * notice, this list of conditions and the following disclaimer; 1811666Stushar@ece.gatech.edu * redistributions in binary form must reproduce the above copyright 1911666Stushar@ece.gatech.edu * notice, this list of conditions and the following disclaimer in the 2011666Stushar@ece.gatech.edu * documentation and/or other materials provided with the distribution; 2111666Stushar@ece.gatech.edu * neither the name of the copyright holders nor the names of its 2211666Stushar@ece.gatech.edu * contributors may be used to endorse or promote products derived from 2311666Stushar@ece.gatech.edu * this software without specific prior written permission. 2411666Stushar@ece.gatech.edu * 2511666Stushar@ece.gatech.edu * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2611666Stushar@ece.gatech.edu * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 2711666Stushar@ece.gatech.edu * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 2811666Stushar@ece.gatech.edu * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 2911666Stushar@ece.gatech.edu * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 3011666Stushar@ece.gatech.edu * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 3111666Stushar@ece.gatech.edu * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 3211666Stushar@ece.gatech.edu * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 3311666Stushar@ece.gatech.edu * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 3412492Sodanrc@yahoo.com.br * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 3512492Sodanrc@yahoo.com.br * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.* 3611666Stushar@ece.gatech.edu * 3711666Stushar@ece.gatech.edu * Authors: Peter Enns 3811666Stushar@ece.gatech.edu */ 3911666Stushar@ece.gatech.edu 4011666Stushar@ece.gatech.edu 4111666Stushar@ece.gatech.edu/** @file 4211666Stushar@ece.gatech.edu * All i2c devices should derive from this class. 4311666Stushar@ece.gatech.edu */ 4411666Stushar@ece.gatech.edu 4511666Stushar@ece.gatech.edu#ifndef __DEV_I2CDEV__ 4611666Stushar@ece.gatech.edu#define __DEV_I2CDEV__ 4712492Sodanrc@yahoo.com.br 48#include "base/types.hh" 49#include "params/I2CDevice.hh" 50#include "sim/sim_object.hh" 51 52class I2CDevice : public SimObject 53{ 54 55 protected: 56 57 uint8_t _addr; 58 59 public: 60 61 I2CDevice(const I2CDeviceParams* p) 62 : SimObject(p), _addr(p->i2c_addr) 63 { } 64 65 virtual ~I2CDevice() { } 66 67 /** 68 * Return the next message that the device expects to send. This 69 * will likely have side effects (e.g., incrementing a register 70 * pointer). 71 * 72 * @return 8-bit message the device has been set up to send 73 */ 74 virtual uint8_t read() = 0; 75 76 /** 77 * Perform any actions triggered by an i2c write (save msg in a 78 * register, perform an interrupt, update a register pointer or 79 * command register, etc...) 80 * 81 * @param msg 8-bit message from master 82 */ 83 virtual void write(uint8_t msg) = 0; 84 85 /** 86 * Perform any initialization necessary for the device when it 87 * received a start signal from the bus master (devices frequently 88 * expect the first write to be a register address) 89 */ 90 virtual void i2cStart() = 0; 91 92 uint8_t i2cAddr() const { return _addr; } 93 94}; 95 96#endif // __DEV_I2CDEV__ 97