scheduler.cpp File Reference

#include "globals.h"
#include "scheduler.h"
#include "scheduledIO.h"
#include "timers.h"
#include "schedule_calcs.h"
#include "preprocessor.h"
#include "units.h"
#include "schedule_state_machine.h"

Functions
static void	reset (Schedule &schedule)
static void	reset (FuelSchedule &schedule)
static void	reset (IgnitionSchedule &schedule)
void	initialiseFuelSchedulers (void)
void	initialiseIgnitionSchedulers (void)
void	startIgnitionSchedulers (void)
void	stopIgnitionSchedulers (void)
void	startFuelSchedulers (void)
void	stopFuelSchedulers (void)
void	setCallbacks (Schedule &schedule, voidVoidCallback pStartCallback, voidVoidCallback pEndCallback)
	Set the schedule action start & end callbacks.
static uint16_t	clipDuration (uint16_t duration)
static void	setScheduleNext (Schedule &schedule, uint32_t delay, uint16_t duration)
static void	setScheduleRunning (Schedule &schedule, uint32_t delay, uint16_t duration)
void	setSchedule (Schedule &schedule, uint32_t delay, uint16_t duration, bool allowQueuedSchedule)
	Set the schedule action to run for a certain duration in the future.
void	refreshIgnitionSchedule1 (unsigned long timeToEnd)
void	beginInjectorPriming (void)
void	moveToNextState (FuelSchedule &schedule)
	Shared fuel schedule timer ISR implementation. Should be called by the actual timer ISRs (as timed interrupts) when either the start time or the duration time are reached. See Schedule finite state machine.
static void	onEndIgnitionEvent (IgnitionSchedule *pSchedule)
	Called when an ignition event ends. I.e. a spark fires.
	BEGIN_LTO_ALWAYS_INLINE (void) static ignitionPendingToRunning(Schedule *pSchedule)
	Called when the supplied schedule transitions from a PENDING state to RUNNING.
void	moveToNextState (IgnitionSchedule &schedule)
	Shared ignition schedule timer ISR implementation. Should be called by the actual ignition timer ISRs (as timed interrupts) when either the start time or the duration time are reached. See Schedule finite state machine.
static void	disableSchedule (Schedule &schedule)
void	disableFuelSchedule (uint8_t channel)
void	disableIgnSchedule (uint8_t channel)
void	disableAllFuelSchedules (void)
void	disableAllIgnSchedules (void)

Variables
FuelSchedule	fuelSchedule1 (FUEL1_COUNTER, FUEL1_COMPARE)
FuelSchedule	fuelSchedule2 (FUEL2_COUNTER, FUEL2_COMPARE)
FuelSchedule	fuelSchedule3 (FUEL3_COUNTER, FUEL3_COMPARE)
FuelSchedule	fuelSchedule4 (FUEL4_COUNTER, FUEL4_COMPARE)
IgnitionSchedule	ignitionSchedule1 (IGN1_COUNTER, IGN1_COMPARE)
IgnitionSchedule	ignitionSchedule2 (IGN2_COUNTER, IGN2_COMPARE)
IgnitionSchedule	ignitionSchedule3 (IGN3_COUNTER, IGN3_COMPARE)
IgnitionSchedule	ignitionSchedule4 (IGN4_COUNTER, IGN4_COMPARE)
IgnitionSchedule	ignitionSchedule5 (IGN5_COUNTER, IGN5_COMPARE)
static table2D_u8_u8_4 PrimingPulseTable &	configPage2

Detailed Description

Injector and Ignition (on/off) scheduling (functions). There is usually 8 functions for cylinders 1-8 with same naming pattern.

Scheduling structures

Structures FuelSchedule and Schedule describe (from scheduler.h) describe the scheduling info for Fuel and Ignition respectively. They contain duration, current activity status, start timing, end timing, callbacks to carry out action, etc.

Scheduling Functions

For Injection:

• setFuelSchedule*(tout,dur) - Setup schedule for (next) injection on the channel
• inj*StartFunction() - Execute start of injection (Interrupt handler)
• inj*EndFunction() - Execute end of injection (interrupt handler)

For Ignition (has more complex schedule setup):

• setIgnitionSchedule*(cb_st,tout,dur,cb_end) - Setup schedule for (next) ignition on the channel
• ign*StartFunction() - Execute start of ignition (Interrupt handler)
• ign*EndFunction() - Execute end of ignition (Interrupt handler)

Function Documentation

beginInjectorPriming()

void beginInjectorPriming

(

void

)

Perform the injector priming pulses. Set these to run at an arbitrary time in the future (100us). The prime pulse value is in ms*10, so need to multiple by 100 to get to uS

Here is the call graph for this function:

Here is the caller graph for this function:

clipDuration()

static uint16_t clipDuration ( uint16_t  duration )

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

initialiseFuelSchedulers()

void initialiseFuelSchedulers

(

void

)

