320 lines
11 KiB
C++
320 lines
11 KiB
C++
/**
|
|
* Marlin 3D Printer Firmware
|
|
* Copyright (c) 2020 MarlinFirmware [https://github.com/MarlinFirmware/Marlin]
|
|
*
|
|
* Based on Sprinter and grbl.
|
|
* Copyright (c) 2011 Camiel Gubbels / Erik van der Zalm
|
|
*
|
|
* 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
|
|
* along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
#pragma once
|
|
|
|
/**
|
|
* feature/spindle_laser.h
|
|
* Support for Laser Power or Spindle Power & Direction
|
|
*/
|
|
|
|
#include "../inc/MarlinConfig.h"
|
|
|
|
#include "spindle_laser_types.h"
|
|
|
|
#if USE_BEEPER
|
|
#include "../libs/buzzer.h"
|
|
#endif
|
|
|
|
#if ENABLED(LASER_POWER_INLINE)
|
|
#include "../module/planner.h"
|
|
#endif
|
|
|
|
#define PCT_TO_PWM(X) ((X) * 255 / 100)
|
|
#define PCT_TO_SERVO(X) ((X) * 180 / 100)
|
|
|
|
#ifndef SPEED_POWER_INTERCEPT
|
|
#define SPEED_POWER_INTERCEPT 0
|
|
#endif
|
|
|
|
// #define _MAP(N,S1,S2,D1,D2) ((N)*_MAX((D2)-(D1),0)/_MAX((S2)-(S1),1)+(D1))
|
|
|
|
class SpindleLaser {
|
|
public:
|
|
static constexpr float
|
|
min_pct = TERN(CUTTER_POWER_RELATIVE, 0, TERN(SPINDLE_FEATURE, round(100.0f * (SPEED_POWER_MIN) / (SPEED_POWER_MAX)), SPEED_POWER_MIN)),
|
|
max_pct = TERN(SPINDLE_FEATURE, 100, SPEED_POWER_MAX);
|
|
|
|
static const inline uint8_t pct_to_ocr(const float pct) { return uint8_t(PCT_TO_PWM(pct)); }
|
|
|
|
// cpower = configured values (e.g., SPEED_POWER_MAX)
|
|
|
|
// Convert configured power range to a percentage
|
|
static const inline uint8_t cpwr_to_pct(const cutter_cpower_t cpwr) {
|
|
constexpr cutter_cpower_t power_floor = TERN(CUTTER_POWER_RELATIVE, SPEED_POWER_MIN, 0),
|
|
power_range = SPEED_POWER_MAX - power_floor;
|
|
return cpwr ? round(100.0f * (cpwr - power_floor) / power_range) : 0;
|
|
}
|
|
|
|
// Convert a cpower (e.g., SPEED_POWER_STARTUP) to unit power (upwr, upower),
|
|
// which can be PWM, Percent, Servo angle, or RPM (rel/abs).
|
|
static const inline cutter_power_t cpwr_to_upwr(const cutter_cpower_t cpwr) { // STARTUP power to Unit power
|
|
const cutter_power_t upwr = (
|
|
#if ENABLED(SPINDLE_FEATURE)
|
|
// Spindle configured values are in RPM
|
|
#if CUTTER_UNIT_IS(RPM)
|
|
cpwr // to RPM
|
|
#elif CUTTER_UNIT_IS(PERCENT) // to PCT
|
|
cpwr_to_pct(cpwr)
|
|
#elif CUTTER_UNIT_IS(SERVO) // to SERVO angle
|
|
PCT_TO_SERVO(cpwr_to_pct(cpwr))
|
|
#else // to PWM
|
|
PCT_TO_PWM(cpwr_to_pct(cpwr))
|
|
#endif
|
|
#else
|
|
// Laser configured values are in PCT
|
|
#if CUTTER_UNIT_IS(PWM255)
|
|
PCT_TO_PWM(cpwr)
|
|
#else
|
|
cpwr // to RPM/PCT
|
|
#endif
|
|
#endif
|
|
);
|
|
return upwr;
|
|
}
|
|
|
|
static const cutter_power_t mpower_min() { return cpwr_to_upwr(SPEED_POWER_MIN); }
|
|
static const cutter_power_t mpower_max() { return cpwr_to_upwr(SPEED_POWER_MAX); }
|
|
|
|
#if ENABLED(LASER_FEATURE)
|
|
static cutter_test_pulse_t testPulse; // Test fire Pulse ms value
|
|
#endif
|
|
|
|
static bool isReady; // Ready to apply power setting from the UI to OCR
|
|
static uint8_t power;
|
|
|
|
#if ENABLED(MARLIN_DEV_MODE)
|
|
static cutter_frequency_t frequency; // Set PWM frequency; range: 2K-50K
|
|
#endif
|
|
|
|
static cutter_power_t menuPower, // Power as set via LCD menu in PWM, Percentage or RPM
|
|
unitPower; // Power as displayed status in PWM, Percentage or RPM
|
|
|
|
static void init();
|
|
|
|
#if ENABLED(MARLIN_DEV_MODE)
|
|
static inline void refresh_frequency() { set_pwm_frequency(pin_t(SPINDLE_LASER_PWM_PIN), frequency); }
|
|
#endif
|
|
|
|
// Modifying this function should update everywhere
|
|
static inline bool enabled(const cutter_power_t opwr) { return opwr > 0; }
|
|
static inline bool enabled() { return enabled(power); }
|
|
|
|
static void apply_power(const uint8_t inpow);
|
|
|
|
FORCE_INLINE static void refresh() { apply_power(power); }
|
|
FORCE_INLINE static void set_power(const uint8_t upwr) { power = upwr; refresh(); }
|
|
|
|
#if ENABLED(SPINDLE_LASER_PWM)
|
|
|
|
private:
|
|
|
|
static void _set_ocr(const uint8_t ocr);
|
|
|
|
public:
|
|
|
|
static void set_ocr(const uint8_t ocr);
|
|
static inline void set_ocr_power(const uint8_t ocr) { power = ocr; set_ocr(ocr); }
|
|
static void ocr_off();
|
|
// Used to update output for power->OCR translation
|
|
static inline uint8_t upower_to_ocr(const cutter_power_t upwr) {
|
|
return (
|
|
#if CUTTER_UNIT_IS(PWM255)
|
|
uint8_t(upwr)
|
|
#elif CUTTER_UNIT_IS(PERCENT)
|
|
pct_to_ocr(upwr)
|
|
#else
|
|
uint8_t(pct_to_ocr(cpwr_to_pct(upwr)))
|
|
#endif
|
|
);
|
|
}
|
|
|
|
// Correct power to configured range
|
|
static inline cutter_power_t power_to_range(const cutter_power_t pwr) {
|
|
return power_to_range(pwr, (
|
|
#if CUTTER_UNIT_IS(PWM255)
|
|
0
|
|
#elif CUTTER_UNIT_IS(PERCENT)
|
|
1
|
|
#elif CUTTER_UNIT_IS(RPM)
|
|
2
|
|
#else
|
|
#error "CUTTER_UNIT_IS(unknown)"
|
|
#endif
|
|
));
|
|
}
|
|
static inline cutter_power_t power_to_range(const cutter_power_t pwr, const uint8_t pwrUnit) {
|
|
if (pwr <= 0) return 0;
|
|
cutter_power_t upwr;
|
|
switch (pwrUnit) {
|
|
case 0: // PWM
|
|
upwr = cutter_power_t(
|
|
(pwr < pct_to_ocr(min_pct)) ? pct_to_ocr(min_pct) // Use minimum if set below
|
|
: (pwr > pct_to_ocr(max_pct)) ? pct_to_ocr(max_pct) // Use maximum if set above
|
|
: pwr
|
|
);
|
|
break;
|
|
case 1: // PERCENT
|
|
upwr = cutter_power_t(
|
|
(pwr < min_pct) ? min_pct // Use minimum if set below
|
|
: (pwr > max_pct) ? max_pct // Use maximum if set above
|
|
: pwr // PCT
|
|
);
|
|
break;
|
|
case 2: // RPM
|
|
upwr = cutter_power_t(
|
|
(pwr < SPEED_POWER_MIN) ? SPEED_POWER_MIN // Use minimum if set below
|
|
: (pwr > SPEED_POWER_MAX) ? SPEED_POWER_MAX // Use maximum if set above
|
|
: pwr // Calculate OCR value
|
|
);
|
|
break;
|
|
default: break;
|
|
}
|
|
return upwr;
|
|
}
|
|
|
|
#endif // SPINDLE_LASER_PWM
|
|
|
|
static inline void set_enabled(const bool enable) {
|
|
set_power(enable ? TERN(SPINDLE_LASER_PWM, (power ?: (unitPower ? upower_to_ocr(cpwr_to_upwr(SPEED_POWER_STARTUP)) : 0)), 255) : 0);
|
|
}
|
|
|
|
// Wait for spindle to spin up or spin down
|
|
static inline void power_delay(const bool on) {
|
|
#if DISABLED(LASER_POWER_INLINE)
|
|
safe_delay(on ? SPINDLE_LASER_POWERUP_DELAY : SPINDLE_LASER_POWERDOWN_DELAY);
|
|
#endif
|
|
}
|
|
|
|
#if ENABLED(SPINDLE_CHANGE_DIR)
|
|
static void set_reverse(const bool reverse);
|
|
static bool is_reverse() { return READ(SPINDLE_DIR_PIN) == SPINDLE_INVERT_DIR; }
|
|
#else
|
|
static inline void set_reverse(const bool) {}
|
|
static bool is_reverse() { return false; }
|
|
#endif
|
|
|
|
static inline void disable() { isReady = false; set_enabled(false); }
|
|
|
|
#if HAS_LCD_MENU
|
|
|
|
static inline void enable_with_dir(const bool reverse) {
|
|
isReady = true;
|
|
const uint8_t ocr = TERN(SPINDLE_LASER_PWM, upower_to_ocr(menuPower), 255);
|
|
if (menuPower)
|
|
power = ocr;
|
|
else
|
|
menuPower = cpwr_to_upwr(SPEED_POWER_STARTUP);
|
|
unitPower = menuPower;
|
|
set_reverse(reverse);
|
|
set_enabled(true);
|
|
}
|
|
FORCE_INLINE static void enable_forward() { enable_with_dir(false); }
|
|
FORCE_INLINE static void enable_reverse() { enable_with_dir(true); }
|
|
FORCE_INLINE static void enable_same_dir() { enable_with_dir(is_reverse()); }
|
|
|
|
#if ENABLED(SPINDLE_LASER_PWM)
|
|
static inline void update_from_mpower() {
|
|
if (isReady) power = upower_to_ocr(menuPower);
|
|
unitPower = menuPower;
|
|
}
|
|
#endif
|
|
|
|
#if ENABLED(LASER_FEATURE)
|
|
/**
|
|
* Test fire the laser using the testPulse ms duration
|
|
* Also fires with any PWM power that was previous set
|
|
* If not set defaults to 80% power
|
|
*/
|
|
static inline void test_fire_pulse() {
|
|
enable_forward(); // Turn Laser on (Spindle speak but same funct)
|
|
TERN_(USE_BEEPER, buzzer.tone(30, 3000));
|
|
delay(testPulse); // Delay for time set by user in pulse ms menu screen.
|
|
disable(); // Turn laser off
|
|
}
|
|
#endif
|
|
|
|
#endif // HAS_LCD_MENU
|
|
|
|
#if ENABLED(LASER_POWER_INLINE)
|
|
/**
|
|
* Inline power adds extra fields to the planner block
|
|
* to handle laser power and scale to movement speed.
|
|
*/
|
|
|
|
// Force disengage planner power control
|
|
static inline void inline_disable() {
|
|
isReady = false;
|
|
unitPower = 0;
|
|
planner.laser_inline.status.isPlanned = false;
|
|
planner.laser_inline.status.isEnabled = false;
|
|
planner.laser_inline.power = 0;
|
|
}
|
|
|
|
// Inline modes of all other functions; all enable planner inline power control
|
|
static inline void set_inline_enabled(const bool enable) {
|
|
if (enable)
|
|
inline_power(255);
|
|
else {
|
|
isReady = false;
|
|
unitPower = menuPower = 0;
|
|
planner.laser_inline.status.isPlanned = false;
|
|
TERN(SPINDLE_LASER_PWM, inline_ocr_power, inline_power)(0);
|
|
}
|
|
}
|
|
|
|
// Set the power for subsequent movement blocks
|
|
static void inline_power(const cutter_power_t upwr) {
|
|
unitPower = menuPower = upwr;
|
|
#if ENABLED(SPINDLE_LASER_PWM)
|
|
#if ENABLED(SPEED_POWER_RELATIVE) && !CUTTER_UNIT_IS(RPM) // relative mode does not turn laser off at 0, except for RPM
|
|
planner.laser_inline.status.isEnabled = true;
|
|
planner.laser_inline.power = upower_to_ocr(upwr);
|
|
isReady = true;
|
|
#else
|
|
inline_ocr_power(upower_to_ocr(upwr));
|
|
#endif
|
|
#else
|
|
planner.laser_inline.status.isEnabled = enabled(upwr);
|
|
planner.laser_inline.power = upwr;
|
|
isReady = enabled(upwr);
|
|
#endif
|
|
}
|
|
|
|
static inline void inline_direction(const bool) { /* never */ }
|
|
|
|
#if ENABLED(SPINDLE_LASER_PWM)
|
|
static inline void inline_ocr_power(const uint8_t ocrpwr) {
|
|
isReady = ocrpwr > 0;
|
|
planner.laser_inline.status.isEnabled = ocrpwr > 0;
|
|
planner.laser_inline.power = ocrpwr;
|
|
}
|
|
#endif
|
|
#endif // LASER_POWER_INLINE
|
|
|
|
static inline void kill() {
|
|
TERN_(LASER_POWER_INLINE, inline_disable());
|
|
disable();
|
|
}
|
|
};
|
|
|
|
extern SpindleLaser cutter;
|