Serial Wombat Arduino Library
Public Types | Public Member Functions | List of all members
SerialWombatHSCounter Class Reference

This class is used to measure the frequency or cycles of a high speed input. On the Serial Wombat 18AB chip this class can be used two times, as two clock inputs are avaialble. An enhanced digital capability pin must be used. More...

#include <SerialWombatHSCounter.h>

Inheritance diagram for SerialWombatHSCounter:
SerialWombatPin SerialWombatAbstractProcessedInput

Public Types

enum  publicDataOutput { PULSE_COUNT = 2, FREQUENCY_ON_LTH_TRANSITION = 5 }
 
- Public Types inherited from SerialWombatAbstractProcessedInput
enum  Period {
  PERIOD_1mS = 0, PERIOD_2mS = 1, PERIOD_4mS = 2, PERIOD_8mS = 3,
  PERIOD_16mS = 4, PERIOD_32mS = 5, PERIOD_64mS = 6, PERIOD_128mS = 7,
  PERIOD_256mS = 8, PERIOD_512mS = 9, PERIOD_1024mS = 10
}
 
enum  OutputValue { RAW = 0, FIRST_ORDER_FILTERED = 1, AVERAGE = 2 }
 
enum  Transform { NONE = 0, SCALE_RANGE = 1, LINEAR_MXB = 2 }
 

Public Member Functions

 SerialWombatHSCounter (SerialWombatChip &serialWombat)
 Class constructor for SerialWombatHSCounter. More...
 
int16_t begin (uint8_t pin, SerialWombatHSCounter::publicDataOutput publicDataOutput=publicDataOutput::FREQUENCY_ON_LTH_TRANSITION, uint16_t framesBetweenUpdates=100, uint16_t publicOutputDivisor=1)
 Initialization routine for SerialWombatHSCounter. More...
 
uint32_t readCounts (bool resetCounts=false)
 
int32_t readFrequency ()
 
int16_t disable ()
 Disables the high speed clock output. More...
 
uint8_t pin ()
 Used for inheritance. More...
 
uint8_t swPinModeNumber ()
 Used for ineheritance. More...
 
- Public Member Functions inherited from SerialWombatPin
 SerialWombatPin (SerialWombatChip &serialWombatChip)
 Instantiates a Serial Wombat Pin. More...
 
 SerialWombatPin (SerialWombatChip &serialWombatChip, uint8_t pin)
 Instantiates a Serial Wombat Pin. More...
 
uint16_t readPublicData ()
 Read the 16 Bit public data associated with this pin. More...
 
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. More...
 
void digitalWrite (uint8_t val)
 Set output pin High or Low. More...
 
int digitalRead ()
 Reads the state of the Pin. More...
 
uint16_t writePublicData (uint16_t value)
 Write a 16 bit value to this pin. More...
 
uint8_t pin ()
 Returns the current SW pin number. Used primarily for virtual calls by derived classes. More...
 
uint8_t swPinModeNumber ()
 Returns the Mode number. Used primarily by derived classes to populate packet data. More...
 
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) More...
 
- Public Member Functions inherited from SerialWombatAbstractProcessedInput
 SerialWombatAbstractProcessedInput (SerialWombatChip &sw)
 Constructor for the SerialWombatAbstractScaledOutput Class. More...
 
int16_t writeInverted (bool inverted)
 if enabled subtract the input value from 65535 before doing any other processing. More...
 
int16_t writeFirstOrderFilteringConstant (uint16_t constant)
 Set a first order filtering constant to be applied to the signal Higher is heavier filtering. More...
 
int16_t writeAveragingNumberOfSamples (uint16_t numberOfSamples)
 Set a number of samples to average for each update of the downstream signal. More...
 
int16_t writeExcludeBelowAbove (uint16_t low, uint16_t high)
 Sets input value ranges which are discarded rather than processed. More...
 
int16_t configureQueue (SerialWombatQueue *queue, Period period, bool queueHighByte=true, bool queueLowByte=true)
 Sets up the queueing feature for this pin mode. Queue must have been initialized prior to this queue. More...
 
int16_t configureOutputValue (OutputValue outputValue)
 Configures whether the pin's public data value is averaged, filtered, or neither. More...
 
