Adafruit_Microbit.h

/*!
 * @file Adafruit_Microbit.h
 */

#ifndef _ADAFRUIT_MICROBIT_H_
#define _ADAFRUIT_MICROBIT_H_

#include <Adafruit_GFX.h>
#include <Arduino.h>
#include <Fonts/TomThumb.h>

#if defined(S110) || defined(S130)
#define SD_SELECTED
#include <BLEPeripheral.h>
#endif

#define LED_ON 1  //!< Used to make turning the LED on more readable
#define LED_OFF 0 //!< Used to make turning the LED off more readable

void IRQ_MATRIX_HANDLER(void); //!< Matrix interrupt request handler

/** Class to create Adafruit_GFX interface for 5x5 matrix of micro:bit */
class Adafruit_Microbit_Matrix : public Adafruit_GFX {
public:
  Adafruit_Microbit_Matrix();
  ~Adafruit_Microbit_Matrix(void);
  boolean begin(void);
  void drawPixel(int16_t x, int16_t y, uint16_t color),
      fillScreen(uint16_t color), clear(void), rowHandler(void);
  void show(const uint8_t bitmap[]);
  void scrollText(char *string, uint8_t stepdelay = 150);
  void print(char *string);
  void print(int32_t i);
  void print(int i);
  void print(double f, int precision = 3);

  static const uint8_t EMPTYHEART[5], ///< an empty heart icon
      HEART[5],                       ///< full heart icon
      NO[5],                          ///< X icon
      YES[5],                         ///< Check icon
      MICROBIT_SMILE[5];              ///< smile icon

private:
  void startTimer();
#if defined(NRF51)
  uint8_t matrix_buffer[3][9];
#elif defined(NRF52833_XXAA)
  uint8_t matrix_buffer[5][5];
#endif
};

#ifdef SD_SELECTED
/** Class to use Nordic UART service as a Stream object on micro:bit */
class Adafruit_Microbit_BLESerial : public BLEPeripheral, public Stream {
public:
  Adafruit_Microbit_BLESerial(unsigned char req = BLE_DEFAULT_REQ,
                              unsigned char rdy = BLE_DEFAULT_RDY,
                              unsigned char rst = BLE_DEFAULT_RST);

  void begin(...);
  void poll();
  void end();

  virtual int available(void);
  virtual int peek(void);
  virtual int read(void);
  virtual void flush(void);
  virtual size_t write(uint8_t byte);
  using Print::write;
  virtual operator bool();

private:
  unsigned long _flushed;
  static Adafruit_Microbit_BLESerial *_instance;

  size_t _rxHead;
  size_t _rxTail;
  size_t _rxCount() const;
  uint8_t _rxBuffer[BLE_ATTRIBUTE_MAX_VALUE_LENGTH];
  size_t _txCount;
  uint8_t _txBuffer[BLE_ATTRIBUTE_MAX_VALUE_LENGTH];

  BLEService _uartService = BLEService("6E400001-B5A3-F393-E0A9-E50E24DCCA9E");
  BLEDescriptor _uartNameDescriptor = BLEDescriptor("2901", "UART");
  BLECharacteristic _rxCharacteristic = BLECharacteristic(
      "6E400002-B5A3-F393-E0A9-E50E24DCCA9E", BLEWriteWithoutResponse,
      BLE_ATTRIBUTE_MAX_VALUE_LENGTH);
  BLEDescriptor _rxNameDescriptor =
      BLEDescriptor("2901", "RX - Receive Data (Write)");
  BLECharacteristic _txCharacteristic =
      BLECharacteristic("6E400003-B5A3-F393-E0A9-E50E24DCCA9E", BLENotify,
                        BLE_ATTRIBUTE_MAX_VALUE_LENGTH);
  BLEDescriptor _txNameDescriptor =
      BLEDescriptor("2901", "TX - Transfer Data (Notify)");

  void _received(const uint8_t *data, size_t size);
  static void _received(BLECentral & /*central*/,
                        BLECharacteristic &rxCharacteristic);
};
#endif

/** Class to create hardware interface to BLE/matrix of micro:bit */
class Adafruit_Microbit {
public:
  Adafruit_Microbit_Matrix matrix; ///< 5x5 graphical matrix
#ifdef SD_SELECTED
  Adafruit_Microbit_BLESerial BTLESerial; ///< Nordic UART service connection
  uint8_t getDieTemp(void);
#endif

  void begin(void);
};
#endif