/* * Anduril: Narsil-inspired UI for SpaghettiMonster. * (Anduril is Aragorn's sword, the blade Narsil reforged) * * Copyright (C) 2017 Selene ToyKeeper * * 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 . */ #define FSM_EMISAR_D4_LAYOUT #define USE_LVP #define USE_THERMAL_REGULATION #define DEFAULT_THERM_CEIL 32 #define USE_DELAY_MS #define USE_DELAY_4MS #define USE_DELAY_ZERO #define USE_RAMPING #define USE_BATTCHECK #define BATTCHECK_VpT #define RAMP_LENGTH 150 #define MAX_CLICKS 6 #include "spaghetti-monster.h" // FSM states uint8_t off_state(EventPtr event, uint16_t arg); uint8_t steady_state(EventPtr event, uint16_t arg); uint8_t strobe_state(EventPtr event, uint16_t arg); #ifdef USE_BATTCHECK uint8_t battcheck_state(EventPtr event, uint16_t arg); uint8_t tempcheck_state(EventPtr event, uint16_t arg); #endif uint8_t lockout_state(EventPtr event, uint16_t arg); uint8_t momentary_state(EventPtr event, uint16_t arg); void blink_confirm(uint8_t num); // brightness control uint8_t memorized_level = MAX_1x7135; // smooth vs discrete ramping uint8_t ramp_style = 0; // 0 = smooth, 1 = discrete uint8_t ramp_smooth_floor = 1; uint8_t ramp_smooth_ceil = MAX_LEVEL; uint8_t ramp_discrete_floor = 20; uint8_t ramp_discrete_ceil = MAX_LEVEL - 50; uint8_t ramp_discrete_steps = 7; uint8_t ramp_discrete_step_size; // don't set this // calculate the nearest ramp level which would be valid at the moment // (is a no-op for smooth ramp, but limits discrete ramp to only the // correct levels for the user's config) uint8_t nearest_level(uint8_t target); #ifdef USE_THERMAL_REGULATION // brightness before thermal step-down uint8_t target_level = 0; #endif // strobe timing volatile uint8_t strobe_delay = 67; volatile uint8_t strobe_type = 0; // 0 == party strobe, 1 == tactical strobe // deferred "off" so we won't suspend in a weird state volatile uint8_t go_to_standby = 0; uint8_t off_state(EventPtr event, uint16_t arg) { // turn emitter off when entering state if (event == EV_enter_state) { set_level(0); // sleep while off (lower power use) go_to_standby = 1; return MISCHIEF_MANAGED; } // hold (initially): go to lowest level, but allow abort for regular click else if (event == EV_click1_press) { if (ramp_style == 0) { set_level(ramp_smooth_floor); } else { set_level(ramp_discrete_floor); } return MISCHIEF_MANAGED; } // 1 click (before timeout): go to memorized level, but allow abort for double click else if (event == EV_click1_release) { set_level(memorized_level); return MISCHIEF_MANAGED; } // 1 click: regular mode else if (event == EV_1click) { set_state(steady_state, memorized_level); return MISCHIEF_MANAGED; } // 2 clicks (initial press): off, to prep for later events else if (event == EV_click2_press) { set_level(0); return MISCHIEF_MANAGED; } // 2 clicks: highest mode else if (event == EV_2clicks) { if (ramp_style == 0) { set_state(steady_state, ramp_smooth_ceil); } else { set_state(steady_state, ramp_discrete_ceil); } return MISCHIEF_MANAGED; } #ifdef USE_BATTCHECK // 3 clicks: battcheck mode else if (event == EV_3clicks) { set_state(battcheck_state, 0); return MISCHIEF_MANAGED; } #endif // 4 clicks: soft lockout else if (event == EV_4clicks) { blink_confirm(5); set_state(lockout_state, 0); return MISCHIEF_MANAGED; } // 5 clicks: strobe mode else if (event == EV_5clicks) { set_state(strobe_state, 0); return MISCHIEF_MANAGED; } // 6 clicks: momentary mode else if (event == EV_6clicks) { blink_confirm(1); set_state(momentary_state, 0); return MISCHIEF_MANAGED; } // hold: go to lowest level else if (event == EV_click1_hold) { // don't start ramping immediately; // give the user time to release at moon level if (arg >= HOLD_TIMEOUT) { if (ramp_style == 0) { set_state(steady_state, ramp_smooth_floor); } else { set_state(steady_state, ramp_discrete_floor); } } return MISCHIEF_MANAGED; } // hold, release quickly: go to lowest level else if (event == EV_click1_hold_release) { if (ramp_style == 0) { set_state(steady_state, ramp_smooth_floor); } else { set_state(steady_state, ramp_discrete_floor); } return MISCHIEF_MANAGED; } // click, hold: go to highest level (for ramping down) else if (event == EV_click2_hold) { if (ramp_style == 0) { set_state(steady_state, ramp_smooth_ceil); } else { set_state(steady_state, ramp_discrete_ceil); } return MISCHIEF_MANAGED; } return EVENT_NOT_HANDLED; } uint8_t steady_state(EventPtr event, uint16_t arg) { uint8_t mode_min = ramp_smooth_floor; uint8_t mode_max = ramp_smooth_ceil; uint8_t ramp_step_size = 1; if (ramp_style) { mode_min = ramp_discrete_floor; mode_max = ramp_discrete_ceil; ramp_step_size = ramp_discrete_step_size; } // turn LED on when we first enter the mode if (event == EV_enter_state) { // remember this level, unless it's moon or turbo if ((arg > mode_min) && (arg < mode_max)) memorized_level = arg; // use the requested level even if not memorized #ifdef USE_THERMAL_REGULATION target_level = arg; #endif set_level(nearest_level(arg)); return MISCHIEF_MANAGED; } // 1 click: off else if (event == EV_1click) { set_state(off_state, 0); return MISCHIEF_MANAGED; } // 2 clicks: go to/from highest level else if (event == EV_2clicks) { if (actual_level < MAX_LEVEL) { memorized_level = actual_level; // in case we're on moon #ifdef USE_THERMAL_REGULATION target_level = MAX_LEVEL; #endif // true turbo, not the mode-specific ceiling set_level(MAX_LEVEL); } else { #ifdef USE_THERMAL_REGULATION target_level = memorized_level; #endif set_level(memorized_level); } return MISCHIEF_MANAGED; } // 3 clicks: toggle smooth vs discrete ramping else if (event == EV_3clicks) { ramp_style ^= 1; if (ramp_style) { mode_min = ramp_discrete_floor; mode_max = ramp_discrete_ceil; } else { mode_min = ramp_smooth_floor; mode_max = ramp_smooth_ceil; } if (memorized_level < mode_min) memorized_level = mode_min; if (memorized_level > mode_max) memorized_level = mode_max; //save_config(); set_level(0); delay_4ms(20/4); set_level(nearest_level(memorized_level)); return MISCHIEF_MANAGED; } // 4 clicks: configure this ramp mode else if (event == EV_4clicks) { // TODO: implement this return MISCHIEF_MANAGED; } // hold: change brightness (brighter) else if (event == EV_click1_hold) { // ramp slower in discrete mode if (ramp_style && (arg % HOLD_TIMEOUT != 0)) { return MISCHIEF_MANAGED; } // TODO: make it ramp down instead, if already at max? if (actual_level + ramp_step_size < mode_max) memorized_level = actual_level + ramp_step_size; else memorized_level = mode_max; memorized_level = nearest_level(memorized_level); #ifdef USE_THERMAL_REGULATION target_level = memorized_level; #endif // only blink once for each threshold if ((memorized_level != actual_level) && ((memorized_level == MAX_1x7135) || (memorized_level == mode_max))) { set_level(0); delay_4ms(8/4); } set_level(memorized_level); return MISCHIEF_MANAGED; } // click, hold: change brightness (dimmer) else if (event == EV_click2_hold) { // ramp slower in discrete mode if (ramp_style && (arg % HOLD_TIMEOUT != 0)) { return MISCHIEF_MANAGED; } // TODO: make it ramp up instead, if already at min? // TODO: test what happens if I go to moon, switch to discrete mode // (with min configured for like 10), then try to ramp down if (actual_level - mode_min > ramp_step_size) memorized_level = (actual_level-ramp_step_size); else memorized_level = mode_min; memorized_level = nearest_level(memorized_level); #ifdef USE_THERMAL_REGULATION target_level = memorized_level; #endif // only blink once for each threshold if ((memorized_level != actual_level) && ((memorized_level == MAX_1x7135) || (memorized_level == mode_min))) { set_level(0); delay_4ms(8/4); } set_level(memorized_level); return MISCHIEF_MANAGED; } #ifdef USE_THERMAL_REGULATION // TODO: test this on a real light // overheating: drop by an amount proportional to how far we are above the ceiling else if (event == EV_temperature_high) { if (actual_level > MAX_LEVEL/4) { uint8_t stepdown = actual_level - arg; if (stepdown < MAX_LEVEL/4) stepdown = MAX_LEVEL/4; set_level(stepdown); } return MISCHIEF_MANAGED; } // underheating: increase slowly if we're lower than the target // (proportional to how low we are) else if (event == EV_temperature_low) { if (actual_level < target_level) { uint8_t stepup = actual_level + (arg>>1); if (stepup > target_level) stepup = target_level; set_level(stepup); } return MISCHIEF_MANAGED; } #endif return EVENT_NOT_HANDLED; } uint8_t strobe_state(EventPtr event, uint16_t arg) { if (event == EV_enter_state) { return MISCHIEF_MANAGED; } // 1 click: off else if (event == EV_1click) { set_state(off_state, 0); return MISCHIEF_MANAGED; } // 2 clicks: toggle party strobe vs tactical strobe else if (event == EV_2clicks) { strobe_type ^= 1; return MISCHIEF_MANAGED; } // 3 clicks: go back to regular modes else if (event == EV_3clicks) { set_state(steady_state, memorized_level); return MISCHIEF_MANAGED; } // hold: change speed (go faster) else if (event == EV_click1_hold) { if ((arg & 1) == 0) { if (strobe_delay > 8) strobe_delay --; } return MISCHIEF_MANAGED; } // click, hold: change speed (go slower) else if (event == EV_click2_hold) { if ((arg & 1) == 0) { if (strobe_delay < 255) strobe_delay ++; } return MISCHIEF_MANAGED; } return EVENT_NOT_HANDLED; } #ifdef USE_BATTCHECK uint8_t battcheck_state(EventPtr event, uint16_t arg) { // 1 click: off if (event == EV_1click) { set_state(off_state, 0); return MISCHIEF_MANAGED; } // 2 clicks: tempcheck mode else if (event == EV_2clicks) { set_state(tempcheck_state, 0); return MISCHIEF_MANAGED; } return EVENT_NOT_HANDLED; } uint8_t tempcheck_state(EventPtr event, uint16_t arg) { // 1 click: off if (event == EV_1click) { set_state(off_state, 0); return MISCHIEF_MANAGED; } return EVENT_NOT_HANDLED; } #endif uint8_t lockout_state(EventPtr event, uint16_t arg) { // conserve power while locked out // (allow staying awake long enough to exit, but otherwise // be persistent about going back to sleep every few seconds // even if the user keeps pressing the button) if (event == EV_tick) { static uint8_t ticks_spent_awake = 0; ticks_spent_awake ++; if (ticks_spent_awake > 180) { ticks_spent_awake = 0; go_to_standby = 1; } return MISCHIEF_MANAGED; } // 4 clicks: exit else if (event == EV_4clicks) { blink_confirm(2); set_state(off_state, 0); return MISCHIEF_MANAGED; } return EVENT_NOT_HANDLED; } uint8_t momentary_state(EventPtr event, uint16_t arg) { if (event == EV_click1_press) { set_level(memorized_level); empty_event_sequence(); // don't attempt to parse multiple clicks return MISCHIEF_MANAGED; } else if (event == EV_release) { set_level(0); empty_event_sequence(); // don't attempt to parse multiple clicks //go_to_standby = 1; // sleep while light is off return MISCHIEF_MANAGED; } // Sleep, dammit! (but wait a few seconds first) // (because standby mode uses such little power that it can interfere // with exiting via tailcap loosen+tighten unless you leave power // disconnected for several seconds, so we want to be awake when that // happens to speed up the process) else if ((event == EV_tick) && (actual_level == 0)) { if (arg > TICKS_PER_SECOND*15) { // sleep after 15 seconds go_to_standby = 1; // sleep while light is off } return MISCHIEF_MANAGED; } return EVENT_NOT_HANDLED; } uint8_t nearest_level(uint8_t target) { if (! ramp_style) return target; if (target < ramp_discrete_floor) return ramp_discrete_floor; uint8_t ramp_range = ramp_discrete_ceil - ramp_discrete_floor; ramp_discrete_step_size = ramp_range / (ramp_discrete_steps-1); uint8_t this_level = ramp_discrete_floor; for(uint8_t i=0; i>1)) return this_level; } return this_level; } void blink_confirm(uint8_t num) { for (; num>0; num--) { set_level(MAX_LEVEL/4); delay_4ms(10/4); set_level(0); delay_4ms(100/4); } } void low_voltage() { // "step down" from strobe to something low if (current_state == strobe_state) { set_state(steady_state, RAMP_SIZE/6); } // in normal mode, step down by half or turn off else if (current_state == steady_state) { if (actual_level > 1) { set_level(actual_level >> 1); } else { set_state(off_state, 0); } } // all other modes, just turn off when voltage is low else { set_state(off_state, 0); } } void setup() { set_level(RAMP_SIZE/8); delay_4ms(3); set_level(0); push_state(off_state, 0); } void loop() { // deferred "off" so we won't suspend in a weird state // (like... during the middle of a strobe pulse) if (go_to_standby) { go_to_standby = 0; set_level(0); standby_mode(); } if (current_state == strobe_state) { set_level(MAX_LEVEL); if (strobe_type == 0) { // party strobe if (strobe_delay < 30) delay_zero(); else delay_ms(1); } else { //tactical strobe nice_delay_ms(strobe_delay >> 1); } set_level(0); nice_delay_ms(strobe_delay); } #ifdef USE_BATTCHECK else if (current_state == battcheck_state) { battcheck(); } else if (current_state == tempcheck_state) { blink_num(projected_temperature>>2); nice_delay_ms(1000); } #endif }