fusible 0.14.3

Electronic linter: a fuse that blows to block firmware code generation
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

//! Espressif ESP32-S3 IO MUX, boot strapping, and reserved memory pin tables.

use crate::silicon::model::{
    MuxFunction, PeripheralSignal, PinCapabilities, PinSpec, SiliconTarget, StrappingRequirement,
};

const ESP_GPIO_CAP: PinCapabilities = PinCapabilities {
    is_gpio: true,
    is_analog: false,
    is_input_only: false,
    is_reserved_flash: false,
};

const ESP_INPUT_ONLY: PinCapabilities = PinCapabilities {
    is_gpio: true,
    is_analog: false,
    is_input_only: true,
    is_reserved_flash: false,
};

const ESP_FLASH_CAP: PinCapabilities = PinCapabilities {
    is_gpio: false,
    is_analog: false,
    is_input_only: false,
    is_reserved_flash: true,
};

static GP0_FUNCS: &[MuxFunction] = &[];
static GP3_FUNCS: &[MuxFunction] = &[];
static GP19_FUNCS: &[MuxFunction] = &[mux!(PeripheralSignal::UsbDm, 0, "USB_DM")];
static GP20_FUNCS: &[MuxFunction] = &[mux!(PeripheralSignal::UsbDp, 0, "USB_DP")];
static GP43_FUNCS: &[MuxFunction] = &[mux!(PeripheralSignal::UartTx(0), 0, "U0TXD")];
static GP44_FUNCS: &[MuxFunction] = &[mux!(PeripheralSignal::UartRx(0), 0, "U0RXD")];
static GP45_FUNCS: &[MuxFunction] = &[];
static GP46_FUNCS: &[MuxFunction] = &[];
static EMPTY_FUNCS: &[MuxFunction] = &[];

pub static ESP32S3_PINS: &[PinSpec] =
    &[
        gpio_pin!(
            0,
            "GPIO0",
            ESP_GPIO_CAP,
            GP0_FUNCS,
            StrappingRequirement::MustBeHigh {
                purpose: "SPI Flash Boot mode",
                violation_consequence: "holding GPIO0 LOW at reset forces ROM download bootloader",
            }
        ),
        gpio_pin!(1, "GPIO1", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(2, "GPIO2", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(
            3,
            "GPIO3",
            ESP_GPIO_CAP,
            GP3_FUNCS,
            StrappingRequirement::MustBeLow {
                purpose: "JTAG signal selection",
                violation_consequence: "holding GPIO3 HIGH at reset alters JTAG routing",
            }
        ),
        gpio_pin!(4, "GPIO4", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(5, "GPIO5", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(6, "GPIO6", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(7, "GPIO7", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(8, "GPIO8", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(9, "GPIO9", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(10, "GPIO10", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(11, "GPIO11", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(12, "GPIO12", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(13, "GPIO13", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(14, "GPIO14", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(15, "GPIO15", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(16, "GPIO16", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(17, "GPIO17", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(18, "GPIO18", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(19, "GPIO19", ESP_GPIO_CAP, GP19_FUNCS),
        gpio_pin!(20, "GPIO20", ESP_GPIO_CAP, GP20_FUNCS),
        gpio_pin!(21, "GPIO21", ESP_GPIO_CAP, EMPTY_FUNCS),
        // GPIO 26-32: Reserved for SPI Flash
        gpio_pin!(26, "GPIO26", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(27, "GPIO27", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(28, "GPIO28", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(29, "GPIO29", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(30, "GPIO30", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(31, "GPIO31", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(32, "GPIO32", ESP_FLASH_CAP, EMPTY_FUNCS),
        // GPIO 33-37: Reserved for Octal Flash / PSRAM
        gpio_pin!(33, "GPIO33", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(34, "GPIO34", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(35, "GPIO35", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(36, "GPIO36", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(37, "GPIO37", ESP_FLASH_CAP, EMPTY_FUNCS),
        gpio_pin!(38, "GPIO38", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(39, "GPIO39", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(40, "GPIO40", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(41, "GPIO41", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(42, "GPIO42", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(43, "GPIO43", ESP_GPIO_CAP, GP43_FUNCS),
        gpio_pin!(44, "GPIO44", ESP_GPIO_CAP, GP44_FUNCS),
        gpio_pin!(
            45,
            "GPIO45",
            ESP_GPIO_CAP,
            GP45_FUNCS,
            StrappingRequirement::MustBeLow {
                purpose: "VDD_SPI Flash voltage selection",
                violation_consequence:
                    "holding GPIO45 HIGH selects 1.8V flash and browns out standard 3.3V modules",
            }
        ),
        gpio_pin!(46, "GPIO46", ESP_INPUT_ONLY, GP46_FUNCS, StrappingRequirement::MustBeLow {
            purpose: "ROM boot log output",
            violation_consequence:
                "holding GPIO46 HIGH suppresses ROM boot messages; pin cannot be used as an output",
        }),
        gpio_pin!(47, "GPIO47", ESP_GPIO_CAP, EMPTY_FUNCS),
        gpio_pin!(48, "GPIO48", ESP_GPIO_CAP, EMPTY_FUNCS),
    ];

pub static ESP32S3: SiliconTarget = SiliconTarget {
    name: "esp32-s3",
    family: "Espressif",
    pins: ESP32S3_PINS,
};