A class for the Serial Wombat SW8B or SW18AB chips which received IR remote signals. Currently only NEC protocol is supported. More...

#include <SerialWombatIRRx.h>

Inheritance diagram for SerialWombatIRRx:

[legend]

Collaboration diagram for SerialWombatIRRx:

[legend]

Public Types
enum	publicDataOutput { COMMAND = 0 , ADDRESS = 1 , DATACOUNT = 2 }

Public Member Functions
	SerialWombatIRRx (SerialWombatChip &sw)
	Constructor for the SerialWombatIRRx class.

int16_t	begin (uint8_t pin, uint8_t irMode=0, bool useRepeat=true, SerialWombatPinState_t activeState=SW_LOW, uint16_t publicDataTimeoutPeriod_mS=1000, uint16_t publicDataTimeoutValue=0xFFFF, bool useAddressFilter=false, uint16_t addressFilterValue=0x1234, SerialWombatIRRx::publicDataOutput dataOutput=SerialWombatIRRx::publicDataOutput::COMMAND)
	Initalize the SerialWombatIRRx.

int	available ()

int	read ()
	Reads a byte from the SerialWombatIRRx queue.

void	flush ()
	Discard all bytes from the SerialWombatIRRx queue.

int	peek ()
	Query the SerialWombatIRRx queue for the next avaialble byte, but don't remove it from the queue.

size_t	write (uint8_t data)
	Write a byte to the SerialWombatIRRx queue (Does Nothing)

size_t	write (const uint8_t *buffer, size_t size)
	Write bytes to the SerialWombatIRRx queue (Does nothing)

int	availableForWrite ()
	Number of bytes avaialble to write to SerialWombatIRRx queue. Returns 0.

size_t	readBytes (char *buffer, size_t length)
	Reads a specified number of bytes from the SerialWombatIRRx queue queue.

void	setTimeout (long timeout_mS)
	implemented to fulfill Stream requirement.

SerialWombatIRRx	operator= (SerialWombatIRRx &irrx)
	used to allow reference copy. Not for user use.

uint16_t	readAddress ()

uint16_t	readDataCount ()

Public Member Functions inherited from SerialWombatPin
	SerialWombatPin (SerialWombatChip &serialWombatChip)
	Instantiates a Serial Wombat Pin.

	SerialWombatPin (SerialWombatChip &serialWombatChip, uint8_t pin)
	Instantiates a Serial Wombat Pin.

uint16_t	readPublicData ()
	Read the 16 Bit public data associated with this pin.

void	pinMode (uint8_t mode, bool pullDown=false, bool openDrain=false)
	Set pin to INPUT or OUTPUT, with options for pull Ups and open Drain settings.

void	digitalWrite (uint8_t val)
	Set output pin High or Low.

int	digitalRead ()
	Reads the state of the Pin.

uint16_t	writePublicData (uint16_t value)
	Write a 16 bit value to this pin.

uint8_t	pin ()
	Returns the current SW pin number. Used primarily for virtual calls by derived classes.

uint8_t	swPinModeNumber ()
	Returns the Mode number. Used primarily by derived classes to populate packet data.

int16_t	initPacketNoResponse (uint8_t packetNumber, uint8_t param0=0x55, uint8_t param1=0x55, uint8_t param2=0x55, uint8_t param3=0x55, uint8_t param4=0x55)

int16_t	initPacketNoResponse (uint8_t packetNumber, uint16_t param0=0x55, uint8_t param1=0x55, uint8_t param2=0x55, uint8_t param3=0x55)

int16_t	initPacketNoResponse (uint8_t packetNumber, uint16_t param0, uint16_t param1, uint8_t param2=0x55)

int16_t	disable ()
	Disables the pin mode (if applicable)

int16_t	enablePullup (bool enabled)
	Enables the weak pull up on a pin. Implemented on SW18AB and SW8B only.

