path: root/ChangeLog.md

# ChangeLog

Items should be sorted roughly in order of most to least important, with 
model-specific changes at the bottom.  Most items should use one of these 
formats:

  - Breaking change:
  - Added
  - Fixed
  - Removed
  - Changed
  - Documented
  - @brand-model: Hardware-specific change (NNNN, NNNN, ...)

# Next

# 2023-10-31

General:

- Finally finished converting all lights to the multi-channel API.
  (but a few are untested due to hardware being unavailable)
- Enabled smooth steps on almost all supported lights, including old ones.
  (in some cases, on old t85 lights, some other things may have been removed
   to make room)
- Made smooth steps work better, and fixed several bugs.
- Added/fixed RGB aux voltage on dual-fuel AA/li-ion drivers.
- Fixed delay timing on all supported MCUs, so 1 "second" is closer to an
  actual second (like in beacon mode or biking mode).
  (especially attiny1616, which was 17% too slow)
- Raised default thermal limit to 50C on attiny1616-based lights, since
  it doesn't need as big an error margin as older MCUs.
- Fixed missing item in globals menu on some lights.
- Misc internal improvements and per-light tweaks.
- Added a ChangeLog.md, to periodically summarize changes in a format which is
  more readable than the raw commit logs.

New lights:

- @thefreeman-boost21-6a: Added.  (1631)
  (very nice HDR boost driver which fits into a FW3A)
- @thefreeman-boost-fwaa: Added.  (1632)
  (very nice AA/li-ion HDR boost driver which fits into a FWAA)

Hardware-specific changes:

- Upgraded several builds to use delta-sigma modulation (DSM), for
  lower lows and smoother ramping with less flicker or ripple:
  - @blf-lt1  (0621)
  - @blf-lt1-t1616  (0622)
  - @emisar-d4k-3ch  (0151)
    (**dramatically** improves resolution and low modes on its 8-bit channel)
  - @noctigon-dm11-boost  (0273)
  - @noctigon-kr4-boost  (0216)
  - @noctigon-k1-boost  (0253)
  - @noctigon-m44  (0143)

- Upgraded some builds to use dynamic PWM, for lower lows and smoother ramping:
  - @blf-q8-t1616,  @sofirn-sp36-t1616  (0613, 0614)
  - @gchart-fet1-t1616  (1618)
  - @noctigon-k1-sbt90  (0252)

- @wurkkos-ts10, @wurkkos-ts10-rgbaux: Fixed too-high default ceiling.  (0713, 0714)

# 2023-10-01

General:

- Updated a bunch of lights to work with the new multi-channel API.
- Added "smooth steps" a.k.a. "soft start", to make on/off and step changes
  smooth.  (enabled by default, can be turned off in Ramp Extras menu)
- User can save a different channel mode for each strobe-group mode.
- Made strobes/blinkies more responsive in Tactical Mode.
- Fixed bug: Tactical Mode clobbers strobe group memory.
- Fixed some minor post-off voltage display bugs.
- Made RGB button brightness update faster in blinky modes.
- Fixed bug: Wrong channel after colored factory reset.
- @attiny1616, @attiny1634: Partially fixed oscillating aux LED voltage 
  colors while off.  Better than before, but can still happen in some cases.
- @attiny1616: Fixed spurious voltage warnings in sleep mode.  (it could 
  sometimes go from Lockout mode to Off mode by itself)
- Lots of internal refactoring.

New lights:

- @emisar-2ch-fet: Added.  (0136)
- @emisar-d4k-3ch: Added.  (0151)
- @noctigon-m44: Added.  (0143)
- @wurkkos-ts10-rgbaux: Added.  (0713)

Hardware-specific changes:

- @ff-e01, @ff-pl47, @ff-pl47g2: Enabled smooth steps instead of SOS mode.
  (0421, 0422, 0423, 0441)
- @emisar-2ch, @noctigon-m44: Added RGB aux channel modes.  (0135, 0143)
- @emisar-2ch-fet, @noctigon-k9.3: New ramps with better-calibrated shape.
  (0136, 0261)
- @emisar-d4v2-nofet: New ramp table.  (0115)
- @emisar-d4sv2-tintramp: Removed / renamed.  (0135, 0136)
- @noctigon-k9.3: Fixed years-old mess.  Merged builds, converted to
  multi-channel, removed old builds, generally got K9.3 working quite a bit
  better.  (0261, 0262, 0263, 0265, 0266, 0267)
- @noctigon-m44: Lower moon, and greatly reduced flicker.  (0143)
- @sofirn-lt1s-pro: Allow configuring the blink channel.  (0623)
- @wurkkos: Raised default temperature limit to 50 C.  (07xx)
- @wurkkos-ts10: Better / smoother ramp.  (0713, 0714)

# 2023-06-29

- Fixed red aux blink on 1st frame of post-off voltage display
- Removed Harry Potter references because its author (J.K. Rowling) spreads 
  hate
- @noctigon-kr4: Fixed thermal regulation (0211, 0212, 0213, 0214, 0215, 0216)

# 2023-05-30

- Breaking change: Changed version check from YYYYMMDDXXXX to XXXX.YYYY-MM-DD, 
  where the punctuation makes a "buzz" instead of number blinks.
- Fixed issue where some lights always thought they were overheating (when 
  cold, or after a factory reset)
- Fixed aux pre-flash
- Fixed a rare corner case where gradual brightness adjustments stopped at 99% 
  power instead of 100% power while going up from level 149/150 to 150/150 on 
  some lights
