1 // Copyright 2024 The Pigweed Authors
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License"); you may not
4 // use this file except in compliance with the License. You may obtain a copy of
5 // the License at
6 //
7 // https://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11 // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12 // License for the specific language governing permissions and limitations under
13 // the License.
14
15 #include "FreeRTOS.h"
16 #include "pw_assert/check.h"
17 #include "task.h"
18
19 #if configUSE_MALLOC_FAILED_HOOK != 0
20
21 /// @ingroup FreeRTOS_application_functions
22 ///
23 /// If `configUSE_MALLOC_FAILED_HOOK` is enabled, FreeRTOS requires
24 /// applications to implement `vApplicationMallocFailedHook`, which is called
25 /// when a heap allocation fails. This implementation invokes
26 /// @c_macro{PW_CRASH} with the remaining heap size.
vApplicationMallocFailedHook()27 extern "C" void vApplicationMallocFailedHook() {
28 PW_CRASH("Malloc failed to allocate, remaining heap size: %d",
29 xPortGetFreeHeapSize());
30 }
31
32 #endif // configUSE_MALLOC_FAILED_HOOK != 0
33