int16_t	enablePulldown (bool enabled)
	Enables the weak pull down on a pin. Implemented on SW18AB and SW8B only.

int16_t	enableOpenDrain (bool enabled)
	Enables open drain mode on a pin. Implemented on SW18AB and SW8B only.

int16_t	forceDMA (bool enabled)
	Forces use of DMA instead of hardware timing resources on SW18AB.

Protected Attributes
uint32_t	timeout = 1

Protected Attributes inherited from SerialWombatPin
uint8_t	_pin = 255

SerialWombatChip &	_sw

uint8_t	_pinMode = 0

Detailed Description

A class for the Serial Wombat SW8B or SW18AB chips which received IR remote signals. Currently only NEC protocol is supported.

A Tutorial video is avaialble:

COMING SOON

The class inherits from the Arduino Stream class, so queued button presses can be read like a Serial port.

Definition at line 47 of file SerialWombatIRRx.h.

Member Enumeration Documentation

◆ publicDataOutput

enum SerialWombatIRRx::publicDataOutput

Enumerator
COMMAND	The last 8 bit command received (address filtered if enabled)
ADDRESS	the last 16 bit address received. Not Address filtered
DATACOUNT	The number of data that have been queued (Affected by address filtering and repeat settings)

Definition at line 51 of file SerialWombatIRRx.h.

Constructor & Destructor Documentation

◆ SerialWombatIRRx()

SerialWombatIRRx::SerialWombatIRRx ( SerialWombatChip & sw )

inline

Constructor for the SerialWombatIRRx class.

Parameters

serialWombat The Serial Wombat Chip on which the SerialWombatUART instance will run.

Definition at line 62 of file SerialWombatIRRx.h.

Member Function Documentation

◆ available()

int SerialWombatIRRx::available ( )

inline

Definition at line 125 of file SerialWombatIRRx.h.

◆ availableForWrite()

int SerialWombatIRRx::availableForWrite ( )

inline

Number of bytes avaialble to write to SerialWombatIRRx queue. Returns 0.

Returns: Zero. Writes are not suppored.

Definition at line 211 of file SerialWombatIRRx.h.

◆ begin()

int16_t SerialWombatIRRx::begin	(	uint8_t	pin,
		uint8_t	irMode = 0,
		bool	useRepeat = true,
		SerialWombatPinState_t	activeState = SW_LOW,
		uint16_t	publicDataTimeoutPeriod_mS = 1000,
		uint16_t	publicDataTimeoutValue = 0xFFFF,
		bool	useAddressFilter = false,
		uint16_t	addressFilterValue = 0x1234,
		SerialWombatIRRx::publicDataOutput	dataOutput = SerialWombatIRRx::publicDataOutput::COMMAND )

inline

Initalize the SerialWombatIRRx.

Parameters

controlPin	Keypad scanning transitions will occur while this pin is being serviced by the Serial Wombat executive. Typically this will be the same as the row0 pin
row0pin	pin attached to the topmost keypad row. On many marked keypads this row has 1,2,3 and A in it. Enter 255 if this column is unused
row1pin	pin attached to the topcenter keypad row. On many marked keypads this row has 4,5,6 and B in it. Enter 255 if this row is unused
row2pin	pin attached to the topmost keypad row. On many marked keypads this row has 7,8,9 and C in it. Enter 255 if this row is unused
row3pin	pin attached to the topmost keypad row. On many marked keypads this row has *,0,# and D in it. Enter 255 if this row is unused
column0pin	pin attached to the leftmost keypad column. On many marked keypads this column has 1,4,7 and * in it. Enter 255 if this column is unused
column1pin	pin attached to the leftcenter keypad column. On many marked keypads this column has 1,5,8 and 0 in it. Enter 255 if this column is unused
column2pin	pin attached to the rightcenter keypad column. On many marked keypads this column has 3,5,9 and # in it. Enter 255 if this column is unused
column3pin	pin attached to the rightmost keypad column. On many marked keypads this column has A,B,C and D in it. Enter 255 if this column is unused
bufferMode	0: Public data is Binary of 16 keys (Default) 1: Public data is last key index pressed 2: Public data is last key pressed or 16 for no key index 3: Public data is Ascii of last key pressed
queueMode	0: Button presses are queued as indexes 1: Button Presses are queued as ASCII
rowTiming	mS to delay after setting a pin row low before reading columns

