~toykeeper/flashlight-firmware/fsm

483.12.14 by Selene ToyKeeper
switched the rest of FSM + Anduril to use SPDX license headers
1
// Noctigon KR4 / D4V2.5 driver layout (attiny1634)
2
// Copyright (C) 2020-2023 Selene ToyKeeper
3
// SPDX-License-Identifier: GPL-3.0-or-later
4
#pragma once
433.3.1 by Selene Scriven
initial support for Noctigon KR4
5
483.12.14 by Selene ToyKeeper
switched the rest of FSM + Anduril to use SPDX license headers
6
/*
433.3.1 by Selene Scriven
initial support for Noctigon KR4
7
 * Pin / Name / Function
8
 *   1    PA6   FET PWM (direct drive) (PWM1B)
9
 *   2    PA5   R: red aux LED (PWM0B)
10
 *   3    PA4   G: green aux LED
11
 *   4    PA3   B: blue aux LED
481.1.1 by Selene Scriven
added Emisar D4v2.5 support (D4v2 with a KR4 driver, same as KR4 but with lighted button indicator LED support)
12
 *   5    PA2   button LED (D4V2.5 only)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
13
 *   6    PA1   (none)
14
 *   7    PA0   (none)
15
 *   8    GND   GND
16
 *   9    VCC   VCC
17
 *  10    PC5   (none)
18
 *  11    PC4   (none)
19
 *  12    PC3   RESET
20
 *  13    PC2   (none)
21
 *  14    PC1   SCK
22
 *  15    PC0   (none) PWM0A
23
 *  16    PB3   main LED PWM (linear) (PWM1A)
24
 *  17    PB2   MISO / e-switch (PCINT10)
25
 *  18    PB1   MOSI / battery voltage (ADC6)
26
 *  19    PB0   Opamp power
27
 *  20    PA7   (none)
28
 *      ADC12   thermal sensor
29
 *
30
 * Main LED power uses one pin to turn the Opamp on/off,
31
 * and one pin to control Opamp power level.
32
 * Main brightness control uses the power level pin, with 4 kHz 10-bit PWM.
33
 * The on/off pin is only used to turn the main LED on and off,
34
 * not to change brightness.
35
 * Some models also have a direct-drive FET for turbo.
36
 */