- Changed "0" digit readout to use the same timing as other short blinks, to 
  help ensure it works on all lights.
- Minor code changes with no runtime impact
- Documented new version check format
- @wurkkos: Added red+blue police strobe (0715, 0716, 0717)
- @noctigon-kr4: Broke thermal regulation (oops) (0211, 0212, 0213, 0214, 
  0215, 0216)
- @noctigon-kr4: Use 7 aux channel modes instead of 3 (0211, 0212, 0213, 0214, 
  0215, 0216)
- @emisar-d4v2: Changed number blinks from aux to main LEDs by default (0113, 
  0114, 0115, 0123)

# 2023-05-17

- @noctigon-dm11-12v: Renamed to noctigon-dm11-boost (0273)
- @noctigon-dm11-boost: Now supported in multi-channel branch (0273)

# 2023-05-02

- Added ability to set channel mode for number readouts (batt check, temp 
  check, version check). Press 3C in batt check mode to change the blink 
  channel.
- Changed post-off voltage display:
  - Display for 4s by default, not 5s
  - Made timing user-configurable in battcheck 7H menu item 2
    (1 click per second the display should last)
  - Use low brightness when torch was at moon level before
  - Skip the voltage display after UI actions which didn't change the mode 
    (like "Off -> 7C" to change aux LED settings)
- Changed RGB button behavior: While torch is on, use low mode below a 
  configured level for real-time voltage color display, instead of always 
  using high mode
- Fixed bug: Channel change could stick when activating a config menu from 
  battcheck (the blink function changed the channel, then the config menu 
  saved it, then the blink function restored it, then the config menu restored 
  it to the value it saved, which was wrong)
- Documented ramp 6C, ramp 4C, ramp 4H, lockout 3H, battcheck 3C, and post-off 
  voltage display config
- @emisar-d4v2: Added the rest of the aux RGB colors as channel modes, and set 
  aux "white" as the mode it uses to blink out numbers (0113, 0114, 0115, 
  0123)
- @wurkkos-ts10: Converted to multi-channel, and gave it a new ramp with 
  better low modes (0714)
- @wurkkos-ts25: Converted to multi-channel, and gave it a smoother ramp 
  (0715)
- @wurkkos: Added Wurkkos FC13 and TS11 (0716, 0717)

# 2023-04-29

- Changed lockout mode:
  - Fixed manual memory timer and tint
  - Added 3H for next channel (to change channels without unlocking, was 
    possible before but needed to be updated for the new channel system)
  - Made 3H+ use mem level instead of lowest moon (this is needed for
    making the channel discernible, and also helps make aux LED controls
    stand out more)
- @emisar, @noctigon: Added Extended Simple UI to Hank's config, so a few more 
  features are allowed in simple mode
- @emisar-d4v2, @noctigon-kr4: Slightly smaller ROM size
- @emisar-d4sv2: Converted to multi-channel, and updated it to use dynamic PWM 
  for a smoother ramp with lower lows (0133, 0134)
- @noctigon-kr4: Converted to multi-channel (0211, 0212, 0213, 0214)
- @noctigon-kr4: Don't blink at top of regulated power (0211, 0213, 0214)

# 2023-04-28

- Added voltage display (by color) on RGB aux LEDs after turning the main LEDs 
  off
- Changed RGB aux: Always preview in high mode while changing color or pattern
- Changed default RGB aux color in lockout mode: Uses blinking voltage, 
  instead of blinking disco (unless model-specific config defines a different 
  default)
- Changed tactical mode default config: only use 2-color strobe if it's on 
  main LEDs, not aux LEDs
- @emisar-d4v2: Smoother ramp (0113, 0114)
- @emisar-d4v2: Added hidden channel modes for RGB aux LEDs (0113, 0114, 0115)

# 2023-04-27

- Changed channel mode menu to preview channels during configuration
- Changed tactical mode default config: use 2-color police strobe if it 
  exists, instead of single-color strobe
- Fixed unnecessary flickering when changing channel modes from/to the same 
  value
- Fixed sleep voltage measurement on attiny1616
- @noctigon-kr4-tintramp: Converted to multi-channel, renamed to 
  noctigon-kr4-2ch (0215)

# 2023-04-25

- Fixed old old bug(s) with voltage measurement while asleep, while also 
  adding other improvements:
  - Fixed oscillating RGB aux colors while asleep in voltage mode, mostly.  
    Some much smaller oscillations are still possible, but the primary issue 
    has been fixed, I think.
  - Fixed old old bug which could cause spurious low-voltage warnings while 
    asleep (previously required a messy code workaround).
  - Reduced avg standby power by ~15uA.
  - Now measures voltage every 1s instead of 8s while asleep.
  - Changed RGB aux behavior: Puts aux LEDs in high mode for 3 seconds after 
    light goes to sleep (much easier to see the voltage this way)
    (this change was obsoleted soon by a better post-off voltage display)
  - Broke sleep voltage measurement on attiny1616 (oops)
- Changed internal details for how gradual ramping works
- @emisar-d4sv2-tintramp: Converted to multi-channel, renamed to emisar-2ch. 
  (0135)
- @sofirn-lt1s-pro: Updated to use today's new code internals (0623)

# 2023-04-19

- Added stepped tint ramping
- Documented new channel modes system
- @sofirn-lt1s-pro: Added white-only auto-tint mode (0623)

# Older: TODO

- Need to import old commit logs as changelog items


<!-- vim: set textwidth=78 shiftwidth=2 -->