159 lines
6.7 KiB
C
159 lines
6.7 KiB
C
/*
|
|
* This file is part of the MicroPython project, http://micropython.org/
|
|
*
|
|
* The MIT License (MIT)
|
|
*
|
|
* Copyright (c) 2023 Dan Halbert for Adafruit Industries
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
* of this software and associated documentation files (the "Software"), to deal
|
|
* in the Software without restriction, including without limitation the rights
|
|
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
* copies of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be included in
|
|
* all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
* THE SOFTWARE.
|
|
*/
|
|
|
|
#include "py/enum.h"
|
|
|
|
#include "shared-bindings/supervisor/SafeModeReason.h"
|
|
|
|
// Reuse the non-Python safe_mode_t enum
|
|
#include "supervisor/shared/safe_mode.h"
|
|
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, NONE, SAFE_MODE_NONE);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, BROWNOUT, SAFE_MODE_BROWNOUT);
|
|
// alphabetical from here down
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, FLASH_WRITE_FAIL, SAFE_MODE_FLASH_WRITE_FAIL);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, GC_ALLOC_OUTSIDE_VM, SAFE_MODE_GC_ALLOC_OUTSIDE_VM);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, HARD_FAULT, SAFE_MODE_HARD_FAULT);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, INTERRUPT_ERROR, SAFE_MODE_INTERRUPT_ERROR);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, NLR_JUMP_FAIL, SAFE_MODE_NLR_JUMP_FAIL);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, NO_CIRCUITPY, SAFE_MODE_NO_CIRCUITPY);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, NO_HEAP, SAFE_MODE_NO_HEAP);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, PROGRAMMATIC, SAFE_MODE_PROGRAMMATIC);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, SDK_FATAL_ERROR, SAFE_MODE_SDK_FATAL_ERROR);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, STACK_OVERFLOW, SAFE_MODE_STACK_OVERFLOW);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, USB_BOOT_DEVICE_NOT_INTERFACE_ZERO, SAFE_MODE_USB_BOOT_DEVICE_NOT_INTERFACE_ZERO);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, USB_TOO_MANY_ENDPOINTS, SAFE_MODE_USB_TOO_MANY_ENDPOINTS);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, USB_TOO_MANY_INTERFACE_NAMES, SAFE_MODE_USB_TOO_MANY_INTERFACE_NAMES);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, USER, SAFE_MODE_USER);
|
|
MAKE_ENUM_VALUE(supervisor_safe_mode_reason_type, safe_mode_reason, WATCHDOG, SAFE_MODE_WATCHDOG);
|
|
|
|
|
|
//| class SafeModeReason:
|
|
//| """The reason that CircuitPython went into safe mode.
|
|
//|
|
|
//| **Limitations**: Class not available on builds that do not implement ``safemode.py``.
|
|
//| """
|
|
//|
|
|
MAKE_ENUM_MAP(supervisor_safe_mode_reason) {
|
|
|
|
//| NONE: object
|
|
//| """CircuitPython is not in safe mode."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, NONE),
|
|
|
|
//| BROWNOUT: object
|
|
//| """The microcontroller voltage dropped too low."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, BROWNOUT),
|
|
|
|
// alphabetical from here down
|
|
|
|
//| FLASH_WRITE_FAIL: object
|
|
//| """Could not write to flash memory."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, FLASH_WRITE_FAIL),
|
|
|
|
//| GC_ALLOC_OUTSIDE_VM: object
|
|
//| """CircuitPython tried to allocate storage when its virtual machine was not running."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, GC_ALLOC_OUTSIDE_VM),
|
|
|
|
//| HARD_FAULT: object
|
|
//| """The microcontroller detected a fault, such as an out-of-bounds memory write."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, HARD_FAULT),
|
|
|
|
//| INTERRUPT_ERROR: object
|
|
//| """Internal error related to interrupts."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, INTERRUPT_ERROR),
|
|
|
|
//| NLR_JUMP_FAIL: object
|
|
//| """An error occurred during exception handling, possibly due to memory corruption."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, NLR_JUMP_FAIL),
|
|
|
|
//| NO_CIRCUITPY: object
|
|
//| """The CIRCUITPY drive was not available."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, NO_CIRCUITPY),
|
|
|
|
//| NO_HEAP: object
|
|
//| """Heap storage was not present."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, NO_HEAP),
|
|
|
|
//| PROGRAMMATIC: object
|
|
//| """The program entered safe mode using the `supervisor` module."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, PROGRAMMATIC),
|
|
|
|
//| SDK_FATAL_ERROR: object
|
|
//| """Third party firmware reported a fatal error."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, SDK_FATAL_ERROR),
|
|
|
|
//| STACK_OVERFLOW: object
|
|
//| """The CircuitPython heap was corrupted because the stack was too small."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, STACK_OVERFLOW),
|
|
|
|
//| USB_BOOT_DEVICE_NOT_INTERFACE_ZERO: object
|
|
//| """The USB HID boot device was not set up to be the first device, on interface #0."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, USB_BOOT_DEVICE_NOT_INTERFACE_ZERO),
|
|
|
|
//| USB_TOO_MANY_ENDPOINTS: object
|
|
//| """USB devices need more endpoints than are available."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, USB_TOO_MANY_ENDPOINTS),
|
|
|
|
//| USB_TOO_MANY_INTERFACE_NAMES: object
|
|
//| """USB devices specify too many interface names."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, USB_TOO_MANY_INTERFACE_NAMES),
|
|
|
|
//| USER: object
|
|
//| """The user pressed one or more buttons to enter safe mode.
|
|
//| This safe mode does **not** cause ``safemode.py`` to be run, since its purpose
|
|
//| is to prevent all user code from running.
|
|
//| This allows errors in ``safemode.py`` to be corrected easily.
|
|
//| """
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, USER),
|
|
|
|
//| SAFE_MODE_WATCHDOG: object
|
|
//| """An internal watchdog timer expired."""
|
|
//|
|
|
MAKE_ENUM_MAP_ENTRY(safe_mode_reason, WATCHDOG),
|
|
};
|
|
|
|
STATIC MP_DEFINE_CONST_DICT(supervisor_safe_mode_reason_locals_dict, supervisor_safe_mode_reason_locals_table);
|
|
|
|
MAKE_PRINTER(supervisor, supervisor_safe_mode_reason);
|
|
|
|
MAKE_ENUM_TYPE(supervisor, SafeModeReason, supervisor_safe_mode_reason);
|