gtr/osc32final/OSCBoards.h

156 lines
4.0 KiB
C++

/*
Written by Yotam Mann, The Center for New Music and Audio Technologies,
University of California, Berkeley. Copyright (c) 2013, The Regents of
the University of California (Regents).
Permission to use, copy, modify, distribute, and distribute modified versions
of this software and its documentation without fee and without a signed
licensing agreement, is hereby granted, provided that the above copyright
notice, this paragraph and the following two paragraphs appear in all copies,
modifications, and distributions.
IN NO EVENT SHALL REGENTS BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,
SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING
OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF REGENTS HAS
BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
REGENTS SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE SOFTWARE AND ACCOMPANYING DOCUMENTATION, IF ANY, PROVIDED
HEREUNDER IS PROVIDED "AS IS". REGENTS HAS NO OBLIGATION TO PROVIDE
MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
For bug reports and feature requests please email me at yotam@cnmat.berkeley.edu
*/
#ifndef OSCDATA_h
#define OSCDATA_h
#include "Arduino.h"
#include <stdlib.h>
#include <stdint.h>
#include <inttypes.h>
#include <string.h>
#include "OSCTiming.h"
#if (defined(TEENSYDUINO) && defined(USB_SERIAL)) || (!defined(TEENSYDUINO) && defined(__AVR_ATmega32U4__)) || defined(__SAM3X8E__) || (defined(_USB) && defined(_USE_USB_FOR_SERIAL_)) || defined(BOARD_maple_mini)
#define BOARD_HAS_USB_SERIAL
#if defined(__SAM3X8E__)
#define thisBoardsSerialUSB SerialUSB
#else
#define thisBoardsSerialUSB Serial
#endif
#endif
#if defined(ESP8266) || defined(ESP32)
#define ESPxx
#endif
//ERRORS/////////////////////////////////////////////////
typedef enum { OSC_OK = 0,
BUFFER_FULL, INVALID_OSC, ALLOCFAILED, INDEX_OUT_OF_BOUNDS
} OSCErrorCode;
class OSCData
{
private:
//friends
friend class OSCMessage;
//should only be used while decoding
//leaves an invalid OSCMessage with a type, but no data
OSCData(char t);
public:
//an error flag
OSCErrorCode error;
//the size (in bytes) of the data
int bytes;
//the type of the data
int type;
//the data
union {
char * s; //string
int32_t i; //int
float f; //float
double d; //double
uint64_t l; //long
uint8_t * b; //blob
osctime_t time;
} data;
//overload the constructor to account for all the types and sizes
OSCData(const char * s);
#if defined(__SAM3X8E__)
OSCData (int16_t);
#endif
OSCData (int32_t);
#ifndef ESPxx
OSCData (int);
#endif
OSCData (unsigned int);
OSCData (float);
OSCData (double);
OSCData (uint8_t *, int);
//accepts another OSCData objects and clones it
OSCData (OSCData *);
OSCData (boolean);
OSCData (osctime_t);
//destructor
~OSCData();
//GETTERS
int32_t getInt();
float getFloat();
double getDouble();
int getString(char *);
int getString(char *, int);
int getString(char *, int, int, int);
int getBlob(uint8_t *);
int getBlob(uint8_t *, int);
int getBlob(uint8_t *, int, int, int);
int getBlobLength();
bool getBoolean();
osctime_t getTime();
//constructor from byte array with type and length
OSCData(char, uint8_t *, int);
//fill the passed in buffer with the data
//uint8_t * asByteArray();
};
/*
based on http://stackoverflow.com/questions/809902/64-bit-ntohl-in-c
if the system is little endian, it will flip the bits
if the system is big endian, it'll do nothing
*/
template<typename T>
static inline T BigEndian(const T& x)
{
const int one = 1;
const char sig = *(char*)&one;
if (sig == 0) return x; // for big endian machine just return the input
T ret;
int size = sizeof(T);
char* src = (char*)&x + sizeof(T) - 1;
char* dst = (char*)&ret;
while (size-- > 0){
*dst++ = *src--;
}
return ret;
}
#endif