37
38
#ifdef ATTINY
39
#undef ATTINY
40
#endif
41
#define ATTINY 1634
42
#include <avr/io.h>
43
433.3.2 by Selene Scriven
KR4: added FET channel, measured output, calibrated ramp
44
#define PWM_CHANNELS 2
483.1.121 by Selene Scriven
got PFM / dynamic PWM actually working on Noctigon KR4
45
#define PWM_BITS 16  // data type needs 16 bits, not 8
46
#define PWM_TOP  255 // highest value used in top half of ramp
47
#define USE_DYN_PWM  // dynamic frequency and speed
433.3.1 by Selene Scriven
initial support for Noctigon KR4
48
49
#define SWITCH_PIN   PB2     // pin 17
50
#define SWITCH_PCINT PCINT10 // pin 17 pin change interrupt
51
#define SWITCH_PCIE  PCIE1   // PCIE1 is for PCINT[11:8]
52
#define SWITCH_PCMSK PCMSK1  // PCMSK1 is for PCINT[11:8]
53
#define SWITCH_PORT  PINB    // PINA or PINB or PINC
54
#define PCINT_vect   PCINT1_vect  // ISR for PCINT[11:8]
55
56
// the button tends to short out the voltage divider,
57
// so ignore voltage while the button is being held
433.3.4 by Selene Scriven
fixed the ADC channel for voltage measurement
58
//#define NO_LVP_WHILE_BUTTON_PRESSED
433.3.1 by Selene Scriven
initial support for Noctigon KR4
59
60
61
#define PWM1_PIN PB3        // pin 16, Opamp reference
62
#define PWM1_LVL OCR1A      // OCR1A is the output compare register for PB3
483.1.121 by Selene Scriven
got PFM / dynamic PWM actually working on Noctigon KR4
63
#define PWM1_CNT TCNT1      // for dynamic PWM, reset phase
483.11.5 by Selene ToyKeeper
applied new phase-hack flags to other builds where relevant
64
#define PWM1_PHASE_RESET_OFF  // force reset while shutting off
65
#define PWM1_PHASE_RESET_ON   // force reset while turning on
66
#define PWM1_PHASE_SYNC       // manual sync while changing level
433.3.1 by Selene Scriven
initial support for Noctigon KR4
67
68
#define PWM2_PIN PA6        // pin 1, DD FET PWM
69
#define PWM2_LVL OCR1B      // OCR1B is the output compare register for PA6
70
483.1.120 by Selene Scriven
changed Noctigon KR4 from fixed to dynamic PWM TOP value, for later use
71
// PWM parameters of both channels are tied together because they share a counter
72
#define PWM1_TOP ICR1       // holds the TOP value for for variable-resolution PWM
73
433.3.1 by Selene Scriven
initial support for Noctigon KR4
74
#define LED_ENABLE_PIN  PB0    // pin 19, Opamp power
75
#define LED_ENABLE_PORT PORTB  // control port for PB0
76
77
78
#define USE_VOLTAGE_DIVIDER  // use a dedicated pin, not VCC, because VCC input is flattened
79
#define VOLTAGE_PIN PB1      // Pin 18 / PB1 / ADC6
80
// pin to ADC mappings are in DS table 19-4
81
#define VOLTAGE_ADC      ADC6D  // digital input disable pin for PB1
82
// DIDR0/DIDR1 mappings are in DS section 19.13.5, 19.13.6
83
#define VOLTAGE_ADC_DIDR DIDR1  // DIDR channel for ADC6D
84
// DS tables 19-3, 19-4
85
// Bit   7     6     5      4     3    2    1    0
86
//     REFS1 REFS0 REFEN ADC0EN MUX3 MUX2 MUX1 MUX0
87
// MUX[3:0] = 0, 1, 1, 0 for ADC6 / PB1
88
// divided by ...
89
// REFS[1:0] = 1, 0 for internal 1.1V reference
90
// other bits reserved
433.3.4 by Selene Scriven
fixed the ADC channel for voltage measurement
91
#define ADMUX_VOLTAGE_DIVIDER 0b10000110
433.2.6 by Selene Scriven
applied ADC rewrite updates to most recent build targets
92
#define ADC_PRSCL   0x07    // clk/128
433.3.1 by Selene Scriven
initial support for Noctigon KR4
93
94
// Raw ADC readings at 4.4V and 2.2V
95
// calibrate the voltage readout here
96
// estimated / calculated values are:
481.1.2 by Selene Scriven
minor formatting cleanup
97
//   (voltage - D1) * (R2/(R2+R1) * 1024 / 1.1)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
98
// D1, R1, R2 = 0, 330, 100
99
#ifndef ADC_44
100
//#define ADC_44 981  // raw value at 4.40V
101
#define ADC_44 967  // manually tweaked so 4.16V will blink out 4.2
102
#endif
103
#ifndef ADC_22
104
//#define ADC_22 489  // raw value at 2.20V
105
#define ADC_22 482  // manually tweaked so 4.16V will blink out 4.2
106
#endif
107
108
// this light has aux LEDs under the optic
109
#define AUXLED_R_PIN    PA5    // pin 2
110
#define AUXLED_G_PIN    PA4    // pin 3
111
#define AUXLED_B_PIN    PA3    // pin 4
112
#define AUXLED_RGB_PORT PORTA  // PORTA or PORTB or PORTC
113
#define AUXLED_RGB_DDR  DDRA   // DDRA or DDRB or DDRC
114
#define AUXLED_RGB_PUE  PUEA   // PUEA or PUEB or PUEC
115
481.1.1 by Selene Scriven
added Emisar D4v2.5 support (D4v2 with a KR4 driver, same as KR4 but with lighted button indicator LED support)
116
#define BUTTON_LED_PIN  PA2    // pin 5
117
#define BUTTON_LED_PORT PORTA  // for all "PA" pins
118
#define BUTTON_LED_DDR  DDRA   // for all "PA" pins
119
#define BUTTON_LED_PUE  PUEA   // for all "PA" pins
120
433.3.1 by Selene Scriven
initial support for Noctigon KR4
121
// with so many pins, doing this all with #ifdefs gets awkward...
122
// ... so just hardcode it in each hwdef file instead
123
inline void hwdef_setup() {
124
  // enable output ports
125
  // Opamp level and Opamp on/off
126
  DDRB = (1 << PWM1_PIN)
127
       | (1 << LED_ENABLE_PIN);
481.1.1 by Selene Scriven
added Emisar D4v2.5 support (D4v2 with a KR4 driver, same as KR4 but with lighted button indicator LED support)
128
  // DD FET PWM, aux R/G/B, button LED
433.3.1 by Selene Scriven
initial support for Noctigon KR4
129
  DDRA = (1 << PWM2_PIN)
130
       | (1 << AUXLED_R_PIN)
131
       | (1 << AUXLED_G_PIN)
132
       | (1 << AUXLED_B_PIN)
481.1.1 by Selene Scriven
added Emisar D4v2.5 support (D4v2 with a KR4 driver, same as KR4 but with lighted button indicator LED support)
133
       | (1 << BUTTON_LED_PIN)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
134
       ;
135
136
  // configure PWM
137
  // Setup PWM. F_pwm = F_clkio / 2 / N / TOP, where N = prescale factor, TOP = top of counter
138
  // pre-scale for timer: N = 1
483.8.5 by Selene Scriven
fixed outdated comment in KR4 hwdef
139
  // WGM1[3:0]: 1,0,1,0: PWM, Phase Correct, adjustable (DS table 12-5)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
140
  // CS1[2:0]:    0,0,1: clk/1 (No prescaling) (DS table 12-6)
141
  // COM1A[1:0]:    1,0: PWM OC1A in the normal direction (DS table 12-4)
433.3.2 by Selene Scriven
KR4: added FET channel, measured output, calibrated ramp
142
  // COM1B[1:0]:    1,0: PWM OC1B in the normal direction (DS table 12-4)
483.1.120 by Selene Scriven
changed Noctigon KR4 from fixed to dynamic PWM TOP value, for later use
143
  TCCR1A  = (1<<WGM11)  | (0<<WGM10)   // adjustable PWM (TOP=ICR1) (DS table 12-5)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
144
          | (1<<COM1A1) | (0<<COM1A0)  // PWM 1A in normal direction (DS table 12-4)
433.3.2 by Selene Scriven
KR4: added FET channel, measured output, calibrated ramp
145
          | (1<<COM1B1) | (0<<COM1B0)  // PWM 1B in normal direction (DS table 12-4)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
146
          ;
147
  TCCR1B  = (0<<CS12)   | (0<<CS11) | (1<<CS10)  // clk/1 (no prescaling) (DS table 12-6)
483.1.120 by Selene Scriven
changed Noctigon KR4 from fixed to dynamic PWM TOP value, for later use
148
          | (1<<WGM13)  | (0<<WGM12)  // phase-correct adjustable PWM (DS table 12-5)
433.3.1 by Selene Scriven
initial support for Noctigon KR4
149
          ;
150
483.1.120 by Selene Scriven
changed Noctigon KR4 from fixed to dynamic PWM TOP value, for later use
151
  // set PWM resolution
483.1.121 by Selene Scriven
got PFM / dynamic PWM actually working on Noctigon KR4
152
  PWM1_TOP = PWM_TOP;
483.1.120 by Selene Scriven
changed Noctigon KR4 from fixed to dynamic PWM TOP value, for later use
153
433.3.1 by Selene Scriven
initial support for Noctigon KR4
154
  // set up e-switch
155
  //PORTB = (1 << SWITCH_PIN);  // TODO: configure PORTA / PORTB / PORTC?
156
  PUEB = (1 << SWITCH_PIN);  // pull-up for e-switch
157
  SWITCH_PCMSK = (1 << SWITCH_PCINT);  // enable pin change interrupt
158
}
159
160
#define LAYOUT_DEFINED
161