rusefi-1/firmware/controllers/core/efi_wave.h

90 lines
2.7 KiB
C++

/**
* @file efi_wave.h
*
* @date May 18, 2014
* @author Andrey Belomutskiy, (c) 2012-2017
*/
#ifndef EFI_WAVE_H_
#define EFI_WAVE_H_
#include "global.h"
/**
* This layer has two primary usages:
* 1) 'simple' PWM generation is used to produce actuator square control wave
* 2) 'complex' PWM generation is used for trigger simulator.
* Some triggers like Nissan 360 slot optical wheel need a lot of points to describe the shape of the wave.
* Looks like 252 is explained by 60 tooth * 2 (number of fronts) * 2 (number of crank rotations within engine cycle)
*/
#ifndef PWM_PHASE_MAX_COUNT
#define PWM_PHASE_MAX_COUNT 252
#endif /* PWM_PHASE_MAX_COUNT */
#define PWM_PHASE_MAX_WAVE_PER_PWM 3
/**
* int8_t is probably less efficient then int32_t but we need
* to reduce memory footprint
*
* todo: migrate to bit-array to save memory?
* this would cost some CPU cycles. see std::vector<bool>
*/
typedef trigger_value_e pin_state_t;
/**
* This class represents one channel of a digital signal state sequence
* Each element represents either a HIGH or LOW state - while at the moment this
* is not implemented using a bit array, it could absolutely be a bit array
*
* This sequence does not know anything about signal lengths - only signal state at a given index
*
* @brief PWM configuration for the specific output pin
*/
class SingleWave {
public:
SingleWave();
explicit SingleWave(pin_state_t *pinStates);
void init(pin_state_t *pinStates);
/**
* todo: confirm that we only deal with two states here, no magic '-1'?
* @return HIGH or LOW state at given index
*/
pin_state_t getState(int switchIndex) const;
void setState(int switchIndex, pin_state_t state);
// todo: make this private by using 'getState' and 'setState' methods
pin_state_t *pinStates;
};
/**
* This class represents multi-channel logical signals with shared time axis
*
*/
class MultiWave {
public:
MultiWave();
MultiWave(float *switchTimes, SingleWave *waves);
void init(float *switchTimes, SingleWave *waves);
void reset(void);
float getSwitchTime(const int phaseIndex) const;
void setSwitchTime(const int phaseIndex, const float value);
void checkSwitchTimes(const int size);
pin_state_t getChannelState(const int channelIndex, const int phaseIndex) const;
int findAngleMatch(const float angle, const int size) const;
int findInsertionAngle(const float angle, const int size) const;
/**
* Number of signal channels
*/
int waveCount;
SingleWave *channels = nullptr;
//private:
/**
* values in the (0..1] range which refer to points within the period at at which pin state should be changed
* So, in the simplest case we turn pin off at 0.3 and turn it on at 1 - that would give us a 70% duty cycle PWM
*/
float *switchTimes = nullptr;
};
#endif /* EFI_WAVE_H_ */