83 lines
3.3 KiB
C++
83 lines
3.3 KiB
C++
/* IMPORTANT:
|
|
* The following preprocessing flags are added to
|
|
* avoid compilation error when this headers are included in more than 1 times
|
|
*/
|
|
#ifndef DEVICE_PORT_H
|
|
#define DEVICE_PORT_H
|
|
|
|
#include <string>
|
|
|
|
/* A basic port */
|
|
class BasicPort {
|
|
public: /* Constructors */
|
|
BasicPort();
|
|
BasicPort(const char* name, const size_t& lsb, const size_t& msb);
|
|
BasicPort(const char* name, const size_t& width);
|
|
BasicPort(const std::string& name, const size_t& lsb, const size_t& msb);
|
|
BasicPort(const std::string& name, const size_t& width);
|
|
BasicPort(const BasicPort& basic_port); /* Copy constructor */
|
|
public: /* Accessors */
|
|
size_t get_width() const; /* get the port width */
|
|
size_t get_msb() const; /* get the LSB */
|
|
size_t get_lsb() const; /* get the LSB */
|
|
std::string get_name() const; /* get the name */
|
|
bool is_valid() const; /* check if port size is valid > 0 */
|
|
public: /* Mutators */
|
|
void set(const BasicPort& basic_port); /* copy */
|
|
void set_name(const std::string& name); /* set the port LSB and MSB */
|
|
void set_width(const size_t& width); /* set the port LSB and MSB */
|
|
void set_width(const size_t& lsb, const size_t& msb); /* set the port LSB and MSB */
|
|
void set_lsb(const size_t& lsb);
|
|
void set_msb(const size_t& msb);
|
|
void expand(const size_t& width); /* Increase the port width */
|
|
void revert(); /* Swap lsb and msb */
|
|
bool rotate(const size_t& offset); /* rotate */
|
|
bool counter_rotate(const size_t& offset); /* counter rotate */
|
|
void reset(); /* Reset to initial port */
|
|
void combine(const BasicPort& port); /* Combine two ports */
|
|
private: /* internal functions */
|
|
void make_invalid(); /* Make a port invalid */
|
|
private: /* Internal Data */
|
|
std::string name_; /* Name of this port */
|
|
size_t msb_; /* Most Significant Bit of this port */
|
|
size_t lsb_; /* Least Significant Bit of this port */
|
|
};
|
|
|
|
/* Configuration ports:
|
|
* 1. reserved configuration port, which is used by RRAM FPGA architecture
|
|
* 2. regular configuration port, which is used by any FPGA architecture
|
|
*/
|
|
class ConfPorts {
|
|
public: /* Constructors */
|
|
ConfPorts(); /* default port */
|
|
ConfPorts(const ConfPorts& conf_ports); /* copy */
|
|
public: /* Accessors */
|
|
size_t get_reserved_port_width() const;
|
|
size_t get_reserved_port_lsb() const;
|
|
size_t get_reserved_port_msb() const;
|
|
size_t get_regular_port_width() const;
|
|
size_t get_regular_port_lsb() const;
|
|
size_t get_regular_port_msb() const;
|
|
public: /* Mutators */
|
|
void set(const ConfPorts& conf_ports);
|
|
void set_reserved_port(size_t width);
|
|
void set_regular_port(size_t width);
|
|
void set_regular_port(size_t lsb, size_t msb);
|
|
void set_regular_port_lsb(size_t lsb);
|
|
void set_regular_port_msb(size_t msb);
|
|
void expand_reserved_port(size_t width); /* Increase the port width of reserved port */
|
|
void expand_regular_port(size_t width); /* Increase the port width of regular port */
|
|
void expand(size_t width); /* Increase the port width of both ports */
|
|
bool rotate_regular_port(size_t offset); /* rotate */
|
|
bool counter_rotate_regular_port(size_t offset); /* counter rotate */
|
|
void reset(); /* Reset to initial port */
|
|
private: /* Internal Data */
|
|
BasicPort reserved_;
|
|
BasicPort regular_;
|
|
};
|
|
|
|
/* TODO: create a class for BL and WL ports */
|
|
|
|
#endif
|
|
|