testing: Add simple debug test program

It is a simple test case of the NuttX debugging facilities (breakpoint and watchpoint).

Signed-off-by: Huang Qi <huangqi3@xiaomi.com>

testing/debug/CMakeLists.txt

@@ -0,0 +1,31 @@
+# ##############################################################################
+# apps/testing/debug/CMakeLists.txt
+#
+# 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.
+#
+# ##############################################################################
+
+if(CONFIG_TESTING_DEBUG)
+  nuttx_add_application(
+    NAME
+    ${CONFIG_TESTING_DEBUG_PROGNAME}
+    SRCS
+    debug.c
+    STACKSIZE
+    ${CONFIG_TESTING_DEBUG_STACKSIZE}
+    PRIORITY
+    ${CONFIG_TESTING_DEBUG_PRIORITY})
+endif()

testing/debug/Kconfig

@@ -0,0 +1,31 @@
+#
+# For a description of the syntax of this configuration file,
+# see the file kconfig-language.txt in the NuttX tools repository.
+#
+
+config TESTING_DEBUG
+	tristate "Debug test"
+	default n
+	depends on ARCH_HAVE_DEBUG
+	---help---
+		Enable the DEBUG test program. It is a simple
+		test case of the NuttX debugging facilities.
+
+if TESTING_DEBUG
+
+config TESTING_DEBUG_PROGNAME
+	string "Program name"
+	default "debug"
+	---help---
+		This is the name of the program that will be used when the NSH ELF
+		program is installed.
+
+config TESTING_DEBUG_PRIORITY
+	int "Task priority"
+	default 100
+
+config TESTING_DEBUG_STACKSIZE
+	int "Stack size"
+	default DEFAULT_TASK_STACKSIZE
+
+endif

testing/debug/Make.defs

@@ -0,0 +1,23 @@
+############################################################################
+# apps/testing/debug/Make.defs
+#
+# 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.
+#
+############################################################################
+
+ifneq ($(CONFIG_TESTING_DEBUG),)
+CONFIGURED_APPS += $(APPDIR)/testing/debug
+endif

testing/debug/Makefile

@@ -0,0 +1,34 @@
+############################################################################
+# apps/testing/debug/Makefile
+#
+# 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.
+#
+############################################################################
+
+include $(APPDIR)/Make.defs
+
+# debug built-in application info
+
+PROGNAME = $(CONFIG_TESTING_DEBUG_PROGNAME)
+PRIORITY = $(CONFIG_TESTING_DEBUG_PRIORITY)
+STACKSIZE = $(CONFIG_TESTING_DEBUG_STACKSIZE)
+MODULE = $(CONFIG_TESTING_DEBUG)
+
+# debug Example
+
+MAINSRC = debug.c
+
+include $(APPDIR)/Application.mk

testing/debug/debug.c

