Subversion Repositories openrisc

// ----------------------------------------------------------------------------
 
// Remote Serial Protocol connection: definition
 
// Copyright (C) 2008  Embecosm Limited <info@embecosm.com>
 
// Contributor Jeremy Bennett <jeremy.bennett@embecosm.com>
 
// This file is part of the cycle accurate model of the OpenRISC 1000 based
// system-on-chip, ORPSoC, built using Verilator.
 
// This program is free software: you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation, either version 3 of the License, or (at your
// option) any later version.
 
// This program is distributed in the hope that it will be useful, but WITHOUT
// ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
// FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
// License for more details.
 
// You should have received a copy of the GNU Lesser General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
// ----------------------------------------------------------------------------
 
// $Id: RspConnection.h 326 2009-03-07 16:47:31Z jeremy $
 
#ifndef RSP_CONNECTION__H
#define RSP_CONNECTION__H
 
#include "RspPacket.h"
 
//! The default service to use if port number = 0 and no service specified
#define DEFAULT_RSP_SERVICE  "or1ksim-rsp"
 
//-----------------------------------------------------------------------------
//! Class implementing the RSP connection listener
 
//! RSP requests received from TCP/IP are queued on the output FIFO for
//! processing by the GDB server. Packets read from the input FIFO from the
//! GDB server are sent back via TCP/IP.
 
//! The packets are received serially, ie. a new packet is not sent until the
//! previous ones have been dealt with. Some packets need no reply, so they
//! will be sent one after the other. But for packets that need a reply (which
//! may be one or several packets), new packets are not sent until the reply
//! from the previous one is received.
 
//! The upshot of this is that we can avoid any risk of deadlock by always
//! giving priority to any outgoing reply packets.
 
//! Two threads are used, one to listen for TCP/IP connections from the
//! client, the other to look for FIFO packets from the GDB server to write
//! back to the client. Both must be non-blocking in the SystemC sense
//! (i.e. allow other SystemC threads to run).
//-----------------------------------------------------------------------------
class RspConnection {
public:
 
	// Constructors and destructor
	RspConnection(int _portNum);
	 RspConnection(const char *_serviceName = DEFAULT_RSP_SERVICE);
	~RspConnection();
 
	// Public interface: manage client connections
	bool rspConnect();
	void rspClose();
	bool isConnected();
	char rspSocketPeek();
 
	// Public interface: get packets from the stream and put them out
	bool getPkt(RspPacket * pkt);
	bool putPkt(RspPacket * pkt);
 
	int getRspChar();
 
private:
 
	// Generic initializer
	void rspInit(int _portNum, const char *_serviceName);
 
	// Internal routines to handle individual chars  
	bool putRspChar(char c);
	//int   getRspChar ();
 
	//! The port number to listen on
	int portNum;
 
	//! The service name to listen on
	const char *serviceName;
 
	//! The client file descriptor
	int clientFd;
 
};				// RspConnection ()
 
#endif // RSP_CONNECTION__H