Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 1 | #pragma once |
| 2 | |
| 3 | #include <hei_includes.hpp> |
| 4 | |
| 5 | namespace libhei |
| 6 | { |
| 7 | |
| 8 | /** |
| 9 | * @brief A signature represents an active attention from a single bit on a |
| 10 | * register within a chip. |
| 11 | * |
| 12 | * The isolator will gather a list of all active attentions on a chip and return |
| 13 | * a list of signatures to the user application. The user application should be |
| 14 | * able to determine what actions to take based on these signatures. |
| 15 | */ |
| 16 | class Signature |
| 17 | { |
| 18 | public: // Constructors, destructor, assignment, etc. |
| 19 | |
| 20 | /** |
| 21 | * @brief Constructor from components. |
| 22 | * @param i_chip The chip containing this register. |
| 23 | * @param i_id The register ID. |
| 24 | * @param i_instance The instance of this register. |
| 25 | * @param i_bit The target bit within this register. |
| 26 | * @param i_attnType The attention type reported by this bit. |
| 27 | */ |
Zane Shelley | fe27b65 | 2019-10-28 11:33:07 -0500 | [diff] [blame] | 28 | Signature(const Chip& i_chip, RegisterId_t i_id, |
Zane Shelley | 83da245 | 2019-10-25 15:45:34 -0500 | [diff] [blame] | 29 | RegisterInstance_t i_instance, RegisterBit_t i_bit, |
| 30 | AttentionType_t i_attnType) : |
Zane Shelley | 7f7a42d | 2019-10-28 13:28:31 -0500 | [diff] [blame^] | 31 | iv_chip(i_chip), |
| 32 | iv_id(i_id), iv_instance(i_instance), iv_bit(i_bit), |
| 33 | iv_attnType(i_attnType) |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 34 | {} |
| 35 | |
| 36 | /** @brief Destructor. */ |
| 37 | ~Signature() = default; |
| 38 | |
| 39 | /** @brief Copy constructor. */ |
Zane Shelley | fe27b65 | 2019-10-28 11:33:07 -0500 | [diff] [blame] | 40 | Signature(const Signature&) = default; |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 41 | |
| 42 | /** @brief Assignment operator. */ |
Zane Shelley | fe27b65 | 2019-10-28 11:33:07 -0500 | [diff] [blame] | 43 | Signature& operator=(const Signature&) = default; |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 44 | |
| 45 | private: // Instance variables. |
| 46 | |
| 47 | Chip iv_chip; ///< Chip containing this register. |
| 48 | RegisterId_t iv_id; ///< Register ID. |
| 49 | RegisterInstance_t iv_instance; ///< Instance of this register. |
| 50 | RegisterBit_t iv_bit; ///< Target bit within this register. |
| 51 | AttentionType_t iv_attnType; ///< Attention type reported by this bit. |
| 52 | |
| 53 | public: // Member functions |
| 54 | |
| 55 | /** @return The chip containing this register. */ |
Zane Shelley | 7f7a42d | 2019-10-28 13:28:31 -0500 | [diff] [blame^] | 56 | const Chip& getChip() const |
| 57 | { |
| 58 | return iv_chip; |
| 59 | } |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 60 | |
| 61 | /** @return The register ID. */ |
Zane Shelley | 7f7a42d | 2019-10-28 13:28:31 -0500 | [diff] [blame^] | 62 | RegisterId_t getId() const |
| 63 | { |
| 64 | return iv_id; |
| 65 | } |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 66 | |
| 67 | /** @return The instance of this register. */ |
Zane Shelley | 7f7a42d | 2019-10-28 13:28:31 -0500 | [diff] [blame^] | 68 | RegisterInstance_t getInstance() const |
| 69 | { |
| 70 | return iv_instance; |
| 71 | } |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 72 | |
| 73 | /** @return The target bit within this register. */ |
Zane Shelley | 7f7a42d | 2019-10-28 13:28:31 -0500 | [diff] [blame^] | 74 | RegisterBit_t getBit() const |
| 75 | { |
| 76 | return iv_bit; |
| 77 | } |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 78 | |
| 79 | /** @return The attention type reported by this bit. */ |
Zane Shelley | 7f7a42d | 2019-10-28 13:28:31 -0500 | [diff] [blame^] | 80 | AttentionType_t getAttnType() const |
| 81 | { |
| 82 | return iv_attnType; |
| 83 | } |
Zane Shelley | 93b61ad | 2019-10-16 20:41:03 -0500 | [diff] [blame] | 84 | }; |
| 85 | |
| 86 | } // end namespace libhei |