Definition at line 80 of file SerialWombatIRRx.h.

◆ flush()

void SerialWombatIRRx::flush ( )

inline

Discard all bytes from the SerialWombatIRRx queue.

Definition at line 156 of file SerialWombatIRRx.h.

◆ operator=()

SerialWombatIRRx SerialWombatIRRx::operator= ( SerialWombatIRRx & irrx )

inline

used to allow reference copy. Not for user use.

Definition at line 291 of file SerialWombatIRRx.h.

◆ peek()

int SerialWombatIRRx::peek ( )

inline

Query the SerialWombatIRRx queue for the next avaialble byte, but don't remove it from the queue.

Returns: A byte from 0-255, or -1 if no bytes were avaialble

Definition at line 164 of file SerialWombatIRRx.h.

◆ read()

int SerialWombatIRRx::read ( )

inline

Reads a byte from the SerialWombatIRRx queue.

Returns: A byte from 0-255, or -1 if no bytes were avaialble

Definition at line 137 of file SerialWombatIRRx.h.

◆ readAddress()

uint16_t SerialWombatIRRx::readAddress ( )

inline

Definition at line 297 of file SerialWombatIRRx.h.

◆ readBytes()

size_t SerialWombatIRRx::readBytes	(	char *	buffer,
		size_t	length )

inline

Reads a specified number of bytes from the SerialWombatIRRx queue queue.

Parameters

buffer	An array into which to put received bytes
length	The maximum number of bytes to be received

Returns: the number of bytes written to buffer

This function will read bytes from the SerialWombatIRRx queue into buffer. If 'length' characters are not available to read then the value returned will be less than length.

Definition at line 226 of file SerialWombatIRRx.h.

◆ readDataCount()

uint16_t SerialWombatIRRx::readDataCount ( )

inline

Definition at line 308 of file SerialWombatIRRx.h.

◆ setTimeout()

void SerialWombatIRRx::setTimeout ( long timeout_mS )

inline

implemented to fulfill Stream requirement.

Definition at line 275 of file SerialWombatIRRx.h.

◆ write() [1/2]

size_t SerialWombatIRRx::write	(	const uint8_t *	buffer,
		size_t	size )

inline

Write bytes to the SerialWombatIRRx queue (Does nothing)

Parameters

buffer	An array of uint8_t bytes to send
size	the number of bytes to send

Returns: the number of bytes sent

This function exists to fully implement the Stream class. It throws away the bytes.

Definition at line 201 of file SerialWombatIRRx.h.

◆ write() [2/2]

size_t SerialWombatIRRx::write ( uint8_t data )

inline

Write a byte to the SerialWombatIRRx queue (Does Nothing)

Parameters

data	Byte to write

Returns: Number of bytes written

This function exists to fully implement the Stream class. It throws away the byte.

Definition at line 186 of file SerialWombatIRRx.h.

Member Data Documentation

◆ timeout

uint32_t SerialWombatIRRx::timeout = 1

protected

Definition at line 319 of file SerialWombatIRRx.h.

Public Types

Public Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ publicDataOutput

Constructor & Destructor Documentation

◆ SerialWombatIRRx()

Member Function Documentation

◆ available()

◆ availableForWrite()

◆ begin()

◆ flush()

◆ operator=()

◆ peek()

◆ read()

◆ readAddress()

◆ readBytes()

◆ readDataCount()

◆ setTimeout()

◆ write() [1/2]

◆ write() [2/2]

Member Data Documentation

◆ timeout