Skip to content

Conversation

@georgik
Copy link
Collaborator

@georgik georgik commented Aug 1, 2024

Migrate articles from ESP Journal.

@georgik georgik marked this pull request as draft August 1, 2024 13:35
@georgik
Copy link
Collaborator Author

georgik commented Aug 1, 2024

@pedrominatel @f-hollow Here's the initial test of porting one of articles.
@Hahihula - it was necessary to change following things manually:

  • author changed from "Pedro Minatel" to "pedro-minatel"
  • date format changed: 2021-02-13
  • headers contains bold, which is not necessary:
# **Introduction
  • title is duplicated with header, it can be removed from body: # **How to use custom partition tables on ESP32
  • changed showAuthor: false - value true caues to display default author Espressif Developer Portal

Copy link
Collaborator

@f-hollow f-hollow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Improved readability of the initial paragraphs. The rest of the article can be improved after we migrate all other relevant articles.

Another suggestion: URL slugs (article folder name) shouldn't be this long. Suggest maybe boiling it down to custom-partition-tables-esp32.

authors:
- "pedro-minatel"
---
# How to use custom partition tables on ESP32
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't forget to remove this heading.


# Introduction

When we create a new project using **ESP32** , sometimes we need to store data in the flash to persist even after a restart or power down. In the past, the most common way to do that was by using EEPROM, with just a few bytes of storage ability which limited it for larger amount of data.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
When we create a new project using **ESP32** , sometimes we need to store data in the flash to persist even after a restart or power down. In the past, the most common way to do that was by using EEPROM, with just a few bytes of storage ability which limited it for larger amount of data.
While creating an embedded project, we usually need way to store data that can persist even after a restart or power-down. In the past, the most common way to achieve that was by using EEPROM with just a few bytes of storage ability. Persistently storing larger amounts of data was problematic.


When we create a new project using **ESP32** , sometimes we need to store data in the flash to persist even after a restart or power down. In the past, the most common way to do that was by using EEPROM, with just a few bytes of storage ability which limited it for larger amount of data.

On the other hand, the **ESP32** uses a flash memory to store the firmware, including the bootloader and other relevant data. The flash memory size may vary from version to version, but it’s enough for most of the application code and you still can manage to have some spare storage area.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
On the other hand, the **ESP32** uses a flash memory to store the firmware, including the bootloader and other relevant data. The flash memory size may vary from version to version, but it’s enough for most of the application code and you still can manage to have some spare storage area.
These days, the ESP32 has flash memory onboard that allows storing firmware, including the bootloader and application, as well as other relevant data. The flash memory size may vary from version to version, but it’s enough for most application binaries with yet some spare storage on top.


On the other hand, the **ESP32** uses a flash memory to store the firmware, including the bootloader and other relevant data. The flash memory size may vary from version to version, but it’s enough for most of the application code and you still can manage to have some spare storage area.

But not only the firmware, (your application) is stored in the flash memory. There is some other important data to keep in the flash, including the partitions map, RF calibration data, WiFi data, Bluetooth pairing information, Over-the-air updates and many other data important enough to be kept in the flash.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
But not only the firmware, (your application) is stored in the flash memory. There is some other important data to keep in the flash, including the partitions map, RF calibration data, WiFi data, Bluetooth pairing information, Over-the-air updates and many other data important enough to be kept in the flash.
However, apart from the bootloader and application, other important data needs to be stored in flash, including the partition map, RF calibration data, Wi-Fi data, Bluetooth pairing information, Over-the-air (OTA) updates and many other types.


But not only the firmware, (your application) is stored in the flash memory. There is some other important data to keep in the flash, including the partitions map, RF calibration data, WiFi data, Bluetooth pairing information, Over-the-air updates and many other data important enough to be kept in the flash.

To see all ESP32 family variants, see this ordering information [**link**](https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
To see all ESP32 family variants, see this ordering information [**link**](https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf).
The ESP32 has multiple variants with different flash memory sizes which can be conveniently browsed in the [ESP Product Selector](https://products.espressif.com/#/product-selector?names=).


To see all ESP32 family variants, see this ordering information [**link**](https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf).

> Important note: This article uses the [ESP-IDF v4.2](https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/) and all references use this version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> Important note: This article uses the [ESP-IDF v4.2](https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/) and all references use this version.
> Important note: This article and all references in it refer to [ESP-IDF v4.2](https://docs.espressif.com/projects/esp-idf/en/v4.2/esp32/).


The default partition scheme is defined by two different major partitions:

## **nvs**
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As suggested by Juraj, bold typeface should be removed from all heading titles.

Suggested change
## **nvs**
## nvs

# How to use custom partition tables on ESP32


# Introduction
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Apparently, this heading and all the other ones below should be deeper by one level respectively.

Suggested change
# Introduction
## Introduction

@igrr
Copy link
Member

igrr commented Aug 21, 2024

Regarding the page URL, can we create an alias from /how-to-use-custom-partition-tables-on-esp32-69c0f3fa89c8 (which is the page URI on Medium) to /blog/how-to-use-custom-partition-tables-on-esp32/?

This will allow us to point blog.espressif.com to the new location later.

(https://gohugo.io/methods/page/aliases/)

@georgik
Copy link
Collaborator Author

georgik commented Sep 11, 2024

Closing. This is handled by #105

@georgik georgik closed this Sep 11, 2024
@georgik georgik added migration Migration from old portal labels Sep 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

migration Migration from old portal

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants