【雕爷学编程】MicroPython手册之 ESP32 特定端口库 esp32.Partition.mark_app_valid_cancel_rollback()

MicroPython是为了在嵌入式系统中运行Python 3编程语言而设计的轻量级版本解释器。与常规Python相比，MicroPython解释器体积小(仅100KB左右)，通过编译成二进制Executable文件运行，执行效率较高。它使用了轻量级的垃圾回收机制并移除了大部分Python标准库，以适应资源限制的微控制器。

MicroPython主要特点包括:
1、语法和功能与标准Python兼容,易学易用。支持Python大多数核心语法。
2、对硬件直接访问和控制,像Arduino一样控制GPIO、I2C、SPI等。
3、强大的模块系统,提供文件系统、网络、图形界面等功能。
4、支持交叉编译生成高效的原生代码,速度比解释器快10-100倍。
5、代码量少,内存占用小,适合运行在MCU和内存小的开发板上。
6、开源许可,免费使用。Shell交互环境为开发测试提供便利。
7、内置I/O驱动支持大量微控制器平台，如ESP8266、ESP32、STM32、micro:bit、掌控板和PyBoard等。有活跃的社区。

MicroPython的应用场景包括:
1、为嵌入式产品快速构建原型和用户交互。
2、制作一些小型的可 programmable 硬件项目。
3、作为教育工具,帮助初学者学习Python和物联网编程。
4、构建智能设备固件,实现高级控制和云连接。
5、各种微控制器应用如物联网、嵌入式智能、机器人等。

使用MicroPython需要注意:
1、内存和Flash空间有限。
2、解释执行效率不如C语言。
3、部分库函数与标准版有差异。
4、针对平台优化语法,订正与标准Python的差异。
5、合理使用内存资源,避免频繁分配大内存块。
6、利用原生代码提升速度关键部位的性能。
7、适当使用抽象来封装底层硬件操作。

总体来说,MicroPython让Python进入了微控制器领域，是一项重要的创新，既降低了编程门槛，又提供了良好的硬件控制能力。非常适合各类物联网和智能硬件的开发。

MicroPython的esp是指针对ESP8266和ESP32芯片的MicroPython固件和相关软件库。ESP8266和ESP32是一类广泛应用于物联网和嵌入式系统的低成本、低功耗的Wi-Fi和蓝牙模块。MicroPython的esp为这两种芯片提供了高级的脚本编程环境，使开发者能够使用Python语言进行快速原型设计和开发。

ESP8266：是一款低成本、低功耗的Wi-Fi模块/芯片，由Espressif Systems开发。它内置了TCP/IP协议栈，可以用于连接互联网，并具备较强的处理能力。MicroPython的esp提供了针对ESP8266的固件和相关软件库，使开发者可以使用MicroPython语言进行ESP8266应用的开发。

ESP32：是Espressif Systems推出的一款高度集成的Wi-Fi和蓝牙模块/芯片，与ESP8266相比，它具备更强大的处理能力、更多的外设接口和更多的内存。MicroPython的esp也提供了针对ESP32的固件和相关软件库，使开发者可以使用MicroPython语言进行ESP32应用的开发。

MicroPython的esp固件：是专门针对ESP8266和ESP32芯片的MicroPython固件版本。这些固件经过了针对性的优化，使得它们可以在ESP8266和ESP32上运行，并提供了与硬件交互、网络通信和外设控制等功能的API。

软件库：MicroPython的esp还提供了一系列与ESP8266和ESP32硬件相关的软件库，用于简化和加速开发过程。这些软件库提供了丰富的功能接口，涵盖了Wi-Fi、蓝牙、GPIO（通用输入输出）、I2C、SPI、PWM等常用的硬件和通信协议，使开发者可以方便地访问和控制硬件资源。

esp32.Partition.mark_app_valid_cancel_rollback() 是 MicroPython 中用于标记应用程序有效并取消回滚的方法。它允许您将应用程序标记为有效，阻止回滚到先前的应用程序版本。下面是对其主要特点、应用场景和需注意事项的详细解释，并给出了几个实际运用程序案例：

主要特点：

esp32.Partition.mark_app_valid_cancel_rollback() 方法用于标记应用程序为有效并取消回滚。
通过调用该方法，您可以将当前的应用程序标记为有效，阻止设备回滚到先前的应用程序版本。
标记应用程序为有效后，设备将保持在当前的应用程序版本，并且不会回退到之前的版本。

应用场景：

esp32.Partition.mark_app_valid_cancel_rollback() 方法适用于需要阻止回滚并保持当前应用程序版本的场景。
在进行应用程序更新后，可以使用该方法标记新版本的应用程序为有效，以防止设备回退到旧版本。
该方法还可以用于在设备验证新版本应用程序后，将其标记为有效，以确保设备持续运行更新后的应用程序。

