/* * Copyright (c) 2020 Intel Corporation. * * SPDX-License-Identifier: Apache-2.0 */ #include #include #include #include #include #include #include "coredump_internal.h" #if defined(CONFIG_DEBUG_COREDUMP_BACKEND_LOGGING) extern struct coredump_backend_api coredump_backend_logging; static struct coredump_backend_api *backend_api = &coredump_backend_logging; #elif defined(CONFIG_DEBUG_COREDUMP_BACKEND_FLASH_PARTITION) extern struct coredump_backend_api coredump_backend_flash_partition; static struct coredump_backend_api *backend_api = &coredump_backend_flash_partition; #elif defined(CONFIG_DEBUG_COREDUMP_BACKEND_INTEL_ADSP_MEM_WINDOW) extern struct coredump_backend_api coredump_backend_intel_adsp_mem_window; static struct coredump_backend_api *backend_api = &coredump_backend_intel_adsp_mem_window; #elif defined(CONFIG_DEBUG_COREDUMP_BACKEND_OTHER) extern struct coredump_backend_api coredump_backend_other; static struct coredump_backend_api *backend_api = &coredump_backend_other; #else #error "Need to select a coredump backend" #endif #if defined(CONFIG_COREDUMP_DEVICE) #include #define DT_DRV_COMPAT zephyr_coredump #endif static void dump_header(unsigned int reason) { struct coredump_hdr_t hdr = { .id = {'Z', 'E'}, .hdr_version = COREDUMP_HDR_VER, .reason = sys_cpu_to_le16(reason), }; if (sizeof(uintptr_t) == 8) { hdr.ptr_size_bits = 6; /* 2^6 = 64 */ } else if (sizeof(uintptr_t) == 4) { hdr.ptr_size_bits = 5; /* 2^5 = 32 */ } else { hdr.ptr_size_bits = 0; /* Unknown */ } hdr.tgt_code = sys_cpu_to_le16(arch_coredump_tgt_code_get()); backend_api->buffer_output((uint8_t *)&hdr, sizeof(hdr)); } static void dump_thread(struct k_thread *thread) { #ifdef CONFIG_DEBUG_COREDUMP_MEMORY_DUMP_MIN uintptr_t end_addr; /* * When dumping minimum information, * the current thread struct and stack need to * to be dumped so debugger can examine them. */ if (thread == NULL) { return; } end_addr = POINTER_TO_UINT(thread) + sizeof(*thread); coredump_memory_dump(POINTER_TO_UINT(thread), end_addr); end_addr = thread->stack_info.start + thread->stack_info.size; coredump_memory_dump(thread->stack_info.start, end_addr); #endif } #if defined(CONFIG_COREDUMP_DEVICE) static void process_coredump_dev_memory(const struct device *dev) { struct coredump_driver_api *api = (struct coredump_driver_api *)dev->api; api->dump(dev); } #endif void process_memory_region_list(void) { #ifdef CONFIG_DEBUG_COREDUMP_MEMORY_DUMP_LINKER_RAM unsigned int idx = 0; while (true) { struct z_coredump_memory_region_t *r = &z_coredump_memory_regions[idx]; if (r->end == POINTER_TO_UINT(NULL)) { break; } coredump_memory_dump(r->start, r->end); idx++; } #endif #if defined(CONFIG_COREDUMP_DEVICE) #define MY_FN(inst) process_coredump_dev_memory(DEVICE_DT_INST_GET(inst)); DT_INST_FOREACH_STATUS_OKAY(MY_FN) #endif } void coredump(unsigned int reason, const z_arch_esf_t *esf, struct k_thread *thread) { z_coredump_start(); dump_header(reason); if (esf != NULL) { arch_coredump_info_dump(esf); } if (thread != NULL) { dump_thread(thread); } process_memory_region_list(); z_coredump_end(); } void z_coredump_start(void) { backend_api->start(); } void z_coredump_end(void) { backend_api->end(); } void coredump_buffer_output(uint8_t *buf, size_t buflen) { if ((buf == NULL) || (buflen == 0)) { /* Invalid buffer, skip */ return; } backend_api->buffer_output(buf, buflen); } void coredump_memory_dump(uintptr_t start_addr, uintptr_t end_addr) { struct coredump_mem_hdr_t m; size_t len; if ((start_addr == POINTER_TO_UINT(NULL)) || (end_addr == POINTER_TO_UINT(NULL))) { return; } if (start_addr >= end_addr) { return; } len = end_addr - start_addr; m.id = COREDUMP_MEM_HDR_ID; m.hdr_version = COREDUMP_MEM_HDR_VER; if (sizeof(uintptr_t) == 8) { m.start = sys_cpu_to_le64(start_addr); m.end = sys_cpu_to_le64(end_addr); } else if (sizeof(uintptr_t) == 4) { m.start = sys_cpu_to_le32(start_addr); m.end = sys_cpu_to_le32(end_addr); } coredump_buffer_output((uint8_t *)&m, sizeof(m)); coredump_buffer_output((uint8_t *)start_addr, len); } int coredump_query(enum coredump_query_id query_id, void *arg) { int ret; if (backend_api->query == NULL) { ret = -ENOTSUP; } else { ret = backend_api->query(query_id, arg); } return ret; } int coredump_cmd(enum coredump_cmd_id cmd_id, void *arg) { int ret; if (backend_api->cmd == NULL) { ret = -ENOTSUP; } else { ret = backend_api->cmd(cmd_id, arg); } return ret; }