/**************************************************************************** * apps/nshlib/nsh_dbgcmds.c * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. The * ASF licenses this file to you under the Apache License, Version 2.0 (the * "License"); you may not use this file except in compliance with the * License. You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations * under the License. * ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include #include #include #include "nsh.h" #include "nsh_console.h" /**************************************************************************** * Pre-processor Definitions ****************************************************************************/ #undef NSH_HAVE_MEMCMDS #if !defined(CONFIG_NSH_DISABLE_MB) || !defined(CONFIG_NSH_DISABLE_MH) || \ !defined(CONFIG_NSH_DISABLE_MW) # define NSH_HAVE_MEMCMDS 1 #endif /**************************************************************************** * Private Types ****************************************************************************/ #ifdef NSH_HAVE_MEMCMDS struct dbgmem_s { bool dm_write; /* true: perform write operation */ FAR void *dm_addr; /* Address to access */ uint32_t dm_value; /* Value to write */ unsigned int dm_count; /* The number of bytes to access */ }; #endif /**************************************************************************** * Private Functions ****************************************************************************/ /**************************************************************************** * Name: mem_parse ****************************************************************************/ #ifdef NSH_HAVE_MEMCMDS static int mem_parse(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv, FAR struct dbgmem_s *mem) { UNUSED(vtbl); FAR char *pcvalue = strchr(argv[1], '='); unsigned long lvalue = 0; /* Check if we are writing a value */ if (pcvalue) { *pcvalue = '\0'; pcvalue++; lvalue = strtoul(pcvalue, NULL, 16); if (lvalue > 0xffffffffl) { return -EINVAL; } mem->dm_write = true; mem->dm_value = (uint32_t)lvalue; } else { mem->dm_write = false; mem->dm_value = 0; } /* Get the address to be accessed */ mem->dm_addr = (FAR void *)((uintptr_t)strtoul(argv[1], NULL, 16)); /* Get the number of bytes to access */ if (argc > 2) { mem->dm_count = (unsigned int)strtoul(argv[2], NULL, 16); } else { mem->dm_count = 1; } return OK; } #endif /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: cmd_mb ****************************************************************************/ #ifndef CONFIG_NSH_DISABLE_MB int cmd_mb(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv) { struct dbgmem_s mem; FAR volatile uint8_t *ptr; unsigned int i; int ret; ret = mem_parse(vtbl, argc, argv, &mem); if (ret == 0) { /* Loop for the number of requested bytes */ for (i = 0, ptr = (volatile uint8_t *)mem.dm_addr; i < mem.dm_count; i++, ptr++) { /* Print the value at the address */ nsh_output(vtbl, " %p = 0x%02x", ptr, *ptr); /* Are we supposed to write a value to this address? */ if (mem.dm_write) { /* Yes, was the supplied value within range? */ if (mem.dm_value > 0x000000ff) { nsh_error(vtbl, g_fmtargrange, argv[0]); return ERROR; } /* Write the value and re-read the address so that we print its * current value (if the address is a process address, then the * value read might not necessarily be the value written). */ *ptr = (uint8_t)mem.dm_value; nsh_output(vtbl, " -> 0x%02x", *ptr); } /* Make sure we end it with a newline */ nsh_output(vtbl, "\n"); } } return ret; } #endif /**************************************************************************** * Name: cmd_mh ****************************************************************************/ #ifndef CONFIG_NSH_DISABLE_MH int cmd_mh(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv) { struct dbgmem_s mem; FAR volatile uint16_t *ptr; unsigned int i; int ret; ret = mem_parse(vtbl, argc, argv, &mem); if (ret == 0) { /* Loop for the number of requested bytes */ for (i = 0, ptr = (volatile uint16_t *)mem.dm_addr; i < mem.dm_count; i += 2, ptr++) { /* Print the value at the address */ nsh_output(vtbl, " %p = 0x%04x", ptr, *ptr); /* Are we supposed to write a value to this address? */ if (mem.dm_write) { /* Yes, was the supplied value within range? */ if (mem.dm_value > 0x0000ffff) { nsh_error(vtbl, g_fmtargrange, argv[0]); return ERROR; } /* Write the value and re-read the address so that we print its * current value (if the address is a process address, then the * value read might not necessarily be the value written). */ *ptr = (uint16_t)mem.dm_value; nsh_output(vtbl, " -> 0x%04x", *ptr); } /* Make sure we end it with a newline */ nsh_output(vtbl, "\n"); } } return ret; } #endif /**************************************************************************** * Name: cmd_mw ****************************************************************************/ #ifndef CONFIG_NSH_DISABLE_MW int cmd_mw(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv) { struct dbgmem_s mem; FAR volatile uint32_t *ptr; unsigned int i; int ret; ret = mem_parse(vtbl, argc, argv, &mem); if (ret == 0) { /* Loop for the number of requested bytes */ for (i = 0, ptr = (volatile uint32_t *)mem.dm_addr; i < mem.dm_count; i += 4, ptr++) { /* Print the value at the address */ nsh_output(vtbl, " %p = 0x%08" PRIx32, ptr, *ptr); /* Are we supposed to write a value to this address? */ if (mem.dm_write) { /* Write the value and re-read the address so that we print its * current value (if the address is a process address, then the * value read might not necessarily be the value written). */ *ptr = mem.dm_value; nsh_output(vtbl, " -> 0x%08" PRIx32, *ptr); } /* Make sure we end it with a newline */ nsh_output(vtbl, "\n"); } } return ret; } #endif /**************************************************************************** * Name: nsh_dumpbuffer ****************************************************************************/ void nsh_dumpbuffer(FAR struct nsh_vtbl_s *vtbl, FAR const char *msg, FAR const uint8_t *buffer, ssize_t nbytes) { char line[128]; size_t size; int ch; int i; int j; nsh_output(vtbl, "%s:\n", msg); for (i = 0; i < nbytes; i += 16) { snprintf(line, sizeof(line), "%04x: ", i); size = strlen(line); for (j = 0; j < 16; j++) { if (i + j < nbytes) { snprintf(&line[size], sizeof(line) - size, "%02x ", buffer[i + j]); } else { strlcpy(&line[size], " ", sizeof(line) - size); } size += strlen(&line[size]); } for (j = 0; j < 16; j++) { if (i + j < nbytes) { ch = buffer[i + j]; snprintf(&line[size], sizeof(line) - size, "%c", ch >= 0x20 && ch <= 0x7e ? ch : '.'); size += strlen(&line[size]); } } nsh_output(vtbl, "%s\n", line); } } /**************************************************************************** * Name: cmd_xd, hex dump of memory ****************************************************************************/ #ifndef CONFIG_NSH_DISABLE_XD int cmd_xd(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv) { UNUSED(argc); FAR char *addr; FAR char *endptr; int nbytes; addr = (FAR char *)((uintptr_t)strtoul(argv[1], &endptr, 16)); if (argv[0][0] == '\0' || *endptr != '\0') { return ERROR; } nbytes = (int)strtol(argv[2], &endptr, 0); if (argv[0][0] == '\0' || *endptr != '\0' || nbytes < 0) { return ERROR; } nsh_dumpbuffer(vtbl, "Hex dump", (uint8_t *)addr, nbytes); return OK; } #endif /**************************************************************************** * Name: cmd_hexdump, hex dump of files ****************************************************************************/ #ifndef CONFIG_NSH_DISABLE_HEXDUMP int cmd_hexdump(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv) { FAR uint8_t *buffer; char msg[32]; off_t position; int fd; int ret = OK; #ifdef CONFIG_NSH_CMDOPT_HEXDUMP off_t skip = 0; off_t count = 0xfffffff; off_t dumpbytes; int x; #endif /* Open the file for reading */ fd = open(argv[1], O_RDONLY); if (fd < 0) { nsh_error(vtbl, g_fmtcmdfailed, "hexdump", "open", NSH_ERRNO); return ERROR; } buffer = (FAR uint8_t *)malloc(IOBUFFERSIZE); if (buffer == NULL) { close(fd); nsh_error(vtbl, g_fmtcmdfailed, "hexdump", "malloc", NSH_ERRNO); return ERROR; } #ifdef CONFIG_NSH_CMDOPT_HEXDUMP for (x = 2; x < argc; x++) { if (strncmp(argv[x], "skip=", 5) == 0) { skip = atoi(&argv[x][5]); } else if (strncmp(argv[x], "count=", 6) == 0) { count = atoi(&argv[x][6]); } } #endif position = 0; for (; ; ) { int nbytesread = read(fd, buffer, IOBUFFERSIZE); /* Check for read errors */ if (nbytesread < 0) { nsh_error(vtbl, g_fmtcmdfailed, "hexdump", "read", NSH_ERRNO_OF(errno)); ret = ERROR; break; } else if (nbytesread > 0) { #ifdef CONFIG_NSH_CMDOPT_HEXDUMP if (position < skip) { /* Skip bytes until we reach the skip point */ position += nbytesread; if (position > skip) { dumpbytes = position - skip; if (dumpbytes > count) { dumpbytes = count; } snprintf(msg, sizeof(msg), "%s at %08jx", argv[1], (uintmax_t)skip); nsh_dumpbuffer(vtbl, msg, &buffer[nbytesread - (position - skip)], dumpbytes); if (count > dumpbytes) { count -= dumpbytes; } else { break; } } /* Don't print if we are in skip mode */ continue; } /* Limit dumpbuffer to count if less than a full buffer needed */ if (nbytesread > count) { nbytesread = count; } #endif snprintf(msg, sizeof(msg), "%s at %08jx", argv[1], (uintmax_t)position); nsh_dumpbuffer(vtbl, msg, buffer, nbytesread); position += nbytesread; #ifdef CONFIG_NSH_CMDOPT_HEXDUMP if (count > nbytesread) { count -= nbytesread; } else { break; } #endif } else { break; /* EOF */ } } close(fd); free(buffer); return ret; } #endif /**************************************************************************** * Name: cmd_irqinfo ****************************************************************************/ #ifdef HAVE_IRQINFO int cmd_irqinfo(FAR struct nsh_vtbl_s *vtbl, int argc, FAR char **argv) { UNUSED(argc); return nsh_catfile(vtbl, argv[0], CONFIG_NSH_PROC_MOUNTPOINT "/irqs"); } #endif