aboutsummaryrefslogtreecommitdiff
path: root/hw/thefreeman/avr32dd20-devkit/hwdef.h
blob: 7e093f94e2c8a6dfbe72468fc2d918aa560df332 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
// hwdef for thefreeman's avr32dd20 dev kit
// Copyright (C) 2023 thefreeman, Selene ToyKeeper
// SPDX-License-Identifier: GPL-3.0-or-later
#pragma once

/* thefreeman’s avr32dd20 dev kit
 * Boost driver based on MP3431(?)
 * with high dynamic range and DAC control + aux RGB
 *
 * Pin   Name   Function
 *   1   PA4    -
 *   2   PA5    LVB (unused)
 *   3   PA6    BATT LVL (voltage divider)
 *   4   PA7    HDR: high/low Rsense range
 *   5   PC1    -
 *   6   PC2    -
 *   7   PC3    -
 *   8   VDDIO2 VCC2 (unused)
 *   9   PD4    e-switch
 *  10   PD5    EN: boost enable
 *  11   PD6    DAC: control voltage out
 *  12   PD7    IN- NFET: absorb startup flash
 *  13   VDD    VCC
 *  14   GND    GND
 *  15   PF6    RESET
 *  16   PF7    UPDI
 *  17   PA0    R: aux red
 *  18   PA1    G: aux green
 *  19   PA2    B: aux blue
 *  20   PA3    CH: detect charging
 *
 * BST EN enable the boost regulator and Op-Amp
 * DAC sets the current, max current depends on Vset voltage divider and Rsense
 * HDR FET switches between high value Rsense (low current range, pin low),
 *         and low value Rsense (high current range, pin high)
 * IN- NFET : pull up after BST enable to eliminate startup flash, pull down otherwise
 * CH senses the status of the onboard charger
 * LVL : ??? (unused?)
 * LVB is for OTSM firmware, not used here
 */

#define HWDEF_C thefreeman/avr32dd20-devkit/hwdef.c

// allow using aux LEDs as extra channel modes
#include "fsm/chan-rgbaux.h"

// channel modes:
// * 0. main LEDs
// * 1+. aux RGB
#define NUM_CHANNEL_MODES   (1 + NUM_RGB_AUX_CHANNEL_MODES)
enum CHANNEL_MODES {
    CM_MAIN = 0,
    RGB_AUX_ENUMS
};

#define DEFAULT_CHANNEL_MODE  CM_MAIN

// right-most bit first, modes are in fedcba9876543210 order
#define CHANNEL_MODES_ENABLED 0b0000000000000001


#define PWM_CHANNELS  1  // old, remove this

#undef  GRADUAL_ADJUST_SPEED
#define GRADUAL_ADJUST_SPEED  4

#define PWM_BITS      16        // 10-bit DAC
#define PWM_DATATYPE  uint16_t
#define PWM_DATATYPE2 uint32_t  // only needs 32-bit if ramp values go over 255
#define PWM1_DATATYPE uint16_t  // main LED ramp
#define PWM1_GET(l)   PWM_GET16(pwm1_levels, l)
#define PWM2_DATATYPE uint8_t   // DAC Vref table
#define PWM2_GET(l)   PWM_GET8(pwm2_levels, l)

// main LED outputs
#define DAC_LVL   DAC0_DATA    // 0 to 255, for 0V to Vref
#define DAC_VREF  VREF_DAC0REF // 1.024V, 2.048V, 4.096V, or 2.5V
//#define DAC_VREF  VREF.ADC0REF // 1.024V, 2.048V, 4.096V, or 2.5V
#define PWM_TOP_INIT  255      // highest value used in top half of ramp (unused?)
// Vref values
#define V10   VREF_REFSEL_1V024_gc
#define V20   VREF_REFSEL_2V048_gc
#define V25   VREF_REFSEL_2V500_gc
#define V40   VREF_REFSEL_4V096_gc

// BST enable
#define BST_ENABLE_PIN   PIN5_bp
#define BST_ENABLE_PORT  PORTD_OUT

// HDR
// turns on HDR FET for the high current range
#define HDR_ENABLE_PIN   PIN7_bp
#define HDR_ENABLE_PORT  PORTA_OUT

// IN- NFET
// pull high to force output to zero to eliminate the startup flash
#define IN_NFET_DELAY_TIME   12  // (ms)
#define IN_NFET_ENABLE_PIN   PIN7_bp
#define IN_NFET_ENABLE_PORT  PORTD_OUT

// e-switch
#ifndef SWITCH_PIN
#define SWITCH_PIN      PIN4_bp
#define SWITCH_PORT     VPORTD.IN
#define SWITCH_ISC_REG  PORTD.PIN4CTRL
#define SWITCH_VECT     PORTD_PORT_vect
#define SWITCH_INTFLG   VPORTD.INTFLAGS
#endif

// TODO: define stuff for the voltage divider
// AVR datasheet table 3.1 I/O Multiplexing, PA6 ADC0 = AIN26
//#define USE_VOLTAGE_DIVIDER    // use a dedicated pin, not VCC, because VCC input is regulated
#define ADMUX_VOLTAGE_DIVIDER  ADC_MUXPOS_AIN26_gc

