speeduino.ino File Reference

#include <stdint.h>
#include "globals.h"
#include "speeduino.h"
#include "scheduler.h"
#include "comms.h"
#include "comms_legacy.h"
#include "comms_secondary.h"
#include "maths.h"
#include "corrections.h"
#include "timers.h"
#include "decoders.h"
#include "idle.h"
#include "auxiliaries.h"
#include "sensors.h"
#include "storage.h"
#include "crankMaths.h"
#include "init.h"
#include "utilities.h"
#include "engineProtection.h"
#include "scheduledIO.h"
#include "secondaryTables.h"
#include "comms_CAN.h"
#include "SD_logger.h"
#include "schedule_calcs.h"
#include <RTC_LIB_H>
#include <BOARD_H>

Functions
void	setup (void)
uint16_t	applyFuelTrimToPW (trimTable3d *pTrimTable, int16_t fuelLoad, int16_t RPM, uint16_t currentPW)
void	loop (void)
uint16_t	PW (int REQ_FUEL, byte VE, long MAP, uint16_t corrections, int injOpen)
	This function calculates the required pulsewidth time (in us) given the current system state.
byte	getVE1 (void)
byte	getAdvance1 (void)
void	calculateIgnitionAngles (uint16_t dwellAngle)
uint16_t	calculatePWLimit ()
void	calculateStaging (uint32_t pwLimit)
void	checkLaunchAndFlatShift ()

Variables
uint16_t	req_fuel_uS = 0
uint16_t	inj_opentime_uS = 0
uint8_t	ignitionChannelsOn
uint8_t	ignitionChannelsPending = 0
uint8_t	fuelChannelsOn
uint32_t	rollingCutLastRev = 0
uint16_t	staged_req_fuel_mult_pri = 0
uint16_t	staged_req_fuel_mult_sec = 0

Detailed Description

Speeduino initialisation and main loop.

Function Documentation

applyFuelTrimToPW()

uint16_t applyFuelTrimToPW ( trimTable3d *  pTrimTable, int16_t  fuelLoad, int16_t  RPM, uint16_t  currentPW  )

inline

Here is the call graph for this function:

Here is the caller graph for this function:

calculateIgnitionAngles()

void calculateIgnitionAngles

(

uint16_t

dwellAngle

)

Calculate the Ignition angles for all cylinders (based on config2::nCylinders). both start and end angles are calculated for each channel. Also the mode of ignition firing - wasted spark vs. dedicated spark per cyl. - is considered here.

Here is the call graph for this function:

Here is the caller graph for this function:

calculatePWLimit()

uint16_t calculatePWLimit

(

)

Here is the call graph for this function:

Here is the caller graph for this function:

calculateStaging()

void calculateStaging

(

uint32_t

pwLimit

)

Here is the call graph for this function:

Here is the caller graph for this function:

checkLaunchAndFlatShift()

void checkLaunchAndFlatShift

(

)

Here is the call graph for this function:

Here is the caller graph for this function:

getAdvance1()

byte getAdvance1

(

void

)

Lookup the ignition advance from 3D ignition table. The values used to look this up will be RPM and whatever load source the user has configured.

Returns

byte The current target advance value in degrees

Here is the call graph for this function:

Here is the caller graph for this function:

getVE1()

byte getVE1

(

void

)

Lookup the current VE value from the primary 3D fuel map. The Y axis value used for this lookup varies based on the fuel algorithm selected (speed density, alpha-n etc).

Returns

byte The current VE value

Here is the call graph for this function:

Here is the caller graph for this function:

loop()

void loop

(

void

)

Speeduino main loop.

Main loop chores (roughly in the order that they are performed):

• Check if serial comms or tooth logging are in progress (send or receive, prioritise communication)
• Record loop timing vars
• Check tooth time, update statuses (currentStatus) variables
• Read sensors
• get VE for fuel calcs and spark advance for ignition
• Check crank/cam/tooth/timing sync (skip remaining ops if out-of-sync)
• execute doCrankSpeedCalcs()

single byte variable LOOP_TIMER plays a big part here as:

• it contains expire-bits for interval based frequency driven events (e.g. 15Hz, 4Hz, 1Hz)
• Can be tested for certain frequency interval being expired by (eg) BIT_CHECK(LOOP_TIMER, BIT_TIMER_15HZ)

Here is the call graph for this function:

PW()

uint16_t PW	(	int	REQ_FUEL,
		byte	VE,
		long	MAP,
		uint16_t	corrections,
		int	injOpen
	)

This function calculates the required pulsewidth time (in us) given the current system state.

Parameters

REQ_FUEL	The required fuel value in uS, as calculated by TunerStudio
VE	Lookup from the main fuel table. This can either have been MAP or TPS based, depending on the algorithm used
MAP	In KPa, read from the sensor (This is used when performing a multiply of the map only. It is applicable in both Speed density and Alpha-N)
corrections	Sum of Enrichment factors (Cold start, acceleration). This is a multiplication factor (Eg to add 10%, this should be 110)
injOpen	Injector opening time. The time the injector take to open minus the time it takes to close (Both in uS)

Returns

uint16_t The injector pulse width in uS

Here is the call graph for this function:

Here is the caller graph for this function:

setup()

void setup

(

void

)

Here is the call graph for this function:

Variable Documentation

fuelChannelsOn

uint8_t fuelChannelsOn

The current state of the fuel system (on or off)

ignitionChannelsOn

uint8_t ignitionChannelsOn

The current state of the ignition system (on or off)

ignitionChannelsPending

uint8_t ignitionChannelsPending = 0

Any ignition channels that are pending injections before they are resumed

inj_opentime_uS

uint16_t inj_opentime_uS = 0

The injector opening time. This is set within Tuner Studio, but stored here in uS rather than mS

req_fuel_uS

uint16_t req_fuel_uS = 0

The required fuel variable (As calculated by TunerStudio) in uS

rollingCutLastRev

uint32_t rollingCutLastRev = 0

Tracks whether we're on the same or a different rev for the rolling cut

staged_req_fuel_mult_pri

uint16_t staged_req_fuel_mult_pri = 0

staged_req_fuel_mult_sec

uint16_t staged_req_fuel_mult_sec = 0