speeduino.ino File Reference

#include <stdint.h>
#include "globals.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 "programmableIOControl.h"
#include "engineProtection.h"
#include "secondaryTables.h"
#include "comms_CAN.h"
#include "SD_logger.h"
#include "schedule_calcs.h"
#include "load_source.h"
#include "board_definition.h"
#include "unit_testing.h"
#include <RTC_LIB_H>
#include "units.h"
#include "fuel_calcs.h"
#include "preprocessor.h"
#include "dwell.h"
#include "decoder_init.h"
#include "src/pins/pinMapping.h"
#include "resetControl.h"
#include "scheduler_ignition_controller.h"

Macros
#define	CRANK_RUN_HYSTER   15
#define	SET_FUEL_CHANNEL(channel)    setFuelSchedule(fuelSchedule ##channel, UINT8_C(channel), current.PW ##channel, injectionStartAngles[(channel)-1U], crankAngle, fuelChannelsOn);

Functions
void	checkLaunchAndFlatShift ()
void	setup (void)
static uint16_t	applyFuelTrimToPW (trimTable3d *pTrimTable, uint16_t fuelLoad, int16_t RPM, uint16_t currentPW)
static uint8_t	getVE1 (void)
static int8_t	getAdvance1 (void)
static void	setFuelSchedule (FuelSchedule &schedule, uint8_t channel, uint16_t pw, uint16_t startAngle, uint16_t crankAngle, byte fuelChannelsOn)
static void	setFuelSchedules (const statuses &current, const uint16_t(&injectionStartAngles)[INJ_CHANNELS], uint16_t crankAngle, byte fuelChannelsOn)
	BEGIN_LTO_ALWAYS_INLINE (void) loop(void)

Variables
constexpr table2D_u8_u16_4 injectorAngleTable &	configPage2
constexpr table2D_i8_u8_4 rollingCutTable &	configPage15
	Immediately below max RPM, there is a range within which we can apply a rolling cut.
constexpr table2D_u8_u8_10 idleTargetTable &	configPage6

Detailed Description

Speeduino initialisation and main loop.

Macro Definition Documentation

CRANK_RUN_HYSTER

#define CRANK_RUN_HYSTER   15

SET_FUEL_CHANNEL

#define SET_FUEL_CHANNEL

(

channel

)

setFuelSchedule(fuelSchedule ##channel, UINT8_C(channel), current.PW ##channel, injectionStartAngles[(channel)-1U], crankAngle, fuelChannelsOn);

Function Documentation

applyFuelTrimToPW()

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

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

BEGIN_LTO_ALWAYS_INLINE()

BEGIN_LTO_ALWAYS_INLINE

(

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)

Sometimes loop() is inlined by LTO & sometimes not When not inlined, there is a huge difference in stack usage: 60+ bytes That eats into available RAM. Adding attribute((always_inline)) forces the LTO process to inline.

Since the function is declared in an Arduino header, we can't change it to inline, so we need to suppress the resulting warning.

Here is the call graph for this function:

checkLaunchAndFlatShift()

void checkLaunchAndFlatShift

(

)

Here is the call graph for this function:

Here is the caller graph for this function:

getAdvance1()

static int8_t getAdvance1 ( void  )

inlinestatic

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()

static uint8_t getVE1 ( void  )

inlinestatic

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:

setFuelSchedule()

static void setFuelSchedule ( FuelSchedule &  schedule, uint8_t  channel, uint16_t  pw, uint16_t  startAngle, uint16_t  crankAngle, byte  fuelChannelsOn  )

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

setFuelSchedules()

static void setFuelSchedules ( const statuses &  current, const uint16_t(&)  injectionStartAngles[INJ_CHANNELS], uint16_t  crankAngle, byte  fuelChannelsOn  )

inlinestatic

Here is the caller graph for this function:

setup()

void setup

(

void

)

Here is the call graph for this function:

Variable Documentation

configPage15

constexpr table2D_i8_u8_4 rollingCutTable& configPage15

constexpr

Immediately below max RPM, there is a range within which we can apply a rolling cut.

The rolling cut table defines a series of relative negative RPM offsets that define the window and percent cut for each offset. I.e. RPM 0---------------------—|++++++++++++++++++++|<- max RPM | rolling cut window |

configPage2

constexpr table2D_u8_u16_4 injectorAngleTable& configPage2

constexpr

configPage6

constexpr table2D_u8_u8_10 idleTargetTable& configPage6

constexpr