modbusRequest.hpp

// Modbus for c++ <https://github.com/Mazurel/Modbus>
// Copyright (c) 2020 Mateusz Mazur aka Mazurel
// Licensed under: MIT License <http://opensource.org/licenses/MIT>
 
#pragma once
 
#include <cstdint>
#include <stdexcept>
#include <string>
#include <vector>
 
#include "modbusCell.hpp"
#include "modbusException.hpp"
 
namespace MB {
class ModbusRequest {
  private:
    uint8_t _slaveID;
    utils::MBFunctionCode _functionCode;
 
    uint16_t _address;
    uint16_t _registersNumber;
 
    std::vector<ModbusCell> _values;
 
  public:
    // We do not allow default CTORs: https://github.com/Mazurel/Modbus/issues/6
    ModbusRequest() = delete;
 
    explicit ModbusRequest(const std::vector<uint8_t> &inputData,
                           bool CRC = false) noexcept(false);
 
    /*
     * @description Constructs Request from raw data
     * @params inputData is a vector of bytes that will be interpreted
     * @throws ModbusException
     **/
    static ModbusRequest fromRaw(const std::vector<uint8_t> &inputData) noexcept(false) {
        return ModbusRequest(inputData);
    }
 
    /*
     * @description Constructs Request from raw data and checks it's CRC
     * @params inputData is a vector of bytes that will be interpreted
     * @throws ModbusException
     * @note This methods performs CRC check that may throw ModbusException on
     * invalid CRC
     **/
    static ModbusRequest fromRawCRC(const std::vector<uint8_t> &inputData) {
        return ModbusRequest(inputData, true);
    }
 
    explicit ModbusRequest(
        uint8_t slaveId                    = 0,
        utils::MBFunctionCode functionCode = static_cast<utils::MBFunctionCode>(0),
        uint16_t address = 0, uint16_t registersNumber = 0,
        std::vector<ModbusCell> values = {}) noexcept;
 
    ModbusRequest(const ModbusRequest &) = default;
 
    [[nodiscard]] std::string toString() const noexcept;
    [[nodiscard]] std::vector<uint8_t> toRaw() const noexcept;
 
    [[nodiscard]] utils::MBFunctionType functionType() const noexcept {
        return utils::functionType(_functionCode);
    }
    [[nodiscard]] utils::MBFunctionRegisters functionRegisters() const noexcept {
        return utils::functionRegister(_functionCode);
    }
 
    [[nodiscard]] uint8_t slaveID() const { return _slaveID; }
    [[nodiscard]] utils::MBFunctionCode functionCode() const { return _functionCode; }
    [[nodiscard]] uint16_t registerAddress() const { return _address; }
    [[nodiscard]] uint16_t numberOfRegisters() const { return _registersNumber; }
    [[nodiscard]] const std::vector<ModbusCell> &registerValues() const {
        return _values;
    }
 
    void setSlaveId(uint8_t slaveId) { _slaveID = slaveId; }
    void setFunctionCode(utils::MBFunctionCode functionCode) {
        _functionCode = functionCode;
    }
    void setAddress(uint16_t address) { _address = address; }
    void setRegistersNumber(uint16_t registersNumber) {
        _registersNumber = registersNumber;
        _values.resize(registersNumber);
    }
    void setValues(const std::vector<ModbusCell> &values) { _values = values; }
};
} // namespace MB