RaceCapturePro Lua Scripting

This page is under construction. Check back soon!

Scripting functions for RaceCapture/Pro

getGpio( channel )

Retrieves the state of the specified GPIO channel

• params
  • channel: integer 0 - 2
• returns:
  • state: 1 = channel is high, 0 = channel is low

When the channel is configured for input mode, a voltage high input (> 2 volts) will read as 1; a voltage low will read as 0. A disconnected channel will read as high due to the internal pullup resistor.

When the channel is configured as output, the channel reads 1 when the channel is activated (output transistor is connected to ground) and 0 when the channel is deactivated (pullup resistor is active)

setGpio ( channel, state )

Sets the state of the GPIO channel when the channel is configured for output mode.

• params
  • channel: integer 0 - 2, state - 1 = output active; 0 = output inactive
• returns:
  • none

When the state specified is 1, the output is active (transistor is connected to ground). When state is 0, transistor is disconnected, and pullup resistor is active.

When configured for input mode this function has no effect.

getButton()

Gets the state of the front panel pushbutton.

• params
  • none
• returns
  • state: 1 = pushbutton is depressed; 0 = pushbutton is not depressed

isSDCardPresent

Indicates if an SD card is present in the socket

present isSDCardPresent()

• params
  • none
• returns
  • present: 1 = SD card is present in socket; 0 = SD card not present

isSDCardWritable()

Indicates if the SD card is writable (lock switch on SD card is active)

• params
  • none
• returns
  • writable: 1 = SD card is writable; 0 = SD card is not writable

setPwmDutyCycle( channel, dutyCyclePct )

Sets the duty cycle of the specified PWM / Analog output channel to the specified duty cycle percentage

• params
  • channel: PWM / Analog output channel 0 - 3
• returns
  • none

setPwmPeriod( channel, period )

Sets the period of the specified PWM / Analog output channel to the specified period

• params
  • channel: PWM / Analog output channel 0 - 3
  • period: The period value
  • returns
• none

setAnalogOut( channel, voltage )

Sets the output voltage of the specified PWM / Analog output channel to the specified period. A convenience function equivalent to setPwmDutyCycle that translates voltage to PWM percentage.

• params
  • channel: PWM / Analog output channel 0 - 3
  • voltage: the specified output voltage ( 0 - 5v)
  • returns
• none

getTimerRpm(channel)

Returns the current RPM of the specified timer input channel. Note, the timer channel configuration must be set to RPM mode.

• params
  • channel: Timer channel 0 - 3
  • returns: RPM value

getTimerPeriodMs(channel)

Returns the current duration of the full cycle pulse of the specified timer input channel, in milliseconds. Note the timer channel configuration must be set to Duration mode.

• params
  • channel: Timer channel 0 - 3
  • returns: millisecond value

getTimerFrequency(channel)

Returns the current frequency present on the specified timer input channel, in Hz. Note the timer channel configuration must be set to Frequency Mode.

• params
  • channel: Timer channel 0 - 3
  • returns: Frequency in Hz

getTimerRaw(channel)

Returns the current raw timer value as measured on the specified timer input channel.

• params
  • channel: Timer channel 0 - 3
  • returns: Raw timer value between 0 - 65535

getAnalog(channel)

Reads the scaled analog value for the specified analog input channel.

• params
  • channel: Analog input channel 0 - 7
  • returns: Scaled / calculated value for the specified analog channel as defined in the channel scaling configuration

getAnalogRaw(channel)

Reads the raw analog value for the specified analog input channel.

• params
  • channel: Analog input channel 0 - 7
  • returns: The raw value measured by the 10 bit Analog to Digital Converted on the specified analog channel, between 0 - 1023

readSerial(port)

Read a line of data from the specified serial port. This command blocks until a newline ('\n') character is received on the port.

• params
  • port: Serial port 0 - 1
  • returns: a line of serial data

writeSerial(port, data)

Writes data to the specified serial port.

• params
  • port: Serial port 0 - 1
  • data: the data in string format

getGpsPosition()

Reads the current position as measured by the attached GPS module coming in firmware 1.2

• params
  • none
• returns
  • Latitude: latitude in decimal degrees
  • Longitude: longitude in decimal degress

getGpsLatitude()

Provides the current latitude as measured by the attached GPS module will be removed in firmware 1.2, replaced with getGpsPosition

• params
  • (none)
• returns
  • The current latitude in decimal degrees

getGpsLongitude()

Provides the current longitude as measured by the attached GPS module will be removed in firmware 1.2, replaced with getGpsPosition

• params
  • (none)
• returns
  • The current longitude in decimal degrees

getGpsSpeed()

Provides the current speed as measured by the attached GPS module

• params
  • (none)
• returns
  • The current speed in MPH

getGpsQuality()

Provides the current GPS quality indicator as indicated by the attached GPS module

• params
  • (none)
• returns
  • The current GPS quality indicator

getGpsTime()

Provides the current GPS time as indicated by the attached GPS module (in NMEA format) todo: document this

• params
  • (none)
• returns
  • The current GPS time value

getLapCount()

Provides the current Lap Count as determined by the start/finish line configuration and measured by the attached GPS module.

• params
  • (none)
• returns
  • The number of laps detected since the logging session started

getLapTime()

Provides the last lap time as determined by the start/finish line configuration and measured by the attached GPS module.

• params
  • (none)
• returns
  • The last measured lap time in decimal minutes / seconds

getGpsSec()

Provides the number of seconds since midnight, as measured by the GPS module. todo: how does this relate to timezone? GMT or local?

• params
  • (none)
• returns
  • number of seconds since midnight, as measured by the attached GPS module

getAtStartFinish()

Indicates if within the start finish line target as determined by the start/finish line configuration and measured by the attached GPS module.

• params
  • (none)
• returns
  • 1 if currently within the start/finish line target, 0 if outside

getTimeDiff()

Utility function to calculate the absolute difference between two time values, in seconds. todo: investigate the need for this function. may be eliminated in 1.2 firmware

• params
  • time 1
  • time 2
• returns
  • The absolute difference between the specified values

getTimeSince

Utility function to calculate the time since midnight, in seconds. todo: investigate the need for this function. may be eliminated in 1.2 firmware

• params
  • time 1
• returns
  • The number of seconds since midnight