需注意事项：

在使用 esp32.Partition.mark_app_valid_cancel_rollback() 方法之前，需要先导入 esp32 模块。
确保在应用程序更新完成后再调用该方法，以避免标记尚未完成的应用程序为有效。
标记应用程序为有效后，将无法回滚到之前的应用程序版本，请确保在执行标记操作之前进行适当的测试和验证。

下面是几个实际运用程序案例：

案例1：标记当前应用程序为有效并取消回滚：
:

import esp32

# 标记当前应用程序为有效并取消回滚
esp32.Partition.mark_app_valid_cancel_rollback()

print("当前应用程序已标记为有效，并取消了回滚.")

案例2：应用程序更新后标记为有效：

import esp32

# 完成应用程序更新
# ...

# 标记新版本的应用程序为有效
esp32.Partition.mark_app_valid_cancel_rollback()

print("新版本的应用程序已标记为有效.")

案例3：验证应用程序后标记为有效：

import esp32

# 验证新版本的应用程序
# ...

# 标记新版本的应用程序为有效
esp32.Partition.mark_app_valid_cancel_rollback()

print("新版本的应用程序已验证并标记为有效.")

请注意，上述示例中的标记操作应在适当的时机调用，并根据实际需求进行相应的应用程序更新和验证操作。确保在使用 esp32.Partition.mark_app_valid_cancel_rollback() 方法时，了解其影响，并在适当的时间点进行调用。

案例4：验证新固件:

from machine import Partition
part = Partition.find_partition('/')
part.mark_app_valid_cancel_rollback()

案例5：撤销回滚:

from machine import Partition
part = Partition.find_partition('/')
part.mark_app_valid_cancel_rollback()
reset()

案例6：回滚固件:

from machine import Partition, reset
part = Partition.find_partition('/')
part.erase_region(0, part.size())
reset()

第一个例子验证新固件后立即生效。第二个例子安装新固件后撤销回滚。第三个例子模拟回滚到旧固件。此方法用于OTA固件更新的回滚管理,保证安装前后固件的一致性。它与下载、擦除等方法配合能实现可靠的固件升级。

案例7：取消回滚并标记应用为有效：

import machine

# 打开分区
partition = machine.Partition('app')

# 取消回滚并标记应用为有效
partition.mark_app_valid_cancel_rollback()

# 重启设备
machine.reset()

在这个例子中，我们使用esp32.Partition.mark_app_valid_cancel_rollback()方法来取消回滚并标记应用为有效。我们首先使用machine.Partition()方法打开一个名为’app’的分区。然后，我们使用mark_app_valid_cancel_rollback()方法取消任何可能正在进行的回滚，并将应用标记为有效。最后，我们使用machine.reset()方法重启设备，以使更改生效。

案例8：取消回滚并标记应用为有效，并清除回滚计数器：:

import machine

# 打开分区
partition = machine.Partition('app')

# 取消回滚并标记应用为有效，并清除回滚计数器
partition.mark_app_valid_cancel_rollback(clear_rollback_counter=True)

# 重启设备
machine.reset()

在这个例子中，我们使用esp32.Partition.mark_app_valid_cancel_rollback()方法来取消回滚并标记应用为有效，并清除回滚计数器。我们首先使用machine.Partition()方法打开一个名为’app’的分区。然后，我们使用mark_app_valid_cancel_rollback()方法取消任何可能正在进行的回滚，并将应用标记为有效。通过将参数clear_rollback_counter设置为True，我们还清除了回滚计数器。最后，我们使用machine.reset()方法重启设备，以使更改生效。

案例9：取消回滚并标记应用为有效，并输出回滚计数器：:

import machine

# 打开分区
partition = machine.Partition('app')

# 取消回滚并标记应用为有效，并获取回滚计数器的值
rollback_counter = partition.mark_app_valid_cancel_rollback()

# 输出回滚计数器的值
print("回滚计数器：", rollback_counter)

# 重启设备
machine.reset()

在这个例子中，我们使用esp32.Partition.mark_app_valid_cancel_rollback()方法来取消回滚并标记应用为有效，并获取回滚计数器的值。我们首先使用machine.Partition()方法打开一个名为’app’的分区。然后，我们使用mark_app_valid_cancel_rollback()方法取消任何可能正在进行的回滚，并将应用标记为有效。同时，我们将返回的回滚计数器的值存储在rollback_counter变量中。最后，我们使用print()函数输出回滚计数器的值，并使用machine.reset()方法重启设备，以使更改生效。