serial.cc revision 12334
112239Sandreas.sandberg@arm.com/* 212239Sandreas.sandberg@arm.com * Copyright (c) 2014, 2017 ARM Limited 312239Sandreas.sandberg@arm.com * All rights reserved 412239Sandreas.sandberg@arm.com * 512239Sandreas.sandberg@arm.com * The license below extends only to copyright in the software and shall 612239Sandreas.sandberg@arm.com * not be construed as granting a license to any other intellectual 712239Sandreas.sandberg@arm.com * property including but not limited to intellectual property relating 812239Sandreas.sandberg@arm.com * to a hardware implementation of the functionality of the software 912239Sandreas.sandberg@arm.com * licensed hereunder. You may use the software subject to the license 1012239Sandreas.sandberg@arm.com * terms below provided that you ensure that this notice is replicated 1112239Sandreas.sandberg@arm.com * unmodified and in its entirety in all distributions of the software, 1212239Sandreas.sandberg@arm.com * modified or unmodified, in source code or in binary form. 1312239Sandreas.sandberg@arm.com * 1412239Sandreas.sandberg@arm.com * Redistribution and use in source and binary forms, with or without 1512239Sandreas.sandberg@arm.com * modification, are permitted provided that the following conditions are 1612239Sandreas.sandberg@arm.com * met: redistributions of source code must retain the above copyright 1712239Sandreas.sandberg@arm.com * notice, this list of conditions and the following disclaimer; 1812239Sandreas.sandberg@arm.com * redistributions in binary form must reproduce the above copyright 1912239Sandreas.sandberg@arm.com * notice, this list of conditions and the following disclaimer in the 2012239Sandreas.sandberg@arm.com * documentation and/or other materials provided with the distribution; 2112239Sandreas.sandberg@arm.com * neither the name of the copyright holders nor the names of its 2212239Sandreas.sandberg@arm.com * contributors may be used to endorse or promote products derived from 2312239Sandreas.sandberg@arm.com * this software without specific prior written permission. 2412239Sandreas.sandberg@arm.com * 2512239Sandreas.sandberg@arm.com * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 2612239Sandreas.sandberg@arm.com * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 2712239Sandreas.sandberg@arm.com * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 2812239Sandreas.sandberg@arm.com * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 2912239Sandreas.sandberg@arm.com * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 3012239Sandreas.sandberg@arm.com * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 3112239Sandreas.sandberg@arm.com * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 3212239Sandreas.sandberg@arm.com * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 3312239Sandreas.sandberg@arm.com * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 3412239Sandreas.sandberg@arm.com * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 3512239Sandreas.sandberg@arm.com * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 3612239Sandreas.sandberg@arm.com * 3712239Sandreas.sandberg@arm.com * Authors: Andreas Sandberg 3812239Sandreas.sandberg@arm.com */ 3912239Sandreas.sandberg@arm.com 4012239Sandreas.sandberg@arm.com#include "dev/serial/serial.hh" 4112239Sandreas.sandberg@arm.com 4212334Sgabeblack@google.com#include "base/logging.hh" 4312239Sandreas.sandberg@arm.com#include "params/SerialDevice.hh" 4412239Sandreas.sandberg@arm.com#include "params/SerialNullDevice.hh" 4512239Sandreas.sandberg@arm.com 4612239Sandreas.sandberg@arm.comSerialDevice::SerialDevice(const SerialDeviceParams *p) 4712239Sandreas.sandberg@arm.com : SimObject(p), interfaceCallback(nullptr) 4812239Sandreas.sandberg@arm.com{ 4912239Sandreas.sandberg@arm.com} 5012239Sandreas.sandberg@arm.com 5112239Sandreas.sandberg@arm.comSerialDevice::~SerialDevice() 5212239Sandreas.sandberg@arm.com{ 5312239Sandreas.sandberg@arm.com} 5412239Sandreas.sandberg@arm.com 5512239Sandreas.sandberg@arm.comvoid 5612239Sandreas.sandberg@arm.comSerialDevice::regInterfaceCallback(Callback *c) 5712239Sandreas.sandberg@arm.com{ 5812239Sandreas.sandberg@arm.com // This can happen if the user has connected multiple UARTs to the 5912239Sandreas.sandberg@arm.com // same terminal. In that case, each of them tries to register 6012239Sandreas.sandberg@arm.com // callbacks. 6112239Sandreas.sandberg@arm.com if (interfaceCallback) 6212239Sandreas.sandberg@arm.com fatal("A UART has already been associated with this device.\n"); 6312239Sandreas.sandberg@arm.com interfaceCallback = c; 6412239Sandreas.sandberg@arm.com} 6512239Sandreas.sandberg@arm.com 6612239Sandreas.sandberg@arm.comvoid 6712239Sandreas.sandberg@arm.comSerialDevice::notifyInterface() 6812239Sandreas.sandberg@arm.com{ 6912239Sandreas.sandberg@arm.com assert(dataAvailable()); 7012239Sandreas.sandberg@arm.com // Registering a callback is optional. 7112239Sandreas.sandberg@arm.com if (interfaceCallback) 7212239Sandreas.sandberg@arm.com interfaceCallback->process(); 7312239Sandreas.sandberg@arm.com} 7412239Sandreas.sandberg@arm.com 7512239Sandreas.sandberg@arm.com 7612239Sandreas.sandberg@arm.com 7712239Sandreas.sandberg@arm.com 7812239Sandreas.sandberg@arm.comSerialNullDevice::SerialNullDevice(const SerialNullDeviceParams *p) 7912239Sandreas.sandberg@arm.com : SerialDevice(p) 8012239Sandreas.sandberg@arm.com{ 8112239Sandreas.sandberg@arm.com} 8212239Sandreas.sandberg@arm.com 8312239Sandreas.sandberg@arm.comuint8_t 8412239Sandreas.sandberg@arm.comSerialNullDevice::readData() 8512239Sandreas.sandberg@arm.com{ 8612239Sandreas.sandberg@arm.com panic("SerialNullDevice does not have pending data.\n"); 8712239Sandreas.sandberg@arm.com} 8812239Sandreas.sandberg@arm.com 8912239Sandreas.sandberg@arm.com 9012239Sandreas.sandberg@arm.com 9112239Sandreas.sandberg@arm.comSerialNullDevice * 9212239Sandreas.sandberg@arm.comSerialNullDeviceParams::create() 9312239Sandreas.sandberg@arm.com{ 9412239Sandreas.sandberg@arm.com return new SerialNullDevice(this); 9512239Sandreas.sandberg@arm.com} 96