@@ -0,0 +1,276 @@
+/****************************************************************************
+ * apps/testing/debug/debug.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 <stdio.h>
+#include <stdbool.h>
+
+#include <nuttx/arch.h>
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Private Data
+ ****************************************************************************/
+
+static uint8_t g_test_data[4];
+static const char g_test_rodata[] = "This is a read-only string";
+
+/****************************************************************************
+ * Private Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: trigger_func1
+ ****************************************************************************/
+
+static void test_trigger(void)
+{
+  printf("Calling test_trigger\n");
+}
+
+/****************************************************************************
+ * Name: debug_callback
+ ****************************************************************************/
+
+static void debug_callback(int type, FAR void *addr, size_t size,
+                           FAR void *arg)
+{
+  *(bool *)arg = true;
+  up_debugpoint_remove(type, addr, size);
+}
+
+/****************************************************************************
+ * Name: test_function
+ ****************************************************************************/
+
+static int test_function(void (*func)(void))
+{
+  int ret = 0;
+  bool triggered = false;
+  printf("==== Calling test_function ====\n");
+
+  printf("Add breakpoint at 0x%" PRIxPTR "\n", (uintptr_t)func);
+  ret = up_debugpoint_add(DEBUGPOINT_BREAKPOINT, func, 0,
+                          debug_callback, &triggered);
+
+  if (ret != OK)
+    {
+      printf("ERROR: Registering breakpoint at %p failed with %d\n",
+             func, ret);
+      return ret;
+    }
+
+  func();
+
+  if (triggered)
+    {
+      printf("Pass: Breakpoint at %p triggered\n", func);
+    }
+  else
+    {
+      up_debugpoint_remove(DEBUGPOINT_BREAKPOINT, func, 0);
+      printf("ERROR: Breakpoint %p not triggered\n", func);
+      ret = -1;
+    }
+
+  return ret;
+}
+
+/****************************************************************************
+ * Name: test_dataread
+ ****************************************************************************/
+
+static int test_data(uint8_t *addr, size_t size, bool r, bool w)
+{
+  int ret = 0;
+  int tmp;
+  int test_type;
+  bool triggered = false;
+
+  printf("==== Calling test_data ====\n");
+
+  if (r && w)
+    {
+      test_type = DEBUGPOINT_WATCHPOINT_RW;
+      printf("Add read/write watchpoint at 0x%" PRIxPTR "\n",
+             (uintptr_t)addr);
+    }
+  else if (r)
+    {
+      test_type = DEBUGPOINT_WATCHPOINT_RO;
+      printf("Add read watchpoint at 0x%" PRIxPTR "\n", (uintptr_t)addr);
+    }
+  else if (w)
+    {
+      test_type = DEBUGPOINT_WATCHPOINT_WO;
+      printf("Add write watchpoint at 0x%" PRIxPTR "\n", (uintptr_t)addr);
+    }
+  else
+    {
+      printf("ERROR: Invalid test type\n");
+      return -1;
+    }
+
+  triggered = false;
+  ret = up_debugpoint_add(test_type, addr, size,
+                          debug_callback, &triggered);
+
+  if (ret != OK)
+    {
+      printf("ERROR: Registering read watchpoint at %p failed with %d\n",
+             addr, ret);
+      return ret;
+    }
+
+  if (r & w)
+    {
+      /* Trigger the watchpoint by reading and writing to the address */
+
+      if (addr[0] == 0x55)
+        {
+          /* Do something to avoid compiler removing the read */
+
+          tmp = 0xaa;
+        }
+      else
+        {
+          tmp = 0x55;
+        }
+
+      if (triggered)
+        {
+          printf("Pass: Read watchpoint at %p triggered\n", addr);
+        }
+      else
+        {
+          up_debugpoint_remove(test_type, addr, size);
+          printf("ERROR: Read watchpoint at %p not triggered\n", addr);
+          ret = -1;
+        }
+
+      /* Register the watchpoint again to test write watchpoints */
+
+      triggered = false;
+      ret = up_debugpoint_add(test_type, addr, size,
+                              debug_callback, &triggered);
+
+      if (ret != OK)
+        {
+          printf("ERROR: Registering read/write watchpoint at %p"
+                      " failed with %d\n", addr, ret);
+          return ret;
+        }
+
+      addr[0] = tmp;
+
+      if (triggered)
+        {
+          printf("Pass: Write watchpoint at %p triggered\n", addr);
+        }
+      else
+        {
+          up_debugpoint_remove(test_type, addr, size);
+          printf("ERROR: Write watchpoint at %p not triggered\n", addr);
+          ret = -1;
+        }
+    }
+  else if (r)
+    {
+      /* Trigger the watchpoint by reading the address */
+
+      if (addr[0] == 0x55)
+        {
+          /* Do nothing to avoid compiler removing the read */
+
+          ret = 0;
+        }
+
+      if (triggered)
+        {
+          printf("Pass: Read watchpoint at %p triggered\n", addr);
+        }
+      else
+        {
+          up_debugpoint_remove(test_type, addr, size);
+          printf("ERROR: Read watchpoint at %p not triggered\n", addr);
+          ret = -1;
+        }
+    }
+  else if (w)
+    {
+      /** Trigger the watchpoint by writing to the address */
+
+      addr[0] = 0x55;
+
+      if (triggered)
+        {
+          printf("Pass: Write watchpoint at %p triggered\n", addr);
+        }
+      else
+        {
+          up_debugpoint_remove(test_type, addr, size);
+          printf("ERROR: Write watchpoint at %p not triggered\n", addr);
+          ret = -1;
+        }
+    }
+
+  return ret;
+}
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+/****************************************************************************
+ * Name: main
+ ****************************************************************************/
+
+int main(int argc, FAR char *argv[])
+{
+  printf("Testing breakpoints\n");
+
+  /* Test breakpoint at a function */
+
+  test_function(test_trigger);
+
+  /* Test read watchpoint for rodata */
+
+  test_data((uint8_t *)&g_test_rodata, sizeof(g_test_rodata), true, false);
+
+  /* Test read watchpoint for data */
+
+  test_data((uint8_t *)&g_test_data, sizeof(g_test_data), true, false);
+
+  /* Test write watchpoint for data */
+
+  test_data((uint8_t *)&g_test_data, sizeof(g_test_data), false, true);
+
+  /* Test read/write watchpoint for data */
+
+  test_data((uint8_t *)&g_test_data, sizeof(g_test_data), true, true);
+
+  return 0;
+}