andrewm@0: /*
andrewm@0:  * Utilities.h
andrewm@0:  *
andrewm@0:  *  Created on: Oct 27, 2014
andrewm@0:  *      Author: parallels
andrewm@0:  */
andrewm@0: 
andrewm@0: #ifndef UTILITIES_H_
andrewm@0: #define UTILITIES_H_
andrewm@0: 
andrewm@45: #include "BeagleRT.h"
andrewm@45: 
andrewm@45: #define setBit(word,bit) 			((word) | (1 << (bit)))
andrewm@45: #define clearBit(word,bit) 			((word) &~ (1 << (bit)))
andrewm@45: #define getBit(word,bit) 			(((word) >> (bit)) & 1)
andrewm@45: #define changeBit(word,bit,value) 	((clearBit((word),(bit))) | ((value) << (bit)))
andrewm@45: 
andrewm@45: #if 1
andrewm@45: // Note: pinMode(), analogWrite() and digitalWrite() should be able to be called from initialise_render()
andrewm@45: // Likewise, thread launch should be able to be called from initialise_render()
andrewm@45: // Also, make volume change functions callable from render() thread -- as an aux task?
andrewm@45: 
andrewm@45: float analogReadFrame(BeagleRTContext *context, int frame, int channel);
andrewm@45: void analogWriteFrame(BeagleRTContext *context, int frame, int channel, float value);
andrewm@45: void analogWriteFrameOnce(BeagleRTContext *context, int frame, int channel, float value);
andrewm@45: 
andrewm@45: int digitalReadFrame(BeagleRTContext *context, int frame, int channel);
andrewm@45: void digitalWriteFrame(BeagleRTContext *context, int frame, int channel, int value);
andrewm@45: void digitalWriteFrameOnce(BeagleRTContext *context, int frame, int channel, int value);
andrewm@45: 
andrewm@45: void pinModeFrame(BeagleRTContext *context, int frame, int channel, int mode);
andrewm@45: void pinModeFrameOnce(BeagleRTContext *context, int frame, int channel, int mode);
andrewm@45: 
andrewm@45: #else
andrewm@13: 
giuliomoro@19: // Macros for accessing the analog values: usable _only_ within render()
andrewm@5: 
giuliomoro@19: // Read an Analog input from input pin p at frame f
giuliomoro@23: #define analogRead(p, f) (analogIn[(f)*gNumAnalogChannels + (p)])
giuliomoro@19: // Write an Analog output frame at output pin p, frame f, to value v
giuliomoro@23: #define analogWriteFrame(p, f, v) (analogOut[(f)*gNumAnalogChannels + (p)] = (v))
giuliomoro@23: #define analogWrite(pin, frame, value) \
giuliomoro@18: (({do {\
giuliomoro@19: 	for (int _privateI=(frame); _privateI<numAnalogFrames; _privateI++){ \
giuliomoro@23: 		analogWriteFrame(pin,_privateI,value); \
giuliomoro@18: 	}\
giuliomoro@18: 	} while (0);}),(void)0)\
andrewm@5: 
andrewm@45: 
giuliomoro@19: //digital API:
giuliomoro@33: #define setDigitalDirectionFrame(pin,frame,direction) digital[(frame)]=changeBit(digital[(frame)],(pin),(direction)),void(0)
giuliomoro@33: #define setDigitalDirection(pin,frame,direction)\
giuliomoro@33: 		(({do {\
giuliomoro@33: 			for(int _privateI=(frame); _privateI<numDigitalFrames; _privateI++)\
giuliomoro@33: 				setDigitalDirectionFrame(pin,_privateI,direction);\
giuliomoro@33: 			} while (0);}), (void)0)
giuliomoro@19: #define digitalWriteAll(frame,value) digital[(frame)]=0xffff0000*(!(!value));
giuliomoro@16: //sets the bit in the high word, clears the bit in the low word (just in case the direction was not previously set)
giuliomoro@19: #define digitalWriteFrame(pin, frame, value) digital[(frame)]=( changeBit(digital[(frame)], (pin+16), (value)) & (0xffffffff-(1<<(pin))) ) //could have been done with two subsequent assignments
giuliomoro@18: #define digitalWrite(pin, frame, value) \
giuliomoro@18: 	(({do {\
giuliomoro@33: 		for (int _privateI=(frame); _privateI<numDigitalFrames; _privateI++) \
giuliomoro@18: 			digitalWriteFrame(pin,_privateI,value); \
giuliomoro@18: 		} while (0);}),(void)0)\
giuliomoro@18: 
giuliomoro@19: #define digitalRead(pin, frame) ( getBit(digital[(frame)], pin+16) )
giuliomoro@16: 
andrewm@45: #endif
andrewm@45: 
andrewm@0: float map(float x, float in_min, float in_max, float out_min, float out_max);
andrewm@0: float constrain(float x, float min_val, float max_val);
andrewm@0: 
andrewm@0: #endif /* UTILITIES_H_ */