int16_t writeTransformScaleRange (uint16_t min, uint16_t max)
 Scale incoming values to a range of 0 to 65535. More...
 
int16_t writeTransformLinearMXB (int32_t m, int32_t b)
 Scale incoming values based on an mx+b linear equation. More...
 
int16_t configureIntegrator (uint16_t negativeMaxIndex, uint16_t negativeMidIndex, uint16_t negativeDeadZone, uint16_t positiveDeadZone, uint16_t positiveMidIndex, uint16_t positiveMaxIndex, uint16_t midIncrement, uint16_t maxIncrement, uint16_t initialValue, uint8_t updateFrequencyMask=0)
 Sort incoming data into one of 5 ranges, and integrate based on linear interpolation in those ranges. More...
 
int16_t writeProcessedInputEnable (bool enabled)
 Enables or disables all input processing functions If disabled, the raw input value is placed directly in the pin's 16 bit public data buffer. More...
 
uint16_t readMinimum (bool resetAfterRead=false)
 Retreive the maximum public data output value since the last call with reset= true. More...
 
uint16_t readMaximum (bool resetAfterRead=false)
 Retreive the minimum public data output value since the last call with reset= true. More...
 
uint16_t readAverage ()
 Retreive the last completed averaged value. More...
 
uint16_t readFiltered ()
 Retreive the filtered value. More...
 

Additional Inherited Members

- Protected Attributes inherited from SerialWombatPin
uint8_t _pin = 255
 
SerialWombatChip_sw
 
uint8_t _pinMode = 0
 

Detailed Description

This class is used to measure the frequency or cycles of a high speed input. On the Serial Wombat 18AB chip this class can be used two times, as two clock inputs are avaialble. An enhanced digital capability pin must be used.

This pin mode has been tested on inputs up to 4MHz on the 18AB.

For frequency measurements a number of counts is divided by a time. The time in mS can be specified. The frequency is updated every X ms. In order to get a good value, X should be an even divisor of 1000.

The counter can be retreived and optionally be reset on reading.

The public data buffer for this pin mode can be based either on the count of cycles or the frequency.

Since the public data buffer is limited to 16 bits a divisor is available that's applied to the counter or frequency before it's copied to the public data buffer. That way a varying high speed frequency can still create a varying public data buffer rather than saturating at 65535.

A video Tutorial on this pin mode may be available in the future:

TODO - Video coming Soon TODO - Video coming soon

Member Enumeration Documentation

◆ publicDataOutput

Enumerator
PULSE_COUNT 

The number of pulses that have occured since initialization.

FREQUENCY_ON_LTH_TRANSITION 

The frequency of the pulse in Hz.

Constructor & Destructor Documentation

◆ SerialWombatHSCounter()

SerialWombatHSCounter::SerialWombatHSCounter ( SerialWombatChip serialWombat)
inline

Class constructor for SerialWombatHSCounter.

Parameters
serialWombatThe Serial Wombat chip on which the SerialWombatHSCounter pinmode will be run

Member Function Documentation

◆ begin()

int16_t SerialWombatHSCounter::begin ( uint8_t  pin,
SerialWombatHSCounter::publicDataOutput  publicDataOutput = publicDataOutput::FREQUENCY_ON_LTH_TRANSITION,
uint16_t  framesBetweenUpdates = 100,
uint16_t  publicOutputDivisor = 1 
)
inline

Initialization routine for SerialWombatHSCounter.

Parameters
pin

◆ disable()

int16_t SerialWombatHSCounter::disable ( )
inline

Disables the high speed clock output.

◆ pin()

uint8_t SerialWombatHSCounter::pin ( )
inlinevirtual

Used for inheritance.

Implements SerialWombatAbstractProcessedInput.

◆ readCounts()

uint32_t SerialWombatHSCounter::readCounts ( bool  resetCounts = false)
inline

◆ readFrequency()

int32_t SerialWombatHSCounter::readFrequency ( )
inline

◆ swPinModeNumber()

uint8_t SerialWombatHSCounter::swPinModeNumber ( )
inlinevirtual

Used for ineheritance.

Implements SerialWombatAbstractProcessedInput.