hps/dev.h

// Copyright 2021 The Chromium OS Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

/*
 * Device access interface.
 */
#ifndef HPS_DEV_H_
#define HPS_DEV_H_

#include <cstddef>
#include <cstdint>

namespace hps {

class DevInterface {
 public:
  virtual ~DevInterface() {}
  /*
   * Returns true on successful read, false on error.
   * In the event of an error, the contents may have been modified.
   */
  virtual bool Read(uint8_t cmd, uint8_t* data, size_t len) = 0;
  /*
   * Write the data to the device.
   * Returns true on successful write, false on error.
   */
  virtual bool Write(uint8_t cmd, const uint8_t* data, size_t len) = 0;
  /*
   * Read 1 register.
   * Returns value read, or -1 for error.
   */
  int ReadReg(int r);
  /*
   * Write 1 register.
   * Returns false on failure.
   */
  bool WriteReg(int r, uint16_t data);
  /*
   * Return the maximum download block size (in bytes).
   * This value is the actual data to be written, not including the
   * write command byte or the 4 byte address header.
   */
  virtual size_t BlockSizeBytes();
};

}  // namespace hps

#endif  // HPS_DEV_H_