2017-09-06 11:28:31 +00:00
|
|
|
/**
|
|
|
|
* Marlin 3D Printer Firmware
|
2020-02-03 14:00:57 +00:00
|
|
|
* Copyright (c) 2020 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
|
2017-09-06 11:28:31 +00:00
|
|
|
*
|
|
|
|
* Based on Sprinter and grbl.
|
2019-06-28 04:57:50 +00:00
|
|
|
* Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
|
2017-09-06 11:28:31 +00:00
|
|
|
*
|
|
|
|
* This program is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
|
|
* (at your option) any later version.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU General Public License
|
2020-07-23 03:20:14 +00:00
|
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
2017-09-06 11:28:31 +00:00
|
|
|
*
|
|
|
|
*/
|
2018-10-16 08:38:57 +00:00
|
|
|
#pragma once
|
2017-09-18 05:06:16 +00:00
|
|
|
|
|
|
|
#include "../inc/MarlinConfig.h"
|
|
|
|
|
2019-02-10 10:54:23 +00:00
|
|
|
//#define MIXER_NORMALIZER_DEBUG
|
|
|
|
|
2020-04-22 21:35:03 +00:00
|
|
|
#ifndef __AVR__ // || HAS_DUAL_MIXING
|
2019-02-10 10:54:23 +00:00
|
|
|
// Use 16-bit (or fastest) data for the integer mix factors
|
|
|
|
typedef uint_fast16_t mixer_comp_t;
|
|
|
|
typedef uint_fast16_t mixer_accu_t;
|
|
|
|
#define COLOR_A_MASK 0x8000
|
|
|
|
#define COLOR_MASK 0x7FFF
|
|
|
|
#else
|
|
|
|
// Use 8-bit data for the integer mix factors
|
|
|
|
// Exactness is sacrificed for speed
|
2018-10-16 08:38:57 +00:00
|
|
|
#define MIXER_ACCU_SIGNED
|
2019-02-03 05:30:26 +00:00
|
|
|
typedef uint8_t mixer_comp_t;
|
2018-10-16 08:38:57 +00:00
|
|
|
typedef int8_t mixer_accu_t;
|
2018-11-01 19:38:45 +00:00
|
|
|
#define COLOR_A_MASK 0x80
|
|
|
|
#define COLOR_MASK 0x7F
|
2017-09-18 05:06:16 +00:00
|
|
|
#endif
|
|
|
|
|
2019-02-10 10:54:23 +00:00
|
|
|
typedef int8_t mixer_perc_t;
|
|
|
|
|
2018-10-16 08:38:57 +00:00
|
|
|
#ifndef MIXING_VIRTUAL_TOOLS
|
|
|
|
#define MIXING_VIRTUAL_TOOLS 1
|
|
|
|
#endif
|
2017-09-18 05:06:16 +00:00
|
|
|
|
2019-02-10 10:54:23 +00:00
|
|
|
enum MixTool {
|
2020-04-22 21:35:03 +00:00
|
|
|
FIRST_USER_VIRTUAL_TOOL = 0
|
|
|
|
, LAST_USER_VIRTUAL_TOOL = MIXING_VIRTUAL_TOOLS - 1
|
|
|
|
, NR_USER_VIRTUAL_TOOLS
|
|
|
|
, MIXER_DIRECT_SET_TOOL = NR_USER_VIRTUAL_TOOLS
|
2020-04-19 07:01:30 +00:00
|
|
|
#if HAS_MIXER_SYNC_CHANNEL
|
2020-04-22 21:35:03 +00:00
|
|
|
, MIXER_AUTORETRACT_TOOL
|
2018-11-01 19:38:45 +00:00
|
|
|
#endif
|
2020-04-22 21:35:03 +00:00
|
|
|
, NR_MIXING_VIRTUAL_TOOLS
|
2019-02-10 10:54:23 +00:00
|
|
|
};
|
|
|
|
|
2020-04-19 07:01:30 +00:00
|
|
|
#define MAX_VTOOLS TERN(HAS_MIXER_SYNC_CHANNEL, 254, 255)
|
2019-05-02 02:55:58 +00:00
|
|
|
static_assert(NR_MIXING_VIRTUAL_TOOLS <= MAX_VTOOLS, "MIXING_VIRTUAL_TOOLS must be <= " STRINGIFY(MAX_VTOOLS) "!");
|
2017-09-18 05:06:16 +00:00
|
|
|
|
2020-04-19 07:01:30 +00:00
|
|
|
#define MIXER_STEPPER_LOOP(VAR) for (uint_fast8_t VAR = 0; VAR < MIXING_STEPPERS; VAR++)
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
#if ENABLED(GRADIENT_MIX)
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
bool enabled; // This gradient is enabled
|
|
|
|
mixer_comp_t color[MIXING_STEPPERS]; // The current gradient color
|
|
|
|
float start_z, end_z; // Region for gradient
|
|
|
|
int8_t start_vtool, end_vtool; // Start and end virtual tools
|
2021-03-24 10:40:28 +00:00
|
|
|
mixer_perc_t start_mix[MIXING_STEPPERS], // Start and end mixes from those tools
|
2019-02-10 10:54:23 +00:00
|
|
|
end_mix[MIXING_STEPPERS];
|
2021-03-24 10:40:28 +00:00
|
|
|
#if ENABLED(GRADIENT_VTOOL)
|
|
|
|
int8_t vtool_index; // Use this virtual tool number as index
|
|
|
|
#endif
|
2019-02-10 10:54:23 +00:00
|
|
|
} gradient_t;
|
|
|
|
|
|
|
|
#endif
|
2018-10-16 08:38:57 +00:00
|
|
|
|
2019-02-03 05:30:26 +00:00
|
|
|
/**
|
|
|
|
* @brief Mixer class
|
|
|
|
* @details Contains data and behaviors for a Mixing Extruder
|
|
|
|
*/
|
2018-10-16 08:38:57 +00:00
|
|
|
class Mixer {
|
|
|
|
public:
|
|
|
|
|
2019-02-10 10:54:23 +00:00
|
|
|
static float collector[MIXING_STEPPERS]; // M163 components, also editable from LCD
|
|
|
|
|
|
|
|
static void init(); // Populate colors at boot time
|
2019-02-03 05:30:26 +00:00
|
|
|
|
|
|
|
static void reset_vtools();
|
2019-05-02 02:55:58 +00:00
|
|
|
static void refresh_collector(const float proportion=1.0, const uint8_t t=selected_vtool, float (&c)[MIXING_STEPPERS]=collector);
|
2018-10-16 08:38:57 +00:00
|
|
|
|
|
|
|
// Used up to Planner level
|
2019-07-05 23:01:21 +00:00
|
|
|
FORCE_INLINE static void set_collector(const uint8_t c, const float f) { collector[c] = _MAX(f, 0.0f); }
|
2019-02-10 10:54:23 +00:00
|
|
|
|
2018-10-16 08:38:57 +00:00
|
|
|
static void normalize(const uint8_t tool_index);
|
2019-02-10 10:54:23 +00:00
|
|
|
FORCE_INLINE static void normalize() { normalize(selected_vtool); }
|
|
|
|
|
2019-02-03 05:30:26 +00:00
|
|
|
FORCE_INLINE static uint8_t get_current_vtool() { return selected_vtool; }
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
FORCE_INLINE static void T(const uint_fast8_t c) {
|
|
|
|
selected_vtool = c;
|
2020-04-22 21:35:03 +00:00
|
|
|
TERN_(GRADIENT_VTOOL, refresh_gradient());
|
|
|
|
TERN_(HAS_DUAL_MIXING, update_mix_from_vtool());
|
2019-02-10 10:54:23 +00:00
|
|
|
}
|
2018-10-16 08:38:57 +00:00
|
|
|
|
|
|
|
// Used when dealing with blocks
|
2019-02-10 10:54:23 +00:00
|
|
|
FORCE_INLINE static void populate_block(mixer_comp_t b_color[MIXING_STEPPERS]) {
|
|
|
|
#if ENABLED(GRADIENT_MIX)
|
|
|
|
if (gradient.enabled) {
|
|
|
|
MIXER_STEPPER_LOOP(i) b_color[i] = gradient.color[i];
|
|
|
|
return;
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
MIXER_STEPPER_LOOP(i) b_color[i] = color[selected_vtool][i];
|
2018-10-16 08:38:57 +00:00
|
|
|
}
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
FORCE_INLINE static void stepper_setup(mixer_comp_t b_color[MIXING_STEPPERS]) {
|
|
|
|
MIXER_STEPPER_LOOP(i) s_color[i] = b_color[i];
|
|
|
|
}
|
|
|
|
|
2020-04-22 21:35:03 +00:00
|
|
|
#if EITHER(HAS_DUAL_MIXING, GRADIENT_MIX)
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
static mixer_perc_t mix[MIXING_STEPPERS]; // Scratch array for the Mix in proportion to 100
|
|
|
|
|
|
|
|
static inline void copy_mix_to_color(mixer_comp_t (&tcolor)[MIXING_STEPPERS]) {
|
|
|
|
// Scale each component to the largest one in terms of COLOR_A_MASK
|
|
|
|
// So the largest component will be COLOR_A_MASK and the other will be in proportion to it
|
2019-09-29 00:12:23 +00:00
|
|
|
const float scale = (COLOR_A_MASK) * RECIPROCAL(_MAX(
|
|
|
|
LIST_N(MIXING_STEPPERS, mix[0], mix[1], mix[2], mix[3], mix[4], mix[5])
|
|
|
|
));
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
// Scale all values so their maximum is COLOR_A_MASK
|
|
|
|
MIXER_STEPPER_LOOP(i) tcolor[i] = mix[i] * scale;
|
|
|
|
|
|
|
|
#ifdef MIXER_NORMALIZER_DEBUG
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOPGM("Mix [ ");
|
2021-02-08 06:37:24 +00:00
|
|
|
SERIAL_ECHOLIST_N(MIXING_STEPPERS, mix[0], mix[1], mix[2], mix[3], mix[4], mix[5]);
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOPGM(" ] to Color [ ");
|
2021-02-08 06:37:24 +00:00
|
|
|
SERIAL_ECHOLIST_N(MIXING_STEPPERS, tcolor[0], tcolor[1], tcolor[2], tcolor[3], tcolor[4], tcolor[5]);
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOLNPGM(" ]");
|
2019-02-10 10:54:23 +00:00
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void update_mix_from_vtool(const uint8_t j=selected_vtool) {
|
|
|
|
float ctot = 0;
|
|
|
|
MIXER_STEPPER_LOOP(i) ctot += color[j][i];
|
|
|
|
//MIXER_STEPPER_LOOP(i) mix[i] = 100.0f * color[j][i] / ctot;
|
2019-09-29 00:12:23 +00:00
|
|
|
MIXER_STEPPER_LOOP(i) mix[i] = mixer_perc_t(100.0f * color[j][i] / ctot);
|
|
|
|
|
2019-02-10 10:54:23 +00:00
|
|
|
#ifdef MIXER_NORMALIZER_DEBUG
|
2021-09-09 09:57:05 +00:00
|
|
|
SERIAL_ECHOPGM("V-tool ", j, " [ ");
|
2021-02-08 06:37:24 +00:00
|
|
|
SERIAL_ECHOLIST_N(MIXING_STEPPERS, color[j][0], color[j][1], color[j][2], color[j][3], color[j][4], color[j][5]);
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOPGM(" ] to Mix [ ");
|
2021-02-08 06:37:24 +00:00
|
|
|
SERIAL_ECHOLIST_N(MIXING_STEPPERS, mix[0], mix[1], mix[2], mix[3], mix[4], mix[5]);
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOLNPGM(" ]");
|
2019-02-10 10:54:23 +00:00
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
2020-04-22 21:35:03 +00:00
|
|
|
#endif // HAS_DUAL_MIXING || GRADIENT_MIX
|
2019-02-10 10:54:23 +00:00
|
|
|
|
2020-04-22 21:35:03 +00:00
|
|
|
#if HAS_DUAL_MIXING
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
// Update the virtual tool from an edited mix
|
|
|
|
static inline void update_vtool_from_mix() {
|
|
|
|
copy_mix_to_color(color[selected_vtool]);
|
2020-04-22 21:35:03 +00:00
|
|
|
TERN_(GRADIENT_MIX, refresh_gradient());
|
2019-02-10 10:54:23 +00:00
|
|
|
// MIXER_STEPPER_LOOP(i) collector[i] = mix[i];
|
|
|
|
// normalize();
|
|
|
|
}
|
|
|
|
|
2020-04-22 21:35:03 +00:00
|
|
|
#endif // HAS_DUAL_MIXING
|
2019-02-10 10:54:23 +00:00
|
|
|
|
|
|
|
#if ENABLED(GRADIENT_MIX)
|
|
|
|
|
|
|
|
static gradient_t gradient;
|
|
|
|
static float prev_z;
|
|
|
|
|
|
|
|
// Update the current mix from the gradient for a given Z
|
2021-04-01 22:59:57 +00:00
|
|
|
static void update_gradient_for_z(const_float_t z);
|
2019-02-10 10:54:23 +00:00
|
|
|
static void update_gradient_for_planner_z();
|
2021-04-01 22:59:57 +00:00
|
|
|
static inline void gradient_control(const_float_t z) {
|
2019-02-10 10:54:23 +00:00
|
|
|
if (gradient.enabled) {
|
|
|
|
if (z >= gradient.end_z)
|
|
|
|
T(gradient.end_vtool);
|
|
|
|
else
|
|
|
|
update_gradient_for_z(z);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
static inline void update_mix_from_gradient() {
|
|
|
|
float ctot = 0;
|
|
|
|
MIXER_STEPPER_LOOP(i) ctot += gradient.color[i];
|
2019-09-29 00:12:23 +00:00
|
|
|
MIXER_STEPPER_LOOP(i) mix[i] = (mixer_perc_t)CEIL(100.0f * gradient.color[i] / ctot);
|
|
|
|
|
2019-02-10 10:54:23 +00:00
|
|
|
#ifdef MIXER_NORMALIZER_DEBUG
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOPGM("Gradient [ ");
|
2021-02-08 06:37:24 +00:00
|
|
|
SERIAL_ECHOLIST_N(MIXING_STEPPERS, gradient.color[0], gradient.color[1], gradient.color[2], gradient.color[3], gradient.color[4], gradient.color[5]);
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOPGM(" ] to Mix [ ");
|
2021-02-08 06:37:24 +00:00
|
|
|
SERIAL_ECHOLIST_N(MIXING_STEPPERS, mix[0], mix[1], mix[2], mix[3], mix[4], mix[5]);
|
2019-09-29 00:12:23 +00:00
|
|
|
SERIAL_ECHOLNPGM(" ]");
|
2019-02-10 10:54:23 +00:00
|
|
|
#endif
|
|
|
|
}
|
|
|
|
|
|
|
|
// Refresh the gradient after a change
|
|
|
|
static void refresh_gradient() {
|
|
|
|
#if ENABLED(GRADIENT_VTOOL)
|
2019-03-25 01:02:28 +00:00
|
|
|
const bool is_grd = (gradient.vtool_index == -1 || selected_vtool == (uint8_t)gradient.vtool_index);
|
2019-02-10 10:54:23 +00:00
|
|
|
#else
|
|
|
|
constexpr bool is_grd = true;
|
|
|
|
#endif
|
|
|
|
gradient.enabled = is_grd && gradient.start_vtool != gradient.end_vtool && gradient.start_z < gradient.end_z;
|
|
|
|
if (gradient.enabled) {
|
|
|
|
mixer_perc_t mix_bak[MIXING_STEPPERS];
|
|
|
|
COPY(mix_bak, mix);
|
|
|
|
update_mix_from_vtool(gradient.start_vtool);
|
|
|
|
COPY(gradient.start_mix, mix);
|
|
|
|
update_mix_from_vtool(gradient.end_vtool);
|
|
|
|
COPY(gradient.end_mix, mix);
|
|
|
|
update_gradient_for_planner_z();
|
|
|
|
COPY(mix, mix_bak);
|
|
|
|
prev_z = -1;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif // GRADIENT_MIX
|
2018-10-16 08:38:57 +00:00
|
|
|
|
|
|
|
// Used in Stepper
|
2019-02-03 05:30:26 +00:00
|
|
|
FORCE_INLINE static uint8_t get_stepper() { return runner; }
|
|
|
|
FORCE_INLINE static uint8_t get_next_stepper() {
|
2019-02-10 10:54:23 +00:00
|
|
|
for (;;) {
|
2018-10-16 08:38:57 +00:00
|
|
|
if (--runner < 0) runner = MIXING_STEPPERS - 1;
|
|
|
|
accu[runner] += s_color[runner];
|
|
|
|
if (
|
|
|
|
#ifdef MIXER_ACCU_SIGNED
|
|
|
|
accu[runner] < 0
|
|
|
|
#else
|
|
|
|
accu[runner] & COLOR_A_MASK
|
|
|
|
#endif
|
|
|
|
) {
|
|
|
|
accu[runner] &= COLOR_MASK;
|
|
|
|
return runner;
|
|
|
|
}
|
2019-02-10 10:54:23 +00:00
|
|
|
}
|
2018-10-16 08:38:57 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
private:
|
|
|
|
|
|
|
|
// Used up to Planner level
|
2019-02-03 05:30:26 +00:00
|
|
|
static uint_fast8_t selected_vtool;
|
|
|
|
static mixer_comp_t color[NR_MIXING_VIRTUAL_TOOLS][MIXING_STEPPERS];
|
2018-10-16 08:38:57 +00:00
|
|
|
|
|
|
|
// Used in Stepper
|
2019-02-03 05:30:26 +00:00
|
|
|
static int_fast8_t runner;
|
|
|
|
static mixer_comp_t s_color[MIXING_STEPPERS];
|
|
|
|
static mixer_accu_t accu[MIXING_STEPPERS];
|
2018-10-16 08:38:57 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
extern Mixer mixer;
|