Subversion Repositories openrisc_2011-10-31

// ----------------------------------------------------------------------------
 
// 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