mirror of
https://github.com/esp8266/Arduino.git
synced 2025-04-19 23:22:16 +03:00
d3eddeb501
Create dedicated function for xPortGetFreeHeapSize() that only reports on DRAM. NONOS SDK API system_get_free_heap_size() relies on xPortGetFreeHeapSize() for the free Heap size. Possible breaking change for multiple Heap Sketches calling system_get_free_heap_size(); it will now always report free DRAM Heap size. Update and export umm_free_heap_size_lw() to report the free Heap size of the current Heap. Updated ESP.getFreeHeap() to use umm_free_heap_size_lw(). Updated build options to supply exported umm_free_heap_size_lw() via either UMM_STATS or UMM_INFO. Improved build option support via the SketchName.ino.globals.h method for Heap options: UMM_INFO, UMM_INLINE_METRICS, UMM_STATS, UMM_STATS_FULL, UMM_BEST_FIT, and UMM_FIRST_FIT. While uncommon to change from the defaults, you can review umm_malloc_cfgport.h for more details, which may help reduce your Sketch's size in dire situations. Assuming you are willing to give up some functionality. For debugging UMM_STATS_FULL can offer additional stats, like Heap low water mark (umm_free_heap_size_min()).
64 lines
2.1 KiB
C++
64 lines
2.1 KiB
C++
/*
|
|
Esp.cpp - ESP8266-specific APIs
|
|
Copyright (c) 2015 Ivan Grokhotkov. All rights reserved.
|
|
This file is part of the esp8266 core for Arduino environment.
|
|
|
|
This library is free software; you can redistribute it and/or
|
|
modify it under the terms of the GNU Lesser General Public
|
|
License as published by the Free Software Foundation; either
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
This library is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
License along with this library; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#include "umm_malloc/umm_malloc.h"
|
|
#include "coredecls.h"
|
|
#include "Esp.h"
|
|
|
|
#if defined(UMM_INFO)
|
|
void EspClass::getHeapStats(uint32_t* hfree, uint32_t* hmax, uint8_t* hfrag)
|
|
{
|
|
// L2 / Euclidean norm of free block sizes.
|
|
// Having getFreeHeap()=sum(hole-size), fragmentation is given by
|
|
// 100 * (1 - sqrt(sum(hole-size²)) / sum(hole-size))
|
|
umm_info(NULL, false);
|
|
|
|
uint32_t free_size = umm_free_heap_size_core(umm_get_current_heap());
|
|
if (hfree)
|
|
*hfree = free_size;
|
|
if (hmax)
|
|
*hmax = umm_max_block_size_core(umm_get_current_heap());
|
|
if (hfrag) {
|
|
if (free_size) {
|
|
*hfrag = umm_fragmentation_metric_core(umm_get_current_heap());
|
|
} else {
|
|
*hfrag = 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
void EspClass::getHeapStats(uint32_t* hfree, uint16_t* hmax, uint8_t* hfrag)
|
|
{
|
|
uint32_t hmax32;
|
|
getHeapStats(hfree, &hmax32, hfrag);
|
|
if (hmax) {
|
|
// With the MMU_EXTERNAL_HEAP option, hmax could overflow for heaps larger
|
|
// then 64KB. return UINT16_MAX (saturation) for those cases.
|
|
// Added deprecated attribute and message.
|
|
*hmax = (hmax32 > UINT16_MAX) ? UINT16_MAX : hmax32;
|
|
}
|
|
}
|
|
|
|
uint8_t EspClass::getHeapFragmentation()
|
|
{
|
|
return (uint8_t)umm_fragmentation_metric();
|
|
}
|
|
#endif
|