/** * Marlin 3D Printer Firmware * Copyright (C) 2016 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 . * */ #ifndef MACROS_H #define MACROS_H #define NUM_AXIS 4 #define ABCE 4 #define XYZE 4 #define ABC 3 #define XYZ 3 #define _XMIN_ 100 #define _YMIN_ 200 #define _ZMIN_ 300 #define _XMAX_ 101 #define _YMAX_ 201 #define _ZMAX_ 301 #define _FORCE_INLINE_ __attribute__((__always_inline__)) __inline__ #define FORCE_INLINE __attribute__((always_inline)) inline #define _UNUSED __attribute__((unused)) #define _O0 __attribute__((optimize("O0"))) #define _Os __attribute__((optimize("Os"))) #define _O1 __attribute__((optimize("O1"))) #define _O2 __attribute__((optimize("O2"))) #define _O3 __attribute__((optimize("O3"))) // Clock speed factors #if !defined(CYCLES_PER_MICROSECOND) && !defined(__STM32F1__) #define CYCLES_PER_MICROSECOND (F_CPU / 1000000L) // 16 or 20 on AVR #endif // Processor-level delays for hardware interfaces #ifndef _NOP #define _NOP() do { __asm__ volatile ("nop"); } while (0) #endif #define DELAY_NOPS(X) \ switch (X) { \ case 20: _NOP(); case 19: _NOP(); case 18: _NOP(); case 17: _NOP(); \ case 16: _NOP(); case 15: _NOP(); case 14: _NOP(); case 13: _NOP(); \ case 12: _NOP(); case 11: _NOP(); case 10: _NOP(); case 9: _NOP(); \ case 8: _NOP(); case 7: _NOP(); case 6: _NOP(); case 5: _NOP(); \ case 4: _NOP(); case 3: _NOP(); case 2: _NOP(); case 1: _NOP(); \ } #define DELAY_0_NOP NOOP #define DELAY_1_NOP DELAY_NOPS( 1) #define DELAY_2_NOP DELAY_NOPS( 2) #define DELAY_3_NOP DELAY_NOPS( 3) #define DELAY_4_NOP DELAY_NOPS( 4) #define DELAY_5_NOP DELAY_NOPS( 5) #define DELAY_10_NOP DELAY_NOPS(10) #define DELAY_20_NOP DELAY_NOPS(20) #if CYCLES_PER_MICROSECOND <= 200 #define DELAY_100NS DELAY_NOPS((CYCLES_PER_MICROSECOND + 9) / 10) #else #define DELAY_100NS DELAY_20_NOP #endif // Microsecond delays for hardware interfaces #if CYCLES_PER_MICROSECOND <= 20 #define DELAY_1US DELAY_NOPS(CYCLES_PER_MICROSECOND) #define DELAY_US(X) \ switch (X) { \ case 20: DELAY_1US; case 19: DELAY_1US; case 18: DELAY_1US; case 17: DELAY_1US; \ case 16: DELAY_1US; case 15: DELAY_1US; case 14: DELAY_1US; case 13: DELAY_1US; \ case 12: DELAY_1US; case 11: DELAY_1US; case 10: DELAY_1US; case 9: DELAY_1US; \ case 8: DELAY_1US; case 7: DELAY_1US; case 6: DELAY_1US; case 5: DELAY_1US; \ case 4: DELAY_1US; case 3: DELAY_1US; case 2: DELAY_1US; case 1: DELAY_1US; \ } #else #define DELAY_US(X) delayMicroseconds(X) // May not be usable in CRITICAL_SECTION #define DELAY_1US DELAY_US(1) #endif #define DELAY_2US DELAY_US( 2) #define DELAY_3US DELAY_US( 3) #define DELAY_4US DELAY_US( 4) #define DELAY_5US DELAY_US( 5) #define DELAY_6US DELAY_US( 6) #define DELAY_7US DELAY_US( 7) #define DELAY_8US DELAY_US( 8) #define DELAY_9US DELAY_US( 9) #define DELAY_10US DELAY_US(10) #define DELAY_20US DELAY_US(20) // Remove compiler warning on an unused variable #define UNUSED(x) (void) (x) // Macros to make a string from a macro #define STRINGIFY_(M) #M #define STRINGIFY(M) STRINGIFY_(M) #define A(CODE) " " CODE "\n\t" #define L(CODE) CODE ":\n\t" // Macros for bit masks #undef _BV #define _BV(b) (1 << (b)) #define TEST(n,b) !!((n)&_BV(b)) #define SBI(n,b) (n |= _BV(b)) #define CBI(n,b) (n &= ~_BV(b)) #define _BV32(b) (1UL << (b)) #define TEST32(n,b) !!((n)&_BV32(b)) #define SBI32(n,b) (n |= _BV32(b)) #define CBI32(n,b) (n &= ~_BV32(b)) // Macros for maths shortcuts #ifndef M_PI #define M_PI 3.14159265358979323846 #endif #define RADIANS(d) ((d)*M_PI/180.0) #define DEGREES(r) ((r)*180.0/M_PI) #define HYPOT2(x,y) (sq(x)+sq(y)) #define CIRCLE_AREA(R) (M_PI * sq(R)) #define CIRCLE_CIRC(R) (2.0 * M_PI * (R)) #define SIGN(a) ((a>0)-(a<0)) #define IS_POWER_OF_2(x) ((x) && !((x) & ((x) - 1))) // Macros to contrain values #define NOLESS(v,n) do{ if (v < n) v = n; }while(0) #define NOMORE(v,n) do{ if (v > n) v = n; }while(0) #define LIMIT(v,n1,n2) do{ if (v < n1) v = n1; else if (v > n2) v = n2; }while(0) // Macros to support option testing #define _CAT(a, ...) a ## __VA_ARGS__ #define SWITCH_ENABLED_false 0 #define SWITCH_ENABLED_true 1 #define SWITCH_ENABLED_0 0 #define SWITCH_ENABLED_1 1 #define SWITCH_ENABLED_0x0 0 #define SWITCH_ENABLED_0x1 1 #define SWITCH_ENABLED_ 1 #define ENABLED(b) _CAT(SWITCH_ENABLED_, b) #define DISABLED(b) !ENABLED(b) #define WITHIN(V,L,H) ((V) >= (L) && (V) <= (H)) #define NUMERIC(a) WITHIN(a, '0', '9') #define DECIMAL(a) (NUMERIC(a) || a == '.') #define NUMERIC_SIGNED(a) (NUMERIC(a) || (a) == '-' || (a) == '+') #define DECIMAL_SIGNED(a) (DECIMAL(a) || (a) == '-' || (a) == '+') #define COUNT(a) (sizeof(a)/sizeof(*a)) #define ZERO(a) memset(a,0,sizeof(a)) #define COPY(a,b) memcpy(a,b,min(sizeof(a),sizeof(b))) // Macros for initializing arrays #define ARRAY_6(v1, v2, v3, v4, v5, v6, ...) { v1, v2, v3, v4, v5, v6 } #define ARRAY_5(v1, v2, v3, v4, v5, ...) { v1, v2, v3, v4, v5 } #define ARRAY_4(v1, v2, v3, v4, ...) { v1, v2, v3, v4 } #define ARRAY_3(v1, v2, v3, ...) { v1, v2, v3 } #define ARRAY_2(v1, v2, ...) { v1, v2 } #define ARRAY_1(v1, ...) { v1 } #define _ARRAY_N(N, ...) ARRAY_ ##N(__VA_ARGS__) #define ARRAY_N(N, ...) _ARRAY_N(N, __VA_ARGS__) // Macros for adding #define INC_0 1 #define INC_1 2 #define INC_2 3 #define INC_3 4 #define INC_4 5 #define INC_5 6 #define INC_6 7 #define INC_7 8 #define INC_8 9 #define INCREMENT_(n) INC_ ##n #define INCREMENT(n) INCREMENT_(n) // Macros for subtracting #define DEC_1 0 #define DEC_2 1 #define DEC_3 2 #define DEC_4 3 #define DEC_5 4 #define DEC_6 5 #define DEC_7 6 #define DEC_8 7 #define DEC_9 8 #define DECREMENT_(n) DEC_ ##n #define DECREMENT(n) DECREMENT_(n) #define PIN_EXISTS(PN) (defined(PN ##_PIN) && PN ##_PIN >= 0) #define PENDING(NOW,SOON) ((long)(NOW-(SOON))<0) #define ELAPSED(NOW,SOON) (!PENDING(NOW,SOON)) #define MMM_TO_MMS(MM_M) ((MM_M)/60.0) #define MMS_TO_MMM(MM_S) ((MM_S)*60.0) #define NOOP do{} while(0) #define CEILING(x,y) (((x) + (y) - 1) / (y)) #define MIN3(a, b, c) min(min(a, b), c) #define MIN4(a, b, c, d) min(MIN3(a, b, c), d) #define MIN5(a, b, c, d, e) min(MIN4(a, b, c, d), e) #define MAX3(a, b, c) max(max(a, b), c) #define MAX4(a, b, c, d) max(MAX3(a, b, c), d) #define MAX5(a, b, c, d, e) max(MAX4(a, b, c, d), e) #define UNEAR_ZERO(x) ((x) < 0.000001) #define NEAR_ZERO(x) WITHIN(x, -0.000001, 0.000001) #define NEAR(x,y) NEAR_ZERO((x)-(y)) #define RECIPROCAL(x) (NEAR_ZERO(x) ? 0.0 : 1.0 / (x)) #define FIXFLOAT(f) (f + (f < 0.0 ? -0.00005 : 0.00005)) // // Maths macros that can be overridden by HAL // #define ATAN2(y, x) atan2(y, x) #define FABS(x) fabs(x) #define POW(x, y) pow(x, y) #define SQRT(x) sqrt(x) #define CEIL(x) ceil(x) #define FLOOR(x) floor(x) #define LROUND(x) lround(x) #define FMOD(x, y) fmod(x, y) #define HYPOT(x,y) SQRT(HYPOT2(x,y)) #endif //__MACROS_H