/*! \file osc.h \brief Open Sound Control (OSC) client functions. */
//*****************************************************************************
//
// File Name	: 'osc.h'
// Title		: Open Sound Control (OSC) client functions
// Author		: Pascal Stang - Copyright (C) 2002
//				  Bjoern Hartmann - 2005
// Created		: 10/30/2002
// Revised		: 07/07/2005
// Version		: 0.2
// Target MCU	: Atmel AVR series
// Editor Tabs	: 4
//
// Description	: This code implements a subset of the OSC protocol and
//		messages.  It is meant to be used with the OSC extension for the visual
//		programming and data-processing package Pure-Data (or PD).  Note that
//		this code sends OSC messages over serial RS-232, not a network.  You
//		must use these functions with a suitable OSC SERIAL server (receiver)
//		on a host machine.
//
// The OSC spec can be found at:
// 		http://www.cnmat.berkeley.edu/OpenSoundControl/OSC-spec.html
//
// This code is distributed under the GNU Public License
//		which can be found at http://www.gnu.org/licenses/gpl.txt
//
//*****************************************************************************

#ifndef OSC_H
#define OSC_H

#include "global.h"

// OSC serial packet structure:
// [HEADER][LENGTH][OSC MESSAGE][CHECKSUM] 
// where
// [HEADER] is the byte 0xBE
// [LENGTH] is the number of bytes in OSC MESSGAGE (must be a multiple of four)
// [OSC MESSAGE] is defined by the OSC specification
// [CHECKSUM] is the 8-bit sum of bytes in the OSC MESSAGE

// defines
#define OSC_HEADER	0xBE
#define OSC_TYPE_TAG_INT 0
#define OSC_TYPE_TAG_INTINT 1
#define OSC_TYPE_TAG_STRING 2
#define OSC_MAX_RX_MSG_SIZE 0x0040
// function prototypes

//! Initializes the OSC function library
void oscInit(void);

//! sends an OSC message without any arguments (message with OSC address only)
void oscSendMessage(char *address);

//! sends an OSC message with one 32-bit integer argument
void oscSendMessageInt(char *address, u32 arg);

//! sends an OSC message with two 32-bit integer arguments
void oscSendMessageIntInt(char *address, u32 arg, u32 arg2);

//! sends an OSC message with a null-terminated string argument
void oscSendMessageString(char *address, char *arg);

//! start receiving OSC messages
void oscInitRx(void);
//! redirects received data to a user function
void oscSetIntMessageHandler(void (*rx_func)(char *addr, u32 arg));

// private functions
void oscWriteHeader(char *address, u08 arglen);	///< writes the OSC header+length
void oscWriteString(char *address);				///< writes the OSC address or strings
void oscWriteChecksum(void);					///< calculates and writes the OSC checksum
void oscWriteTypeTag(u08 type);					///< writes the OSC type tag string
void oscUartRxTestHandler(unsigned char c);	
void oscUartRxHandler(unsigned char c);			///< handles incoming data from UART
#endif