GY-63_MS5611/libraries/SHEX/SHEX.h

#pragma once
//
//    FILE: SHEX.h
//  AUTHOR: Rob Tillaart
// VERSION: 0.3.0
// PURPOSE: Arduino library to generate hex dump over Serial
//    DATE: 2020-05-24
//     URL: https://github.com/RobTillaart/SHEX


#include "Arduino.h"
#include "Print.h"


#define SHEX_LIB_VERSION                (F("0.3.0"))

#define SHEX_DEFAULT_LENGTH             16
#define SHEX_MAX_LENGTH                 32
#define SHEX_MIN_LENGTH                 4
#define SHEX_COUNTER_DIGITS             4
#define SHEX_DEFAULT_VTAB               8


class SHEX: public Print
{
public:
  SHEX(Print* stream = &Serial, uint8_t length = SHEX_DEFAULT_LENGTH);

  void     reset();

  size_t   write(uint8_t c);

  void     setHEX(bool hexOutput = true);
  bool     getHEX() { return _hexOutput; };

  void     setBytesPerLine(const uint8_t length = SHEX_DEFAULT_LENGTH);
  uint8_t  getBytesPerLine() { return _length; };

  void     setSeparator(char c = ' ') { _separator = c; };
  char     getSeparator() { return _separator; };

  //       must be 0, 4, 6 or 8
  void     setCountDigits(uint8_t digits = SHEX_COUNTER_DIGITS);
  uint8_t  getCountDigits() { return _digits; }
  //  restarts the output - use with care
  void     restartOutput();
  uint32_t getCounter() { return _charCount; };

  void     setVTAB(uint8_t vtab = SHEX_DEFAULT_VTAB);
  uint8_t  getVTAB() { return _vtab; };


protected:
  Print *   _stream    = &Serial;
  bool      _hexOutput = true;
  uint8_t   _length    = SHEX_DEFAULT_LENGTH;
  uint8_t   _vtab      = SHEX_DEFAULT_VTAB;
  char      _separator = ' ';

  uint32_t  _charCount = 0;
  uint32_t  _digits    = SHEX_COUNTER_DIGITS;
};


///////////////////////////////////////////////////
//
//  SHEXA shows also ASCII dump
//        derived class as it takes extra RAM
//
class SHEXA : public SHEX
{
public:
  SHEXA(Print* stream = &Serial, uint8_t length = SHEX_DEFAULT_LENGTH);

  size_t    write(uint8_t c);
  //  flushes the ASCII column to output;  not ideal but workable for now.
  //  use with care
  void      flushASCII();

protected:
  uint8_t   _txtbuf[SHEX_MAX_LENGTH];
  bool      _showtxt = true;
};


// -- END OF FILE --