Move libcaliptra example functionality into a test.c file.

This can make it easier to use the same test functionality in a different build system. Moves all test logic to test.c and only exposes a run_tests function that takes a parameter with the settings that will be used for the tests. The actually functionality of the test isn't changed at all.

Reading in the FW images was moved to main.c and an initialization function was added to interface.c. It gets initialized at the beginning of run_tests.

Some function parameters were changed to const because they weren't being changed within the function.

Also contains some #include cleanup.

Author: zhalvorsen

libcaliptra/examples/generic/main.c

@@ -3,7 +3,7 @@ Q=@
 CC=$(CROSS_COMPILE)gcc
 AR=$(CROSS_COMPILE)ar
 
-SOURCE += ../generic/main.c ../../src/caliptra_api.c
+SOURCE += ../generic/main.c ../generic/test.c ../../src/caliptra_api.c
 
 LIBCALIPTRA_ROOT = ../..
 LIBCALIPTRA_INC  = $(LIBCALIPTRA_ROOT)/inc
@@ -14,7 +14,7 @@ OBJS := $(patsubst %.c,%.o, $(filter %.c,$(SOURCE)))
 RTL_SOC_IFC_INCLUDE_PATH = ../../../hw/1.0/rtl/src/soc_ifc/rtl
 
 # INCLUDES
-INCLUDES += -I$(RTL_SOC_IFC_INCLUDE_PATH) -I$(LIBCALIPTRA_INC)
+INCLUDES += -I$(RTL_SOC_IFC_INCLUDE_PATH) -I$(LIBCALIPTRA_INC) -I./
 
 .PHONY = run clean