added two new apps

added tock-dpl-hello and tock-welcomes-dpl. The first app is a simple c_hello analog that prints a message and terminates on boot. The second app is a helper app that installs tock-dpl-hello on the board during runtime. These apps were made to test the dynamic process loading using hw-ci.

Author: viswajith-g

examples/tests/app_loader/Makefile renamed to examples/tests/app_loader/button-press-loading/Makefile

@@ -1,7 +1,7 @@
 # Makefile for user application
 
 # Specify this directory relative to the current application.
-TOCK_USERLAND_BASE_DIR = ../../..
+TOCK_USERLAND_BASE_DIR = ../../../..
 
 # Which files to compile.
 C_SRCS := $(wildcard *.c)

examples/tests/app_loader/README.md renamed to examples/tests/app_loader/button-press-loading/README.md

@@ -0,0 +1,11 @@
+# Makefile for user application
+
+# Specify this directory relative to the current application.
+TOCK_USERLAND_BASE_DIR = ../../../../
+
+# Which files to compile.
+C_SRCS := $(wildcard *.c)
+
+# Include userland master makefile. Contains rules and flags for actually
+# building the application.
+include $(TOCK_USERLAND_BASE_DIR)/AppMakefile.mk

examples/tests/app_loader/main.c renamed to examples/tests/app_loader/button-press-loading/main.c

@@ -0,0 +1,25 @@
+/* vim: set sw=2 expandtab tw=80: */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <unistd.h>
+
+#include <console.h>
+
+char hello[] = "Tock now supports dynamic app installs!\r\n";
+
+static void nop(
+  int   a __attribute__((unused)),
+  int   b __attribute__((unused)),
+  int   c __attribute__((unused)),
+  void* d __attribute__((unused))) {}
+
+int main(void) {
+  putnstr_async(hello, strlen(hello), nop, NULL);
+  // Because we used the async method (as opposed to something synchronous,
+  // such as printf), we must explicitly wait for the asynchronous write to complete.
+  yield();
+  // Now we are done.
+  return 0;
+}

examples/tests/app_loader/tock-dpl-hello/Makefile

@@ -0,0 +1,11 @@
+# Makefile for user application
+
+# Specify this directory relative to the current application.
+TOCK_USERLAND_BASE_DIR = ../../../..
+
+# Which files to compile.
+C_SRCS := $(wildcard *.c)
+
+# Include userland master makefile. Contains rules and flags for actually
+# building the application.
+include $(TOCK_USERLAND_BASE_DIR)/AppMakefile.mk

examples/tests/app_loader/tock-dpl-hello/main.c

@@ -0,0 +1,12 @@
+# Dynamic App Loader (HW-CLI Test App)
+======================================
+
+This app installs a new `tock-welcomes-dpl` app upon boot. 
+This new app prints `Tock now supports dynamic application installs and updates!` 
+before terminating.
+
+#### Outcomes:
+The app requests the capsule to load the new app. There are only two outcomes: 
+
+1. The `tock-welcomes-dpl` app is loaded successfully and functions without requiring a restart.
+2. The load process failed somewhere, and the app is erased.

examples/tests/app_loader/tock-welcomes-dpl/Makefile

@@ -8,7 +8,7 @@ extern "C"
 #include "tock.h"
 
 // Driver number for system call
-#define DRIVER_NUM_APP_LOADER   0x50004
+#define DRIVER_NUM_APP_LOADER   0x10001
 
 #define BUTTON1 0
 #define BUTTON2 1

examples/tests/app_loader/tock-welcomes-dpl/README.md

@@ -24,7 +24,7 @@ def print_hex_array(hex_array):
         print()  # Add a new line if the last line is not complete
 
 
-file_name = 'examples/adc/build/cortex-m4/cortex-m4.tbf'
+file_name = 'examples/tests/app_loader/tock-dpl-hello/build/cortex-m4/cortex-m4.tbf'
 binary_data = read_binary_file(file_name)
 hex_array = binary_to_array(binary_data)
 print_hex_array(hex_array)