< The number of crank degrees until cylinder 1 is at TDC (This is obviously 0 for virtually ALL engines, but there's some weird ones)

< The number of crank degrees until cylinder 2 (and 5/6/7/8) is at TDC

< The number of crank degrees until cylinder 3 (and 5/6/7/8) is at TDC

< The number of crank degrees until cylinder 4 (and 5/6/7/8) is at TDC

Here is the call graph for this function:

Here is the caller graph for this function:

initialiseIgnitionSchedulers()

void initialiseIgnitionSchedulers

(

void

)

< The number of crank degrees until cylinder 1 is at TDC (This is obviously 0 for virtually ALL engines, but there's some weird ones)

< The number of crank degrees until cylinder 2 (and 5/6/7/8) is at TDC

< The number of crank degrees until cylinder 2 (and 5/6/7/8) is at TDC

< The number of crank degrees until cylinder 2 (and 5/6/7/8) is at TDC

Here is the call graph for this function:

Here is the caller graph for this function:

refreshIgnitionSchedule1()

void refreshIgnitionSchedule1

(

unsigned long

timeToEnd

)

Here is the call graph for this function:

Here is the caller graph for this function:

reset() [1/3]

static void reset ( FuelSchedule &  schedule )

inlinestatic

Here is the call graph for this function:

reset() [2/3]

static void reset ( IgnitionSchedule &  schedule )

inlinestatic

Here is the call graph for this function:

reset() [3/3]

static void reset ( Schedule &  schedule )

static

Here is the call graph for this function:

Here is the caller graph for this function:

setCallbacks()

void setCallbacks	(	Schedule &	schedule,
		voidVoidCallback	pStartCallback,
		voidVoidCallback	pEndCallback
	)

Set the schedule action start & end callbacks.

Parameters

schedule	Schedule to modify
pStartCallback	Start callback
pEndCallback	End callback

Here is the call graph for this function:

Here is the caller graph for this function:

setSchedule()

void setSchedule	(	Schedule &	schedule,
		uint32_t	delay,
		uint16_t	duration,
		bool	allowQueuedSchedule
	)

Set the schedule action to run for a certain duration in the future.

Parameters

schedule	Schedule to modify
delay	Delay until the action starts (µS)
duration	Action duration (µS)
allowQueuedSchedule	true to allow a schedule to be queued up if one is currently running; false otherwise

Here is the call graph for this function:

Here is the caller graph for this function:

setScheduleNext()

static void setScheduleNext ( Schedule &  schedule, uint32_t  delay, uint16_t  duration  )

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

setScheduleRunning()

static void setScheduleRunning ( Schedule &  schedule, uint32_t  delay, uint16_t  duration  )

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

startFuelSchedulers()

void startFuelSchedulers

(

void

)

Here is the call graph for this function:

Here is the caller graph for this function:

startIgnitionSchedulers()

void startIgnitionSchedulers

(

void

)

Here is the call graph for this function:

Here is the caller graph for this function:

stopFuelSchedulers()

void stopFuelSchedulers

(

void

)

Here is the call graph for this function:

stopIgnitionSchedulers()

void stopIgnitionSchedulers

(

void

)

Here is the call graph for this function:

Variable Documentation

configPage2

table2D_u8_u8_4 PrimingPulseTable& configPage2

static

fuelSchedule1

FuelSchedule fuelSchedule1(FUEL1_COUNTER, FUEL1_COMPARE)	(	FUEL1_COUNTER	,
		FUEL1_COMPARE
	)

fuelSchedule2

FuelSchedule fuelSchedule2(FUEL2_COUNTER, FUEL2_COMPARE)	(	FUEL2_COUNTER	,
		FUEL2_COMPARE
	)

fuelSchedule3

FuelSchedule fuelSchedule3(FUEL3_COUNTER, FUEL3_COMPARE)	(	FUEL3_COUNTER	,
		FUEL3_COMPARE
	)

fuelSchedule4

FuelSchedule fuelSchedule4(FUEL4_COUNTER, FUEL4_COMPARE)	(	FUEL4_COUNTER	,
		FUEL4_COMPARE
	)

ignitionSchedule1

IgnitionSchedule ignitionSchedule1(IGN1_COUNTER, IGN1_COMPARE)	(	IGN1_COUNTER	,
		IGN1_COMPARE
	)

ignitionSchedule2

IgnitionSchedule ignitionSchedule2(IGN2_COUNTER, IGN2_COMPARE)	(	IGN2_COUNTER	,
		IGN2_COMPARE
	)

ignitionSchedule3

IgnitionSchedule ignitionSchedule3(IGN3_COUNTER, IGN3_COMPARE)	(	IGN3_COUNTER	,
		IGN3_COMPARE
	)

ignitionSchedule4

IgnitionSchedule ignitionSchedule4(IGN4_COUNTER, IGN4_COMPARE)	(	IGN4_COUNTER	,
		IGN4_COMPARE
	)

ignitionSchedule5

IgnitionSchedule ignitionSchedule5(IGN5_COUNTER, IGN5_COMPARE)	(	IGN5_COUNTER	,
		IGN5_COMPARE
	)