microcontroller – Pin references and cpu functionality¶
Available on these boards
- microcontroller.cpu :Processor¶
CPU information and control, such as
cpu.frequency(clock frequency). This object is an instance of
- microcontroller.cpus :Processor¶
CPU information and control, such as
cpus.frequency(clock frequency) on chips with more than 1 cpu. The index selects which cpu. This object is an instance of
- microcontroller.delay_us(delay: int) None ¶
Dedicated delay method used for very short delays. Do not do long delays because this stops all other functions from completing. Think of this as an empty
whileloop that runs for the specified
(delay)time. If you have other code or peripherals (e.g audio recording) that require specific timing or processing while you are waiting, explore a different avenue such as using
- microcontroller.disable_interrupts() None ¶
Disable all interrupts. Be very careful, this can stall everything.
- microcontroller.enable_interrupts() None ¶
Enable the interrupts that were enabled at the last disable.
- microcontroller.on_next_reset(run_mode: RunMode) None ¶
Configure the run mode used the next time the microcontroller is reset but not powered down.
run_mode (RunMode) – The next run mode
- microcontroller.reset() None ¶
Reset the microcontroller. After reset, the microcontroller will enter the run mode last set by
This may result in file system corruption when connected to a host computer. Be very careful when calling this! Make sure the device “Safely removed” on Windows or “ejected” on Mac OSX and Linux.
- microcontroller.nvm :Optional[nvm.ByteArray]¶
Available non-volatile memory. This object is the sole instance of
nvm.ByteArraywhen available or
nvm.ByteArray or None
- microcontroller.watchdog :Optional[watchdog.WatchDogTimer]¶
Available watchdog timer. This object is the sole instance of
watchdog.WatchDogTimerwhen available or
- class microcontroller.Pin¶
Identifies an IO pin on the microcontroller.
Identifies an IO pin on the microcontroller. They are fixed by the hardware so they cannot be constructed on demand. Instead, use
microcontroller.pinto reference the desired pin.
- class microcontroller.Processor¶
Microcontroller CPU information and control
import microcontroller print(microcontroller.cpu.frequency) print(microcontroller.cpu.temperature) Note that on chips with more than one cpu (such as the RP2040) microcontroller.cpu will return the value for CPU 0. To get values from other CPUs use microcontroller.cpus indexed by the number of the desired cpu. i.e. print(microcontroller.cpus.temperature) print(microcontroller.cpus.frequency)
- frequency :int¶
The CPU operating frequency in Hertz. (read-only)
- reset_reason :ResetReason¶
The reason the microcontroller started up from reset state.
- temperature :Optional[float]¶
The on-chip temperature, in Celsius, as a float. (read-only)
Noneif the temperature is not available.
Limitations: Not available on ESP32 or ESP32-S3. On small SAMD21 builds without external flash, the reported temperature has reduced accuracy and precision, to save code space.
- class microcontroller.ResetReason¶
The reason the microntroller was last reset
- POWER_ON :object¶
The microntroller was started from power off.
- BROWNOUT :object¶
The microntroller was reset due to too low a voltage.
- SOFTWARE :object¶
The microntroller was reset from software.
- DEEP_SLEEP_ALARM :object¶
The microntroller was reset for deep sleep and restarted by an alarm.
- RESET_PIN :object¶
The microntroller was reset by a signal on its reset pin. The pin might be connected to a reset button.
- WATCHDOG :object¶
The microcontroller was reset by its watchdog timer.
- UNKNOWN :object¶
The microntroller restarted for an unknown reason.
- RESCUE_DEBUG :object¶
The microntroller was reset by the rescue debug port.
- class microcontroller.RunMode¶
run state of the microcontroller
Enum-like class to define the run mode of the microcontroller and CircuitPython.
- NORMAL :RunMode¶
Run CircuitPython as normal.
- SAFE_MODE :RunMode¶
Run CircuitPython in safe mode. User code will not run and the file system will be writeable over USB.
- UF2 :RunMode¶
Run the uf2 bootloader.
- BOOTLOADER :RunMode¶
Run the default bootloader.