// average drop across diode on this hardware
#ifndef VOLTAGE_FUDGE_FACTOR
#define VOLTAGE_FUDGE_FACTOR 0  // using a PFET so no appreciable drop
#endif

// this driver allows for aux LEDs under the optic
#define AUXLED_R_PIN  PIN0_bp
#define AUXLED_G_PIN  PIN1_bp
#define AUXLED_B_PIN  PIN2_bp
#define AUXLED_RGB_PORT PORTA

// this light has three aux LED channels: R, G, B
#define USE_AUX_RGB_LEDS


inline void hwdef_setup() {

    // TODO? for this DAC controlled-light, try to decrease the clock speed
    mcu_clock_speed();

    VPORTA.DIR = PIN0_bm   // R
               | PIN1_bm   // G
               | PIN2_bm   // B
               //| PIN3_bm   // CH
               | PIN7_bm;  // HDR
    VPORTD.DIR = PIN5_bm   // EN
               | PIN6_bm   // DAC
               | PIN7_bm;  // IN- NFET

    // enable pullups on the unused and input pins to reduce power
    //PORTA.PIN0CTRL = PORT_PULLUPEN_bm;  // R
    //PORTA.PIN1CTRL = PORT_PULLUPEN_bm;  // G
    //PORTA.PIN2CTRL = PORT_PULLUPEN_bm;  // B
    //PORTA.PIN3CTRL = PORT_PULLUPEN_bm;  // CH
    PORTA.PIN4CTRL = PORT_PULLUPEN_bm;
    PORTA.PIN5CTRL = PORT_PULLUPEN_bm;
    PORTA.PIN6CTRL = PORT_PULLUPEN_bm;
    //PORTA.PIN7CTRL = PORT_PULLUPEN_bm;  // HDR

    //PORTC.PIN0CTRL = PORT_PULLUPEN_bm;  // doesn't exist
    PORTC.PIN1CTRL = PORT_PULLUPEN_bm;
    PORTC.PIN2CTRL = PORT_PULLUPEN_bm;
    PORTC.PIN3CTRL = PORT_PULLUPEN_bm;
    //PORTC.PIN4CTRL = PORT_PULLUPEN_bm;  // doesn't exist
    //PORTC.PIN5CTRL = PORT_PULLUPEN_bm;  // doesn't exist

    //PORTD.PIN0CTRL = PORT_PULLUPEN_bm;  // doesn't exist
    //PORTD.PIN1CTRL = PORT_PULLUPEN_bm;  // doesn't exist
    //PORTD.PIN2CTRL = PORT_PULLUPEN_bm;  // doesn't exist
    //PORTD.PIN3CTRL = PORT_PULLUPEN_bm;  // doesn't exist
    PORTD.PIN4CTRL = PORT_PULLUPEN_bm
                   | PORT_ISC_BOTHEDGES_gc;  // e-switch
    //PORTD.PIN5CTRL = PORT_PULLUPEN_bm;  // EN
    // AVR datasheet 34.3.1 #2, DAC pin must have input disable set
    PORTD.PIN6CTRL = PORT_ISC_INPUT_DISABLE_gc;  // DAC
    //PORTD.PIN7CTRL = PORT_PULLUPEN_bm;  // IN- NFET

    // set up the DAC
    // DAC ranges from 0V to (255 * Vref) / 256
    DAC_VREF = V10;
    // TODO: try DAC_RUNSTDBY_bm for extra-efficient moon
    DAC0.CTRLA = DAC_ENABLE_bm | DAC_OUTEN_bm;
    DAC_LVL = 0; // set the output voltage  (off at boot)
    // TODO: instead of enabling the DAC at boot, pull pin down
    //       to generate a zero without spending power on the DAC
    //       (and do this in set_level_zero() too)

}


// set fuses, these carry over to the ELF file
// we need this for enabling BOD in Active Mode from the factory.
// settings can be verified / dumped from the ELF file using this
// command: avr-objdump -d -S -j .fuse anduril.elf
FUSES = {
    .WDTCFG  = FUSE_WDTCFG_DEFAULT,   // Watchdog Configuration

    // enable BOD (continuous) in active mode
    .BODCFG  = ACTIVE_ENABLE_gc,      // BOD Configuration

    .OSCCFG  = FUSE_OSCCFG_DEFAULT,   // Oscillator Configuration
    .SYSCFG0 = FUSE_SYSCFG0_DEFAULT,  // System Configuration 0

    // enable MVIO because VDDIO2 pin isn't connected
    // set startup time to 64ms to allow power to stabilize
    .SYSCFG1 = MVSYSCFG_DUAL_gc | SUT_64MS_gc,

    .CODESIZE = FUSE_CODESIZE_DEFAULT,
    .BOOTSIZE = FUSE_BOOTSIZE_DEFAULT,
};


#define LAYOUT_DEFINED