Add ESP32 erlang:system_info/1 memory keys to match new STM32 keys with atomvm_ prefix

Adds new ESP32 erlang:system_info/1 heap memory keys `atomvm_free_heap_size` and
`atomvm_minimum_free_size` to align with newly added STM32 memory keys.

When the old keys are used a deprecation warning will be printed to the console to alert users to
update to the new key names before the old keys are removed in the 0.8.x release cycle.

Signed-off-by: Winford <winford@object.stream>

Author: UncleGrumpy

CHANGELOG.md

@@ -56,6 +56,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Removed `externalterm_to_term_copy` added in [0.6.5] and introduced flags to `externalterm_to_term` to perform copy.
 - Release images for ESP32 chips are built with ESP-IDF v5.4
 - ESP32: SPI peripheral defaults to `"spi2"` instead of deprecated `hspi`
+- Deprecated ESP32 `erlang:system_info/1` memory keys  `esp32_free_heap_size` and
+`esp32_minimum_free_size` in favor of `atomvm_` prefixed keys with warnings to update applications
+before the old keys are removed.
 
 ### Fixed
 

UPDATING.md

@@ -13,6 +13,9 @@ port socket driver, are also represented by a port and some matching code may ne
 `is_pid/1` to `is_port/1`.
 - Ports and pids can be registered. Function `globalcontext_get_registered_process` result now is
 a term that can be a `port()` or a `pid()`.
+- ESP32 `erlang:system_info/1` memory keys `esp32_free_heap_size` and `esp32_minimum_free_size` have
+been deprecated in favor of `atomvm_` prefixed keys. Applications should be updated to use
+`atomvm_free_heap_size` and `atomvm_minimum_free_size` instead.
 
 ## v0.6.4 -> v0.6.5
 

src/platforms/esp32/components/avm_sys/sys.c

@@ -72,8 +72,12 @@ static void *select_thread_loop(void *);
 static void select_thread_signal(struct ESP32PlatformData *platform);
 
 // clang-format off
+// TODO: remove deprecated `atomvm_free_heap_size_atom` for the 0.8.x release cycle
+static const char *const atomvm_free_heap_size_atom = "\x15" "atomvm_free_heap_size";
 static const char *const esp_free_heap_size_atom = "\x14" "esp32_free_heap_size";
 static const char *const esp_largest_free_block_atom = "\x18" "esp32_largest_free_block";
+static const char *const atomvm_get_minimum_free_size_atom = "\x18" "atomvm_minimum_free_size";
+// TODO: remove deprecated `esp_get_minimum_free_size_atom` for the 0.8.x release cycle
 static const char *const esp_get_minimum_free_size_atom = "\x17" "esp32_minimum_free_size";
 static const char *const esp_chip_info_atom = "\xF" "esp32_chip_info";
 static const char *const esp_idf_version_atom = "\xF" "esp_idf_version";
@@ -499,13 +503,27 @@ static term get_features(Context *ctx, uint32_t features)
 term sys_get_info(Context *ctx, term key)
 {
     GlobalContext *glb = ctx->global;
+    // TODO: remove this deprecated key for the 0.8.x release cycle
     if (key == globalcontext_make_atom(glb, esp_free_heap_size_atom)) {
+        ESP_LOGW(TAG, "The system_info/1 key 'esp32_free_heap_size' has been deprecated in favor of the \
+        muti-platform key 'atomvm_free_heap_size'. This key will be removed in a future release, please \
+        update your application to use 'atomvm_free_heap_size'.");
+        return term_from_int32(esp_get_free_heap_size());
+    }
+    if (key == globalcontext_make_atom(glb, atomvm_free_heap_size_atom)) {
         return term_from_int32(esp_get_free_heap_size());
     }
     if (key == globalcontext_make_atom(glb, esp_largest_free_block_atom)) {
         return term_from_int32(heap_caps_get_largest_free_block(MALLOC_CAP_DEFAULT));
     }
+    // TODO: remove this deprecated key for the 0.8.x release cycle
     if (key == globalcontext_make_atom(glb, esp_get_minimum_free_size_atom)) {
+        ESP_LOGW(TAG, "The system_info/1 key 'esp32_minimum_free_size' has been deprecated in favor of the \
+        muti-platform key 'atomvm_minimum_free_size'. This key will be removed in a future release, please \
+        update your application to use 'atomvm_minimum_free_size'.");
+        return term_from_int32(esp_get_minimum_free_heap_size());
+    }
+    if (key == globalcontext_make_atom(glb, atomvm_get_minimum_free_size_atom)) {
         return term_from_int32(esp_get_minimum_free_heap_size());
     }
     if (key == globalcontext_make_atom(glb, esp_chip_info_atom)) {