Start of public OpenTitan development history
Code contributors:
Alex Bradbury <asb@lowrisc.org>
Cindy Chen <chencindy@google.com>
Eunchan Kim <eunchan@google.com>
Gaurang Chitroda <gaurangg@google.com>
Mark Hayter <mark.hayter@gmail.com>
Michael Schaffner <msf@google.com>
Miguel Osorio <miguelosorio@google.com>
Nils Graf <nilsg@google.com>
Philipp Wagner <phw@lowrisc.org>
Pirmin Vogel <vogelpi@lowrisc.org>
Ram Babu Penugonda <rampenugonda@google.com>
Scott Johnson <scottdj@google.com>
Shail Kushwah <kushwahs@google.com>
Srikrishna Iyer <sriyer@google.com>
Steve Nelson <Steve.Nelson@wdc.com>
Tao Liu <taliu@google.com>
Timothy Chen <timothytim@google.com>
Tobias Wölfel <tobias.woelfel@mailbox.org>
Weicai Yang <weicai@google.com>
diff --git a/sw/.gitignore b/sw/.gitignore
new file mode 100644
index 0000000..19c0fdf
--- /dev/null
+++ b/sw/.gitignore
@@ -0,0 +1,10 @@
+*.a
+*.bin
+*.d
+*.dis
+*.elf
+*.map
+*.o
+*.vmem
+*_regs.h
+*.map
diff --git a/sw/benchmarks/coremark/Makefile b/sw/benchmarks/coremark/Makefile
new file mode 100644
index 0000000..0fa4dfb
--- /dev/null
+++ b/sw/benchmarks/coremark/Makefile
@@ -0,0 +1,24 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+NAME := coremark
+PROGRAM_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+COREMARK_DIR := $(PROGRAM_DIR)/../../vendor/$(NAME)
+COREMARK_PORT := $(PROGRAM_DIR)/top_earlgrey
+
+all:
+# $(MAKE) -C $(LIB_DIR) MAKEFLAGS=$(MAKEFLAGS)
+ $(MAKE) -C $(LIB_DIR)
+ $(MAKE) -C $(COREMARK_DIR) PORT_DIR=$(COREMARK_PORT)
+ $(foreach out, $(OUTFILES), cp $(COREMARK_DIR)/$(out) .;)
+
+
+distclean:
+ $(RM) $(OUTFILES)
+ $(MAKE) -C $(LIB_DIR) distclean
+ $(MAKE) -C $(COREMARK_DIR) clean PORT_DIR=$(COREMARK_PORT)
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
diff --git a/sw/benchmarks/coremark/README.md b/sw/benchmarks/coremark/README.md
new file mode 100644
index 0000000..4d8d3c6
--- /dev/null
+++ b/sw/benchmarks/coremark/README.md
@@ -0,0 +1,13 @@
+# Options
+There are two main options available for coremark SIM, ITERATIONS
+
+## ITERATIONS
+Controls how many iteartions are run. By default this value is 0 and will cause coremark to run >10s.
+For simulation and verilator, set to 1 for a reduced run
+
+## For verilator
+make distclean; make SIM=1 ITERATIONS=1
+SIM=1 matces the verilator UART baudrates
+
+## For DV / FPGA
+make distclean; make ITERATIONS=1/N
diff --git a/sw/benchmarks/coremark/top_earlgrey/core_portme.c b/sw/benchmarks/coremark/top_earlgrey/core_portme.c
new file mode 100644
index 0000000..0ef7e62
--- /dev/null
+++ b/sw/benchmarks/coremark/top_earlgrey/core_portme.c
@@ -0,0 +1,122 @@
+/*
+ File : core_portme.c
+*/
+/*
+ Author : Shay Gal-On, EEMBC
+ Legal : TODO!
+*/
+#include "core_portme.h"
+
+#include "coremark.h"
+
+#if VALIDATION_RUN
+volatile ee_s32 seed1_volatile = 0x3415;
+volatile ee_s32 seed2_volatile = 0x3415;
+volatile ee_s32 seed3_volatile = 0x66;
+#endif
+#if PERFORMANCE_RUN
+volatile ee_s32 seed1_volatile = 0x0;
+volatile ee_s32 seed2_volatile = 0x0;
+volatile ee_s32 seed3_volatile = 0x66;
+#endif
+#if PROFILE_RUN
+volatile ee_s32 seed1_volatile = 0x8;
+volatile ee_s32 seed2_volatile = 0x8;
+volatile ee_s32 seed3_volatile = 0x8;
+#endif
+volatile ee_s32 seed4_volatile = ITERATIONS;
+volatile ee_s32 seed5_volatile = 0;
+/* Porting : Timing functions
+ How to capture time and convert to seconds must be ported to whatever is
+ supported by the platform. e.g. Read value from on board RTC, read value from
+ cpu clock cycles performance counter etc. Sample implementation for standard
+ time.h and windows.h definitions included.
+*/
+CORETIMETYPE barebones_clock() {
+ ee_u32 result;
+ __asm__ volatile("csrr %0, mcycle;" : "=r"(result));
+ return result;
+}
+/* Define : TIMER_RES_DIVIDER
+ Divider to trade off timer resolution and total time that can be
+ measured.
+
+ Use lower values to increase resolution, but make sure that overflow
+ does not occur. If there are issues with the return value overflowing,
+ increase this value.
+ */
+#define GETMYTIME(_t) (*_t = barebones_clock())
+#define MYTIMEDIFF(fin, ini) ((fin) - (ini))
+#define TIMER_RES_DIVIDER 1
+#define SAMPLE_TIME_IMPLEMENTATION 1
+#define CLOCKS_PER_SEC 500000
+#define EE_TICKS_PER_SEC (CLOCKS_PER_SEC / TIMER_RES_DIVIDER)
+
+/** Define Host specific (POSIX), or target specific global time variables. */
+static CORETIMETYPE start_time_val, stop_time_val;
+
+/* Function : start_time
+ This function will be called right before starting the timed portion of
+ the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the
+ example code) or zeroing some system parameters - e.g. setting the cpu clocks
+ cycles to 0.
+*/
+void start_time(void) { GETMYTIME(&start_time_val); }
+/* Function : stop_time
+ This function will be called right after ending the timed portion of the
+ benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the
+ example code) or other system parameters - e.g. reading the current value of
+ cpu cycles counter.
+*/
+void stop_time(void) { GETMYTIME(&stop_time_val); }
+/* Function : get_time
+ Return an abstract "ticks" number that signifies time on the system.
+
+ Actual value returned may be cpu cycles, milliseconds or any other
+ value, as long as it can be converted to seconds by <time_in_secs>. This
+ methodology is taken to accomodate any hardware or simulated platform. The
+ sample implementation returns millisecs by default, and the resolution is
+ controlled by <TIMER_RES_DIVIDER>
+*/
+CORE_TICKS get_time(void) {
+ CORE_TICKS elapsed = (CORE_TICKS)(MYTIMEDIFF(stop_time_val, start_time_val));
+ return elapsed;
+}
+/* Function : time_in_secs
+ Convert the value returned by get_time to seconds.
+
+ The <secs_ret> type is used to accomodate systems with no support for
+ floating point. Default implementation implemented by the EE_TICKS_PER_SEC
+ macro above.
+*/
+secs_ret time_in_secs(CORE_TICKS ticks) {
+ secs_ret retval = ((secs_ret)ticks) / (secs_ret)EE_TICKS_PER_SEC;
+ return retval;
+}
+
+ee_u32 default_num_contexts = 1;
+
+/* Function : portable_init
+ Target specific initialization code
+ Test for some common mistakes.
+*/
+void portable_init(core_portable *p, int *argc, char *argv[]) {
+ uart_init(UART_BAUD_RATE);
+
+ if (sizeof(ee_ptr_int) != sizeof(ee_u8 *)) {
+ ee_printf(
+ "ERROR! Please define ee_ptr_int to a type that holds a pointer!\n");
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR! Please define ee_u32 to a 32b unsigned type!\n");
+ }
+ p->portable_id = 1;
+}
+/* Function : portable_fini
+ Target specific final code
+*/
+void portable_fini(core_portable *p) { p->portable_id = 0; }
diff --git a/sw/benchmarks/coremark/top_earlgrey/core_portme.h b/sw/benchmarks/coremark/top_earlgrey/core_portme.h
new file mode 100644
index 0000000..bf0bd98
--- /dev/null
+++ b/sw/benchmarks/coremark/top_earlgrey/core_portme.h
@@ -0,0 +1,206 @@
+/* File : core_portme.h */
+
+/*
+ Author : Shay Gal-On, EEMBC
+ Legal : TODO!
+*/
+/* Topic : Description
+ This file contains configuration constants required to execute on
+ different platforms
+*/
+
+#ifndef CORE_PORTME_H
+#define CORE_PORTME_H
+
+#include <sys/types.h>
+
+#include "common.h"
+#include "uart.h"
+
+extern unsigned int _stack_start;
+
+/************************/
+/* Data types and settings */
+/************************/
+/* Configuration : HAS_FLOAT
+ Define to 1 if the platform supports floating point.
+*/
+#ifndef HAS_FLOAT
+#define HAS_FLOAT 0
+#endif
+/* Configuration : HAS_TIME_H
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef HAS_TIME_H
+#define HAS_TIME_H 1
+#endif
+/* Configuration : USE_CLOCK
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef USE_CLOCK
+#define USE_CLOCK 1
+#endif
+/* Configuration : HAS_STDIO
+ Define to 1 if the platform has stdio.h.
+*/
+#ifndef HAS_STDIO
+#define HAS_STDIO 0
+#endif
+/* Configuration : HAS_PRINTF
+ Define to 1 if the platform has stdio.h and implements the printf
+ function.
+*/
+#ifndef HAS_PRINTF
+#define HAS_PRINTF 0
+#endif
+
+/* Definitions : COMPILER_VERSION, COMPILER_FLAGS, MEM_LOCATION
+ Initialize these strings per platform
+*/
+#ifndef COMPILER_VERSION
+#ifdef __GNUC__
+#define COMPILER_VERSION "GCC"
+#else
+#define COMPILER_VERSION "unknown"
+#endif
+#endif
+#ifndef COMPILER_FLAGS
+#define COMPILER_FLAGS "" /* "Please put compiler flags here (e.g. -o3)" */
+#endif
+#ifndef MEM_LOCATION
+#define MEM_LOCATION _stack_start
+#endif
+
+/* Data Types :
+ To avoid compiler issues, define the data types that need to be used for
+ 8b, 16b and 32b in <core_portme.h>.
+
+ *Imprtant* :
+ ee_ptr_int needs to be the data type used to hold pointers, otherwise
+ coremark may fail!!!
+*/
+typedef signed short ee_s16;
+typedef unsigned short ee_u16;
+typedef signed int ee_s32;
+typedef double ee_f32;
+typedef unsigned char ee_u8;
+typedef unsigned int ee_u32;
+typedef ee_u32 ee_ptr_int;
+typedef size_t ee_size_t;
+#define NULL ((void *)0)
+/* align_mem :
+ This macro is used to align an offset to point to a 32b value. It is
+ used in the Matrix algorithm to initialize the input memory blocks.
+*/
+#define align_mem(x) (void *)(4 + (((ee_ptr_int)(x)-1) & ~3))
+
+/* Configuration : CORE_TICKS
+ Define type of return from the timing functions.
+ */
+#define CORETIMETYPE ee_u32
+typedef ee_u32 CORE_TICKS;
+
+/* Configuration : SEED_METHOD
+ Defines method to get seed values that cannot be computed at compile
+ time.
+
+ Valid values :
+ SEED_ARG - from command line.
+ SEED_FUNC - from a system function.
+ SEED_VOLATILE - from volatile variables.
+*/
+#ifndef SEED_METHOD
+#define SEED_METHOD SEED_VOLATILE
+#endif
+
+/* Configuration : MEM_METHOD
+ Defines method to get a block of memry.
+
+ Valid values :
+ MEM_MALLOC - for platforms that implement malloc and have malloc.h.
+ MEM_STATIC - to use a static memory array.
+ MEM_STACK - to allocate the data block on the stack (NYI).
+*/
+#ifndef MEM_METHOD
+#define MEM_METHOD MEM_STACK
+#endif
+
+/* Configuration : MULTITHREAD
+ Define for parallel execution
+
+ Valid values :
+ 1 - only one context (default).
+ N>1 - will execute N copies in parallel.
+
+ Note :
+ If this flag is defined to more then 1, an implementation for launching
+ parallel contexts must be defined.
+
+ Two sample implementations are provided. Use <USE_PTHREAD> or <USE_FORK>
+ to enable them.
+
+ It is valid to have a different implementation of <core_start_parallel>
+ and <core_end_parallel> in <core_portme.c>, to fit a particular architecture.
+*/
+#ifndef MULTITHREAD
+#define MULTITHREAD 1
+#define USE_PTHREAD 0
+#define USE_FORK 0
+#define USE_SOCKET 0
+#endif
+
+/* Configuration : MAIN_HAS_NOARGC
+ Needed if platform does not support getting arguments to main.
+
+ Valid values :
+ 0 - argc/argv to main is supported
+ 1 - argc/argv to main is not supported
+
+ Note :
+ This flag only matters if MULTITHREAD has been defined to a value
+ greater then 1.
+*/
+#ifndef MAIN_HAS_NOARGC
+#define MAIN_HAS_NOARGC 0
+#endif
+
+/* Configuration : MAIN_HAS_NORETURN
+ Needed if platform does not support returning a value from main.
+
+ Valid values :
+ 0 - main returns an int, and return value will be 0.
+ 1 - platform does not support returning a value from main
+*/
+#ifndef MAIN_HAS_NORETURN
+#define MAIN_HAS_NORETURN 0
+#endif
+
+/* Variable : default_num_contexts
+ Not used for this simple port, must cintain the value 1.
+*/
+extern ee_u32 default_num_contexts;
+
+typedef struct CORE_PORTABLE_S {
+ ee_u8 portable_id;
+} core_portable;
+
+/* target specific init/fini */
+void portable_init(core_portable *p, int *argc, char *argv[]);
+void portable_fini(core_portable *p);
+
+#if !defined(PROFILE_RUN) && !defined(PERFORMANCE_RUN) && \
+ !defined(VALIDATION_RUN)
+#if (TOTAL_DATA_SIZE == 1200)
+#define PROFILE_RUN 1
+#elif (TOTAL_DATA_SIZE == 2000)
+#define PERFORMANCE_RUN 1
+#else
+#define VALIDATION_RUN 1
+#endif
+#endif
+
+int ee_printf(const char *fmt, ...);
+
+#endif /* CORE_PORTME_H */
diff --git a/sw/benchmarks/coremark/top_earlgrey/core_portme.mak b/sw/benchmarks/coremark/top_earlgrey/core_portme.mak
new file mode 100755
index 0000000..739e251
--- /dev/null
+++ b/sw/benchmarks/coremark/top_earlgrey/core_portme.mak
@@ -0,0 +1,82 @@
+#File : core_portme.mak
+
+NAME = coremark
+PORTME_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+PROGRAM_DIR := $(PORTME_DIR)/../
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
+PORT_CLEAN := $(OUTFILES)
+
+
+# Flag : OUTFLAG
+# Use this flag to define how to to get an executable (e.g -o)
+OUTFLAG= -T $(LINKER_SCRIPT) -L$(LIB_DIR) -l$(LIB_NAME) -Xlinker -Map=coremark.map -o
+# Flag : CC
+# Use this flag to define compiler to use
+CC = $(RV_TOOLS)/riscv32-unknown-elf-gcc
+# Flag : LD
+# Use this flag to define compiler to use
+LD = $(RV_TOOLS)/riscv32-unknown-elf-ld
+# Flag : AS
+# Use this flag to define compiler to use
+AS = $(RV_TOOLS)/riscv32-unknown-elf-as
+# Flag : CFLAGS
+# Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS="other flags"
+PORT_CFLAGS = -DTOTAL_DATA_SIZE=6000 -DMAIN_HAS_NOARGC=1
+FLAGS_STR = "$(PORT_CFLAGS) $(XCFLAGS) $(XLFLAGS) $(LFLAGS_END)"
+CFLAGS += $(PORT_CFLAGS) $(XCFLAGS) -I$(PORT_DIR) -I. -I$(LIB_DIR)
+#Flag : LFLAGS_END
+# Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts).
+# Note : On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.
+#SEPARATE_COMPILE=1
+# Flag : SEPARATE_COMPILE
+# You must also define below how to create an object file, and how to link.
+OBJOUT = -o
+LFLAGS =
+ASFLAGS =
+OFLAG = -o
+COUT = -c
+
+LFLAGS_END =
+# Flag : PORT_SRCS
+# Port specific source files can be added here
+# You may also need cvt.c if the fcvt functions are not provided as intrinsics by your compiler!
+PORT_SRCS = $(PORT_DIR)/core_portme.c $(PORT_DIR)/ee_printf.c $(EXT_SRCS)
+vpath %.c $(PORT_DIR)
+vpath %.s $(PORT_DIR)
+
+# Flag : LOAD
+# For a simple port, we assume self hosted compile and run, no load needed.
+
+# Flag : RUN
+# For a simple port, we assume self hosted compile and run, simple invocation of the executable
+
+LOAD = echo "Please set LOAD to the process of loading the executable to the flash"
+RUN = echo "Please set LOAD to the process of running the executable (e.g. via jtag, or board reset)"
+
+OEXT = .o
+EXE = .elf
+
+$(OPATH)$(PORT_DIR)/%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+$(OPATH)%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+$(OPATH)$(PORT_DIR)/%$(OEXT) : %.s
+ $(AS) $(ASFLAGS) $< $(OBJOUT) $@
+
+# Target : port_pre% and port_post%
+# For the purpose of this simple port, no pre or post steps needed.
+
+.PHONY : port_clean port_prebuild port_postbuild port_prerun port_postrun port_preload port_postload
+
+port_postbuild:
+ $(RV_TOOLS)/riscv32-unknown-elf-objcopy -O binary coremark.elf coremark.bin
+ srec_cat coremark.bin -binary -offset 0x0 -byte-swap 4 -o coremark.vmem -vmem
+ $(RV_TOOLS)/riscv32-unknown-elf-objdump -SD coremark.elf > coremark.dis
+
+# FLAG : OPATH
+# Path to the output folder. Default - current folder.
+OPATH = ./
+MKDIR = mkdir -p
diff --git a/sw/benchmarks/coremark/top_earlgrey/cvt.c b/sw/benchmarks/coremark/top_earlgrey/cvt.c
new file mode 100644
index 0000000..f88e493
--- /dev/null
+++ b/sw/benchmarks/coremark/top_earlgrey/cvt.c
@@ -0,0 +1,96 @@
+#include <math.h>
+#define CVTBUFSIZE 80
+static char CVTBUF[CVTBUFSIZE];
+
+static char *cvt(double arg, int ndigits, int *decpt, int *sign, char *buf,
+ int eflag) {
+ int r2;
+ double fi, fj;
+ char *p, *p1;
+
+ if (ndigits < 0) {
+ ndigits = 0;
+ }
+ if (ndigits >= CVTBUFSIZE - 1) {
+ ndigits = CVTBUFSIZE - 2;
+ }
+ r2 = 0;
+ *sign = 0;
+ p = &buf[0];
+ if (arg < 0) {
+ *sign = 1;
+ arg = -arg;
+ }
+ arg = modf(arg, &fi);
+ p1 = &buf[CVTBUFSIZE];
+
+ if (fi != 0) {
+ p1 = &buf[CVTBUFSIZE];
+ while (fi != 0) {
+ fj = modf(fi / 10, &fi);
+ *--p1 = (int)((fj + .03) * 10) + '0';
+ r2++;
+ }
+ while (p1 < &buf[CVTBUFSIZE]) {
+ *p++ = *p1++;
+ }
+ } else if (arg > 0) {
+ while ((fj = arg * 10) < 1) {
+ arg = fj;
+ r2--;
+ }
+ }
+ p1 = &buf[ndigits];
+ if (eflag == 0) {
+ p1 += r2;
+ }
+ *decpt = r2;
+ if (p1 < &buf[0]) {
+ buf[0] = '\0';
+ return buf;
+ }
+ while (p <= p1 && p < &buf[CVTBUFSIZE]) {
+ arg *= 10;
+ arg = modf(arg, &fj);
+ *p++ = (int)fj + '0';
+ }
+ if (p1 >= &buf[CVTBUFSIZE]) {
+ buf[CVTBUFSIZE - 1] = '\0';
+ return buf;
+ }
+ p = p1;
+ *p1 += 5;
+ while (*p1 > '9') {
+ *p1 = '0';
+ if (p1 > buf) {
+ ++*--p1;
+ } else {
+ *p1 = '1';
+ (*decpt)++;
+ if (eflag == 0) {
+ if (p > buf) {
+ *p = '0';
+ }
+ p++;
+ }
+ }
+ }
+ *p = '\0';
+ return buf;
+}
+
+char *ecvt(double arg, int ndigits, int *decpt, int *sign) {
+ return cvt(arg, ndigits, decpt, sign, CVTBUF, 1);
+}
+
+char *ecvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf) {
+ return cvt(arg, ndigits, decpt, sign, buf, 1);
+}
+
+char *fcvt(double arg, int ndigits, int *decpt, int *sign) {
+ return cvt(arg, ndigits, decpt, sign, CVTBUF, 0);
+}
+
+char *fcvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf) {
+ return cvt(arg, ndigits, decpt, sign, buf, 0);
+}
diff --git a/sw/benchmarks/coremark/top_earlgrey/ee_printf.c b/sw/benchmarks/coremark/top_earlgrey/ee_printf.c
new file mode 100644
index 0000000..ba5fd18
--- /dev/null
+++ b/sw/benchmarks/coremark/top_earlgrey/ee_printf.c
@@ -0,0 +1,672 @@
+/* File : barebones/ee_printf.c
+ This file contains an implementation of ee_printf that only requires a
+method to output a char to a UART without pulling in library code.
+
+This code is based on a file that contains the following:
+ Copyright (C) 2002 Michael Ringgaard. All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ 1. Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+ 2. Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in the
+ documentation and/or other materials provided with the distribution.
+ 3. Neither the name of the project nor the names of its contributors
+ may be used to endorse or promote products derived from this software
+ without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
+GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ SUCH DAMAGE.
+
+*/
+
+#include <coremark.h>
+#include <stdarg.h>
+
+#define ZEROPAD (1 << 0) /* Pad with zero */
+#define SIGN (1 << 1) /* Unsigned/signed long */
+#define PLUS (1 << 2) /* Show plus */
+#define SPACE (1 << 3) /* Spacer */
+#define LEFT (1 << 4) /* Left justified */
+#define HEX_PREP (1 << 5) /* 0x */
+#define UPPERCASE (1 << 6) /* 'ABCDEF' */
+
+#define is_digit(c) ((c) >= '0' && (c) <= '9')
+
+static char *digits = "0123456789abcdefghijklmnopqrstuvwxyz";
+static char *upper_digits = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+static size_t strnlen(const char *s, size_t count);
+
+static size_t strnlen(const char *s, size_t count) {
+ const char *sc;
+ for (sc = s; *sc != '\0' && count--; ++sc) {
+ }
+ return sc - s;
+}
+
+static int skip_atoi(const char **s) {
+ int i = 0;
+ while (is_digit(**s)) {
+ i = i * 10 + *((*s)++) - '0';
+ }
+ return i;
+}
+
+static char *number(char *str, long num, int base, int size, int precision,
+ int type) {
+ char c, sign, tmp[66];
+ char *dig = digits;
+ int i;
+
+ if (type & UPPERCASE) {
+ dig = upper_digits;
+ }
+ if (type & LEFT) {
+ type &= ~ZEROPAD;
+ }
+ if (base < 2 || base > 36) {
+ return 0;
+ }
+
+ c = (type & ZEROPAD) ? '0' : ' ';
+ sign = 0;
+ if (type & SIGN) {
+ if (num < 0) {
+ sign = '-';
+ num = -num;
+ size--;
+ } else if (type & PLUS) {
+ sign = '+';
+ size--;
+ } else if (type & SPACE) {
+ sign = ' ';
+ size--;
+ }
+ }
+
+ if (type & HEX_PREP) {
+ if (base == 16) {
+ size -= 2;
+ } else if (base == 8) {
+ size--;
+ }
+ }
+
+ i = 0;
+
+ if (num == 0) {
+ tmp[i++] = '0';
+ } else {
+ while (num != 0) {
+ tmp[i++] = dig[((unsigned long)num) % (unsigned)base];
+ num = ((unsigned long)num) / (unsigned)base;
+ }
+ }
+
+ if (i > precision) {
+ precision = i;
+ }
+ size -= precision;
+ if (!(type & (ZEROPAD | LEFT))) {
+ while (size-- > 0) {
+ *str++ = ' ';
+ }
+ }
+ if (sign) {
+ *str++ = sign;
+ }
+
+ if (type & HEX_PREP) {
+ if (base == 8) {
+ *str++ = '0';
+ } else if (base == 16) {
+ *str++ = '0';
+ *str++ = digits[33];
+ }
+ }
+
+ if (!(type & LEFT)) {
+ while (size-- > 0) {
+ *str++ = c;
+ }
+ }
+ while (i < precision--) {
+ *str++ = '0';
+ }
+ while (i-- > 0) {
+ *str++ = tmp[i];
+ }
+ while (size-- > 0) {
+ *str++ = ' ';
+ }
+
+ return str;
+}
+
+static char *eaddr(char *str, unsigned char *addr, int size, int precision,
+ int type) {
+ char tmp[24];
+ char *dig = digits;
+ int i, len;
+
+ if (type & UPPERCASE) {
+ dig = upper_digits;
+ }
+ len = 0;
+ for (i = 0; i < 6; i++) {
+ if (i != 0) {
+ tmp[len++] = ':';
+ }
+ tmp[len++] = dig[addr[i] >> 4];
+ tmp[len++] = dig[addr[i] & 0x0F];
+ }
+
+ if (!(type & LEFT)) {
+ while (len < size--) {
+ *str++ = ' ';
+ }
+ }
+ for (i = 0; i < len; ++i) {
+ *str++ = tmp[i];
+ }
+ while (len < size--) {
+ *str++ = ' ';
+ }
+
+ return str;
+}
+
+static char *iaddr(char *str, unsigned char *addr, int size, int precision,
+ int type) {
+ char tmp[24];
+ int i, n, len;
+
+ len = 0;
+ for (i = 0; i < 4; i++) {
+ if (i != 0) {
+ tmp[len++] = '.';
+ }
+ n = addr[i];
+
+ if (n == 0) {
+ tmp[len++] = digits[0];
+ } else {
+ if (n >= 100) {
+ tmp[len++] = digits[n / 100];
+ n = n % 100;
+ tmp[len++] = digits[n / 10];
+ n = n % 10;
+ } else if (n >= 10) {
+ tmp[len++] = digits[n / 10];
+ n = n % 10;
+ }
+
+ tmp[len++] = digits[n];
+ }
+ }
+
+ if (!(type & LEFT)) {
+ while (len < size--) {
+ *str++ = ' ';
+ }
+ }
+ for (i = 0; i < len; ++i) {
+ *str++ = tmp[i];
+ }
+ while (len < size--) {
+ *str++ = ' ';
+ }
+
+ return str;
+}
+
+#ifdef HAS_FLOAT
+
+char *ecvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf);
+char *fcvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf);
+static void ee_bufcpy(char *d, char *s, int count);
+
+void ee_bufcpy(char *pd, char *ps, int count) {
+ char *pe = ps + count;
+ while (ps != pe) {
+ *pd++ = *ps++;
+ }
+}
+
+static void parse_float(double value, char *buffer, char fmt, int precision) {
+ int decpt, sign, exp, pos;
+ char *digits = NULL;
+ char cvtbuf[80];
+ int capexp = 0;
+ int magnitude;
+
+ if (fmt == 'G' || fmt == 'E') {
+ capexp = 1;
+ fmt += 'a' - 'A';
+ }
+
+ if (fmt == 'g') {
+ digits = ecvtbuf(value, precision, &decpt, &sign, cvtbuf);
+ magnitude = decpt - 1;
+ if (magnitude < -4 || magnitude > precision - 1) {
+ fmt = 'e';
+ precision -= 1;
+ } else {
+ fmt = 'f';
+ precision -= decpt;
+ }
+ }
+
+ if (fmt == 'e') {
+ digits = ecvtbuf(value, precision + 1, &decpt, &sign, cvtbuf);
+
+ if (sign) {
+ *buffer++ = '-';
+ }
+ *buffer++ = *digits;
+ if (precision > 0) {
+ *buffer++ = '.';
+ }
+ ee_bufcpy(buffer, digits + 1, precision);
+ buffer += precision;
+ *buffer++ = capexp ? 'E' : 'e';
+
+ if (decpt == 0) {
+ if (value == 0.0) {
+ exp = 0;
+ } else {
+ exp = -1;
+ }
+ } else {
+ exp = decpt - 1;
+ }
+
+ if (exp < 0) {
+ *buffer++ = '-';
+ exp = -exp;
+ } else {
+ *buffer++ = '+';
+ }
+
+ buffer[2] = (exp % 10) + '0';
+ exp = exp / 10;
+ buffer[1] = (exp % 10) + '0';
+ exp = exp / 10;
+ buffer[0] = (exp % 10) + '0';
+ buffer += 3;
+ } else if (fmt == 'f') {
+ digits = fcvtbuf(value, precision, &decpt, &sign, cvtbuf);
+ if (sign) {
+ *buffer++ = '-';
+ }
+ if (*digits) {
+ if (decpt <= 0) {
+ *buffer++ = '0';
+ *buffer++ = '.';
+ for (pos = 0; pos < -decpt; pos++) {
+ *buffer++ = '0';
+ }
+ while (*digits) {
+ *buffer++ = *digits++;
+ }
+ } else {
+ pos = 0;
+ while (*digits) {
+ if (pos++ == decpt) {
+ *buffer++ = '.';
+ }
+ *buffer++ = *digits++;
+ }
+ }
+ } else {
+ *buffer++ = '0';
+ if (precision > 0) {
+ *buffer++ = '.';
+ for (pos = 0; pos < precision; pos++) {
+ *buffer++ = '0';
+ }
+ }
+ }
+ }
+
+ *buffer = '\0';
+}
+
+static void decimal_point(char *buffer) {
+ while (*buffer) {
+ if (*buffer == '.') {
+ return;
+ }
+ if (*buffer == 'e' || *buffer == 'E') {
+ break;
+ }
+ buffer++;
+ }
+
+ if (*buffer) {
+ int n = strnlen(buffer, 256);
+ while (n > 0) {
+ buffer[n + 1] = buffer[n];
+ n--;
+ }
+
+ *buffer = '.';
+ } else {
+ *buffer++ = '.';
+ *buffer = '\0';
+ }
+}
+
+static void cropzeros(char *buffer) {
+ char *stop;
+
+ while (*buffer && *buffer != '.') {
+ buffer++;
+ }
+ if (*buffer++) {
+ while (*buffer && *buffer != 'e' && *buffer != 'E') {
+ buffer++;
+ }
+ stop = buffer--;
+ while (*buffer == '0') {
+ buffer--;
+ }
+ if (*buffer == '.') {
+ buffer--;
+ }
+ while (buffer != stop) {
+ *++buffer = 0;
+ }
+ }
+}
+
+static char *flt(char *str, double num, int size, int precision, char fmt,
+ int flags) {
+ char tmp[80];
+ char c, sign;
+ int n, i;
+
+ // Left align means no zero padding
+ if (flags & LEFT) {
+ flags &= ~ZEROPAD;
+ }
+
+ // Determine padding and sign char
+ c = (flags & ZEROPAD) ? '0' : ' ';
+ sign = 0;
+ if (flags & SIGN) {
+ if (num < 0.0) {
+ sign = '-';
+ num = -num;
+ size--;
+ } else if (flags & PLUS) {
+ sign = '+';
+ size--;
+ } else if (flags & SPACE) {
+ sign = ' ';
+ size--;
+ }
+ }
+
+ // Compute the precision value
+ if (precision < 0) {
+ precision = 6; // Default precision: 6
+ }
+
+ // Convert floating point number to text
+ parse_float(num, tmp, fmt, precision);
+
+ if ((flags & HEX_PREP) && precision == 0) {
+ decimal_point(tmp);
+ }
+ if (fmt == 'g' && !(flags & HEX_PREP)) {
+ cropzeros(tmp);
+ }
+
+ n = strnlen(tmp, 256);
+
+ // Output number with alignment and padding
+ size -= n;
+ if (!(flags & (ZEROPAD | LEFT))) {
+ while (size-- > 0) {
+ *str++ = ' ';
+ }
+ }
+ if (sign) {
+ *str++ = sign;
+ }
+ if (!(flags & LEFT)) {
+ while (size-- > 0) {
+ *str++ = c;
+ }
+ }
+ for (i = 0; i < n; i++) {
+ *str++ = tmp[i];
+ }
+ while (size-- > 0) {
+ *str++ = ' ';
+ }
+
+ return str;
+}
+
+#endif
+
+static int ee_vsprintf(char *buf, const char *fmt, va_list args) {
+ int len;
+ unsigned long num;
+ int i, base;
+ char *str;
+ char *s;
+
+ int flags; // Flags to number()
+
+ int field_width; // Width of output field
+ int precision; // Min. # of digits for integers; max number of chars for from
+ // string
+ int qualifier; // 'h', 'l', or 'L' for integer fields
+
+ for (str = buf; *fmt; fmt++) {
+ if (*fmt != '%') {
+ *str++ = *fmt;
+ continue;
+ }
+
+ // Process flags
+ flags = 0;
+ repeat:
+ fmt++; // This also skips first '%'
+ switch (*fmt) {
+ case '-':
+ flags |= LEFT;
+ goto repeat;
+ case '+':
+ flags |= PLUS;
+ goto repeat;
+ case ' ':
+ flags |= SPACE;
+ goto repeat;
+ case '#':
+ flags |= HEX_PREP;
+ goto repeat;
+ case '0':
+ flags |= ZEROPAD;
+ goto repeat;
+ }
+
+ // Get field width
+ field_width = -1;
+ if (is_digit(*fmt)) {
+ field_width = skip_atoi(&fmt);
+ } else if (*fmt == '*') {
+ fmt++;
+ field_width = va_arg(args, int);
+ if (field_width < 0) {
+ field_width = -field_width;
+ flags |= LEFT;
+ }
+ }
+
+ // Get the precision
+ precision = -1;
+ if (*fmt == '.') {
+ ++fmt;
+ if (is_digit(*fmt)) {
+ precision = skip_atoi(&fmt);
+ } else if (*fmt == '*') {
+ ++fmt;
+ precision = va_arg(args, int);
+ }
+ if (precision < 0) {
+ precision = 0;
+ }
+ }
+
+ // Get the conversion qualifier
+ qualifier = -1;
+ if (*fmt == 'l' || *fmt == 'L') {
+ qualifier = *fmt;
+ fmt++;
+ }
+
+ // Default base
+ base = 10;
+
+ switch (*fmt) {
+ case 'c':
+ if (!(flags & LEFT)) {
+ while (--field_width > 0) {
+ *str++ = ' ';
+ }
+ }
+ *str++ = (unsigned char)va_arg(args, int);
+ while (--field_width > 0) {
+ *str++ = ' ';
+ }
+ continue;
+
+ case 's':
+ s = va_arg(args, char *);
+ if (!s) {
+ s = "<NULL>";
+ }
+ len = strnlen(s, precision);
+ if (!(flags & LEFT)) {
+ while (len < field_width--) {
+ *str++ = ' ';
+ }
+ }
+ for (i = 0; i < len; ++i) {
+ *str++ = *s++;
+ }
+ while (len < field_width--) {
+ *str++ = ' ';
+ }
+ continue;
+
+ case 'p':
+ if (field_width == -1) {
+ field_width = 2 * sizeof(void *);
+ flags |= ZEROPAD;
+ }
+ str = number(str, (unsigned long)va_arg(args, void *), 16, field_width,
+ precision, flags);
+ continue;
+
+ case 'A':
+ flags |= UPPERCASE;
+
+ case 'a':
+ if (qualifier == 'l') {
+ str = eaddr(str, va_arg(args, unsigned char *), field_width,
+ precision, flags);
+ } else {
+ str = iaddr(str, va_arg(args, unsigned char *), field_width,
+ precision, flags);
+ }
+ continue;
+
+ // Integer number formats - set up the flags and "break"
+ case 'o':
+ base = 8;
+ break;
+
+ case 'X':
+ flags |= UPPERCASE;
+
+ case 'x':
+ base = 16;
+ break;
+
+ case 'd':
+ case 'i':
+ flags |= SIGN;
+
+ case 'u':
+ break;
+
+#ifdef HAS_FLOAT
+
+ case 'f':
+ str = flt(str, va_arg(args, double), field_width, precision, *fmt,
+ flags | SIGN);
+ continue;
+
+#endif
+
+ default:
+ if (*fmt != '%') {
+ *str++ = '%';
+ }
+ if (*fmt) {
+ *str++ = *fmt;
+ } else {
+ --fmt;
+ }
+ continue;
+ }
+
+ if (qualifier == 'l') {
+ num = va_arg(args, unsigned long);
+ } else if (flags & SIGN) {
+ num = va_arg(args, int);
+ } else {
+ num = va_arg(args, unsigned int);
+ }
+
+ str = number(str, num, base, field_width, precision, flags);
+ }
+
+ *str = '\0';
+ return str - buf;
+}
+
+int ee_printf(const char *fmt, ...) {
+ char buf[256], *p;
+ va_list args;
+ int n = 0;
+
+ va_start(args, fmt);
+ ee_vsprintf(buf, fmt, args);
+ va_end(args);
+ p = buf;
+ while (*p) {
+ uart_send_char(*p);
+ n++;
+ p++;
+ }
+
+ return n;
+}
diff --git a/sw/boot_rom/Makefile b/sw/boot_rom/Makefile
new file mode 100644
index 0000000..961d98e
--- /dev/null
+++ b/sw/boot_rom/Makefile
@@ -0,0 +1,83 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+GENHDRS = uart_regs.h gpio_regs.h spi_device_regs.h flash_ctrl_regs.h
+
+PROGRAM ?= boot_rom
+PROGRAM_CFLAGS = -Wall -g -Os
+ifeq ($(SIM),1)
+ PROGRAM_CFLAGS += -DSIMULATION
+endif
+ARCH = rv32imc
+# ARCH = rv32im # to disable compressed instructions
+SRCS = uart.c gpio.c spi_device.c flash_ctrl.c bootstrap.c $(PROGRAM).c
+RV_TOOLS ?= /tools/riscv/bin
+
+
+CC = ${RV_TOOLS}/riscv32-unknown-elf-gcc
+
+OBJCOPY ?= $(subst gcc,objcopy,$(wordlist 1,1,$(CC)))
+OBJDUMP ?= $(subst gcc,objdump,$(wordlist 1,1,$(CC)))
+REGTOOL = ../../util/regtool.py
+
+LINKER_SCRIPT ?= link.ld
+CRT ?= crt0.S
+CFLAGS ?= -march=$(ARCH) -mabi=ilp32 -static -mcmodel=medany \
+ -fvisibility=hidden -nostdlib -nostartfiles $(PROGRAM_CFLAGS)
+
+OBJS := ${SRCS:.c=.o} ${CRT:.S=.o}
+DEPS = $(OBJS:%.o=%.d)
+
+OUTFILES = $(PROGRAM).elf $(PROGRAM).vmem $(PROGRAM).bin $(PROGRAM).dis $(PROGRAM).map
+
+all: $(OUTFILES)
+
+$(PROGRAM).elf: $(OBJS) $(LINKER_SCRIPT)
+ $(CC) $(CFLAGS) -T $(LINKER_SCRIPT) $(OBJS) -o $@ $(LIBS) -Xlinker -Map=${PROGRAM}.map
+
+%.dis: %.elf
+ $(OBJDUMP) -SD $^ > $@
+
+# Note: this target requires the srecord package to be installed.
+# XXX: This could be replaced by objcopy once
+# https://sourceware.org/bugzilla/show_bug.cgi?id=19921
+# is merged.
+# XXX: Currently the start address 0x1000 is hardcoded. It could/should be
+# read from the elf file, but is lost in the bin file.
+# Switching to objcopy will resolve that as well.
+%.vmem: %.bin
+ srec_cat $^ -binary -offset 0x0 -byte-swap 4 -o $@ -vmem
+
+%.bin: %.elf
+ $(OBJCOPY) -O binary $^ $@
+
+%.o: %.c
+ $(CC) $(CFLAGS) -MMD -c $(INCS) -o $@ $<
+
+%.o: %.S
+ $(CC) $(CFLAGS) -MMD -c $(INCS) -o $@ $<
+
+# Can't find a way to use % twice in RHS, this based on stackoverflow
+GENHDR_BASE = $(subst _regs.h,,$(GENHDRS))
+define header_gen
+ $1.c: $1_regs.h
+
+ $1_regs.h: ../../hw/ip/$1/doc/*.hjson
+ if [ -f ../../hw/ip/$1/doc/$1.hjson ]; then \
+ $(REGTOOL) -D -o $1_regs.h ../../hw/ip/$1/doc/$1.hjson ; \
+ else \
+ $(REGTOOL) -D -o $1_regs.h ../../hw/ip/$1/doc/$1_reg.hjson ; \
+ fi
+endef
+$(foreach f,$(GENHDR_BASE),$(eval $(call header_gen,$f)))
+
+-include $(DEPS)
+
+clean:
+ $(RM) -f *.o *.d *.bin *.vmem *.dis *.elf *.map $(GENHDRS)
+
+distclean: clean
+ $(RM) -f $(OUTFILES)
diff --git a/sw/boot_rom/boot_rom.c b/sw/boot_rom/boot_rom.c
new file mode 100644
index 0000000..d36fb2f
--- /dev/null
+++ b/sw/boot_rom/boot_rom.c
@@ -0,0 +1,45 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "bootstrap.h"
+#include "common.h"
+#include "flash_ctrl.h"
+#include "gpio.h"
+#include "spi_device.h"
+#include "uart.h"
+
+// Choose a "standard" baud rate to make it possible to use stty/screen directly
+#if defined(SIMULATION)
+const unsigned long UART_BAUD_RATE = 9600;
+#else
+const unsigned long UART_BAUD_RATE = 230400;
+#endif
+
+static inline void try_launch(void) {
+ __asm__ volatile(
+ "la a0, _flash_start;"
+ "la sp, _stack_start;"
+ "jr a0;"
+ :
+ :
+ :);
+}
+
+int main(int argc, char **argv) {
+ uart_init(UART_BAUD_RATE);
+
+ int rv = bootstrap();
+ if (rv) {
+ uart_send_str("Bootstrap failed with status code: ");
+ uart_send_uint(rv, 32);
+ uart_send_str("\r\n");
+ // Currently the only way to recover is by a hard reset.
+ return rv;
+ }
+
+ uart_send_str("Jump!\r\n");
+ while (!uart_tx_empty()) {
+ }
+ try_launch();
+}
diff --git a/sw/boot_rom/bootstrap.c b/sw/boot_rom/bootstrap.c
new file mode 100644
index 0000000..ec0485c
--- /dev/null
+++ b/sw/boot_rom/bootstrap.c
@@ -0,0 +1,100 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "bootstrap.h"
+
+#include "common.h"
+#include "flash_ctrl.h"
+#include "gpio.h"
+#include "spi_device.h"
+#include "uart.h" // TODO: Wrap uart in DEBUG macros.
+
+/* Checks if flash is blank to determine if bootstrap is needed. */
+/* TODO: Update this to check bootstrap pin instead in Verilator. */
+static int bootstrap_requested(void) {
+// The following flash empty-sniff-check is done this way due to the lack of
+// clear eflash reset in SIM environments.
+#if defined(SIMULATION)
+ return !!(REG32(FLASH_MEM_BASE_ADDR) == 0 ||
+ REG32(FLASH_MEM_BASE_ADDR) == 0xFFFFFFFF);
+#else
+ return !!(gpio_read() & GPIO_BOOTSTRAP_BIT_MASK);
+#endif
+}
+
+/* Erase all flash, and verify blank. */
+static int erase_flash(void) {
+ if (flash_bank_erase(FlashBank0)) {
+ return E_BS_ERASE;
+ }
+ if (flash_bank_erase(FlashBank1)) {
+ return E_BS_ERASE;
+ }
+ if (!flash_check_empty()) {
+ return E_BS_NOTEMPTY;
+ }
+ return 0;
+}
+
+/* Processes frames received via spid interface and writes them to flash. */
+static int bootstrap_flash(void) {
+ static frame_t f;
+ static uint8_t ack[32] = {0};
+ uint32_t expected_frame_no = 0;
+ for (;;) {
+ if (spid_bytes_available() >= sizeof(f)) {
+ spid_read_nb(&f, sizeof(f));
+ uart_send_str("Processing frame no: ");
+ uart_send_uint(f.hdr.frame_num, 32);
+ uart_send_str(" exp no: ");
+ uart_send_uint(expected_frame_no, 32);
+ uart_send_str("\r\n");
+
+ // TODO: Add hash check.
+ if (FRAME_NO(f.hdr.frame_num) == expected_frame_no) {
+ // TODO: Add ack computation.
+ spid_send(ack, sizeof(ack));
+
+ if (expected_frame_no == 0) {
+ // TODO: Add signed header checks.
+ flash_default_region_access(/*rd_en=*/1, /*prog_en=*/1,
+ /*erase_en=*/1);
+ int rv = erase_flash();
+ if (rv) {
+ return rv;
+ }
+ }
+ if (flash_write(f.hdr.flash_offset, f.data, ARRAYSIZE(f.data))) {
+ return E_BS_WRITE;
+ }
+
+ ++expected_frame_no;
+ if (f.hdr.frame_num & FRAME_EOF_MARKER) {
+ break;
+ }
+ } else {
+ // Send previous ack if unable to verify current frame.
+ spid_send(ack, sizeof(ack));
+ }
+ }
+ }
+ uart_send_str("bootstrap: DONE!\r\n");
+ return 0;
+}
+
+int bootstrap(void) {
+ if (!bootstrap_requested()) {
+ return 0;
+ }
+ // SPI device is only initialized in bootstrap mode.
+ spid_init();
+ flash_init_block();
+
+ int rv = bootstrap_flash();
+
+ // Always make sure to revert flash_ctrl access to default settings.
+ // bootstrap_flash enables access to flash to perform update.
+ flash_default_region_access(/*rd_en=*/0, /*prog_en=*/0, /*erase_en=*/0);
+ return rv;
+}
diff --git a/sw/boot_rom/bootstrap.h b/sw/boot_rom/bootstrap.h
new file mode 100644
index 0000000..03ea92f
--- /dev/null
+++ b/sw/boot_rom/bootstrap.h
@@ -0,0 +1,20 @@
+#ifndef _F_BOOTSTRAP_H__
+#define _F_BOOTSTRAP_H__
+
+#include "bootstrap_msgs.h"
+
+/**
+ * Bootstrap Flash with payload received on SPI device.
+ *
+ * The payload is expected to be split into frames as defined in
+ * bootstrap_msgs.h. Frames are processed in consecutive number, with
+ * |frame_num| in frame_hdr_t expected to increase monotonically.
+ *
+ * The last frame must be ord with FRAME_EOF_MARKER to signal the end of
+ * payload transmission.
+ *
+ * @return Bootstrap status code.
+ */
+int bootstrap(void);
+
+#endif // _F_BOOTSTRAP_H__
diff --git a/sw/boot_rom/bootstrap_msgs.h b/sw/boot_rom/bootstrap_msgs.h
new file mode 100644
index 0000000..81ed9b9
--- /dev/null
+++ b/sw/boot_rom/bootstrap_msgs.h
@@ -0,0 +1,40 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_BOOTSTRAP_MSGS_H__
+#define _F_BOOTSTRAP_MSGS_H__
+#include <stdint.h>
+
+#define RAW_BUFFER_SIZE 1024
+#define FRAME_EOF_MARKER 0x80000000
+#define FRAME_NO(k) ((k)&0xffffff)
+
+typedef struct {
+ /* SHA2 of the entire frame_t message starting at the |frame_num| offset. */
+ uint32_t hash[8];
+
+ /* Frame number starting at 0. The last frame should be ord with
+ * FRAME_EOF_MARKER. */
+ uint32_t frame_num;
+
+ /* 0-based flash offset where the frame should be written to. */
+ uint32_t flash_offset;
+} frame_hdr_t;
+
+typedef struct {
+ /* Frame header. See frame_hdr_t for details. */
+ frame_hdr_t hdr;
+
+ /* Frame data uint32_t aligned. */
+ uint32_t data[(RAW_BUFFER_SIZE - sizeof(frame_hdr_t)) / sizeof(uint32_t)];
+} frame_t;
+
+/* Bootstrap error codes */
+
+/* Errors requiring reset */
+#define E_BS_ERASE 10
+#define E_BS_NOTEMPTY 11
+#define E_BS_WRITE 12
+
+#endif // _F_BOOTSTRAP_MSGS_H__
diff --git a/sw/boot_rom/common.h b/sw/boot_rom/common.h
new file mode 100644
index 0000000..a0a8c88
--- /dev/null
+++ b/sw/boot_rom/common.h
@@ -0,0 +1,38 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+#ifndef _COMMON_H_
+#define _COMMON_H_
+
+#include <stdint.h>
+
+#ifdef SIMULATION
+#define CLK_FIXED_FREQ_HZ (500 * 1000)
+#else
+#define CLK_FIXED_FREQ_HZ (50ULL * 1000 * 1000)
+#endif
+
+#define REG8(add) *((volatile uint8_t *)(add))
+#define REG16(add) *((volatile uint16_t *)(add))
+#define REG32(add) *((volatile uint32_t *)(add))
+
+// Flash memory base defines, _SZ are presented in bytes
+#define FLASH_MEM_BASE_ADDR 0x20000000
+#define FLASH_WORDS_PER_PAGE 256
+#define FLASH_WORD_SZ 4
+#define FLASH_PAGE_SZ (FLASH_WORDS_PER_PAGE * FLASH_WORD_SZ)
+#define FLASH_PAGES_PER_BANK 256
+#define FLASH_BANK_SZ (FLASH_PAGES_PER_BANK * FLASH_PAGE_SZ)
+
+#define ARRAYSIZE(x) (sizeof(x) / sizeof(x[0]))
+
+/* Hamming weight */
+#define BITLENGTH_1(X) ((X) - (((X) >> 1) & 0x55555555))
+#define BITLENGTH_2(X) (((X)&0x33333333) + (((X) >> 2) & 0x33333333))
+#define BITLENGTH_3(X) (((X) + ((X) >> 4)) & 0x0f0f0f0f)
+#define BITLENGTH_4(X) ((X) + ((X) >> 8))
+#define BITLENGTH_5(X) ((X) + ((X) >> 16))
+#define BITLENGTH(X) \
+ ((BITLENGTH_5(BITLENGTH_4(BITLENGTH_3(BITLENGTH_2(BITLENGTH_1(X)))))) & 0x7f)
+
+#endif // _COMMON_H_
diff --git a/sw/boot_rom/crt0.S b/sw/boot_rom/crt0.S
new file mode 100644
index 0000000..ac53f7f
--- /dev/null
+++ b/sw/boot_rom/crt0.S
@@ -0,0 +1,104 @@
+ .section .text
+
+exception_handler:
+ jal x0, exception_handler
+
+default_irq_handler:
+ jal x0, default_irq_handler
+
+reset_handler:
+ /* set all registers to zero */
+ mv x1, x0
+ mv x2, x1
+ mv x3, x1
+ mv x4, x1
+ mv x5, x1
+ mv x6, x1
+ mv x7, x1
+ mv x8, x1
+ mv x9, x1
+ mv x10, x1
+ mv x11, x1
+ mv x12, x1
+ mv x13, x1
+ mv x14, x1
+ mv x15, x1
+ mv x16, x1
+ mv x17, x1
+ mv x18, x1
+ mv x19, x1
+ mv x20, x1
+ mv x21, x1
+ mv x22, x1
+ mv x23, x1
+ mv x24, x1
+ mv x25, x1
+ mv x26, x1
+ mv x27, x1
+ mv x28, x1
+ mv x29, x1
+ mv x30, x1
+ mv x31, x1
+
+ /* stack initilization */
+ la x2, _stack_start
+
+_start:
+ .global _start
+
+ /* clear BSS */
+ la x26, _bss_start
+ la x27, _bss_end
+
+ bge x26, x27, zero_loop_end
+
+zero_loop:
+ sw x0, 0(x26)
+ addi x26, x26, 4
+ ble x26, x27, zero_loop
+zero_loop_end:
+
+
+main_entry:
+ /* jump to main program entry point (argc = argv = 0) */
+ addi x10, x0, 0
+ addi x11, x0, 0
+ jal x1, main
+
+/* ====================== [ exceptions & interrupts ] =================== */
+/* This section has to be down here, since we have to disable rvc for it */
+
+ .section .vectors, "ax"
+ .option norvc;
+
+ // exception handler
+ .org 0x00
+ jal x0, exception_handler
+
+ /* use the same default handler for all interrupts */
+ // software interrupt handler
+ .org 0x0c
+ jal x0, default_irq_handler
+
+ // timer interrupt handler
+ .org 0x1c
+ jal x0, default_irq_handler
+
+ // external interrupt handler
+ .org 0x2c
+ jal x0, default_irq_handler
+
+ // fast interrupts 0 - 14
+ .org 0x40
+ .rept 14
+ nop
+ .endr
+ jal x0, default_irq_handler
+
+ // non-maskable interrupt handler
+ .org 0x7c
+ jal x0, default_irq_handler
+
+ // reset vector
+ .org 0x80
+ jal x0, reset_handler
diff --git a/sw/boot_rom/flash_ctrl.c b/sw/boot_rom/flash_ctrl.c
new file mode 100644
index 0000000..ed60ec1
--- /dev/null
+++ b/sw/boot_rom/flash_ctrl.c
@@ -0,0 +1,99 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+#include "flash_ctrl.h"
+
+#include "common.h"
+#include "flash_ctrl_regs.h"
+
+#define FLASH_CTRL0_BASE_ADDR 0x40030000
+
+typedef enum flash_op {
+ FlashRead = 0,
+ FlashProg = 1,
+ FlashErase = 2
+} flash_op_t;
+
+typedef enum erase_type { PageErase = 0, BankErase = 1 } erase_type_t;
+
+/* Wait for flash command to complete and set ACK in controller */
+static inline void wait_done_and_ack(void) {
+ while ((REG32(FLASH_CTRL_OP_STATUS(0)) & (1 << FLASH_CTRL_OP_STATUS_DONE)) ==
+ 0) {
+ };
+ REG32(FLASH_CTRL_OP_STATUS(0)) = 0;
+}
+
+void flash_init_block(void) {
+ while ((REG32(FLASH_CTRL_STATUS(0)) & (1 << FLASH_CTRL_STATUS_INIT_WIP)) >
+ 0) {
+ }
+}
+
+int flash_check_empty(void) {
+ uint32_t mask = -1u;
+ uint32_t *p = (uint32_t *)FLASH_MEM_BASE_ADDR;
+ // TODO: Update range to cover entire flash. Limited now to one bank while
+ // we debu initialization.
+ for (; p < (uint32_t *)(FLASH_MEM_BASE_ADDR + FLASH_BANK_SZ);) {
+ mask &= *p++;
+ mask &= *p++;
+ mask &= *p++;
+ mask &= *p++;
+ mask &= *p++;
+ mask &= *p++;
+ mask &= *p++;
+ mask &= *p++;
+ if (mask != -1u) {
+ return 0;
+ }
+ }
+ return 1;
+}
+
+int flash_bank_erase(bank_index_t idx) {
+ REG32(FLASH_CTRL_MP_BANK_CFG(0)) =
+ 0x1 << ((idx == FlashBank0) ? FLASH_CTRL_MP_BANK_CFG_ERASE_EN0
+ : FLASH_CTRL_MP_BANK_CFG_ERASE_EN1);
+
+ // TODO: Add timeout conditions and add error codes.
+ REG32(FLASH_CTRL_ADDR(0)) = (idx == FlashBank0)
+ ? FLASH_MEM_BASE_ADDR
+ : (FLASH_MEM_BASE_ADDR + FLASH_BANK_SZ);
+ REG32(FLASH_CTRL_CONTROL(0)) = (FlashErase << FLASH_CTRL_CONTROL_OP_OFFSET |
+ BankErase << FLASH_CTRL_CONTROL_ERASE_SEL |
+ 0x1 << FLASH_CTRL_CONTROL_START);
+ wait_done_and_ack();
+
+ REG32(FLASH_CTRL_MP_BANK_CFG(0)) =
+ 0x0 << ((idx == FlashBank0) ? FLASH_CTRL_MP_BANK_CFG_ERASE_EN0
+ : FLASH_CTRL_MP_BANK_CFG_ERASE_EN1);
+ return 0;
+}
+
+static int flash_write_internal(uint32_t addr, const uint32_t *data,
+ uint32_t size) {
+ // TODO: Do we need to select bank as part of the write?
+ // TODO: Update with address alignment requirements.
+ REG32(FLASH_CTRL_ADDR(0)) = addr;
+ REG32(FLASH_CTRL_CONTROL(0)) = (FlashProg << FLASH_CTRL_CONTROL_OP_OFFSET |
+ (size - 1) << FLASH_CTRL_CONTROL_NUM_OFFSET |
+ 0x1 << FLASH_CTRL_CONTROL_START);
+ for (int i = 0; i < size; ++i) {
+ REG32(FLASH_CTRL_PROG_FIFO(FLASH_CTRL0_BASE_ADDR)) = data[i];
+ }
+ wait_done_and_ack();
+ return 0;
+}
+
+int flash_write(uint32_t addr, const uint32_t *data, uint32_t size) {
+ // TODO: Breakdown into FIFO chunks if needed.
+ return flash_write_internal(addr, data, size);
+}
+
+void flash_default_region_access(bool rd_en, bool prog_en, bool erase_en) {
+ REG32(FLASH_CTRL_DEFAULT_REGION(0)) =
+ rd_en << FLASH_CTRL_DEFAULT_REGION_RD_EN |
+ prog_en << FLASH_CTRL_DEFAULT_REGION_PROG_EN |
+ erase_en << FLASH_CTRL_DEFAULT_REGION_ERASE_EN;
+}
diff --git a/sw/boot_rom/flash_ctrl.h b/sw/boot_rom/flash_ctrl.h
new file mode 100644
index 0000000..a3e7770
--- /dev/null
+++ b/sw/boot_rom/flash_ctrl.h
@@ -0,0 +1,52 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_FLASH_CTRL_H__
+#define _F_FLASH_CTRL_H__
+
+#include <stdbool.h>
+#include <stdint.h>
+
+/**
+ * Flash bank IDs
+ */
+typedef enum bank_index { FlashBank0 = 0, FlashBank1 = 1 } bank_index_t;
+
+/**
+ * Block until flash is initialized.
+ */
+void flash_init_block(void);
+
+/**
+ * Returns 1 if flash is empty, otherwise 0.
+ */
+int flash_check_empty(void);
+
+/*
+ * Erase flash bank |bank_idx|. Blocks until erase is complete.
+ *
+ * @param idx Flash bank index.
+ * @return Non zero on failure.
+ */
+int flash_bank_erase(bank_index_t idx);
+
+/**
+ * Write |data| at |addr| offset with |size| in 4B words
+ *
+ * @param addr Flash address 32bit aligned.
+ * @param data Data to write.
+ * @param size Number of bytes to write from |data| buffer.
+ */
+int flash_write(uint32_t addr, const uint32_t *data, uint32_t size);
+
+/**
+ * Set flash controller default permissions.
+ *
+ * @param rd_end Read enable.
+ * @param prog_en Write enable.
+ * @param erase_en Erase enable.
+ */
+void flash_default_region_access(bool rd_en, bool prog_en, bool erase_en);
+
+#endif // _F_FLASH_CTRL_H__
diff --git a/sw/boot_rom/gpio.c b/sw/boot_rom/gpio.c
new file mode 100644
index 0000000..a78fc4b
--- /dev/null
+++ b/sw/boot_rom/gpio.c
@@ -0,0 +1,36 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "gpio.h"
+
+#include "assert.h"
+#include "common.h"
+
+/**
+ * @param oe bits to use as output
+ */
+void gpio_init(uint32_t oe) { REG32(GPIO_DIRECT_OE(0)) = oe; }
+
+void gpio_write_bit(unsigned int bit, unsigned int val) {
+ uint32_t mask = 0;
+ uint32_t reg_val = 0;
+ volatile uint32_t *gpio_masked_out_reg = 0;
+
+ if (bit < 16) {
+ gpio_masked_out_reg = (uint32_t *)GPIO_MASKED_OUT_LOWER(0);
+ } else if (bit < 32) {
+ gpio_masked_out_reg = (uint32_t *)GPIO_MASKED_OUT_UPPER(0);
+ } else {
+ assert(1 && "bit must be < 32");
+ }
+ bit %= 16;
+
+ mask = (1 << bit);
+ reg_val = (mask << 16) | ((val & 0x01) << bit);
+ *gpio_masked_out_reg = reg_val;
+}
+
+void gpio_write_all(uint32_t val) { REG32(GPIO_DIRECT_OUT(0)) = val; }
+
+uint32_t gpio_read(void) { return REG32(GPIO_DATA_IN(0)); }
diff --git a/sw/boot_rom/gpio.h b/sw/boot_rom/gpio.h
new file mode 100644
index 0000000..e31762d
--- /dev/null
+++ b/sw/boot_rom/gpio.h
@@ -0,0 +1,21 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _GPIO_H_
+#define _GPIO_H_
+
+#include <stdint.h>
+
+#include "gpio_regs.h"
+
+#define GPIO0_BASE_ADDR 0x40010000
+
+#define GPIO_BOOTSTRAP_BIT_MASK 0x20000
+
+void gpio_init(uint32_t oe);
+void gpio_write_bit(unsigned int bit, unsigned int val);
+void gpio_write_all(uint32_t val);
+uint32_t gpio_read(void);
+
+#endif
diff --git a/sw/boot_rom/link.ld b/sw/boot_rom/link.ld
new file mode 100644
index 0000000..57d96ca
--- /dev/null
+++ b/sw/boot_rom/link.ld
@@ -0,0 +1,96 @@
+OUTPUT_ARCH(riscv)
+
+/* required to correctly link newlib */
+GROUP( -lc -lgloss -lgcc -lsupc++ )
+
+SEARCH_DIR(.)
+__DYNAMIC = 0;
+
+MEMORY
+{
+ rom (rx) : ORIGIN = 0x00008000, LENGTH = 0x2000
+ ram (w) : ORIGIN = 0x10000000, LENGTH = 0x10000
+ flash (rx) : ORIGIN = 0x20000000, LENGTH = 0x100000
+}
+
+/* Memory Allocation */
+_heap_size = 0xe000;
+_stack_size = 0x2000;
+_stack_start = ORIGIN(ram) + _heap_size + _stack_size;
+_flash_start = ORIGIN(flash);
+
+/* We have to align each sector to word boundaries as our current s19->slm
+ * conversion scripts are not able to handle non-word aligned sections. */
+
+SECTIONS
+{
+ .vectors :
+ {
+ . = ALIGN(4);
+ KEEP(*(.vectors))
+ } > rom
+
+ .text : {
+ . = ALIGN(4);
+ _stext = .;
+ *(.text)
+ _etext = .;
+ __CTOR_LIST__ = .;
+ LONG((__CTOR_END__ - __CTOR_LIST__) / 4 - 2)
+ *(.ctors)
+ LONG(0)
+ __CTOR_END__ = .;
+ __DTOR_LIST__ = .;
+ LONG((__DTOR_END__ - __DTOR_LIST__) / 4 - 2)
+ *(.dtors)
+ LONG(0)
+ __DTOR_END__ = .;
+ *(.lit)
+ *(.shdata)
+ _endtext = .;
+ } > rom
+
+ .rodata : {
+ . = ALIGN(4);
+ *(.rodata);
+ *(.rodata.*)
+ } > rom
+
+ .shbss :
+ {
+ . = ALIGN(4);
+ *(.shbss)
+ } > rom
+
+ .data : {
+ . = ALIGN(4);
+ sdata = .;
+ _sdata = .;
+ *(.data);
+ *(.data.*)
+ edata = .;
+ _edata = .;
+ } > rom
+
+ .bss :
+ {
+ . = ALIGN(4);
+ _bss_start = .;
+ *(.bss)
+ *(.bss.*)
+ *(.sbss)
+ *(.sbss.*)
+ *(COMMON)
+ _bss_end = .;
+ } > ram
+
+ .stab 0 (NOLOAD) :
+ {
+ [ .stab ]
+ }
+
+ .stabstr 0 (NOLOAD) :
+ {
+ [ .stabstr ]
+ }
+}
diff --git a/sw/boot_rom/spi_device.c b/sw/boot_rom/spi_device.c
new file mode 100644
index 0000000..20222ef
--- /dev/null
+++ b/sw/boot_rom/spi_device.c
@@ -0,0 +1,216 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "spi_device.h"
+
+#include "common.h"
+#include "spi_device_regs.h"
+
+#define SPI_DEVICE0_BASE_ADDR 0x40020000
+#define SPID_SRAM_ADDR SPI_DEVICE_BUFFER(SPI_DEVICE0_BASE_ADDR)
+#define SPID_RXF_BASE 0x000
+#define SPID_RXF_SIZE 0x400
+#define SPID_TXF_BASE 0x600
+#define SPID_TXF_SIZE 0x200
+
+#define SPID_SRAM_SIZE (0x800)
+
+/* Note: these will correctly remove the phase bit */
+#define READ32_RXFPTR(P) \
+ REG32(SPID_SRAM_ADDR + SPID_RXF_BASE + ((P) & (SPID_RXF_SIZE - 1)))
+
+#define ACCESS32_TXFPTR(P) \
+ REG32(SPID_SRAM_ADDR + SPID_TXF_BASE + ((P) & ((SPID_TXF_SIZE - 1) & ~0x3)))
+
+uint32_t calc_depth(uint32_t wptr, uint32_t rptr, uint32_t size);
+
+void spid_init(void) {
+ /* Abort 0 */
+ REG32(SPI_DEVICE_CONTROL(0)) =
+ REG32(SPI_DEVICE_CONTROL(0)) & ~(1 << SPI_DEVICE_CONTROL_ABORT);
+
+ /* CPOL(0), CPHA(0), ORDERs(00), TIMER(63) */
+ REG32(SPI_DEVICE_CFG(0)) =
+ ((0 << SPI_DEVICE_CFG_CPOL) | (0 << SPI_DEVICE_CFG_CPHA) |
+ (0 << SPI_DEVICE_CFG_RX_ORDER) | (0 << SPI_DEVICE_CFG_TX_ORDER) |
+ ((63 & SPI_DEVICE_CFG_TIMER_V_MASK) << SPI_DEVICE_CFG_TIMER_V_OFFSET));
+
+ /* SRAM RXF/TXF ADDR. */
+ REG32(SPI_DEVICE_RXF_ADDR(0)) =
+ ((SPID_RXF_BASE & SPI_DEVICE_RXF_ADDR_BASE_MASK)
+ << SPI_DEVICE_RXF_ADDR_BASE_OFFSET) |
+ (((SPID_RXF_SIZE - 1) & SPI_DEVICE_RXF_ADDR_LIMIT_MASK)
+ << SPI_DEVICE_RXF_ADDR_LIMIT_OFFSET);
+
+ REG32(SPI_DEVICE_TXF_ADDR(0)) =
+ ((SPID_TXF_BASE & SPI_DEVICE_TXF_ADDR_BASE_MASK)
+ << SPI_DEVICE_TXF_ADDR_BASE_OFFSET) |
+ (((SPID_TXF_SIZE - 1) & SPI_DEVICE_TXF_ADDR_LIMIT_MASK)
+ << SPI_DEVICE_TXF_ADDR_LIMIT_OFFSET);
+}
+
+/**
+ * Calculation FIFO depth in bytes
+ *
+ * Assume SRAM size is fixed (constant) given by SPI_DEVICE_BUFFER_SIZE
+ *
+ * Fifo pointers are in bytes
+ */
+inline uint32_t calc_depth(uint32_t wptr, uint32_t rptr, uint32_t size) {
+ const uint32_t sram_szw = BITLENGTH(SPI_DEVICE_BUFFER_SIZE_BYTES - 1);
+ uint32_t depth;
+ uint32_t wptr_phase, rptr_phase, wptr_v, rptr_v;
+ wptr_phase = wptr >> sram_szw;
+ rptr_phase = rptr >> sram_szw;
+ wptr_v = wptr & (SPI_DEVICE_BUFFER_SIZE_BYTES - 1);
+ rptr_v = rptr & (SPI_DEVICE_BUFFER_SIZE_BYTES - 1);
+
+ if (wptr_phase == rptr_phase) {
+ depth = (wptr_v - rptr_v);
+ } else {
+ depth = size - rptr_v + wptr_v;
+ }
+
+ return depth;
+}
+
+/*
+ * Increment pointer, zero and flip phase if it gets to size
+ */
+uint32_t ptr_inc(uint32_t ptr, uint32_t inc, uint32_t size) {
+ uint32_t phase = ptr & SPI_DEVICE_BUFFER_SIZE_BYTES;
+ ptr = (ptr & (SPI_DEVICE_BUFFER_SIZE_BYTES - 1)) + inc;
+ if (ptr >= size) {
+ ptr -= size;
+ phase ^= SPI_DEVICE_BUFFER_SIZE_BYTES;
+ }
+ return ptr | phase;
+}
+
+static int word_aligned(void *p) { return (((int)p & 0x3) == 0); }
+
+uint32_t spid_send(void *data, uint32_t len_bytes) {
+ uint32_t txf_ptr, txf_wptr, txf_rptr;
+ uint32_t fifo_inuse_bytes;
+ uint32_t msg_length_bytes;
+
+ /* Check if TXF has enough space */
+ txf_ptr = REG32(SPI_DEVICE_TXF_PTR(0));
+ txf_wptr = (txf_ptr >> SPI_DEVICE_TXF_PTR_WPTR_OFFSET) &
+ SPI_DEVICE_TXF_PTR_WPTR_MASK;
+ txf_rptr = (txf_ptr >> SPI_DEVICE_TXF_PTR_RPTR_OFFSET) &
+ SPI_DEVICE_TXF_PTR_RPTR_MASK;
+
+ fifo_inuse_bytes = calc_depth(txf_wptr, txf_rptr, SPID_TXF_SIZE);
+
+ // Reserve the last 4 bytes in the fifo so it is always safe
+ // to write 32-bit words
+ if (len_bytes < SPID_TXF_SIZE - fifo_inuse_bytes - 4) {
+ // Safe to send all data
+ msg_length_bytes = len_bytes;
+ } else {
+ msg_length_bytes = SPID_TXF_SIZE - fifo_inuse_bytes - 4;
+ }
+ int tocopy = msg_length_bytes;
+
+ // Aligned case can just copy words
+ if (word_aligned(data) && word_aligned((void *)txf_wptr)) {
+ uint32_t *data_w = (uint32_t *)data;
+ while (tocopy > 0) {
+ ACCESS32_TXFPTR(txf_wptr) = *data_w++;
+ if (tocopy >= 4) {
+ txf_wptr = ptr_inc(txf_wptr, 4, SPID_TXF_SIZE);
+ tocopy -= 4;
+ } else {
+ txf_wptr = ptr_inc(txf_wptr, tocopy, SPID_TXF_SIZE);
+ tocopy = 0; // tocopy -= tocopy always gives zero
+ }
+ }
+ } else {
+ // preserve data if unaligned start
+ uint8_t *data_b = (uint8_t *)data;
+ uint32_t d = ACCESS32_TXFPTR(txf_wptr);
+ while (tocopy > 0) {
+ int shift = (txf_wptr & 0x3) * 8;
+ uint32_t mask = 0xff << shift;
+ d = (d & ~mask) | (*data_b++ << shift);
+ if ((txf_wptr & 0x3) == 0x3) {
+ ACCESS32_TXFPTR(txf_wptr) = d;
+ }
+ txf_wptr = ptr_inc(txf_wptr, 1, SPID_TXF_SIZE);
+ tocopy--;
+ }
+ }
+
+ // Write pointer, requires read pointer to be RO
+ REG32(SPI_DEVICE_TXF_PTR(0)) = txf_wptr << SPI_DEVICE_TXF_PTR_WPTR_OFFSET;
+
+ return msg_length_bytes;
+}
+
+uint32_t spid_read_nb(void *data, uint32_t len_bytes) {
+ uint32_t rxf_ptr, rxf_wptr, rxf_rptr;
+ uint32_t msg_len_bytes;
+
+ rxf_ptr = REG32(SPI_DEVICE_RXF_PTR(0));
+ rxf_wptr = (rxf_ptr >> SPI_DEVICE_RXF_PTR_WPTR_OFFSET) &
+ SPI_DEVICE_RXF_PTR_WPTR_MASK;
+ rxf_rptr = (rxf_ptr >> SPI_DEVICE_RXF_PTR_RPTR_OFFSET) &
+ SPI_DEVICE_RXF_PTR_RPTR_MASK;
+
+ msg_len_bytes = calc_depth(rxf_wptr, rxf_rptr, SPID_RXF_SIZE);
+ if (msg_len_bytes == 0) {
+ return 0;
+ }
+ /* Check there is room for the whole buffer */
+ if (msg_len_bytes > len_bytes) {
+ msg_len_bytes = len_bytes;
+ }
+
+ int tocopy = msg_len_bytes;
+ // Aligned case -- which for now it always will be
+ // if tocopy is not multiple of 4 then will read / write extra bytes
+ // so check buffer length
+ if (word_aligned(data) && ((len_bytes & 0x3) == 0) &&
+ word_aligned((void *)rxf_ptr)) {
+ uint32_t *data_w = (uint32_t *)data;
+ while (tocopy > 0) {
+ *data_w++ = READ32_RXFPTR(rxf_rptr);
+ if (tocopy >= 4) {
+ rxf_rptr = ptr_inc(rxf_rptr, 4, SPID_RXF_SIZE);
+ tocopy -= 4;
+ } else {
+ rxf_rptr = ptr_inc(rxf_rptr, tocopy, SPID_RXF_SIZE);
+ tocopy = 0; // tocopy -= tocopy always gives zero
+ }
+ }
+ } else {
+ uint8_t *data_b = (uint8_t *)data;
+ // Have to deal with only being able to do 32-bit accesses
+ int dst = 0;
+ uint32_t d = READ32_RXFPTR(rxf_rptr & ~0x3);
+ while (tocopy--) {
+ int boff = rxf_rptr & 0x3;
+ data_b[dst++] = (d >> (boff * 8)) & 0xff;
+ rxf_rptr = ptr_inc(rxf_rptr, 1, SPID_RXF_SIZE);
+ if (((rxf_rptr & 0x3) == 0) && tocopy) {
+ d = READ32_RXFPTR(rxf_rptr);
+ }
+ }
+ }
+ /* Update read pointer -- NB relies on write pointer being RO */
+ REG32(SPI_DEVICE_RXF_PTR(0)) = rxf_rptr << SPI_DEVICE_RXF_PTR_RPTR_OFFSET;
+
+ return msg_len_bytes;
+}
+
+uint32_t spid_bytes_available(void) {
+ uint32_t rxf_ptr = REG32(SPI_DEVICE_RXF_PTR(0));
+ uint32_t rxf_wptr = (rxf_ptr >> SPI_DEVICE_RXF_PTR_WPTR_OFFSET) &
+ SPI_DEVICE_RXF_PTR_WPTR_MASK;
+ uint32_t rxf_rptr = (rxf_ptr >> SPI_DEVICE_RXF_PTR_RPTR_OFFSET) &
+ SPI_DEVICE_RXF_PTR_RPTR_MASK;
+
+ return calc_depth(rxf_wptr, rxf_rptr, SPID_RXF_SIZE);
+}
diff --git a/sw/boot_rom/spi_device.h b/sw/boot_rom/spi_device.h
new file mode 100644
index 0000000..2bd12c9
--- /dev/null
+++ b/sw/boot_rom/spi_device.h
@@ -0,0 +1,38 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _SPI_DEVICE_H_
+#define _SPI_DEVICE_H_
+
+#include <stdint.h>
+
+/**
+ * Init SPI Device
+ *
+ * Configure registers, RXF_ADDR, TXF_ADDR, CTRL.TIMER_V
+ */
+void spid_init(void);
+
+/**
+ * Send data over SPI
+ *
+ * @param data pointer to buffer of uint_8 to send
+ * @param len_bytes number of bytes to send
+ * @return number of bytes actually sent (<len if no space in the fifo)
+ */
+uint32_t spid_send(void *data, uint32_t len_bytes);
+
+/**
+ * Read the amount of the data from SRAM RX FIFO
+ *
+ * If remained data is smaller than length, it returns only up to data.
+ */
+uint32_t spid_read_nb(void *data, uint32_t len);
+
+/**
+ * Returns the number of bytes available to read on the RX buffer
+ */
+uint32_t spid_bytes_available(void);
+
+#endif /* _SPI_DEVICE_H_ */
diff --git a/sw/boot_rom/uart.c b/sw/boot_rom/uart.c
new file mode 100644
index 0000000..fc01e8d
--- /dev/null
+++ b/sw/boot_rom/uart.c
@@ -0,0 +1,75 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "uart.h"
+
+#include "common.h"
+
+inline void uart_init(unsigned int baud) {
+ // nco = 2^20 * baud / fclk
+ uint64_t uart_ctrl_nco = ((uint64_t)baud << 20) / CLK_FIXED_FREQ_HZ;
+ REG32(UART_CTRL(0)) =
+ ((uart_ctrl_nco & UART_CTRL_NCO_MASK) << UART_CTRL_NCO_OFFSET) |
+ (1 << UART_CTRL_TX) | (1 << UART_CTRL_RX);
+
+ // reset RX/TX FIFOs
+ REG32(UART_FIFO_CTRL(0)) =
+ (1 << UART_FIFO_CTRL_RXRST) | (1 << UART_FIFO_CTRL_TXRST);
+
+ // disable interrupts
+ REG32(UART_INTR_ENABLE(0)) = 0;
+}
+
+static int uart_tx_rdy(void) {
+ return !(REG32(UART_STATUS(0)) & (1 << UART_STATUS_TXFULL));
+}
+
+void uart_send_char(char c) {
+ while (!uart_tx_rdy()) {
+ }
+ REG32(UART_WDATA(0)) = c;
+}
+
+int uart_tx_empty(void) {
+ return !!(REG32(UART_STATUS(0)) & (1 << UART_STATUS_TXEMPTY));
+}
+
+/**
+ * Send a NULL-terminated string over UART
+ */
+void uart_send_str(char *str) {
+ while (*str != '\0') {
+ uart_send_char(*str++);
+ }
+}
+
+#define hexchar(i) (((i & 0xf) > 9) ? (i & 0xf) - 10 + 'A' : (i & 0xf) + '0')
+
+/**
+ * Send unsigned int over UART
+ */
+void uart_send_uint(uint32_t n, int bits) {
+ for (int i = bits - 4; i >= 0; i -= 4) {
+ uart_send_char(hexchar(n >> i));
+ }
+}
+
+int uart_rx_empty(void) {
+ return !!(REG32(UART_STATUS(0)) & (1 << UART_STATUS_RXEMPTY));
+}
+
+/**
+ * Receive a single character from UART
+ *
+ * @param c received character, caller-allocated
+ * @return 0 on success, -1 if no data is available
+ */
+int uart_rcv_char(char *c) {
+ if (uart_rx_empty()) {
+ return -1;
+ }
+
+ *c = REG32(UART_RDATA(0));
+ return 0;
+}
diff --git a/sw/boot_rom/uart.h b/sw/boot_rom/uart.h
new file mode 100644
index 0000000..8dde94e
--- /dev/null
+++ b/sw/boot_rom/uart.h
@@ -0,0 +1,22 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _UART_H_
+#define _UART_H_
+
+#include <stdint.h>
+
+#define UART0_BASE_ADDR 0x40000000
+
+#include "uart_regs.h"
+
+void uart_send_char(char c);
+void uart_send_uint(uint32_t n, int size);
+void uart_init(unsigned int baud);
+void uart_send_str(char *str);
+int uart_rx_empty(void);
+int uart_tx_empty(void);
+int uart_rcv_char(char *c);
+
+#endif
diff --git a/sw/exts/common/_crt.c b/sw/exts/common/_crt.c
new file mode 100644
index 0000000..e176867
--- /dev/null
+++ b/sw/exts/common/_crt.c
@@ -0,0 +1,21 @@
+#include <string.h>
+
+#include "common.h"
+#include "irq.h"
+
+extern int main(void);
+
+void _crt(void) __attribute__((section(".crt")));
+void _crt(void) {
+ extern char _sdata[];
+ extern char _idata[];
+ extern char _edata[];
+ extern char _bss_start[];
+ extern char _bss_end[];
+
+ update_mtvec();
+ memcpy(_sdata, _idata, _edata - _sdata);
+ memset(_bss_start, 0, _bss_end - _bss_start);
+
+ main();
+}
diff --git a/sw/exts/common/common.mk b/sw/exts/common/common.mk
new file mode 100644
index 0000000..9453bdc
--- /dev/null
+++ b/sw/exts/common/common.mk
@@ -0,0 +1,51 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+##########################################################################
+## The following variables must be set prior to invoking this Makefile ##
+## NAME - Top level name of the final elf ##
+## SRCS - List of files to be compiled ##
+## PROGRAM_DIR - Location of file corresponding to NAME ##
+##########################################################################
+
+all: $(LIB_DIR) $(OUTFILES)
+
+#
+
+.PHONY: $(LIB_DIR)
+
+$(LIB_DIR):
+ $(MAKE) -C $(LIB_DIR)
+
+$(EXE).elf: $(OBJS) $(LINKER_SCRIPT) $(LIB_DIR)
+ $(CC) $(CFLAGS) $(OBJS) -T $(LINKER_SCRIPT) -o $@ $(LIBS) -Xlinker -Map=$(EXE).map
+
+%.dis: %.elf
+ $(OBJDUMP) -SD $^ > $@
+
+# Note: this target requires the srecord package to be installed.
+# XXX: This could be replaced by objcopy once
+# https://sourceware.org/bugzilla/show_bug.cgi?id=19921
+# is merged.
+%.vmem: %.bin
+ srec_cat $^ -binary -offset 0x0 -byte-swap 4 -o $@ -vmem
+
+%.bin: %.elf
+ $(OBJCOPY) -O binary $^ $@
+
+%.o: %.c
+ $(CC) $(CFLAGS) -MMD -c $(INCS) -o $@ $<
+
+%.o: %.S
+ $(CC) $(CFLAGS) -MMD -c $(INCS) -o $@ $<
+
+
+-include $(DEPS)
+
+clean:
+ $(RM) -f *.o *.d $(GENHDRS)
+
+distclean: clean
+ cd $(LIB_DIR) && $(MAKE) distclean
+ $(RM) -f $(OUTFILES) $(EXT_DIR)/*.o $(EXT_DIR)/*.d
diff --git a/sw/exts/common/link.ld b/sw/exts/common/link.ld
new file mode 100644
index 0000000..93d7d61
--- /dev/null
+++ b/sw/exts/common/link.ld
@@ -0,0 +1,106 @@
+OUTPUT_ARCH(riscv)
+
+/* required to correctly link newlib */
+GROUP( -lc -lgloss -lgcc -lsupc++ )
+
+SEARCH_DIR(.)
+__DYNAMIC = 0;
+
+MEMORY
+{
+ flash (rx) : ORIGIN = 0x20000000, LENGTH = 0x100000
+ ram (!rx) : ORIGIN = 0x10000000, LENGTH = 0x10000
+}
+
+_stack_start = ORIGIN(ram) + LENGTH(ram);
+
+/* We have to align each sector to word boundaries as our current s19->slm
+ * conversion scripts are not able to handle non-word aligned sections. */
+
+
+SECTIONS
+{
+ .crt : { *(.crt) } > flash
+
+ /* the 256 byte alignment is required by the machine trap vector table */
+ .vectors : {
+ . = ALIGN(0x100);
+ _svectors = .;
+ *(.vectors)
+ _evectors = .;
+ } > flash
+
+ .text : {
+ . = ALIGN(0x100);
+ _stext = .;
+ *(.text)
+ _etext = .;
+ __CTOR_LIST__ = .;
+ LONG((__CTOR_END__ - __CTOR_LIST__) / 4 - 2)
+ *(.ctors)
+ LONG(0)
+ __CTOR_END__ = .;
+ __DTOR_LIST__ = .;
+ LONG((__DTOR_END__ - __DTOR_LIST__) / 4 - 2)
+ *(.dtors)
+ LONG(0)
+ __DTOR_END__ = .;
+ *(.lit)
+ *(.shdata)
+ _endtext = .;
+ } > flash
+
+ .rodata : {
+ . = ALIGN(4);
+ *(.rodata);
+ *(.rodata.*)
+ } > flash
+
+ .shbss :
+ {
+ . = ALIGN(4);
+ *(.shbss)
+ } > flash
+
+ /* idata stores the static variable data that will be loaded in ram below */
+ .idata :
+ {
+ . = ALIGN(4);
+ _idata = .;
+ } > flash
+
+ /* Static variable LMA at end of program
+ VMA at start of RAM. Stack is at end of RAM */
+ .data 0x10000000 : AT ( _idata ){
+ . = ALIGN(4);
+ _sdata = .; /* start of data */
+ *(.data);
+ *(.data.*)
+ *(.sdata);
+ _edata = .; /* end of data */
+ } > ram
+
+ .bss :
+ {
+ . = ALIGN(4);
+ _bss_start = .;
+ *(.bss)
+ *(.bss.*)
+ *(.sbss)
+ *(.sbss.*)
+ *(COMMON)
+ _bss_end = .;
+ } > ram
+
+ .stab 0 (NOLOAD) :
+ {
+ [ .stab ]
+ }
+
+ .stabstr 0 (NOLOAD) :
+ {
+ [ .stabstr ]
+ }
+}
+
+ENTRY(main)
diff --git a/sw/exts/common/options.mk b/sw/exts/common/options.mk
new file mode 100644
index 0000000..35e13da
--- /dev/null
+++ b/sw/exts/common/options.mk
@@ -0,0 +1,45 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+##########################################################################
+## The following variables must be set prior to invoking this Makefile ##
+## NAME - Top level name of the final elf ##
+## SRCS - List of files to be compiled ##
+## PROGRAM_DIR - Location of file corresponding to NAME ##
+##########################################################################
+
+PROGRAM_CFLAGS += -Wall -g -Os
+ifeq ($(SIM),1)
+ PROGRAM_CFLAGS += -DSIMULATION
+endif
+
+EXE := $(NAME)
+SW_DIR := $(PROGRAM_DIR)/../..
+LIB_DIR := $(SW_DIR)/lib
+LIB_NAME = ot
+EXT_DIR := $(SW_DIR)/exts/common
+EXT_SRCS := $(EXT_DIR)/_crt.c
+EXT_ASMS :=
+
+RV_TOOLS ?= /tools/riscv/bin/
+OBJCOPY ?= $(subst gcc,objcopy,$(wordlist 1,1,$(CC)))
+OBJDUMP ?= $(subst gcc,objdump,$(wordlist 1,1,$(CC)))
+
+# ARCH = rv32im # to disable compressed instructions
+ARCH = rv32imc
+LINKER_SCRIPT ?= $(EXT_DIR)/link.ld
+
+REGTOOL = ../../util/regtool.py
+
+CC := $(RV_TOOLS)/riscv32-unknown-elf-gcc
+CFLAGS ?= -Wall -g -Os -march=$(ARCH) -mabi=ilp32 -static -mcmodel=medany \
+ -fvisibility=hidden -nostdlib -nostartfiles $(PROGRAM_CFLAGS)
+
+OBJS := $(SRCS:.c=.o) $(EXT_SRCS:.c=.o) $(EXT_ASMS:.S=.o)
+DEPS = $(OBJS:%.o=%.d)
+
+LIBS =-L$(LIB_DIR) -l$(LIB_NAME)
+INCS +=-I$(LIB_DIR)
+
+OUTFILES := $(EXE).elf $(EXE).vmem $(EXE).bin $(EXE).dis $(EXE).map
diff --git a/sw/host/spiflash/.gitignore b/sw/host/spiflash/.gitignore
new file mode 100644
index 0000000..82149fe
--- /dev/null
+++ b/sw/host/spiflash/.gitignore
@@ -0,0 +1,2 @@
+spiflash
+*.o
diff --git a/sw/host/spiflash/Makefile b/sw/host/spiflash/Makefile
new file mode 100644
index 0000000..7a40387
--- /dev/null
+++ b/sw/host/spiflash/Makefile
@@ -0,0 +1,29 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+
+PROGRAM ?= spiflash
+PROGRAM_CFLAGS = -Wall -g -Os
+
+MPSSE_DIR = ../vendor/mpsse
+MPSSE_OBJS = $(MPSSE_DIR)/mpsse.o $(MPSSE_DIR)/support.o
+
+CFLAGS += -I${MPSSE_DIR} -std=gnu99
+CXXFLAGS += -I . -I${MPSSE_DIR} -Wall -std=c++14
+LDFLAGS += -lcrypto -lftdi1 -lusb-1.0 -L/usr/lib/x86_64-linux-gnu
+DEPS = spi_interface.h updater.h verilator_spi_interface.h ftdi_spi_interface.h
+OBJS := verilator_spi_interface.o updater.o ftdi_spi_interface.o
+
+all: $(PROGRAM)
+
+%.o: %.c
+ $(CC) $(CFLAGS) -c -o $@ $<
+
+%.o: %.cc $(DEPS)
+ $(CXX) $(CXXFLAGS) -c -o $@ $<
+
+$(PROGRAM): $(PROGRAM).cc $(OBJS) $(MPSSE_OBJS)
+ $(CXX) $(CXXFLAGS) $(LDFLAGS) spiflash.cc -o spiflash $(DEPS) $(OBJS) $(MPSSE_OBJS)
+
+clean:
+ rm -f $(PROGRAM) *.o ${MPSSE_OBJS}
diff --git a/sw/host/spiflash/README.md b/sw/host/spiflash/README.md
new file mode 100644
index 0000000..656800e
--- /dev/null
+++ b/sw/host/spiflash/README.md
@@ -0,0 +1,64 @@
+# SPI Flash
+
+`spiflash` is a tool used to update the firmware stored in OpenTitan's flash.
+The tool resets OpenTitan and signals the boot ROM to enter bootstrap mode
+before sending the update payload.
+
+Currently, the tool only supports Verilator targets.
+
+## Build instructions
+
+`spiflash` is written in C++17.
+
+Required packages:
+
+```shell
+$ sudo apt-get install libssl-dev libftdi1-dev
+```
+
+Build command:
+
+```shell
+$ cd ${REPO_TOP}/util/spiflash
+$ make clean && make
+```
+
+## Run the tool in Verilator
+
+Build boot_rom:
+
+```shell
+$ cd ${REPO_TOP}/sw/boot_rom
+$ make clean && make SIM=1
+```
+
+Build and run Verilator with boot_rom enabled:
+
+```shell
+$ cd ${REPO_TOP}
+$ fusesoc --cores-root . sim --build-only lowrisc:systems:top_earlgrey_verilator
+$ build/lowrisc_systems_top_earlgrey_verilator_0.1/sim-verilator/Vtop_earlgrey_verilator \
+ --rominit=sw/boot_rom/boot_rom.vmem
+```
+
+Build hello_world program:
+
+```shell
+$ cd ${REPO_TOP}/sw/hello_world
+$ make clean && make SIM=1
+```
+
+Run spiflash. In this example we use SPI device `/dev/pts/3` as an example.
+After the transmission is complete, you should be able to see the hello_world
+output in the UART console.
+
+```shell
+$ cd ${REPO_TOP}/util/spiflash
+$ make clean && make
+$ ./spiflash --input=../../sw/hello_world/hello_world.bin --verilator=/dev/pts/3
+```
+
+## TODOs
+
+- Implement ACK handshake between boot_rom and spiflash.
+- Add support for FPGA targets via FTDI interface.
diff --git a/sw/host/spiflash/ftdi_spi_interface.cc b/sw/host/spiflash/ftdi_spi_interface.cc
new file mode 100644
index 0000000..37a0ec8
--- /dev/null
+++ b/sw/host/spiflash/ftdi_spi_interface.cc
@@ -0,0 +1,125 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "ftdi_spi_interface.h"
+
+#include <assert.h>
+#include <fcntl.h>
+#include <termios.h>
+#include <unistd.h>
+
+#include <cstring>
+#include <iostream>
+#include <string>
+#include <vector>
+
+// Include MPSSE SPI library
+extern "C" {
+#include <mpsse.h>
+}
+
+namespace opentitan {
+namespace spiflash {
+namespace {
+
+// Required delay to synchronize transactions with FPGA environment.
+// TODO: If transmission is not successful, adapt this by an argument.
+constexpr int kTransmitDelay = 1000000;
+
+// FTDI Configuration. This can be made configurable later on if needed.
+constexpr int kFrequency = 1000000; // 1MHz
+
+enum FtdiGpioMapping {
+ // SRST_N reset.
+ kGpioJtagSrstN = GPIOL1,
+
+ // JTAG SPI_N select signal.
+ kGpioJtagSpiN = GPIOL2,
+
+ // Bootstrap pin.
+ kBootstrapH = GPIOL3,
+};
+
+// Resets the target to go back to boot_rom. Assumes boot_rom will enter
+// bootstrap mode.
+void ResetTarget(struct mpsse_context *ctx) {
+ // Set bootstrap pin high
+ PinHigh(ctx, kBootstrapH);
+
+ // Enable JTAG mode by setting GPIOL2 high and toggle reset (GPIOL1)
+ PinHigh(ctx, kGpioJtagSpiN);
+ PinLow(ctx, kGpioJtagSrstN);
+ usleep(100000);
+ PinHigh(ctx, kGpioJtagSrstN);
+
+ // Switch from JTAG to SPI mode. The delay is needed to make sure we don't
+ // drop any frames.
+ usleep(100000);
+ PinLow(ctx, kGpioJtagSpiN);
+}
+
+} // namespace
+
+// Wrapper struct used to hide mpsse_context since incomplete C struct
+// declarations don't play in forward declarations.
+struct MpsseHandle {
+ struct mpsse_context *ctx;
+
+ explicit MpsseHandle(struct mpsse_context *new_ctx) : ctx(new_ctx) {}
+ ~MpsseHandle() {
+ if (ctx != nullptr) {
+ Close(ctx);
+ }
+ }
+};
+
+FtdiSpiInterface::FtdiSpiInterface() : spi_(nullptr) {}
+
+FtdiSpiInterface::~FtdiSpiInterface() {
+ // TODO: Add interface to toggle bootstrap pin.
+ PinLow(spi_->ctx, kBootstrapH);
+}
+
+bool FtdiSpiInterface::Init() {
+ struct mpsse_context *ctx = MPSSE(SPI0, kFrequency, MSB);
+ if (ctx == nullptr) {
+ std::cerr << "Unable to open FTDI SPI interface." << std::endl;
+ return false;
+ }
+ spi_ = std::make_unique<MpsseHandle>(ctx);
+ ResetTarget(ctx);
+ return true;
+}
+
+bool FtdiSpiInterface::TransmitFrame(const uint8_t *tx, uint8_t *rx,
+ size_t size) {
+ assert(spi_ != nullptr);
+
+ // The mpsse library is more permissive than the SpiInteface. Copying tx
+ // to local buffer to handle issue internally.
+ std::vector<uint8_t> tx_local(tx, tx + size);
+
+ if (Start(spi_->ctx)) {
+ std::cerr << "Unable to start spi transaction." << std::endl;
+ return false;
+ }
+ uint8_t *tmp_rx = ::Transfer(spi_->ctx, tx_local.data(), size);
+ if (Stop(spi_->ctx)) {
+ std::cerr << "Unable to terminate spi transaction." << std::endl;
+ if (tmp_rx) {
+ free(tmp_rx);
+ }
+ return false;
+ }
+ if (tmp_rx == nullptr) {
+ std::cerr << "Unable to transfer data. Frame size: " << size << std::endl;
+ return false;
+ }
+ usleep(kTransmitDelay);
+ memcpy(rx, tmp_rx, size);
+ free(tmp_rx);
+ return true;
+}
+} // namespace spiflash
+} // namespace opentitan
diff --git a/sw/host/spiflash/ftdi_spi_interface.h b/sw/host/spiflash/ftdi_spi_interface.h
new file mode 100644
index 0000000..e68bbc7
--- /dev/null
+++ b/sw/host/spiflash/ftdi_spi_interface.h
@@ -0,0 +1,43 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_SPIFLASH_FTDI_SPI_INTERFACE_H__
+#define _F_SPIFLASH_FTDI_SPI_INTERFACE_H__
+
+#include <memory>
+#include <string>
+
+#include "spi_interface.h"
+
+namespace opentitan {
+namespace spiflash {
+
+// Forward declaration used to hide MPSSE context.
+struct MpsseHandle;
+
+// Implements SPI interface for an OpenTitan design connected via FTDI.
+// FTDI provides an USB interface called Multi-Protocol Synchronous Serial
+// Engine (MPSSE) which gives access to SPI, I2C and JTAG. This class uses
+// MPSSE to communicate with the SPI device IP in OpenTitan.
+// This class is not thread safe.
+class FtdiSpiInterface : public SpiInterface {
+ public:
+ FtdiSpiInterface();
+ ~FtdiSpiInterface() override;
+
+ // Initialize interface.
+ bool Init() final;
+
+ // Transmit bytes from |tx| buffer and read data back onto |rx| buffer. The
+ // number of bytes are defined by |size|.
+ bool TransmitFrame(const uint8_t *tx, uint8_t *rx, size_t size) final;
+
+ private:
+ std::unique_ptr<MpsseHandle> spi_;
+};
+
+} // namespace spiflash
+} // namespace opentitan
+
+#endif // _F_SPIFLASH_FTDI_SPI_INTERFACE_H__
diff --git a/sw/host/spiflash/spi_interface.h b/sw/host/spiflash/spi_interface.h
new file mode 100644
index 0000000..660b9b0
--- /dev/null
+++ b/sw/host/spiflash/spi_interface.h
@@ -0,0 +1,36 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_SPIFLASH_SPI_INTERFACE_H__
+#define _F_SPIFLASH_SPI_INTERFACE_H__
+
+#include <cstdint>
+#include <cstring>
+
+namespace opentitan {
+namespace spiflash {
+
+// This class defines the SPI interface used to communicate with an OpenTitan
+// device.
+class SpiInterface {
+ public:
+ SpiInterface() = default;
+ virtual ~SpiInterface() = default;
+
+ // Not copy or movable
+ SpiInterface(const SpiInterface &) = delete;
+ SpiInterface &operator=(const SpiInterface &) = delete;
+
+ // Initialize SPI interface. Returns true on success.
+ virtual bool Init() = 0;
+
+ // Transmit bytes from |tx| buffer and read data back onto |rx| buffer. The
+ // number of bytes transferred is defined by |size|.
+ virtual bool TransmitFrame(const uint8_t *tx, uint8_t *rx, size_t size) = 0;
+};
+
+} // namespace spiflash
+} // namespace opentitan
+
+#endif // _F_SPIFLASH_SPI_INTERFACE_H__
diff --git a/sw/host/spiflash/spiflash.cc b/sw/host/spiflash/spiflash.cc
new file mode 100644
index 0000000..6d56b74
--- /dev/null
+++ b/sw/host/spiflash/spiflash.cc
@@ -0,0 +1,123 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include <assert.h>
+#include <getopt.h>
+
+#include <fstream>
+#include <memory>
+#include <sstream>
+#include <string>
+
+#include "ftdi_spi_interface.h"
+#include "spi_interface.h"
+#include "updater.h"
+#include "verilator_spi_interface.h"
+
+namespace {
+
+using opentitan::spiflash::FtdiSpiInterface;
+using opentitan::spiflash::SpiInterface;
+using opentitan::spiflash::Updater;
+using opentitan::spiflash::VerilatorSpiInterface;
+
+constexpr char kUsageString[] = R"R( usage options:
+ --input=Input image in binary format.
+ [--verilator=filehandle] Enables Verilator mode with SPI filehandle.)R";
+
+// SPI flash configuration options.
+struct SpiFlashOpts {
+ // Input file in binary format.
+ std::string input;
+
+ // Target SPI device handle.
+ std::string target;
+
+ // Set to true to target Verilator environment.
+ bool verilator = false;
+};
+
+// Get |filename| contents and store them in |contents|. Using std::string for
+// |filename| because underlying open file call requires a C string.
+bool GetFileContents(const std::string &filename, std::string *contents) {
+ assert(contents);
+ std::ifstream file_stream(filename, std::ios::in | std::ios::binary);
+ if (!file_stream) {
+ std::cerr << "Unable to open: " << filename << " errno: " << errno
+ << std::endl;
+ return false;
+ }
+ std::ostringstream in_stream;
+ in_stream << file_stream.rdbuf();
+ file_stream.close();
+ *contents = in_stream.str();
+ return true;
+}
+
+// Prints help menu.
+static void PrintUsage(int argc, char *argv[]) {
+ assert(argc >= 1);
+ std::cerr << argv[0] << kUsageString << std::endl;
+}
+
+// Parse command line arguments and store results in |options|.
+bool ParseArgs(int argc, char **argv, SpiFlashOpts *options) {
+ assert(options);
+ const struct option long_options[] = {
+ {"input", required_argument, nullptr, 'i'},
+ {"verilator", required_argument, nullptr, 's'},
+ {"help", no_argument, nullptr, 'h'},
+ {nullptr, no_argument, nullptr, 0}};
+
+ while (true) {
+ int c = getopt_long(argc, argv, "i:s:h?", long_options, nullptr);
+ if (c == -1) {
+ return true;
+ }
+
+ switch (c) {
+ case 0:
+ break;
+ case 'i':
+ options->input = optarg;
+ break;
+ case 's':
+ options->verilator = true;
+ options->target = optarg;
+ break;
+ case '?':
+ case 'h':
+ PrintUsage(argc, argv);
+ default:;
+ }
+ }
+ return true;
+}
+
+} // namespace
+
+int main(int argc, char **argv) {
+ SpiFlashOpts spi_flash_options;
+ if (!ParseArgs(argc, argv, &spi_flash_options)) {
+ std::cerr << "Failed to parse command line options." << std::endl;
+ return 1;
+ }
+
+ std::unique_ptr<SpiInterface> spi;
+ if (spi_flash_options.verilator) {
+ spi = std::make_unique<VerilatorSpiInterface>(spi_flash_options.target);
+ } else {
+ spi = std::make_unique<FtdiSpiInterface>();
+ }
+ if (!spi->Init()) {
+ return 1;
+ }
+
+ Updater::Options options;
+ if (!GetFileContents(spi_flash_options.input, &options.code)) {
+ return 1;
+ }
+ Updater updater(options, std::move(spi));
+ return updater.Run() ? 0 : 1;
+}
diff --git a/sw/host/spiflash/updater.cc b/sw/host/spiflash/updater.cc
new file mode 100644
index 0000000..bb37c63
--- /dev/null
+++ b/sw/host/spiflash/updater.cc
@@ -0,0 +1,88 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "updater.h"
+
+#include <assert.h>
+
+namespace opentitan {
+namespace spiflash {
+namespace {
+
+// Populates frame |f| with |frame_number|, |code_offset|, and frame data
+// starting at |code_offset| from |code| buffer. Calculates SHA256 hash of
+// frame payload and it stores it in the frame header. Returns the number of
+// bytes loaded into the frame.
+uint32_t Populate(uint32_t frame_number, uint32_t code_offset,
+ const std::string &code, Frame *f) {
+ assert(f);
+ assert(code_offset < code.size());
+
+ // Populate payload data. Initialize buffer to 0xff to minimize flash
+ // writes.
+ size_t copy_size =
+ std::min<size_t>(f->PayloadSize(), code.size() - code_offset);
+ memset(f->data, 0xff, f->PayloadSize());
+ memcpy(f->data, code.data() + code_offset, copy_size);
+
+ // Populate header number, offset and hash.
+ f->hdr.frame_num = frame_number;
+ f->hdr.offset = code_offset;
+ SHA256_CTX sha256;
+ SHA256_Init(&sha256);
+ SHA256_Update(&sha256, &f->hdr.frame_num, sizeof(f->hdr.frame_num));
+ SHA256_Update(&sha256, &f->hdr.offset, sizeof(f->hdr.offset));
+ SHA256_Update(&sha256, f->data, f->PayloadSize());
+ SHA256_Final(f->hdr.hash, &sha256);
+ return copy_size;
+}
+
+} // namespace
+
+bool Updater::Run() {
+ std::cout << "Running SPI flash update." << std::endl;
+ std::vector<Frame> frames;
+ if (!GenerateFrames(options_.code, &frames)) {
+ std::cerr << "Unable to process flash image." << std::endl;
+ return false;
+ }
+ std::cout << "Image divided into " << frames.size() << " frames."
+ << std::endl;
+
+ for (const Frame &f : frames) {
+ std::cout << "frame: 0x" << std::setfill('0') << std::setw(8) << std::hex
+ << f.hdr.frame_num << " to offset: 0x" << std::setfill('0')
+ << std::setw(8) << std::hex << f.hdr.offset << std::endl;
+ uint8_t rx[sizeof(Frame)];
+ if (!spi_->TransmitFrame(reinterpret_cast<const uint8_t *>(&f), rx,
+ sizeof(Frame))) {
+ std::cerr << "Failed to transmit frame no: 0x" << std::setfill('0')
+ << std::setw(8) << std::hex << f.hdr.frame_num << std::endl;
+ }
+ }
+ return true;
+}
+
+bool Updater::GenerateFrames(const std::string &code,
+ std::vector<Frame> *frames) {
+ if (frames == nullptr) {
+ return false;
+ }
+ uint32_t frame_number = 0;
+ uint32_t code_offset = 0;
+ while (code_offset < code.size()) {
+ Frame frame;
+ uint32_t bytes_copied = Populate(frame_number, code_offset, code, &frame);
+ code_offset += bytes_copied;
+ frame_number++;
+ frames->emplace_back(frame);
+ }
+ // Update last frame to sentinel EOF value.
+ Frame &last_frame = frames->back();
+ last_frame.hdr.frame_num = 0x80000000 | last_frame.hdr.frame_num;
+ return true;
+}
+
+} // namespace spiflash
+} // namespace opentitan
diff --git a/sw/host/spiflash/updater.h b/sw/host/spiflash/updater.h
new file mode 100644
index 0000000..c3a0d2f
--- /dev/null
+++ b/sw/host/spiflash/updater.h
@@ -0,0 +1,81 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_SPIFLASH_UPDATER_H__
+#define _F_SPIFLASH_UPDATER_H__
+
+#include <openssl/sha.h>
+
+#include <algorithm>
+#include <cstdint>
+#include <cstring>
+#include <iomanip>
+#include <iostream>
+#include <memory>
+#include <string>
+#include <vector>
+
+#include "spi_interface.h"
+
+namespace opentitan {
+namespace spiflash {
+
+// Implements the bootstrap SPI frame message.
+struct Frame {
+ // Frame header definition.
+ struct {
+ // SHA2 of the entire frame_t message starting at the |frame_num| offset.
+ uint8_t hash[32];
+
+ // Frame number. Starting at 0.
+ uint32_t frame_num;
+
+ // Flash target offset.
+ uint32_t offset;
+ } hdr;
+
+ uint8_t data[1024 - sizeof(hdr)];
+
+ // Returns available the frame available payload size in bytes.
+ size_t PayloadSize() const { return 1024 - sizeof(hdr); }
+};
+
+// Implements SPI flash update protocol.
+//
+// The firmare image is split into frames, and then sent to the SPI device.
+// More details will be added on the ack protocol once implemented.
+// This class is not thread safe due to the spi driver dependency.
+class Updater {
+ public:
+ // Updater configuration settings.
+ struct Options {
+ // Firmware image in binary format.
+ std::string code;
+ };
+
+ // Constructs updater instance with given configuration |options| and |spi|
+ // interface.
+ Updater(Options options, std::unique_ptr<SpiInterface> spi)
+ : options_(options), spi_(std::move(spi)) {}
+ virtual ~Updater() = default;
+
+ // Not copy or movable
+ Updater(const Updater &) = delete;
+ Updater &operator=(const Updater &) = delete;
+
+ // Runs update flow returning true on success.
+ bool Run();
+
+ private:
+ // Generates |frames| for |code| image.
+ bool GenerateFrames(const std::string &code, std::vector<Frame> *frames);
+
+ Options options_;
+ std::unique_ptr<SpiInterface> spi_;
+};
+
+} // namespace spiflash
+} // namespace opentitan
+
+#endif
diff --git a/sw/host/spiflash/verilator_spi_interface.cc b/sw/host/spiflash/verilator_spi_interface.cc
new file mode 100644
index 0000000..2d0cc1d
--- /dev/null
+++ b/sw/host/spiflash/verilator_spi_interface.cc
@@ -0,0 +1,111 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "verilator_spi_interface.h"
+
+#include <fcntl.h>
+#include <termios.h>
+#include <unistd.h>
+
+#include <cstring>
+#include <iostream>
+#include <string>
+
+namespace opentitan {
+namespace spiflash {
+namespace {
+
+// Required delay to synchronize transactions with simulation environment.
+// TODO: If transmission is not successful, adapt this by an argument.
+constexpr int kWriteReadDelay = 20000000;
+
+// Configure |fd| as a serial port with baud rate 9600.
+bool SetTermOpts(int fd) {
+ struct termios options;
+ if (tcgetattr(fd, &options) != 0) {
+ return false;
+ }
+ cfmakeraw(&options);
+ // The current Verilator configuration uses 9600 baud rate.
+ if (cfsetispeed(&options, B9600) != 0) {
+ return false;
+ }
+ if (cfsetospeed(&options, B9600) != 0) {
+ return false;
+ }
+ if (tcsetattr(fd, TCSANOW, &options) != 0) {
+ return false;
+ }
+ return true;
+}
+
+// Returns file handle on success, or nullopt on failure. This function
+// configures de file handle to behave as a serial port with baud rate 9600,
+// which is the baud rate supported by Verilator.
+int OpenDevice(const std::string &filename) {
+ int fd = open(filename.c_str(), O_RDWR | O_NOCTTY | O_NONBLOCK | O_CLOEXEC);
+ if (fd < 0) {
+ std::cerr << "Failed to open device: " << filename << std::endl;
+ return fd;
+ }
+ if (!SetTermOpts(fd)) {
+ close(fd);
+ return -1;
+ }
+ return fd;
+}
+
+// Reads |size| bytes into |rx| buffer from |fd|. Returns the number of bytes
+// read.
+int ReadBytes(int fd, uint8_t *rx, size_t size) {
+ size_t bytes_read = 0;
+ while (bytes_read != size) {
+ size_t read_size = read(fd, &rx[bytes_read], size - bytes_read);
+ switch (read_size) {
+ case -1:
+ if (errno == EAGAIN || errno == EWOULDBLOCK) {
+ continue;
+ }
+ break;
+ default:
+ bytes_read += read_size;
+ }
+ }
+ return bytes_read;
+}
+
+} // namespace
+
+VerilatorSpiInterface::~VerilatorSpiInterface() {
+ if (fd_ != -1) {
+ close(fd_);
+ }
+}
+
+bool VerilatorSpiInterface::Init() {
+ fd_ = OpenDevice(spi_filename_);
+ if (fd_ < 0) {
+ return false;
+ }
+ return true;
+}
+
+bool VerilatorSpiInterface::TransmitFrame(const uint8_t *tx, uint8_t *rx,
+ size_t size) {
+ size_t bytes_written = write(fd_, tx, size);
+ if (bytes_written != size) {
+ std::cerr << "Failed to write bytes to spi interface. Bytes written: "
+ << bytes_written << " expected: " << size << std::endl;
+ return false;
+ }
+ usleep(kWriteReadDelay);
+ size_t bytes_read = ReadBytes(fd_, rx, size);
+ if (bytes_read < size) {
+ std::cerr << "Failed to read bytes from spi interface. Bytes read: "
+ << bytes_read << " expected: " << size << std::endl;
+ }
+ return true;
+}
+} // namespace spiflash
+} // namespace opentitan
diff --git a/sw/host/spiflash/verilator_spi_interface.h b/sw/host/spiflash/verilator_spi_interface.h
new file mode 100644
index 0000000..b39ef1d
--- /dev/null
+++ b/sw/host/spiflash/verilator_spi_interface.h
@@ -0,0 +1,44 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_SPIFLASH_VERILATOR_SPI_INTERFACE_H__
+#define _F_SPIFLASH_VERILATOR_SPI_INTERFACE_H__
+
+#include <string>
+
+#include "spi_interface.h"
+
+namespace opentitan {
+namespace spiflash {
+
+// Implements SPI interface for an OpenTitan instance running on Verilator.
+// The OpenTitan Verilator model provides a file handle for the SPI device
+// interface. This class sends ands recevies data to the device handle, and
+// adds synchronication delays between writes and reads.
+// This class is not thread safe.
+class VerilatorSpiInterface : public SpiInterface {
+ public:
+ // Constructs instance pointing to the |spi_filename| file path.
+ explicit VerilatorSpiInterface(std::string spi_filename)
+ : spi_filename_(spi_filename), fd_(-1) {}
+
+ // Closes the internal file handle used to communicate with the SPI device.
+ ~VerilatorSpiInterface() override;
+
+ // Initialize interface.
+ bool Init() final;
+
+ // Transmit bytes from |tx| buffer and read data back onto |rx| buffer. The
+ // number of bytes are defined by |size|.
+ bool TransmitFrame(const uint8_t *tx, uint8_t *rx, size_t size) final;
+
+ private:
+ std::string spi_filename_;
+ int fd_;
+};
+
+} // namespace spiflash
+} // namespace opentitan
+
+#endif // _F_SPIFLASH_VERILATOR_SPI_INTERFACE_H__
diff --git a/sw/host/vendor/mpsse/README.md b/sw/host/vendor/mpsse/README.md
new file mode 100644
index 0000000..6dea4bd
--- /dev/null
+++ b/sw/host/vendor/mpsse/README.md
@@ -0,0 +1,6 @@
+# FTDI MPSSE Utilities
+
+FTDI MPSSE utilities extracted from ChromiumOS project
+https://chromium.googlesource.com/chromiumos/platform2/+/refs/heads/master/trunks/ftdi/
+commit hash `8ec1c47f4941a2840d799746a6f8f10b5381f8ed` with minor modifications
+for this project.
diff --git a/sw/host/vendor/mpsse/mpsse.c b/sw/host/vendor/mpsse/mpsse.c
new file mode 100644
index 0000000..308fa50
--- /dev/null
+++ b/sw/host/vendor/mpsse/mpsse.c
@@ -0,0 +1,1008 @@
+/*
+ *
+ *Copyright (C) 2015 The Android Open Source Project
+ *
+ *Licensed 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.
+ *
+ *
+ * This file was copied from https://github.com/devttys0/libmpsse.git (sha1
+ * f1a6744b), and modified to suite the Chromium OS project.
+ *
+ * Main libmpsse source file.
+ *
+ * Craig Heffner
+ * 27 December 2011
+ */
+#include "support.h"
+
+#include <stdlib.h>
+#include <string.h>
+#include <stdint.h>
+#include <unistd.h>
+/* List of known FT2232-based devices */
+struct vid_pid supported_devices[] = {
+ {0x0403, 0x6010, "FT2232 Future Technology Devices International, Ltd"},
+ {0x0403, 0x6011, "FT4232 Future Technology Devices International, Ltd"},
+ {0x0403, 0x6014, "FT232H Future Technology Devices International, Ltd"},
+ /* These devices are based on FT2232 chips, but have not been tested. */
+ {0x0403, 0x8878, "Bus Blaster v2 (channel A)"},
+ {0x0403, 0x8879, "Bus Blaster v2 (channel B)"},
+ {0x0403, 0xBDC8, "Turtelizer JTAG/RS232 Adapter A"},
+ {0x0403, 0xCFF8, "Amontec JTAGkey"},
+ {0x0403, 0x8A98, "TIAO Multi Protocol Adapter"},
+ {0x15BA, 0x0003, "Olimex Ltd. OpenOCD JTAG"},
+ {0x15BA, 0x0004, "Olimex Ltd. OpenOCD JTAG TINY"},
+ {0, 0, NULL}};
+/*
+ * Opens and initializes the first FTDI device found.
+ *
+ * @mode - Mode to open the device in. One of enum modes.
+ * @freq - Clock frequency to use for the specified mode.
+ * @endianess - Specifies how data is clocked in/out (MSB, LSB).
+ *
+ * Returns a pointer to an MPSSE context structure if succeeded, NULL otherwise.
+ */
+struct mpsse_context* MPSSE(enum modes mode, int freq, int endianess) {
+ int i = 0;
+ struct mpsse_context* mpsse = NULL;
+ for (i = 0; supported_devices[i].vid != 0; i++) {
+ mpsse = Open(supported_devices[i].vid, supported_devices[i].pid, mode,
+ freq, endianess, IFACE_A, NULL, NULL);
+ if (mpsse) {
+ mpsse->description = supported_devices[i].description;
+ return mpsse;
+ }
+ }
+ return NULL;
+}
+/*
+ * Open device by VID/PID
+ *
+ * @vid - Device vendor ID.
+ * @pid - Device product ID.
+ * @mode - MPSSE mode, one of enum modes.
+ * @freq - Clock frequency to use for the specified mode.
+ * @endianess - Specifies how data is clocked in/out (MSB, LSB).
+ * @interface - FTDI interface to use (IFACE_A - IFACE_D).
+ * @description - Device product description (set to NULL if not needed).
+ * @serial - Device serial number (set to NULL if not needed).
+ *
+ * Returns a pointer to an MPSSE context structure on success.
+ */
+struct mpsse_context* Open(int vid,
+ int pid,
+ enum modes mode,
+ int freq,
+ int endianess,
+ int interface,
+ const char* description,
+ const char* serial) {
+ return OpenIndex(vid, pid, mode, freq, endianess, interface, description,
+ serial, 0);
+}
+/*
+ * Open device by VID/PID/index
+ *
+ * @vid - Device vendor ID.
+ * @pid - Device product ID.
+ * @mode - MPSSE mode, one of enum modes.
+ * @freq - Clock frequency to use for the specified mode.
+ * @endianess - Specifies how data is clocked in/out (MSB, LSB).
+ * @interface - FTDI interface to use (IFACE_A - IFACE_D).
+ * @description - Device product description (set to NULL if not needed).
+ * @serial - Device serial number (set to NULL if not needed).
+ * @index - Device index (set to 0 if not needed).
+ *
+ * Returns a pointer to an MPSSE context structure.
+ * On success, mpsse->open will be set to 1.
+ * On failure, mpsse->open will be set to 0.
+ */
+struct mpsse_context* OpenIndex(int vid,
+ int pid,
+ enum modes mode,
+ int freq,
+ int endianess,
+ int interface,
+ const char* description,
+ const char* serial,
+ int index) {
+ int status = 0;
+ struct mpsse_context* mpsse = NULL;
+ mpsse = (struct mpsse_context*)malloc(sizeof(struct mpsse_context));
+ if (!mpsse)
+ return NULL;
+ memset(mpsse, 0, sizeof(struct mpsse_context));
+ /* Legacy; flushing is no longer needed, so disable it by default. */
+ FlushAfterRead(mpsse, 0);
+ /* ftdilib initialization */
+ if (ftdi_init(&mpsse->ftdi)) {
+ free(mpsse);
+ return NULL;
+ }
+ /* Set the FTDI interface */
+ ftdi_set_interface(&mpsse->ftdi, interface);
+ /* Open the specified device */
+ if (!ftdi_usb_open_desc_index(&mpsse->ftdi, vid, pid, description, serial,
+ index)) {
+ mpsse->mode = mode;
+ mpsse->vid = vid;
+ mpsse->pid = pid;
+ mpsse->status = STOPPED;
+ mpsse->endianess = endianess;
+ /* Set the appropriate transfer size for the requested protocol */
+ if (mpsse->mode == I2C)
+ mpsse->xsize = I2C_TRANSFER_SIZE;
+ else
+ mpsse->xsize = SPI_RW_SIZE;
+ status |= ftdi_usb_reset(&mpsse->ftdi);
+ status |= ftdi_set_latency_timer(&mpsse->ftdi, LATENCY_MS);
+ status |= ftdi_write_data_set_chunksize(&mpsse->ftdi, CHUNK_SIZE);
+ status |= ftdi_read_data_set_chunksize(&mpsse->ftdi, CHUNK_SIZE);
+ status |= ftdi_set_bitmode(&mpsse->ftdi, 0, BITMODE_RESET);
+ if (status == 0) {
+ /* Set the read and write timeout periods */
+ set_timeouts(mpsse, USB_TIMEOUT);
+ if (mpsse->mode != BITBANG) {
+ ftdi_set_bitmode(&mpsse->ftdi, 0, BITMODE_MPSSE);
+ if (SetClock(mpsse, freq) == MPSSE_OK) {
+ if (SetMode(mpsse, endianess) == MPSSE_OK) {
+ mpsse->opened = 1;
+ /* Give the chip a few mS to initialize */
+ usleep(SETUP_DELAY);
+ /*
+ * Not all FTDI chips support all the commands that SetMode may
+ * have sent.
+ * This clears out any errors from unsupported commands that
+ * might have been sent during set up.
+ */
+ ftdi_usb_purge_buffers(&mpsse->ftdi);
+ }
+ }
+ } else {
+ /* Skip the setup functions if we're just operating in BITBANG mode
+ */
+ if (!ftdi_set_bitmode(&mpsse->ftdi, 0xFF, BITMODE_BITBANG))
+ mpsse->opened = 1;
+ }
+ }
+ }
+ if (mpsse && !mpsse->opened) {
+ Close(mpsse);
+ mpsse = NULL;
+ }
+ return mpsse;
+}
+/*
+ * Closes the device, deinitializes libftdi, and frees the MPSSE context
+ *pointer.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns void.
+ */
+void Close(struct mpsse_context* mpsse) {
+ if (!mpsse)
+ return;
+ if (mpsse->opened) {
+ /* Shut these down only if initialization succeeded before. */
+ ftdi_set_bitmode(&mpsse->ftdi, 0, BITMODE_RESET);
+ ftdi_usb_close(&mpsse->ftdi);
+ }
+ ftdi_deinit(&mpsse->ftdi);
+ free(mpsse);
+}
+/* Enables bit-wise data transfers.
+ * Must be called after MPSSE() / Open() / OpenIndex().
+ *
+ * Returns void.
+ */
+void EnableBitmode(struct mpsse_context* mpsse, int tf) {
+ if (is_valid_context(mpsse)) {
+ if (tf) {
+ mpsse->tx |= MPSSE_BITMODE;
+ mpsse->rx |= MPSSE_BITMODE;
+ mpsse->txrx |= MPSSE_BITMODE;
+ } else {
+ mpsse->tx &= ~MPSSE_BITMODE;
+ mpsse->rx &= ~MPSSE_BITMODE;
+ mpsse->txrx &= ~MPSSE_BITMODE;
+ }
+ }
+}
+/*
+ * Sets the appropriate transmit and receive commands based on the requested
+ *mode and byte order.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @endianess - MPSSE_MSB or MPSSE_LSB.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int SetMode(struct mpsse_context* mpsse, int endianess) {
+ int retval = MPSSE_OK, i = 0, setup_commands_size = 0;
+ uint8_t buf[CMD_SIZE] = {0};
+ uint8_t setup_commands[CMD_SIZE * MAX_SETUP_COMMANDS] = {0};
+ /* Do not call is_valid_context() here, as the FTDI chip may not be completely
+ * configured when SetMode is called */
+ if (mpsse) {
+ /* Read and write commands need to include endianess */
+ mpsse->tx = MPSSE_DO_WRITE | endianess;
+ mpsse->rx = MPSSE_DO_READ | endianess;
+ mpsse->txrx = MPSSE_DO_WRITE | MPSSE_DO_READ | endianess;
+ /* Clock, data out, chip select pins are outputs; all others are inputs. */
+ mpsse->tris = DEFAULT_TRIS;
+ /* Clock and chip select pins idle high; all others are low */
+ mpsse->pidle = mpsse->pstart = mpsse->pstop = DEFAULT_PORT;
+ /* During reads and writes the chip select pin is brought low */
+ mpsse->pstart &= ~CS;
+ /* Disable FTDI internal loopback */
+ SetLoopback(mpsse, 0);
+ /* Send ACKs by default */
+ SetAck(mpsse, ACK);
+ /* Ensure adaptive clock is disabled */
+ setup_commands[setup_commands_size++] = DISABLE_ADAPTIVE_CLOCK;
+ switch (mpsse->mode) {
+ case SPI0:
+ /* SPI mode 0 clock idles low */
+ mpsse->pidle &= ~SK;
+ mpsse->pstart &= ~SK;
+ mpsse->pstop &= ~SK;
+ /* SPI mode 0 propogates data on the falling edge and read data on the
+ * rising edge of the clock */
+ mpsse->tx |= MPSSE_WRITE_NEG;
+ mpsse->rx &= ~MPSSE_READ_NEG;
+ mpsse->txrx |= MPSSE_WRITE_NEG;
+ mpsse->txrx &= ~MPSSE_READ_NEG;
+ break;
+ case SPI3:
+ /* SPI mode 3 clock idles high */
+ mpsse->pidle |= SK;
+ mpsse->pstart |= SK;
+ /* Keep the clock low while the CS pin is brought high to ensure we
+ * don't accidentally clock out an extra bit */
+ mpsse->pstop &= ~SK;
+ /* SPI mode 3 propogates data on the falling edge and read data on the
+ * rising edge of the clock */
+ mpsse->tx |= MPSSE_WRITE_NEG;
+ mpsse->rx &= ~MPSSE_READ_NEG;
+ mpsse->txrx |= MPSSE_WRITE_NEG;
+ mpsse->txrx &= ~MPSSE_READ_NEG;
+ break;
+ case SPI1:
+ /* SPI mode 1 clock idles low */
+ mpsse->pidle &= ~SK;
+ /* Since this mode idles low, the start condition should ensure that the
+ * clock is low */
+ mpsse->pstart &= ~SK;
+ /* Even though we idle low in this mode, we need to keep the clock line
+ * high when we set the CS pin high to prevent
+ * an unintended clock cycle from being sent by the FT2232. This way,
+ * the clock goes high, but does not go low until
+ * after the CS pin goes high.
+ */
+ mpsse->pstop |= SK;
+ /* Data read on falling clock edge */
+ mpsse->rx |= MPSSE_READ_NEG;
+ mpsse->tx &= ~MPSSE_WRITE_NEG;
+ mpsse->txrx |= MPSSE_READ_NEG;
+ mpsse->txrx &= ~MPSSE_WRITE_NEG;
+ break;
+ case SPI2:
+ /* SPI 2 clock idles high */
+ mpsse->pidle |= SK;
+ mpsse->pstart |= SK;
+ mpsse->pstop |= SK;
+ /* Data read on falling clock edge */
+ mpsse->rx |= MPSSE_READ_NEG;
+ mpsse->tx &= ~MPSSE_WRITE_NEG;
+ mpsse->txrx |= MPSSE_READ_NEG;
+ mpsse->txrx &= ~MPSSE_WRITE_NEG;
+ break;
+ case I2C:
+ /* I2C propogates data on the falling clock edge and reads data on the
+ * falling (or rising) clock edge */
+ mpsse->tx |= MPSSE_WRITE_NEG;
+ mpsse->rx &= ~MPSSE_READ_NEG;
+ /* In I2C, both the clock and the data lines idle high */
+ mpsse->pidle |= DO | DI;
+ /* I2C start bit == data line goes from high to low while clock line is
+ * high */
+ mpsse->pstart &= ~DO & ~DI;
+ /* I2C stop bit == data line goes from low to high while clock line is
+ * high - set data line low here, so the transition to the idle state
+ * triggers the stop condition. */
+ mpsse->pstop &= ~DO & ~DI;
+ /* Enable three phase clock to ensure that I2C data is available on both
+ * the rising and falling clock edges */
+ setup_commands[setup_commands_size++] = ENABLE_3_PHASE_CLOCK;
+ break;
+ case GPIO:
+ break;
+ default:
+ retval = MPSSE_FAIL;
+ }
+ /* Send any setup commands to the chip */
+ if (retval == MPSSE_OK && setup_commands_size > 0) {
+ retval = raw_write(mpsse, setup_commands, setup_commands_size);
+ }
+ if (retval == MPSSE_OK) {
+ /* Set the idle pin states */
+ set_bits_low(mpsse, mpsse->pidle);
+ /* All GPIO pins are outputs, set low */
+ mpsse->trish = 0xFF;
+ mpsse->gpioh = 0x00;
+ buf[i++] = SET_BITS_HIGH;
+ buf[i++] = mpsse->gpioh;
+ buf[i++] = mpsse->trish;
+ retval = raw_write(mpsse, buf, i);
+ }
+ } else {
+ retval = MPSSE_FAIL;
+ }
+ return retval;
+}
+/*
+ * Sets the appropriate divisor for the desired clock frequency.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @freq - Desired clock frequency in hertz.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int SetClock(struct mpsse_context* mpsse, uint32_t freq) {
+ int retval = MPSSE_FAIL;
+ uint32_t system_clock = 0;
+ uint16_t divisor = 0;
+ uint8_t buf[CMD_SIZE] = {0};
+ /* Do not call is_valid_context() here, as the FTDI chip may not be completely
+ * configured when SetClock is called */
+ if (mpsse) {
+ if (freq > SIX_MHZ) {
+ buf[0] = TCK_X5;
+ system_clock = SIXTY_MHZ;
+ } else {
+ buf[0] = TCK_D5;
+ system_clock = TWELVE_MHZ;
+ }
+ if (raw_write(mpsse, buf, 1) == MPSSE_OK) {
+ if (freq <= 0) {
+ divisor = 0xFFFF;
+ } else {
+ divisor = freq2div(system_clock, freq);
+ }
+ buf[0] = TCK_DIVISOR;
+ buf[1] = (divisor & 0xFF);
+ buf[2] = ((divisor >> 8) & 0xFF);
+ if (raw_write(mpsse, buf, 3) == MPSSE_OK) {
+ mpsse->clock = div2freq(system_clock, divisor);
+ retval = MPSSE_OK;
+ }
+ }
+ }
+ return retval;
+}
+/*
+ * Retrieves the last error string from libftdi.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns a pointer to the last error string.
+ */
+const char* ErrorString(struct mpsse_context* mpsse) {
+ if (mpsse != NULL) {
+ return ftdi_get_error_string(&mpsse->ftdi);
+ }
+ return NULL_CONTEXT_ERROR_MSG;
+}
+/*
+ * Gets the currently configured clock rate.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns the existing clock rate in hertz.
+ */
+int GetClock(struct mpsse_context* mpsse) {
+ int clock = 0;
+ if (is_valid_context(mpsse)) {
+ clock = mpsse->clock;
+ }
+ return clock;
+}
+/*
+ * Returns the vendor ID of the FTDI chip.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns the integer value of the vendor ID.
+ */
+int GetVid(struct mpsse_context* mpsse) {
+ int vid = 0;
+ if (is_valid_context(mpsse)) {
+ vid = mpsse->vid;
+ }
+ return vid;
+}
+/*
+ * Returns the product ID of the FTDI chip.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns the integer value of the product ID.
+ */
+int GetPid(struct mpsse_context* mpsse) {
+ int pid = 0;
+ if (is_valid_context(mpsse)) {
+ pid = mpsse->pid;
+ }
+ return pid;
+}
+/*
+ * Returns the description of the FTDI chip, if any.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns the description of the FTDI chip.
+ */
+const char* GetDescription(struct mpsse_context* mpsse) {
+ const char* description = NULL;
+ if (is_valid_context(mpsse)) {
+ description = mpsse->description;
+ }
+ return description;
+}
+/*
+ * Enable / disable internal loopback.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @enable - Zero to disable loopback, 1 to enable loopback.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int SetLoopback(struct mpsse_context* mpsse, int enable) {
+ uint8_t buf[1] = {0};
+ int retval = MPSSE_FAIL;
+ if (is_valid_context(mpsse)) {
+ if (enable) {
+ buf[0] = LOOPBACK_START;
+ } else {
+ buf[0] = LOOPBACK_END;
+ }
+ retval = raw_write(mpsse, buf, 1);
+ }
+ return retval;
+}
+/*
+ * Sets the idle state of the chip select pin. CS idles high by default.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @idle - Set to 1 to idle high, 0 to idle low.
+ *
+ * Returns void.
+ */
+void SetCSIdle(struct mpsse_context* mpsse, int idle) {
+ if (is_valid_context(mpsse)) {
+ if (idle > 0) {
+ /* Chip select idles high, active low */
+ mpsse->pidle |= CS;
+ mpsse->pstop |= CS;
+ mpsse->pstart &= ~CS;
+ } else {
+ /* Chip select idles low, active high */
+ mpsse->pidle &= ~CS;
+ mpsse->pstop &= ~CS;
+ mpsse->pstart |= CS;
+ }
+ }
+ return;
+}
+/*
+ * Enables or disables flushing of the FTDI chip's RX buffers after each read
+ *operation.
+ * Flushing is disable by default.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @tf - Set to 1 to enable flushing, or 0 to disable flushing.
+ *
+ * Returns void.
+ */
+void FlushAfterRead(struct mpsse_context* mpsse, int tf) {
+ mpsse->flush_after_read = tf;
+ return;
+}
+/*
+ * Send data start condition.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int Start(struct mpsse_context* mpsse) {
+ int status = MPSSE_OK;
+ if (is_valid_context(mpsse)) {
+ if (mpsse->mode == I2C && mpsse->status == STARTED) {
+ /* Set the default pin states while the clock is low since this is an I2C
+ * repeated start condition */
+ status |= set_bits_low(mpsse, (mpsse->pidle & ~SK));
+ /* Make sure the pins are in their default idle state */
+ status |= set_bits_low(mpsse, mpsse->pidle);
+ }
+ /* Set the start condition */
+ status |= set_bits_low(mpsse, mpsse->pstart);
+ /*
+ * Hackish work around to properly support SPI mode 3.
+ * SPI3 clock idles high, but needs to be set low before sending out
+ * data to prevent unintenteded clock glitches from the FT2232.
+ */
+ if (mpsse->mode == SPI3) {
+ status |= set_bits_low(mpsse, (mpsse->pstart & ~SK));
+ }
+ /*
+ * Hackish work around to properly support SPI mode 1.
+ * SPI1 clock idles low, but needs to be set high before sending out
+ * data to preven unintended clock glitches from the FT2232.
+ */
+ else if (mpsse->mode == SPI1) {
+ status |= set_bits_low(mpsse, (mpsse->pstart | SK));
+ }
+ mpsse->status = STARTED;
+ } else {
+ status = MPSSE_FAIL;
+ mpsse->status = STOPPED;
+ }
+ return status;
+}
+/*
+ * Performs a bit-wise write of up to 8 bits at a time.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @bits - A byte containing the desired bits to write.
+ * @size - The number of bits from the 'bits' byte to write.
+ *
+ * Returns MPSSE_OK on success, MPSSE_FAIL on failure.
+ */
+int WriteBits(struct mpsse_context* mpsse, char bits, size_t size) {
+ uint8_t data[8] = {0};
+ size_t i = 0;
+ int retval = MPSSE_OK;
+ if (size > sizeof(data)) {
+ size = sizeof(data);
+ }
+ /* Convert each bit in bits to an array of bytes */
+ for (i = 0; i < size; i++) {
+ if (bits & (1 << i)) {
+ /* Be sure to honor endianess */
+ if (mpsse->endianess == LSB) {
+ data[i] = '\xFF';
+ } else {
+ data[size - i - 1] = '\xFF';
+ }
+ }
+ }
+ /* Enable bit mode before writing, then disable it afterwards. */
+ EnableBitmode(mpsse, 1);
+ retval = Write(mpsse, data, size);
+ EnableBitmode(mpsse, 0);
+ return retval;
+}
+/*
+ * Send data out via the selected serial protocol.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @data - Buffer of data to send.
+ * @size - Size of data.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int Write(struct mpsse_context* mpsse, const void* vdata, int size) {
+ const uint8_t* data = vdata;
+ uint8_t* buf = NULL;
+ int retval = MPSSE_FAIL, buf_size = 0, txsize = 0, n = 0;
+ if (is_valid_context(mpsse)) {
+ if (mpsse->mode) {
+ while (n < size) {
+ txsize = size - n;
+ if (txsize > mpsse->xsize) {
+ txsize = mpsse->xsize;
+ }
+ /*
+ * For I2C we need to send each byte individually so that we can
+ * read back each individual ACK bit, so set the transmit size to 1.
+ */
+ if (mpsse->mode == I2C) {
+ txsize = 1;
+ }
+ buf = build_block_buffer(mpsse, mpsse->tx, data + n, txsize, &buf_size);
+ if (buf) {
+ retval = raw_write(mpsse, buf, buf_size);
+ n += txsize;
+ free(buf);
+ if (retval == MPSSE_FAIL) {
+ break;
+ }
+ /* Read in the ACK bit and store it in mpsse->rack */
+ if (mpsse->mode == I2C) {
+ raw_read(mpsse, (uint8_t*)&mpsse->rack, 1);
+ }
+ } else {
+ break;
+ }
+ }
+ }
+ if (retval == MPSSE_OK && n == size) {
+ retval = MPSSE_OK;
+ }
+ }
+ return retval;
+}
+/* Performs a read. For internal use only; see Read() and ReadBits(). */
+static uint8_t* InternalRead(struct mpsse_context* mpsse, int size) {
+ uint8_t *data = NULL, *buf = NULL;
+ uint8_t sbuf[SPI_RW_SIZE] = {0};
+ int n = 0, rxsize = 0, data_size = 0, retval = 0;
+ if (is_valid_context(mpsse)) {
+ if (mpsse->mode) {
+ buf = malloc(size);
+ if (buf) {
+ memset(buf, 0, size);
+ while (n < size) {
+ rxsize = size - n;
+ if (rxsize > mpsse->xsize) {
+ rxsize = mpsse->xsize;
+ }
+ data = build_block_buffer(mpsse, mpsse->rx, sbuf, rxsize, &data_size);
+ if (data) {
+ retval = raw_write(mpsse, data, data_size);
+ free(data);
+ if (retval == MPSSE_OK) {
+ n += raw_read(mpsse, buf + n, rxsize);
+ } else {
+ break;
+ }
+ } else {
+ break;
+ }
+ }
+ }
+ }
+ }
+ return buf;
+}
+/*
+ * Reads data over the selected serial protocol.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @size - Number of bytes to read.
+ *
+ * Returns a pointer to the read data on success.
+ * Returns NULL on failure.
+ */
+#ifdef SWIGPYTHON
+swig_string_data Read(struct mpsse_context* mpsse, int size)
+#else
+uint8_t* Read(struct mpsse_context* mpsse, int size)
+#endif
+{
+ uint8_t* buf = NULL;
+ buf = InternalRead(mpsse, size);
+#ifdef SWIGPYTHON
+ swig_string_data sdata = {0};
+ sdata.size = size;
+ sdata.data = buf;
+ return sdata;
+#else
+ return buf;
+#endif
+}
+/*
+ * Performs a bit-wise read of up to 8 bits.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @size - Number of bits to read.
+ *
+ * Returns an 8-bit byte containing the read bits.
+ */
+char ReadBits(struct mpsse_context* mpsse, int size) {
+ char bits = 0;
+ uint8_t* rdata = NULL;
+ if (size > 8) {
+ size = 8;
+ }
+ EnableBitmode(mpsse, 1);
+ rdata = InternalRead(mpsse, size);
+ EnableBitmode(mpsse, 0);
+ if (rdata) {
+ /* The last byte in rdata will have all the read bits set or unset as
+ * needed. */
+ bits = rdata[size - 1];
+ if (mpsse->endianess == MSB) {
+ /*
+ * In MSB mode, bits are sifted in from the left. If less than 8 bits were
+ * read, we need to shift them left accordingly.
+ */
+ bits = bits << (8 - size);
+ } else if (mpsse->endianess == LSB) {
+ /*
+ * In LSB mode, bits are shifted in from the right. If less than 8 bits
+ * were
+ * read, we need to shift them right accordingly.
+ */
+ bits = bits >> (8 - size);
+ }
+ free(rdata);
+ }
+ return bits;
+}
+/*
+ * Reads and writes data over the selected serial protocol (SPI only).
+ *
+ * @mpsse - MPSSE context pointer.
+ * @data - Buffer containing bytes to write.
+ * @size - Number of bytes to transfer.
+ *
+ * Returns a pointer to the read data on success.
+ * Returns NULL on failure.
+ */
+#ifdef SWIGPYTHON
+swig_string_data Transfer(struct mpsse_context* mpsse, char* data, int size)
+#else
+uint8_t* Transfer(struct mpsse_context* mpsse, uint8_t* data, int size)
+#endif
+{
+ uint8_t *txdata = NULL, *buf = NULL;
+ int n = 0, data_size = 0, rxsize = 0, retval = 0;
+ if (is_valid_context(mpsse)) {
+ /* Make sure we're configured for one of the SPI modes */
+ if (mpsse->mode >= SPI0 && mpsse->mode <= SPI3) {
+ buf = malloc(size);
+ if (buf) {
+ memset(buf, 0, size);
+ while (n < size) {
+ /* When sending and recieving, FTDI chips don't seem to like large
+ * data blocks. Limit the size of each block to SPI_TRANSFER_SIZE */
+ rxsize = size - n;
+ if (rxsize > SPI_TRANSFER_SIZE) {
+ rxsize = SPI_TRANSFER_SIZE;
+ }
+ txdata =
+ build_block_buffer(mpsse, mpsse->txrx, data + n,
+ rxsize, &data_size);
+ if (txdata) {
+ retval = raw_write(mpsse, txdata, data_size);
+ free(txdata);
+ if (retval == MPSSE_OK) {
+ n += raw_read(mpsse, (buf + n), rxsize);
+ } else {
+ break;
+ }
+ } else {
+ break;
+ }
+ }
+ }
+ }
+ }
+#ifdef SWIGPYTHON
+ swig_string_data sdata = {0};
+ sdata.size = n;
+ sdata.data = (char*)buf;
+ return sdata;
+#else
+ return buf;
+#endif
+}
+/*
+ * Returns the last received ACK bit.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns either an ACK (0) or a NACK (1).
+ */
+int GetAck(struct mpsse_context* mpsse) {
+ int ack = 0;
+ if (is_valid_context(mpsse)) {
+ ack = (mpsse->rack & 0x01);
+ }
+ return ack;
+}
+/*
+ * Sets the transmitted ACK bit.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @ack - 0 to send ACKs, 1 to send NACKs.
+ *
+ * Returns void.
+ */
+void SetAck(struct mpsse_context* mpsse, int ack) {
+ if (is_valid_context(mpsse)) {
+ if (ack == NACK) {
+ mpsse->tack = 0xFF;
+ } else {
+ mpsse->tack = 0x00;
+ }
+ }
+ return;
+}
+/*
+ * Causes libmpsse to send ACKs after each read byte in I2C mode.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns void.
+ */
+void SendAcks(struct mpsse_context* mpsse) {
+ return SetAck(mpsse, ACK);
+}
+/*
+ * Causes libmpsse to send NACKs after each read byte in I2C mode.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns void.
+ */
+void SendNacks(struct mpsse_context* mpsse) {
+ return SetAck(mpsse, NACK);
+}
+/*
+ * Send data stop condition.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int Stop(struct mpsse_context* mpsse) {
+ int retval = MPSSE_OK;
+ if (is_valid_context(mpsse)) {
+ /* In I2C mode, we need to ensure that the data line goes low while the
+ * clock line is low to avoid sending an inadvertent start condition */
+ if (mpsse->mode == I2C) {
+ retval |= set_bits_low(mpsse, (mpsse->pidle & ~DO & ~SK));
+ }
+ /* Send the stop condition */
+ retval |= set_bits_low(mpsse, mpsse->pstop);
+ if (retval == MPSSE_OK) {
+ /* Restore the pins to their idle states */
+ retval |= set_bits_low(mpsse, mpsse->pidle);
+ }
+ mpsse->status = STOPPED;
+ } else {
+ retval = MPSSE_FAIL;
+ mpsse->status = STOPPED;
+ }
+ return retval;
+}
+/*
+ * Sets the specified pin high.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @pin - Pin number to set high.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int PinHigh(struct mpsse_context* mpsse, int pin) {
+ int retval = MPSSE_FAIL;
+ if (is_valid_context(mpsse)) {
+ retval = gpio_write(mpsse, pin, HIGH);
+ }
+ return retval;
+}
+/*
+ * Sets the specified pin low.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @pin - Pin number to set low.
+ *
+ * Returns MPSSE_OK on success.
+ * Returns MPSSE_FAIL on failure.
+ */
+int PinLow(struct mpsse_context* mpsse, int pin) {
+ int retval = MPSSE_FAIL;
+ if (is_valid_context(mpsse)) {
+ retval = gpio_write(mpsse, pin, LOW);
+ }
+ return retval;
+}
+/*
+ * Sets the input/output direction of all pins. For use in BITBANG mode only.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @direction - Byte indicating input/output direction of each bit. 1 is out.
+ *
+ * Returns MPSSE_OK if direction could be set, MPSSE_FAIL otherwise.
+ */
+int SetDirection(struct mpsse_context* mpsse, uint8_t direction) {
+ int retval = MPSSE_FAIL;
+ if (is_valid_context(mpsse)) {
+ if (mpsse->mode == BITBANG) {
+ if (ftdi_set_bitmode(&mpsse->ftdi, direction, BITMODE_BITBANG) == 0) {
+ retval = MPSSE_OK;
+ }
+ }
+ }
+ return retval;
+}
+/*
+ * Sets the input/output value of all pins. For use in BITBANG mode only.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @data - Byte indicating bit hi/low value of each bit.
+ *
+ * Returns MPSSE_OK if direction could be set, MPSSE_FAIL otherwise.
+ */
+int WritePins(struct mpsse_context* mpsse, uint8_t data) {
+ int retval = MPSSE_FAIL;
+ if (is_valid_context(mpsse)) {
+ if (mpsse->mode == BITBANG) {
+ if (ftdi_write_data(&mpsse->ftdi, &data, 1) == 0) {
+ retval = MPSSE_OK;
+ }
+ }
+ }
+ return retval;
+}
+/*
+ * Reads the state of the chip's pins. For use in BITBANG mode only.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns a byte with the corresponding pin's bits set to 1 or 0.
+ */
+int ReadPins(struct mpsse_context* mpsse) {
+ uint8_t val = 0;
+ if (is_valid_context(mpsse)) {
+ ftdi_read_pins((struct ftdi_context*)&mpsse->ftdi, (uint8_t*)&val);
+ }
+ return (int)val;
+}
+/*
+ * Checks if a specific pin is high or low. For use in BITBANG mode only.
+ *
+ * @mpsse - MPSSE context pointer.
+ * @pin - The pin number.
+ * @state - The state of the pins, as returned by ReadPins.
+ * If set to -1, ReadPins will automatically be called.
+ *
+ * Returns a 1 if the pin is high, 0 if the pin is low.
+ */
+int PinState(struct mpsse_context* mpsse, int pin, int state) {
+ if (state == -1) {
+ state = ReadPins(mpsse);
+ }
+ /* If not in bitbang mode, the specified pin should be one of GPIOLx. Convert
+ * these defines into an absolute pin number. */
+ if (mpsse->mode != BITBANG) {
+ pin += NUM_GPIOL_PINS;
+ }
+ return ((state & (1 << pin)) >> pin);
+}
+/*
+ * Places all I/O pins into a tristate mode.
+ *
+ * @mpsse - MPSSE context pointer.
+ *
+ * Returns MPSSE_OK on success, MPSSE_FAIL on failure.
+ */
+int Tristate(struct mpsse_context* mpsse) {
+ uint8_t cmd[CMD_SIZE] = {0};
+ /* Tristate the all I/O pins (FT232H only) */
+ cmd[0] = TRISTATE_IO;
+ cmd[1] = 0xFF;
+ cmd[2] = 0xFF;
+ return raw_write(mpsse, cmd, sizeof(cmd));
+}
diff --git a/sw/host/vendor/mpsse/mpsse.h b/sw/host/vendor/mpsse/mpsse.h
new file mode 100644
index 0000000..eeeb49e
--- /dev/null
+++ b/sw/host/vendor/mpsse/mpsse.h
@@ -0,0 +1,224 @@
+/*
+ Copyright (C) 2015 The Android Open Source Project
+
+ Licensed 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.
+ */
+ /*
+ * This file was copied from https://github.com/devttys0/libmpsse.git (sha1
+ * f1a6744b), and modified to suite the Chromium OS project.
+ */
+#ifndef TRUNKS_FTDI_MPSSE_H_
+#define TRUNKS_FTDI_MPSSE_H_
+#include <libftdi1/ftdi.h>
+#include <stdint.h>
+#define MPSSE_OK 0
+#define MPSSE_FAIL -1
+#define MSB 0x00
+#define LSB 0x08
+#define CHUNK_SIZE 65535
+#define SPI_RW_SIZE (63 * 1024)
+#define SPI_TRANSFER_SIZE 512
+#define I2C_TRANSFER_SIZE 64
+#define LATENCY_MS 2
+#define TIMEOUT_DIVISOR 1000000
+#define USB_TIMEOUT 120000
+#define SETUP_DELAY 25000
+#define BITMODE_RESET 0
+#define BITMODE_MPSSE 2
+#define CMD_SIZE 3
+#define MAX_SETUP_COMMANDS 10
+#define SS_TX_COUNT 3
+#define LOW 0
+#define HIGH 1
+#define NUM_GPIOL_PINS 4
+#define NUM_GPIO_PINS 12
+#define NULL_CONTEXT_ERROR_MSG "NULL MPSSE context pointer!"
+#ifdef __cplusplus
+extern "C" {
+#endif
+/* FTDI interfaces */
+enum interface {
+ IFACE_ANY = INTERFACE_ANY,
+ IFACE_A = INTERFACE_A,
+ IFACE_B = INTERFACE_B,
+ IFACE_C = INTERFACE_C,
+ IFACE_D = INTERFACE_D
+};
+/* Common clock rates */
+enum clock_rates {
+ ONE_HUNDRED_KHZ = 100000,
+ FOUR_HUNDRED_KHZ = 400000,
+ ONE_MHZ = 1000000,
+ TWO_MHZ = 2000000,
+ FIVE_MHZ = 5000000,
+ SIX_MHZ = 6000000,
+ TEN_MHZ = 10000000,
+ TWELVE_MHZ = 12000000,
+ FIFTEEN_MHZ = 15000000,
+ THIRTY_MHZ = 30000000,
+ SIXTY_MHZ = 60000000
+};
+/* Supported MPSSE modes */
+enum modes {
+ SPI0 = 1,
+ SPI1 = 2,
+ SPI2 = 3,
+ SPI3 = 4,
+ I2C = 5,
+ GPIO = 6,
+ BITBANG = 7,
+};
+enum pins {
+ SK = 1,
+ DO = 2,
+ DI = 4,
+ CS = 8,
+ GPIO0 = 16,
+ GPIO1 = 32,
+ GPIO2 = 64,
+ GPIO3 = 128
+};
+enum gpio_pins {
+ GPIOL0 = 0,
+ GPIOL1 = 1,
+ GPIOL2 = 2,
+ GPIOL3 = 3,
+ GPIOH0 = 4,
+ GPIOH1 = 5,
+ GPIOH2 = 6,
+ GPIOH3 = 7,
+ GPIOH4 = 8,
+ GPIOH5 = 9,
+ GPIOH6 = 10,
+ GPIOH7 = 11
+};
+enum i2c_ack { ACK = 0, NACK = 1 };
+/* SK/DO/CS and GPIOs are outputs, DI is an input */
+#define DEFAULT_TRIS (SK | DO | CS | GPIO0 | GPIO1 | GPIO2 | GPIO3)
+#define DEFAULT_PORT (SK | CS) /* SK and CS are high, all others low */
+enum mpsse_commands {
+ INVALID_COMMAND = 0xAB,
+ ENABLE_ADAPTIVE_CLOCK = 0x96,
+ DISABLE_ADAPTIVE_CLOCK = 0x97,
+ ENABLE_3_PHASE_CLOCK = 0x8C,
+ DISABLE_3_PHASE_CLOCK = 0x8D,
+ TCK_X5 = 0x8A,
+ TCK_D5 = 0x8B,
+ CLOCK_N_CYCLES = 0x8E,
+ CLOCK_N8_CYCLES = 0x8F,
+ PULSE_CLOCK_IO_HIGH = 0x94,
+ PULSE_CLOCK_IO_LOW = 0x95,
+ CLOCK_N8_CYCLES_IO_HIGH = 0x9C,
+ CLOCK_N8_CYCLES_IO_LOW = 0x9D,
+ TRISTATE_IO = 0x9E,
+};
+enum low_bits_status { STARTED, STOPPED };
+struct vid_pid {
+ int vid;
+ int pid;
+ const char* description;
+};
+struct mpsse_context {
+ const char* description;
+ struct ftdi_context ftdi;
+ enum modes mode;
+ enum low_bits_status status;
+ int flush_after_read;
+ int vid;
+ int pid;
+ int clock;
+ int xsize;
+ uint8_t endianess;
+ uint8_t opened;
+ uint8_t tris;
+ uint8_t pstart;
+ uint8_t pstop;
+ uint8_t pidle;
+ uint8_t gpioh;
+ uint8_t trish;
+ uint8_t bitbang;
+ uint8_t tx;
+ uint8_t rx;
+ uint8_t txrx;
+ uint8_t tack;
+ uint8_t rack;
+};
+struct mpsse_context* MPSSE(enum modes mode, int freq, int endianess);
+struct mpsse_context* Open(int vid,
+ int pid,
+ enum modes mode,
+ int freq,
+ int endianess,
+ int interface,
+ const char* description,
+ const char* serial);
+struct mpsse_context* OpenIndex(int vid,
+ int pid,
+ enum modes mode,
+ int freq,
+ int endianess,
+ int interface,
+ const char* description,
+ const char* serial,
+ int index);
+void Close(struct mpsse_context* mpsse);
+const char* ErrorString(struct mpsse_context* mpsse);
+int SetMode(struct mpsse_context* mpsse, int endianess);
+void EnableBitmode(struct mpsse_context* mpsse, int tf);
+int SetClock(struct mpsse_context* mpsse, uint32_t freq);
+int GetClock(struct mpsse_context* mpsse);
+int GetVid(struct mpsse_context* mpsse);
+int GetPid(struct mpsse_context* mpsse);
+const char* GetDescription(struct mpsse_context* mpsse);
+int SetLoopback(struct mpsse_context* mpsse, int enable);
+void SetCSIdle(struct mpsse_context* mpsse, int idle);
+int Start(struct mpsse_context* mpsse);
+int Write(struct mpsse_context* mpsse, const void* data, int size);
+int Stop(struct mpsse_context* mpsse);
+int GetAck(struct mpsse_context* mpsse);
+void SetAck(struct mpsse_context* mpsse, int ack);
+void SendAcks(struct mpsse_context* mpsse);
+void SendNacks(struct mpsse_context* mpsse);
+void FlushAfterRead(struct mpsse_context* mpsse, int tf);
+int PinHigh(struct mpsse_context* mpsse, int pin);
+int PinLow(struct mpsse_context* mpsse, int pin);
+int SetDirection(struct mpsse_context* mpsse, uint8_t direction);
+int WriteBits(struct mpsse_context* mpsse, char bits, size_t size);
+char ReadBits(struct mpsse_context* mpsse, int size);
+int WritePins(struct mpsse_context* mpsse, uint8_t data);
+int ReadPins(struct mpsse_context* mpsse);
+int PinState(struct mpsse_context* mpsse, int pin, int state);
+int Tristate(struct mpsse_context* mpsse);
+char Version(void);
+#ifdef SWIGPYTHON
+typedef struct swig_string_data {
+ int size;
+ char* data;
+} swig_string_data;
+swig_string_data Read(struct mpsse_context* mpsse, int size);
+swig_string_data Transfer(struct mpsse_context* mpsse, char* data, int size);
+#else
+uint8_t* Read(struct mpsse_context* mpsse, int size);
+uint8_t* Transfer(struct mpsse_context* mpsse,
+ uint8_t* data, int size);
+int FastWrite(struct mpsse_context* mpsse, char* data, int size);
+int FastRead(struct mpsse_context* mpsse, char* data, int size);
+int FastTransfer(struct mpsse_context* mpsse,
+ char* wdata,
+ char* rdata,
+ int size);
+#endif
+#ifdef __cplusplus
+}
+#endif
+#endif /* TRUNKS_FTDI_MPSSE_H_ */
diff --git a/sw/host/vendor/mpsse/support.c b/sw/host/vendor/mpsse/support.c
new file mode 100644
index 0000000..930d7aa
--- /dev/null
+++ b/sw/host/vendor/mpsse/support.c
@@ -0,0 +1,232 @@
+/*
+ *
+ *Copyright (C) 2015 The Android Open Source Project
+ *
+ *Licensed 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.
+ *
+ *
+ * This file was copied from https://github.com/devttys0/libmpsse.git (sha1
+ * f1a6744b), and modified to suite the Chromium OS project.
+ *
+ * Internal functions used by libmpsse.
+ *
+ * Craig Heffner
+ * 27 December 2011
+ */
+#include "support.h"
+
+#include <stdlib.h>
+#include <string.h>
+/* Write data to the FTDI chip */
+int raw_write(struct mpsse_context* mpsse, uint8_t* buf, int size) {
+ int retval = MPSSE_FAIL;
+ if (mpsse->mode) {
+ if (ftdi_write_data(&mpsse->ftdi, buf, size) == size) {
+ retval = MPSSE_OK;
+ }
+ }
+ return retval;
+}
+/* Read data from the FTDI chip */
+int raw_read(struct mpsse_context* mpsse, uint8_t* buf, int size) {
+ int n = 0, r = 0;
+ if (mpsse->mode) {
+ while (n < size) {
+ r = ftdi_read_data(&mpsse->ftdi, buf, size);
+ if (r < 0)
+ break;
+ n += r;
+ }
+ if (mpsse->flush_after_read) {
+ /*
+ * Make sure the buffers are cleared after a read or subsequent reads may
+ *fail.
+ *
+ * Is this needed anymore? It slows down repetitive read operations by
+ *~8%.
+ */
+ ftdi_usb_purge_rx_buffer(&mpsse->ftdi);
+ }
+ }
+ return n;
+}
+/* Sets the read and write timeout periods for bulk usb data transfers. */
+void set_timeouts(struct mpsse_context* mpsse, int timeout) {
+ if (mpsse->mode) {
+ mpsse->ftdi.usb_read_timeout = timeout;
+ mpsse->ftdi.usb_write_timeout = timeout;
+ }
+ return;
+}
+/* Convert a frequency to a clock divisor */
+uint16_t freq2div(uint32_t system_clock, uint32_t freq) {
+ return (((system_clock / freq) / 2) - 1);
+}
+/* Convert a clock divisor to a frequency */
+uint32_t div2freq(uint32_t system_clock, uint16_t div) {
+ return (system_clock / ((1 + div) * 2));
+}
+/* Builds a buffer of commands + data blocks */
+uint8_t* build_block_buffer(struct mpsse_context* mpsse,
+ uint8_t cmd,
+ const uint8_t* data,
+ int size,
+ int* buf_size) {
+ uint8_t* buf = NULL;
+ int i = 0, j = 0, k = 0, dsize = 0, num_blocks = 0, total_size = 0,
+ xfer_size = 0;
+ uint16_t rsize = 0;
+ *buf_size = 0;
+ /* Data block size is 1 in I2C, or when in bitmode */
+ if (mpsse->mode == I2C || (cmd & MPSSE_BITMODE)) {
+ xfer_size = 1;
+ } else {
+ xfer_size = mpsse->xsize;
+ }
+ num_blocks = (size / xfer_size);
+ if (size % xfer_size) {
+ num_blocks++;
+ }
+ /* The total size of the data will be the data size + the write command */
+ total_size = size + (CMD_SIZE * num_blocks);
+ /* In I2C we have to add 3 additional commands per data block */
+ if (mpsse->mode == I2C) {
+ total_size += (CMD_SIZE * 3 * num_blocks);
+ }
+ buf = malloc(total_size);
+ if (buf) {
+ memset(buf, 0, total_size);
+ for (j = 0; j < num_blocks; j++) {
+ dsize = size - k;
+ if (dsize > xfer_size) {
+ dsize = xfer_size;
+ }
+ /* The reported size of this block is block size - 1 */
+ rsize = dsize - 1;
+ /* For I2C we need to ensure that the clock pin is set low prior to
+ * clocking out data */
+ if (mpsse->mode == I2C) {
+ buf[i++] = SET_BITS_LOW;
+ buf[i++] = mpsse->pstart & ~SK;
+ /* On receive, we need to ensure that the data out line is set as an
+ * input to avoid contention on the bus */
+ if (cmd == mpsse->rx) {
+ buf[i++] = mpsse->tris & ~DO;
+ } else {
+ buf[i++] = mpsse->tris;
+ }
+ }
+ /* Copy in the command for this block */
+ buf[i++] = cmd;
+ buf[i++] = (rsize & 0xFF);
+ if (!(cmd & MPSSE_BITMODE)) {
+ buf[i++] = ((rsize >> 8) & 0xFF);
+ }
+ /* On a write, copy the data to transmit after the command */
+ if (cmd == mpsse->tx || cmd == mpsse->txrx) {
+ memcpy(buf + i, data + k, dsize);
+ /* i == offset into buf */
+ i += dsize;
+ /* k == offset into data */
+ k += dsize;
+ }
+ /* In I2C mode we need to clock one ACK bit after each byte */
+ if (mpsse->mode == I2C) {
+ /* If we are receiving data, then we need to clock out an ACK for each
+ * byte */
+ if (cmd == mpsse->rx) {
+ buf[i++] = SET_BITS_LOW;
+ buf[i++] = mpsse->pstart & ~SK;
+ buf[i++] = mpsse->tris;
+ buf[i++] = mpsse->tx | MPSSE_BITMODE;
+ buf[i++] = 0;
+ buf[i++] = mpsse->tack;
+ }
+ /* If we are sending data, then we need to clock in an ACK for each byte
+ */
+ else if (cmd == mpsse->tx) {
+ /* Need to make data out an input to avoid contention on the bus when
+ * the slave sends an ACK */
+ buf[i++] = SET_BITS_LOW;
+ buf[i++] = mpsse->pstart & ~SK;
+ buf[i++] = mpsse->tris & ~DO;
+ buf[i++] = mpsse->rx | MPSSE_BITMODE;
+ buf[i++] = 0;
+ buf[i++] = SEND_IMMEDIATE;
+ }
+ }
+ }
+ *buf_size = i;
+ }
+ return buf;
+}
+/* Set the low bit pins high/low */
+int set_bits_low(struct mpsse_context* mpsse, int port) {
+ char buf[CMD_SIZE] = {0};
+ buf[0] = SET_BITS_LOW;
+ buf[1] = port;
+ buf[2] = mpsse->tris;
+ return raw_write(mpsse, (uint8_t*)&buf, sizeof(buf));
+}
+/* Set the high bit pins high/low */
+int set_bits_high(struct mpsse_context* mpsse, int port) {
+ char buf[CMD_SIZE] = {0};
+ buf[0] = SET_BITS_HIGH;
+ buf[1] = port;
+ buf[2] = mpsse->trish;
+ return raw_write(mpsse, (uint8_t*)&buf, sizeof(buf));
+}
+/* Set the GPIO pins high/low */
+int gpio_write(struct mpsse_context* mpsse, int pin, int direction) {
+ int retval = MPSSE_FAIL;
+ if (mpsse->mode == BITBANG) {
+ if (direction == HIGH) {
+ mpsse->bitbang |= (1 << pin);
+ } else {
+ mpsse->bitbang &= ~(1 << pin);
+ }
+ if (set_bits_high(mpsse, mpsse->bitbang) == MPSSE_OK) {
+ retval = raw_write(mpsse, (uint8_t*)&mpsse->bitbang, 1);
+ }
+ } else {
+ /* The first four pins can't be changed unless we are in a stopped status */
+ if (pin < NUM_GPIOL_PINS && mpsse->status == STOPPED) {
+ /* Convert pin number (0-3) to the corresponding pin bit */
+ pin = (GPIO0 << pin);
+ if (direction == HIGH) {
+ mpsse->pstart |= pin;
+ mpsse->pidle |= pin;
+ mpsse->pstop |= pin;
+ } else {
+ mpsse->pstart &= ~pin;
+ mpsse->pidle &= ~pin;
+ mpsse->pstop &= ~pin;
+ }
+ retval = set_bits_low(mpsse, mpsse->pstop);
+ } else if (pin >= NUM_GPIOL_PINS && pin < NUM_GPIO_PINS) {
+ /* Convert pin number (4 - 11) to the corresponding pin bit */
+ pin -= NUM_GPIOL_PINS;
+ if (direction == HIGH) {
+ mpsse->gpioh |= (1 << pin);
+ } else {
+ mpsse->gpioh &= ~(1 << pin);
+ }
+ retval = set_bits_high(mpsse, mpsse->gpioh);
+ }
+ }
+ return retval;
+}
+/* Checks if a given MPSSE context is valid. */
+int is_valid_context(struct mpsse_context* mpsse) {
+ return mpsse != NULL;
+}
diff --git a/sw/host/vendor/mpsse/support.h b/sw/host/vendor/mpsse/support.h
new file mode 100644
index 0000000..949540c
--- /dev/null
+++ b/sw/host/vendor/mpsse/support.h
@@ -0,0 +1,42 @@
+/*
+ *
+ *Copyright (C) 2015 The Android Open Source Project
+ *
+ *Licensed 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.
+ *
+ *
+ * This file was copied from https://github.com/devttys0/libmpsse.git (sha1
+ * f1a6744b), and modified to suite the Chromium OS project.
+ */
+#ifndef TRUNKS_FTDI_SUPPORT_H_
+#define TRUNKS_FTDI_SUPPORT_H_
+
+#include <stddef.h>
+
+#include "mpsse.h"
+
+int raw_write(struct mpsse_context* mpsse, uint8_t* buf, int size);
+int raw_read(struct mpsse_context* mpsse, uint8_t* buf, int size);
+void set_timeouts(struct mpsse_context* mpsse, int timeout);
+uint16_t freq2div(uint32_t system_clock, uint32_t freq);
+uint32_t div2freq(uint32_t system_clock, uint16_t div);
+uint8_t* build_block_buffer(struct mpsse_context* mpsse,
+ uint8_t cmd,
+ const uint8_t* data,
+ int size,
+ int* buf_size);
+int set_bits_high(struct mpsse_context* mpsse, int port);
+int set_bits_low(struct mpsse_context* mpsse, int port);
+int gpio_write(struct mpsse_context* mpsse, int pin, int direction);
+int is_valid_context(struct mpsse_context* mpsse);
+#endif /* TRUNKS_FTDI_SUPPORT_H_ */
diff --git a/sw/lib/Makefile b/sw/lib/Makefile
new file mode 100644
index 0000000..922cd58
--- /dev/null
+++ b/sw/lib/Makefile
@@ -0,0 +1,61 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+DIF_SRCS = uart.c gpio.c spi_device.c flash_ctrl.c hmac.c usbdev.c rv_timer.c
+EXT_SRCS = usb_controlep.c usb_simpleserial.c irq.c handler.c
+EXT_ASMS = irq_vectors.S
+GENHDRS := ${DIF_SRCS:.c=_regs.h}
+GENHDR_BASE := ${DIF_SRCS:.c=}
+ARCH = rv32imc
+# ARCH = rv32im # to disable compressed instructions
+
+RV_TOOLS ?= /tools/riscv/bin/
+
+CC := ${RV_TOOLS}/riscv32-unknown-elf-gcc
+CFLAGS ?= -Wall -g -Os -march=$(ARCH) -mabi=ilp32 -static -mcmodel=medany \
+ -fvisibility=hidden -nostdlib -nostartfiles
+
+ifeq ($(SIM),1)
+ CFLAGS += -DSIMULATION
+endif
+
+AR := $(subst gcc,ar,$(wordlist 1,1,$(CC)))
+ARFLAGS := rc
+
+REGTOOL = ../../util/regtool.py
+
+OBJS := ${DIF_SRCS:.c=.o} ${EXT_SRCS:.c=.o} ${EXT_ASMS:.S=.o}
+DEPS = $(OBJS:%.o=%.d)
+
+OUTFILES = libot.a
+
+$(OUTFILES): $(OBJS)
+ $(AR) $(ARFLAGS) $@ $(OBJS)
+
+all: $(OUTFILES)
+
+%.o: %.c %.S
+ $(CC) $(CFLAGS) -MMD -c $(INCS) -o $@ $<
+
+define header_gen
+ $1.c: $1_regs.h
+
+ $1_regs.h: ../../hw/ip/$1/doc/*.hjson
+ if [ -f ../../hw/ip/$1/doc/$1.hjson ]; then \
+ $(REGTOOL) -D -o $1_regs.h ../../hw/ip/$1/doc/$1.hjson ; \
+ else \
+ $(REGTOOL) -D -o $1_regs.h ../../hw/ip/$1/doc/$1_reg.hjson ; \
+ fi
+endef
+$(foreach f,$(GENHDR_BASE),$(eval $(call header_gen,$f)))
+
+-include $(DEPS)
+
+clean:
+ $(RM) *.o *.d $(GENHDRS)
+
+distclean: clean
+ $(RM) $(OUTFILES)
diff --git a/sw/lib/common.h b/sw/lib/common.h
new file mode 100644
index 0000000..2b989f2
--- /dev/null
+++ b/sw/lib/common.h
@@ -0,0 +1,45 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _COMMON_H_
+#define _COMMON_H_
+
+#include <stdbool.h>
+#include <stdint.h>
+
+// Adjust clock speed to match simulation
+//#define SIMULATION
+
+#ifdef SIMULATION
+#define CLK_FIXED_FREQ_HZ (500 * 1000)
+static const unsigned long UART_BAUD_RATE = 9600;
+#else
+#define CLK_FIXED_FREQ_HZ (50ULL * 1000 * 1000)
+static const unsigned long UART_BAUD_RATE = 230400;
+#endif
+
+// Flash memory base defines, _SZ are presented in bytes
+#define FLASH_MEM_BASE_ADDR 0x20000000
+#define FLASH_WORDS_PER_PAGE 256
+#define FLASH_WORD_SZ 4
+#define FLASH_PAGE_SZ FLASH_WORDS_PER_PAGE *FLASH_WORD_SZ
+#define FLASH_PAGES_PER_BANK 256
+#define FLASH_BANK_SZ FLASH_PAGES_PER_BANK *FLASH_PAGE_SZ
+
+#define REG8(add) *((volatile uint8_t *)(add))
+#define REG16(add) *((volatile uint16_t *)(add))
+#define REG32(add) *((volatile uint32_t *)(add))
+#define SETBIT(val, bit) (val | 1 << bit)
+#define CLRBIT(val, bit) (val & ~(1 << bit))
+
+/* Hamming weight */
+#define BITLENGTH_1(X) ((X) - (((X) >> 1) & 0x55555555))
+#define BITLENGTH_2(X) (((X)&0x33333333) + (((X) >> 2) & 0x33333333))
+#define BITLENGTH_3(X) (((X) + ((X) >> 4)) & 0x0f0f0f0f)
+#define BITLENGTH_4(X) ((X) + ((X) >> 8))
+#define BITLENGTH_5(X) ((X) + ((X) >> 16))
+#define BITLENGTH(X) \
+ ((BITLENGTH_5(BITLENGTH_4(BITLENGTH_3(BITLENGTH_2(BITLENGTH_1(X)))))) & 0x7f)
+
+#endif
diff --git a/sw/lib/flash_ctrl.c b/sw/lib/flash_ctrl.c
new file mode 100644
index 0000000..a780a00
--- /dev/null
+++ b/sw/lib/flash_ctrl.c
@@ -0,0 +1,164 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "flash_ctrl.h"
+
+#include <stdint.h>
+
+#include "common.h"
+
+static uint32_t get_clr_err(void) {
+ uint32_t err_status;
+
+ // extract error status
+ err_status =
+ REG32(FLASH_CTRL_INTR_STATE(0)) & (0x1 << FLASH_CTRL_INTR_STATE_OP_ERROR);
+
+ // clear error if set
+ REG32(FLASH_CTRL_INTR_STATE(0)) = err_status;
+
+ // return status
+ return err_status;
+}
+
+// flash initialization done
+void wait_flash_init(void) {
+ while ((REG32(FLASH_CTRL_STATUS(0)) & (1 << FLASH_CTRL_STATUS_INIT_WIP)) >
+ 0) {
+ }
+}
+
+// wait for flash done and ack
+void wait_done_and_ack(void) {
+ while ((REG32(FLASH_CTRL_OP_STATUS(0)) & (1 << FLASH_CTRL_OP_STATUS_DONE)) ==
+ 0)
+ ;
+
+ REG32(FLASH_CTRL_OP_STATUS(0)) = 0;
+}
+
+// setup flash prog
+void setup_flash_prog(uint32_t addr, uint32_t num) {
+ uint32_t val;
+
+ val = FlashProg << FLASH_CTRL_CONTROL_OP_OFFSET |
+ (num - 1) << FLASH_CTRL_CONTROL_NUM_OFFSET |
+ 0x1 << FLASH_CTRL_CONTROL_START;
+
+ REG32(FLASH_CTRL_ADDR(0)) = addr;
+
+ REG32(FLASH_CTRL_CONTROL(0)) = val;
+}
+
+// program data
+uint32_t prog_flash(uint32_t addr, uint32_t num, uint32_t *data) {
+ uint32_t i = 0;
+
+ // setup flash programming
+ setup_flash_prog(addr, num);
+
+ // beginning filling up the fifo
+ for (i = 0; i < num; i++) {
+ REG32(FLASH_CTRL_PROG_FIFO(FLASH_CTRL0_BASE_ADDR)) = *data;
+ data++;
+ }
+
+ // wait for operation finish
+ wait_done_and_ack();
+
+ // return error status
+ return get_clr_err();
+}
+
+// read data
+uint32_t read_flash(uint32_t addr, uint32_t num, uint32_t *data) {
+ uint32_t val;
+ uint32_t i = 0;
+
+ // kick off flash operation
+ val = FlashRead << FLASH_CTRL_CONTROL_OP_OFFSET |
+ (num - 1) << FLASH_CTRL_CONTROL_NUM_OFFSET |
+ 0x1 << FLASH_CTRL_CONTROL_START;
+
+ REG32(FLASH_CTRL_ADDR(0)) = addr;
+
+ REG32(FLASH_CTRL_CONTROL(0)) = val;
+
+ while (i < num) {
+ // if not empty, read a word
+ if (((REG32(FLASH_CTRL_STATUS(0)) >> FLASH_CTRL_STATUS_RD_EMPTY) & 0x1) ==
+ 0) {
+ *data++ = REG32(FLASH_CTRL_RD_FIFO(FLASH_CTRL0_BASE_ADDR));
+ i++;
+ }
+ }
+
+ // wait for operation finish
+ wait_done_and_ack();
+
+ // return error status
+ return get_clr_err();
+}
+
+// page erase flash
+// wrap down to closest down to page boundary
+uint32_t page_erase(uint32_t addr) {
+ uint32_t val;
+ uint32_t data[ERASE_CHECK_WORDS];
+ uint32_t verify_rounds;
+ uint32_t error;
+
+ error = 0;
+ verify_rounds = WORDS_PER_PAGE / ERASE_CHECK_WORDS;
+
+ // kick off flash operation
+ val = FlashErase << FLASH_CTRL_CONTROL_OP_OFFSET |
+ PageErase << FLASH_CTRL_CONTROL_ERASE_SEL |
+ 0x1 << FLASH_CTRL_CONTROL_START;
+
+ REG32(FLASH_CTRL_ADDR(0)) = addr;
+
+ REG32(FLASH_CTRL_CONTROL(0)) = val;
+
+ // wait for operation finish
+ wait_done_and_ack();
+
+ error += get_clr_err();
+
+ // verify erase
+ for (uint32_t i = 0; i < verify_rounds; i++) {
+ error += read_flash(addr + i * ERASE_CHECK_WORDS * BYTES_PER_WORD,
+ ERASE_CHECK_WORDS, data);
+
+ for (uint32_t j = 0; j < ERASE_CHECK_WORDS; j++) {
+ if (data[i] != 0xFFFFFFFF) {
+ REG32(FLASH_CTRL_SCRATCH(0)) = data[i];
+
+ // re-init array
+ data[i] = 0;
+ error++;
+ }
+ }
+ }
+
+ // return error status
+ return error;
+}
+
+void flash_default_region(uint32_t rd_en, uint32_t prog_en, uint32_t erase_en) {
+ REG32(FLASH_CTRL_DEFAULT_REGION(0)) =
+ rd_en << FLASH_CTRL_DEFAULT_REGION_RD_EN |
+ prog_en << FLASH_CTRL_DEFAULT_REGION_PROG_EN |
+ erase_en << FLASH_CTRL_DEFAULT_REGION_ERASE_EN;
+}
+
+void flash_cfg_region(mp_region_t region_cfg) {
+ REG32(FLASH_CTRL_MP_REGION_CFG0(0) + region_cfg.num * 4) =
+ region_cfg.base << FLASH_CTRL_MP_REGION_CFG0_BASE0_OFFSET |
+ region_cfg.size << FLASH_CTRL_MP_REGION_CFG0_SIZE0_OFFSET |
+ region_cfg.rd_en << FLASH_CTRL_MP_REGION_CFG0_RD_EN0 |
+ region_cfg.prog_en << FLASH_CTRL_MP_REGION_CFG0_PROG_EN0 |
+ region_cfg.erase_en << FLASH_CTRL_MP_REGION_CFG0_ERASE_EN0 |
+ 0x1 << FLASH_CTRL_MP_REGION_CFG0_EN0;
+}
diff --git a/sw/lib/flash_ctrl.h b/sw/lib/flash_ctrl.h
new file mode 100644
index 0000000..21e90a1
--- /dev/null
+++ b/sw/lib/flash_ctrl.h
@@ -0,0 +1,43 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _FLASH_H_
+#define _FLASH_H_
+
+#include <stdint.h>
+
+#include "flash_ctrl_regs.h"
+
+#define FLASH_CTRL0_BASE_ADDR 0x40030000
+#define WORDS_PER_PAGE 256
+#define ERASE_CHECK_WORDS 16
+#define BYTES_PER_WORD 4
+
+typedef enum flash_op {
+ FlashRead = 0,
+ FlashProg = 1,
+ FlashErase = 2
+} flash_op_t;
+
+typedef enum erase_type { PageErase = 0, BankErase = 1 } erase_type_t;
+
+typedef struct mp_region {
+ uint32_t num; // which region to program
+ uint32_t base;
+ uint32_t size;
+ uint32_t rd_en;
+ uint32_t prog_en;
+ uint32_t erase_en;
+} mp_region_t;
+
+void wait_flash_init(void);
+void wait_done_and_ack(void);
+void setup_flash_prog(uint32_t addr, uint32_t num);
+uint32_t prog_flash(uint32_t addr, uint32_t num, uint32_t *data);
+uint32_t read_flash(uint32_t addr, uint32_t num, uint32_t *data);
+uint32_t page_erase(uint32_t addr);
+void flash_default_region(uint32_t rd_en, uint32_t prog_en, uint32_t erase_en);
+void flash_cfg_region(mp_region_t region_cfg);
+
+#endif
diff --git a/sw/lib/gpio.c b/sw/lib/gpio.c
new file mode 100644
index 0000000..a78fc4b
--- /dev/null
+++ b/sw/lib/gpio.c
@@ -0,0 +1,36 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "gpio.h"
+
+#include "assert.h"
+#include "common.h"
+
+/**
+ * @param oe bits to use as output
+ */
+void gpio_init(uint32_t oe) { REG32(GPIO_DIRECT_OE(0)) = oe; }
+
+void gpio_write_bit(unsigned int bit, unsigned int val) {
+ uint32_t mask = 0;
+ uint32_t reg_val = 0;
+ volatile uint32_t *gpio_masked_out_reg = 0;
+
+ if (bit < 16) {
+ gpio_masked_out_reg = (uint32_t *)GPIO_MASKED_OUT_LOWER(0);
+ } else if (bit < 32) {
+ gpio_masked_out_reg = (uint32_t *)GPIO_MASKED_OUT_UPPER(0);
+ } else {
+ assert(1 && "bit must be < 32");
+ }
+ bit %= 16;
+
+ mask = (1 << bit);
+ reg_val = (mask << 16) | ((val & 0x01) << bit);
+ *gpio_masked_out_reg = reg_val;
+}
+
+void gpio_write_all(uint32_t val) { REG32(GPIO_DIRECT_OUT(0)) = val; }
+
+uint32_t gpio_read(void) { return REG32(GPIO_DATA_IN(0)); }
diff --git a/sw/lib/gpio.h b/sw/lib/gpio.h
new file mode 100644
index 0000000..1397b5f
--- /dev/null
+++ b/sw/lib/gpio.h
@@ -0,0 +1,19 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _GPIO_H_
+#define _GPIO_H_
+
+#include <stdint.h>
+
+#include "gpio_regs.h"
+
+#define GPIO0_BASE_ADDR 0x40010000
+
+void gpio_init(uint32_t oe);
+void gpio_write_bit(unsigned int bit, unsigned int val);
+void gpio_write_all(uint32_t val);
+uint32_t gpio_read(void);
+
+#endif
diff --git a/sw/lib/handler.c b/sw/lib/handler.c
new file mode 100644
index 0000000..cefe4e5
--- /dev/null
+++ b/sw/lib/handler.c
@@ -0,0 +1,46 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "common.h"
+
+/**
+ * Default exception handler. Can be overidden.
+ */
+void handler_exception(void) __attribute__((aligned(4), interrupt, weak));
+
+/**
+ * SW IRQ handler. Can be overidden.
+ */
+void handler_irq_software(void) __attribute__((aligned(4), interrupt, weak));
+
+/**
+ * Timer IRQ handler. Can be overidden.
+ */
+void handler_irq_timer(void) __attribute__((aligned(4), interrupt, weak));
+
+/**
+ * external IRQ handler. Can be overidden.
+ */
+void handler_irq_external(void) __attribute__((aligned(4), interrupt, weak));
+
+// Below functions are default weak exception handlers meant to be overriden
+void handler_exception(void) {
+ while (1) {
+ }
+}
+
+void handler_irq_software(void) {
+ while (1) {
+ }
+}
+
+void handler_irq_timer(void) {
+ while (1) {
+ }
+}
+
+void handler_irq_external(void) {
+ while (1) {
+ }
+}
diff --git a/sw/lib/hmac.c b/sw/lib/hmac.c
new file mode 100644
index 0000000..7318c90
--- /dev/null
+++ b/sw/lib/hmac.c
@@ -0,0 +1,109 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "hmac.h"
+
+#include "common.h"
+#include "hmac_regs.h"
+
+#define HMAC0_BASE_ADDR 0x40120000
+#define HMAC_FIFO_MAX 16
+#define HMAC_FIFO_GROUP_SIZE HMAC_FIFO_MAX / 2
+
+void hmac_init(hmac_cfg_t hmac_cfg) {
+ REG32(HMAC_CFG(0)) = hmac_cfg.input_endian_swap << HMAC_CFG_ENDIAN_SWAP |
+ 1 << hmac_cfg.mode |
+ hmac_cfg.digest_endian_swap << HMAC_CFG_DIGEST_SWAP;
+
+ REG32(HMAC_MSG_LENGTH_LOWER(0)) = hmac_cfg.length_lower;
+ REG32(HMAC_MSG_LENGTH_UPPER(0)) = hmac_cfg.length_upper;
+
+ for (int i = 0; i < 8; i++) {
+ REG32(HMAC_KEY0(0) + i * sizeof(uint32_t)) = hmac_cfg.keys[i];
+ }
+
+ REG32(HMAC_CMD(0)) = -1;
+};
+
+int hmac_fifo_full(void) {
+ return (REG32(HMAC_STATUS(0)) >> HMAC_STATUS_FIFO_FULL) & 0x1;
+}
+
+static int hmac_fifo_depth(void) {
+ return (REG32(HMAC_STATUS(0)) >> HMAC_STATUS_FIFO_DEPTH_OFFSET) &
+ HMAC_STATUS_FIFO_DEPTH_MASK;
+}
+
+static int fifo_avail(void) { return HMAC_FIFO_MAX - hmac_fifo_depth(); }
+
+void hmac_write(const void *data, size_t size_in_bytes) {
+ const uint8_t *bp;
+ const uint32_t *wp;
+ uint32_t bytes_per_word = sizeof(uint32_t) / sizeof(uint8_t);
+ uint32_t bytes_left_over = (size_in_bytes % bytes_per_word);
+ size_t words_remaining = size_in_bytes / bytes_per_word;
+
+ wp = (uint32_t *)data;
+
+ // write in all words
+ while (words_remaining > 0) {
+ if (words_remaining > HMAC_FIFO_GROUP_SIZE) {
+ // wait until FIFO is at least half drained
+ while (fifo_avail() <= HMAC_FIFO_GROUP_SIZE) {
+ }
+
+ // write a whole group
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ words_remaining -= HMAC_FIFO_GROUP_SIZE;
+
+ } else {
+ REG32(HMAC_MSG_FIFO(0)) = *wp++;
+ words_remaining--;
+ };
+ }
+
+ // TODO: this is necessary because hmac only understands words right now, we
+ // cannot do a byte write. Once that is addressed, change following to
+ // byte writes directly
+ // Despite no byte support, it would have been okay to just read the entire
+ // word and write it to hmac, since hmac knows exactly which bytes to ignore /
+ // process. The problem however, is that the DV environment does not like
+ // reading of unknown data. So imagine if we have one byte (0xab) left over,
+ // in DV memory, this is represented as
+ // XXXX_XXab. Our environment assertions will fail when a full word read is
+ // made to the X's, thus it is converted to byte reads below to avoid that
+ // problem
+ uint32_t padded_word = 0;
+ uint8_t *last_word_ptr = (uint8_t *)&padded_word;
+ bp = (uint8_t *)wp;
+
+ while (bytes_left_over > 0) {
+ *last_word_ptr++ = *bp++;
+ bytes_left_over--;
+ }
+
+ // this word is ignored if no bytes are left over
+ REG32(HMAC_MSG_FIFO(0)) = padded_word;
+}
+
+int hmac_done(uint32_t *digest) {
+ // TODO need a timeout mechanism
+ // wait for done to assert
+ while (!((REG32(HMAC_INTR_STATE(0)) >> HMAC_INTR_STATE_HMAC_DONE) & 0x1)) {
+ }
+
+ for (uint32_t i = 0; i < 8; i++) {
+ *digest++ = REG32(HMAC_DIGEST0(0) + i * sizeof(uintptr_t));
+ }
+
+ // eventually when we timeout, need to return an error code
+ return 0;
+}
diff --git a/sw/lib/hmac.h b/sw/lib/hmac.h
new file mode 100644
index 0000000..12ee6c1
--- /dev/null
+++ b/sw/lib/hmac.h
@@ -0,0 +1,39 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _F_LIB_HMAC_H__
+#define _F_LIB_HMAC_H__
+
+#include <stddef.h>
+#include <stdint.h>
+
+/* hmac operations */
+typedef enum hmac_ops { Hmac = 0, Sha256 = 1 } hmac_ops_t;
+
+typedef struct hmac_cfg {
+ hmac_ops_t mode;
+ // input swapping only (from reg)
+ uint32_t input_endian_swap;
+ // output swapping only (to digest)
+ uint32_t digest_endian_swap;
+ // length in bits
+ uint32_t length_lower;
+ // lenght in bits
+ uint32_t length_upper;
+ uint32_t keys[8];
+} hmac_cfg_t;
+
+/* Intialize hmac to desired mode. */
+void hmac_init(hmac_cfg_t hmac_cfg);
+
+/* Returns 1 if hmac fifo is full, 0 otherwise. */
+int hmac_fifo_full(void);
+
+/* Write |data| to hmac with |size| in Bytes */
+void hmac_write(const void *data, size_t size);
+
+/* Poll for hmac done and read out digest. */
+int hmac_done(uint32_t *digest);
+
+#endif // _F_LIB_HMAC_H__
diff --git a/sw/lib/irq.c b/sw/lib/irq.c
new file mode 100644
index 0000000..7dc8654
--- /dev/null
+++ b/sw/lib/irq.c
@@ -0,0 +1,54 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "irq.h"
+
+#include "common.h"
+
+static const uint32_t IRQ_EXT_ENABLE_OFFSET = 11;
+static const uint32_t IRQ_TIMER_ENABLE_OFFSET = 7;
+static const uint32_t IRQ_SW_ENABLE_OFFSET = 3;
+
+static void irq_mie_set(uint32_t value) {
+ asm volatile("csrrs zero, mie, %0" : : "r"(value) :);
+}
+
+static void irq_mie_clr(uint32_t value) {
+ asm volatile("csrrc zero, mie, %0" : : "r"(value) :);
+}
+
+void irq_global_ctrl(bool en) {
+ if (en) {
+ asm volatile("csrsi mstatus, 0x8" : : :);
+ } else {
+ asm volatile("csrci mstatus, 0x8" : : :);
+ }
+}
+
+void irq_external_ctrl(bool en) {
+ const uint32_t value = 1 << IRQ_EXT_ENABLE_OFFSET;
+ if (en) {
+ irq_mie_set(value);
+ } else {
+ irq_mie_clr(value);
+ }
+}
+
+void irq_timer_ctrl(bool en) {
+ const uint32_t value = 1 << IRQ_TIMER_ENABLE_OFFSET;
+ if (en) {
+ irq_mie_set(value);
+ } else {
+ irq_mie_clr(value);
+ }
+}
+
+void irq_software_ctrl(bool en) {
+ const uint32_t value = 1 << IRQ_SW_ENABLE_OFFSET;
+ if (en) {
+ irq_mie_set(value);
+ } else {
+ irq_mie_clr(value);
+ }
+}
diff --git a/sw/lib/irq.h b/sw/lib/irq.h
new file mode 100644
index 0000000..a992889
--- /dev/null
+++ b/sw/lib/irq.h
@@ -0,0 +1,36 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _IRQ_H_
+#define _IRQ_H_
+
+#include <stdbool.h>
+#include <stdint.h>
+
+/**
+ * Update to the location of vectors as specificed in the linker file
+ */
+extern void update_mtvec(void);
+
+/**
+ * Enable / disable ibex globlal interrupts
+ */
+void irq_global_ctrl(bool en);
+
+/**
+ * Enable / disable ibex external interrupts
+ */
+void irq_external_ctrl(bool en);
+
+/**
+ * Enable / disable ibex timer interrupts
+ */
+void irq_timer_ctrl(bool en);
+
+/**
+ * Enable / disable ibex software interrupts
+ */
+void irq_software_ctrl(bool en);
+
+#endif
diff --git a/sw/lib/irq_vectors.S b/sw/lib/irq_vectors.S
new file mode 100644
index 0000000..5d16746
--- /dev/null
+++ b/sw/lib/irq_vectors.S
@@ -0,0 +1,36 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+.extern handler_exception
+.extern handler_irq_software
+.extern handler_irq_timer
+.extern handler_irq_external
+.extern _svectors
+
+update_mtvec:
+ .section .text
+ .global update_mtvec
+ la a0, _svectors
+ csrw mtvec, a0
+ ret
+
+exception_handlers:
+ .section .vectors
+ .global vector_handlers
+
+ // exception handler
+ .org 0x0
+ jal x0, handler_exception
+
+ // software interrupt handler
+ .org 0x0c
+ jal x0, handler_irq_software
+
+ // timer interrupt handler
+ .org 0x1c
+ jal x0, handler_irq_timer
+
+ // external interrupt handler
+ .org 0x2c
+ jal x0, handler_irq_external
diff --git a/sw/lib/rv_timer.c b/sw/lib/rv_timer.c
new file mode 100644
index 0000000..d9acefb
--- /dev/null
+++ b/sw/lib/rv_timer.c
@@ -0,0 +1,44 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "rv_timer.h"
+
+#include "common.h"
+#include "rv_timer_regs.h"
+
+#define RV_TIMER0_BASE_ADDR 0x40080000
+#define HART_CFG_ADDR_GAP 0x100
+
+static const uint32_t NS_IN_S = 1000 * 1000 * 1000;
+
+void rv_timer_set_us_tick(uint32_t hart) {
+ uint32_t ticks_per_us = (uint32_t)((1000 * CLK_FIXED_FREQ_HZ) / NS_IN_S) - 1;
+
+ REG32(RV_TIMER_CFG0(0) + hart * 4) =
+ (ticks_per_us & RV_TIMER_CFG0_PRESCALE_MASK) |
+ (1 << RV_TIMER_CFG0_STEP_OFFSET);
+}
+
+void rv_timer_set_cmp(uint32_t hart, uint64_t cmp) {
+ REG32(RV_TIMER_COMPARE_UPPER0_0(0) + hart * HART_CFG_ADDR_GAP) = -1;
+ REG32(RV_TIMER_COMPARE_LOWER0_0(0) + hart * HART_CFG_ADDR_GAP) =
+ (uint32_t)cmp;
+ REG32(RV_TIMER_COMPARE_UPPER0_0(0) + hart * HART_CFG_ADDR_GAP) =
+ (uint32_t)(cmp >> 32);
+}
+
+void rv_timer_ctrl(uint32_t hart, bool en) {
+ REG32(RV_TIMER_CTRL(0)) = (en) ? SETBIT(REG32(RV_TIMER_CTRL(0)), hart)
+ : CLRBIT(REG32(RV_TIMER_CTRL(0)), hart);
+}
+
+void rv_timer_intr_enable(uint32_t hart, bool en) {
+ REG32(RV_TIMER_INTR_ENABLE0(0)) =
+ (en) ? SETBIT(REG32(RV_TIMER_INTR_ENABLE0(0)), hart)
+ : CLRBIT(REG32(RV_TIMER_INTR_ENABLE0(0)), hart);
+}
+
+void rv_timer_clr_all_intrs(void) {
+ REG32(RV_TIMER_INTR_STATE0(0)) = REG32(RV_TIMER_INTR_STATE0(0));
+}
diff --git a/sw/lib/rv_timer.h b/sw/lib/rv_timer.h
new file mode 100644
index 0000000..7d74c6e
--- /dev/null
+++ b/sw/lib/rv_timer.h
@@ -0,0 +1,49 @@
+#ifndef _F_LIB_RV_TIMER_H__
+#define _F_LIB_RV_TIMER_H__
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+
+/**
+ * Set hart timer prescaler
+ *
+ * Program hart timer prescaler to produce 1us ticks
+ *
+ * @param hart hart selection
+ */
+void rv_timer_set_us_tick(uint32_t hart);
+
+/**
+ * Set hart timer compare value
+ *
+ * Program hart timer compare value. When this value is met, an interrupt will
+ * be triggered.
+ *
+ * @param hart hart selection
+ */
+void rv_timer_set_cmp(uint32_t hart, uint64_t cmp);
+
+/**
+ * Enable hart timer to begin counting
+ *
+ * @param hart hart selection
+ * @param en 1 enables timer, 0 disables timer
+ */
+void rv_timer_ctrl(uint32_t hart, bool en);
+
+/**
+ * Set hart timer interrupt enable
+ *
+ * @param hart hart selection
+ * @param en 1 enables interrupt, 0 disables interrupt
+ */
+void rv_timer_intr_enable(uint32_t hart, bool en);
+
+/**
+ * Clear all active interrupts
+ * Interrupt state clearing is W1C (write-one-clear)
+ */
+void rv_timer_clr_all_intrs(void);
+
+#endif // _F_LIB_RV_TIMER_H__
diff --git a/sw/lib/spi_device.c b/sw/lib/spi_device.c
new file mode 100644
index 0000000..3222058
--- /dev/null
+++ b/sw/lib/spi_device.c
@@ -0,0 +1,211 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "spi_device.h"
+
+#include "common.h"
+#include "uart.h"
+
+uint32_t calc_depth(uint32_t wptr, uint32_t rptr, uint32_t size);
+
+/**
+ * Init SPI Device
+ *
+ * Configure registers, RXF_ADDR, TXF_ADDR, CTRL.TIMER_V
+ */
+void spid_init(void) {
+ /* Abort 0 */
+ REG32(SPI_DEVICE_CONTROL(0)) =
+ REG32(SPI_DEVICE_CONTROL(0)) & ~(1 << SPI_DEVICE_CONTROL_ABORT);
+
+ /* CPOL(0), CPHA(0), ORDERs(00), TIMER(63) */
+ REG32(SPI_DEVICE_CFG(0)) =
+ ((0 << SPI_DEVICE_CFG_CPOL) | (0 << SPI_DEVICE_CFG_CPHA) |
+ (0 << SPI_DEVICE_CFG_RX_ORDER) | (0 << SPI_DEVICE_CFG_TX_ORDER) |
+ ((63 & SPI_DEVICE_CFG_TIMER_V_MASK) << SPI_DEVICE_CFG_TIMER_V_OFFSET));
+
+ /* SRAM RXF/TXF ADDR. */
+ REG32(SPI_DEVICE_RXF_ADDR(0)) =
+ ((SPID_RXF_BASE & SPI_DEVICE_RXF_ADDR_BASE_MASK)
+ << SPI_DEVICE_RXF_ADDR_BASE_OFFSET) |
+ (((SPID_RXF_SIZE - 1) & SPI_DEVICE_RXF_ADDR_LIMIT_MASK)
+ << SPI_DEVICE_RXF_ADDR_LIMIT_OFFSET);
+
+ REG32(SPI_DEVICE_TXF_ADDR(0)) =
+ ((SPID_TXF_BASE & SPI_DEVICE_TXF_ADDR_BASE_MASK)
+ << SPI_DEVICE_TXF_ADDR_BASE_OFFSET) |
+ (((SPID_TXF_SIZE - 1) & SPI_DEVICE_TXF_ADDR_LIMIT_MASK)
+ << SPI_DEVICE_TXF_ADDR_LIMIT_OFFSET);
+}
+
+/**
+ * Calculation FIFO depth in bytes
+ *
+ * Assume SRAM size is fixed (constant) given by SPI_DEVICE_BUFFER_SIZE
+ *
+ * Fifo pointers are in bytes
+ */
+inline uint32_t calc_depth(uint32_t wptr, uint32_t rptr, uint32_t size) {
+ const uint32_t sram_szw = BITLENGTH(SPI_DEVICE_BUFFER_SIZE_BYTES - 1);
+ uint32_t depth;
+ uint32_t wptr_phase, rptr_phase, wptr_v, rptr_v;
+ wptr_phase = wptr >> sram_szw;
+ rptr_phase = rptr >> sram_szw;
+ wptr_v = wptr & (SPI_DEVICE_BUFFER_SIZE_BYTES - 1);
+ rptr_v = rptr & (SPI_DEVICE_BUFFER_SIZE_BYTES - 1);
+
+ if (wptr_phase == rptr_phase) {
+ depth = (wptr_v - rptr_v);
+ } else {
+ depth = size - rptr_v + wptr_v;
+ }
+
+ return depth;
+}
+
+/*
+ * Increment pointer, zero and flip phase if it gets to size
+ */
+uint32_t ptr_inc(uint32_t ptr, uint32_t inc, uint32_t size) {
+ uint32_t phase = ptr & SPI_DEVICE_BUFFER_SIZE_BYTES;
+ ptr = (ptr & (SPI_DEVICE_BUFFER_SIZE_BYTES - 1)) + inc;
+ if (ptr >= size) {
+ ptr -= size;
+ phase ^= SPI_DEVICE_BUFFER_SIZE_BYTES;
+ }
+ return ptr | phase;
+}
+
+static int word_aligned(void *p) { return (((int)p & 0x3) == 0); }
+
+/**
+ * Send data over SPI
+ *
+ * @param data pointer to buffer of uint_8 to send
+ * @param len_bytes number of bytes to send
+ * @return number of bytes actually sent (<len if no space in the fifo)
+ */
+size_t spid_send(void *data, size_t len_bytes) {
+ uint32_t txf_ptr, txf_wptr, txf_rptr;
+ uint32_t fifo_inuse_bytes;
+ uint32_t msg_length_bytes;
+
+ /* Check if TXF has enough space */
+ txf_ptr = REG32(SPI_DEVICE_TXF_PTR(0));
+ txf_wptr = (txf_ptr >> SPI_DEVICE_TXF_PTR_WPTR_OFFSET) &
+ SPI_DEVICE_TXF_PTR_WPTR_MASK;
+ txf_rptr = (txf_ptr >> SPI_DEVICE_TXF_PTR_RPTR_OFFSET) &
+ SPI_DEVICE_TXF_PTR_RPTR_MASK;
+
+ fifo_inuse_bytes = calc_depth(txf_wptr, txf_rptr, SPID_TXF_SIZE);
+
+ // Reserve the last 4 bytes in the fifo so it is always safe
+ // to write 32-bit words
+ if (len_bytes < SPID_TXF_SIZE - fifo_inuse_bytes - 4) {
+ // Safe to send all data
+ msg_length_bytes = len_bytes;
+ } else {
+ msg_length_bytes = SPID_TXF_SIZE - fifo_inuse_bytes - 4;
+ }
+ int tocopy = msg_length_bytes;
+
+ // Aligned case can just copy words
+ if (word_aligned(data) && word_aligned((void *)txf_wptr)) {
+ uint32_t *data_w = (uint32_t *)data;
+ while (tocopy > 0) {
+ ACCESS32_TXFPTR(txf_wptr) = *data_w++;
+ if (tocopy >= 4) {
+ txf_wptr = ptr_inc(txf_wptr, 4, SPID_TXF_SIZE);
+ tocopy -= 4;
+ } else {
+ txf_wptr = ptr_inc(txf_wptr, tocopy, SPID_TXF_SIZE);
+ tocopy = 0; // tocopy -= tocopy always gives zero
+ }
+ }
+ } else {
+ // preserve data if unaligned start
+ uint8_t *data_b = (uint8_t *)data;
+ uint32_t d = ACCESS32_TXFPTR(txf_wptr);
+ while (tocopy > 0) {
+ int shift = (txf_wptr & 0x3) * 8;
+ uint32_t mask = 0xff << shift;
+ d = (d & ~mask) | (*data_b++ << shift);
+ if ((txf_wptr & 0x3) == 0x3) {
+ ACCESS32_TXFPTR(txf_wptr) = d;
+ }
+ txf_wptr = ptr_inc(txf_wptr, 1, SPID_TXF_SIZE);
+ tocopy--;
+ }
+ }
+
+ // Write pointer, requires read pointer to be RO
+ REG32(SPI_DEVICE_TXF_PTR(0)) = txf_wptr << SPI_DEVICE_TXF_PTR_WPTR_OFFSET;
+
+ return msg_length_bytes;
+}
+
+/**
+ * Read the amount of the data from SRAM RX FIFO
+ *
+ * If remained data is smaller than length, it returns only up to data
+ */
+size_t spid_read_nb(void *data, size_t len_bytes) {
+ uint32_t rxf_ptr, rxf_wptr, rxf_rptr;
+ uint32_t msg_len_bytes;
+
+ rxf_ptr = REG32(SPI_DEVICE_RXF_PTR(0));
+ rxf_wptr = (rxf_ptr >> SPI_DEVICE_RXF_PTR_WPTR_OFFSET) &
+ SPI_DEVICE_RXF_PTR_WPTR_MASK;
+ rxf_rptr = (rxf_ptr >> SPI_DEVICE_RXF_PTR_RPTR_OFFSET) &
+ SPI_DEVICE_RXF_PTR_RPTR_MASK;
+
+ msg_len_bytes = calc_depth(rxf_wptr, rxf_rptr, SPID_RXF_SIZE);
+ if (msg_len_bytes == 0) {
+ return 0;
+ }
+ uart_send_uint(rxf_ptr, 32);
+ uart_send_char(' ');
+ uart_send_uint(msg_len_bytes, 32);
+ uart_send_char(' ');
+ /* Check there is room for the whole buffer */
+ if (msg_len_bytes > len_bytes) {
+ msg_len_bytes = len_bytes;
+ }
+
+ int tocopy = msg_len_bytes;
+ // Aligned case -- which for now it always will be
+ // if tocopy is not multiple of 4 then will read / write extra bytes
+ // so check buffer length
+ if (word_aligned(data) && ((len_bytes & 0x3) == 0) &&
+ word_aligned((void *)rxf_ptr)) {
+ uint32_t *data_w = (uint32_t *)data;
+ while (tocopy > 0) {
+ *data_w++ = READ32_RXFPTR(rxf_rptr);
+ if (tocopy >= 4) {
+ rxf_rptr = ptr_inc(rxf_rptr, 4, SPID_RXF_SIZE);
+ tocopy -= 4;
+ } else {
+ rxf_rptr = ptr_inc(rxf_rptr, tocopy, SPID_RXF_SIZE);
+ tocopy = 0; // tocopy -= tocopy always gives zero
+ }
+ }
+ } else {
+ uint8_t *data_b = (uint8_t *)data;
+ // Have to deal with only being able to do 32-bit accesses
+ int dst = 0;
+ uint32_t d = READ32_RXFPTR(rxf_rptr & ~0x3);
+ while (tocopy--) {
+ int boff = rxf_rptr & 0x3;
+ data_b[dst++] = (d >> (boff * 8)) & 0xff;
+ rxf_rptr = ptr_inc(rxf_rptr, 1, SPID_RXF_SIZE);
+ if (((rxf_rptr & 0x3) == 0) && tocopy) {
+ d = READ32_RXFPTR(rxf_rptr);
+ }
+ }
+ }
+ /* Update read pointer -- NB relies on write pointer being RO */
+ REG32(SPI_DEVICE_RXF_PTR(0)) = rxf_rptr << SPI_DEVICE_RXF_PTR_RPTR_OFFSET;
+
+ return msg_len_bytes;
+}
diff --git a/sw/lib/spi_device.h b/sw/lib/spi_device.h
new file mode 100644
index 0000000..18d3278
--- /dev/null
+++ b/sw/lib/spi_device.h
@@ -0,0 +1,35 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _SPI_DEVICE_H_
+#define _SPI_DEVICE_H_
+
+#include <stddef.h>
+
+#include "common.h"
+
+#define SPI_DEVICE0_BASE_ADDR 0x40020000
+
+#include "spi_device_regs.h"
+
+#define SPID_SRAM_ADDR SPI_DEVICE_BUFFER(SPI_DEVICE0_BASE_ADDR)
+#define SPID_RXF_BASE 0x000
+#define SPID_RXF_SIZE 0x400
+#define SPID_TXF_BASE 0x600
+#define SPID_TXF_SIZE 0x200
+
+#define SPID_SRAM_SIZE (0x800)
+
+/* Note: these will correctly remove the phase bit */
+#define READ32_RXFPTR(P) \
+ REG32(SPID_SRAM_ADDR + SPID_RXF_BASE + ((P) & (SPID_RXF_SIZE - 1)))
+
+#define ACCESS32_TXFPTR(P) \
+ REG32(SPID_SRAM_ADDR + SPID_TXF_BASE + ((P) & ((SPID_TXF_SIZE - 1) & ~0x3)))
+
+void spid_init(void);
+size_t spid_send(void *data, size_t len_bytes);
+size_t spid_read_nb(void *data, size_t len);
+
+#endif /* _SPI_DEVICE_H_ */
diff --git a/sw/lib/uart.c b/sw/lib/uart.c
new file mode 100644
index 0000000..c8fd52d
--- /dev/null
+++ b/sw/lib/uart.c
@@ -0,0 +1,71 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "uart.h"
+
+#include "common.h"
+
+inline void uart_init(unsigned int baud) {
+ // nco = 2^20 * baud / fclk
+ uint64_t uart_ctrl_nco = ((uint64_t)baud << 20) / CLK_FIXED_FREQ_HZ;
+ REG32(UART_CTRL(0)) =
+ ((uart_ctrl_nco & UART_CTRL_NCO_MASK) << UART_CTRL_NCO_OFFSET) |
+ (1 << UART_CTRL_TX) | (1 << UART_CTRL_RX);
+
+ // reset RX/TX FIFOs
+ REG32(UART_FIFO_CTRL(0)) =
+ (1 << UART_FIFO_CTRL_RXRST) | (1 << UART_FIFO_CTRL_TXRST);
+
+ // disable interrupts
+ REG32(UART_INTR_ENABLE(0)) = 0;
+}
+
+static int uart_tx_rdy(void) {
+ return !(REG32(UART_STATUS(0)) & (1 << UART_STATUS_TXFULL));
+}
+
+void uart_send_char(char c) {
+ while (!uart_tx_rdy()) {
+ }
+ REG32(UART_WDATA(0)) = c;
+}
+
+/**
+ * Send a NULL-terminated string over UART
+ */
+void uart_send_str(char *str) {
+ while (*str != '\0') {
+ uart_send_char(*str++);
+ }
+}
+
+#define hexchar(i) (((i & 0xf) > 9) ? (i & 0xf) - 10 + 'A' : (i & 0xf) + '0')
+
+/**
+ * Send unsigned int over UART
+ */
+void uart_send_uint(uint32_t n, int bits) {
+ for (int i = bits - 4; i >= 0; i -= 4) {
+ uart_send_char(hexchar(n >> i));
+ }
+}
+
+int uart_rx_empty(void) {
+ return !!(REG32(UART_STATUS(0)) & (1 << UART_STATUS_RXEMPTY));
+}
+
+/**
+ * Receive a single character from UART
+ *
+ * @param c received character, caller-allocated
+ * @return 0 on success, -1 if no data is available
+ */
+int uart_rcv_char(char *c) {
+ if (uart_rx_empty()) {
+ return -1;
+ }
+
+ *c = REG32(UART_RDATA(0));
+ return 0;
+}
diff --git a/sw/lib/uart.h b/sw/lib/uart.h
new file mode 100644
index 0000000..acc4590
--- /dev/null
+++ b/sw/lib/uart.h
@@ -0,0 +1,21 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _UART_H_
+#define _UART_H_
+
+#include <stdint.h>
+
+#define UART0_BASE_ADDR 0x40000000
+
+#include "uart_regs.h"
+
+void uart_send_char(char c);
+void uart_send_uint(uint32_t n, int size);
+void uart_init(unsigned int baud);
+void uart_send_str(char *str);
+int uart_rx_empty(void);
+int uart_rcv_char(char *c);
+
+#endif
diff --git a/sw/lib/usb_consts.h b/sw/lib/usb_consts.h
new file mode 100644
index 0000000..5e2ebb7
--- /dev/null
+++ b/sw/lib/usb_consts.h
@@ -0,0 +1,54 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _USB_CONSTS_H_
+#define _USB_CONSTS_H_
+
+// SETUP requests
+typedef enum usb_setup_req {
+ kUsbSetupReqGetStatus = 0,
+ kUsbSetupReqClearFeature = 1,
+ kUsbSetupReqSetFeature = 3,
+ kUsbSetupReqSetAddress = 5,
+ kUsbSetupReqGetDescriptor = 6,
+ kUsbSetupReqSetDescriptor = 7,
+ kUsbSetupReqGetConfiguration = 8,
+ kUsbSetupReqSetConfiguration = 9,
+ kUsbSetupReqGetInterface = 10,
+ kUsbSetupReqSetInterface = 11,
+ kUsbSetupReqSynchFrame = 12
+} usb_setup_req_t;
+
+typedef enum usb_req_type { // bmRequestType
+ kUsbReqTypeRecipientMask = 0x1f,
+ kUsbReqTypeDevice = 0,
+ kUsbReqTypeInterface = 1,
+ kUsbReqTypeEndpoint = 2,
+ kUsbReqTypeOther = 3,
+ kUsbReqTypeTypeMask = 0x60,
+ KUsbReqTypeStandard = 0,
+ KUsbReqTypeClass = 0x20,
+ KUsbReqTypeVendor = 0x40,
+ KUsbReqTypeReserved = 0x60,
+ kUsbReqTypeDirMask = 0x80,
+ kUsbReqTypeDirH2D = 0x00,
+ kUsbReqTypeDirD2H = 0x80,
+} usb_req_type_t;
+
+typedef enum usb_feature_req {
+ kUsbFeatureEndpointHalt = 0, // recipient is endpoint
+ kUsbFeatureDeviceRemoteWakeup = 1, // recipient is device
+ kUsbFeatureTestMode = 2, // recipient is device
+ kUsbFeatureBHnpEnable = 3, // recipient is device only if OTG
+ kUsbFeatureAHnpSupport = 4, // recipient is device only if OTG
+ kUsbFeatureAAltHnpSupport = 5 // recipient is device only if OTG
+} usb_feature_req_t;
+
+typedef enum usb_status {
+ kUsbStatusSelfPowered = 1, // Device status request
+ kUsbStatusRemWake = 2, // Device status request
+ kUsbStatusHalted = 1 // Endpoint status request
+} usb_status_t;
+
+#endif // _USB_CONSTS_H_
diff --git a/sw/lib/usb_controlep.c b/sw/lib/usb_controlep.c
new file mode 100644
index 0000000..7327f8a
--- /dev/null
+++ b/sw/lib/usb_controlep.c
@@ -0,0 +1,243 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+// Get NULL from here
+#include "usb_controlep.h"
+
+#include <stddef.h>
+
+#include "common.h"
+#include "usb_consts.h"
+#include "usbdev.h"
+
+// Device descriptor
+static uint8_t dev_dscr[] = {
+ 18, // bLength
+ 1, // bDescriptorType
+ 0x00, // bcdUSB[0]
+ 0x02, // bcdUSB[1]
+ 0x00, // bDeviceClass (defined at interface level)
+ 0x00, // bDeviceSubClass
+ 0x00, // bDeviceProtocol
+ 64, // bMaxPacketSize0
+
+ 0xd1, // idVendor[0] 0x18d1 Google Inc.
+ 0x18, // idVendor[1]
+ 0x3a, // idProduct[0] lowRISC generic FS USB
+ 0x50, // idProduct[1] (allocated by Google)
+
+ 0, // bcdDevice[0]
+ 0x1, // bcdDevice[1]
+ 0, // iManufacturer
+ 0, // iProduct
+ 0, // iSerialNumber
+ 1 // bNumConfigurations
+};
+
+static ctstate_t setup_req(usb_controlep_ctx_t *ctctx, void *ctx,
+ usbbufid_t buf, int bmRequestType, int bRequest,
+ int wValue, int wIndex, int wLength) {
+ size_t len;
+ uint32_t stat;
+ int zero, type;
+ switch (bRequest) {
+ case kUsbSetupReqGetDescriptor:
+ if ((wValue & 0xff00) == 0x100) {
+ // Device descriptor
+ len = sizeof(dev_dscr);
+ if (wLength < len) {
+ len = wLength;
+ }
+ usbdev_buf_copyto_byid(ctx, buf, dev_dscr, len);
+ usbdev_sendbuf_byid(ctx, buf, len, ctctx->ep);
+ return kCtWaitIn;
+ } else if ((wValue & 0xff00) == 0x200) {
+ // Configuration descriptor
+ len = ctctx->cfg_dscr_len;
+ if (wLength < len) {
+ len = wLength;
+ }
+ usbdev_buf_copyto_byid(ctx, buf, ctctx->cfg_dscr, len);
+ usbdev_sendbuf_byid(ctx, buf, len, ctctx->ep);
+ return kCtWaitIn;
+ }
+ return kCtIdle; // unknown
+
+ case kUsbSetupReqSetAddress:
+ ctctx->new_dev = wValue & 0x7f;
+ // send zero length packet for status phase
+ usbdev_sendbuf_byid(ctx, buf, 0, ctctx->ep);
+ return kCtAddrStatIn;
+
+ case kUsbSetupReqSetConfiguration:
+ // only ever expect this to be 1 since there is one config descriptor
+ ctctx->usb_config = wValue;
+ // send zero length packet for status phase
+ usbdev_sendbuf_byid(ctx, buf, 0, ctctx->ep);
+ return kCtStatIn;
+
+ case kUsbSetupReqGetConfiguration:
+ len = sizeof(ctctx->usb_config);
+ if (wLength < len) {
+ len = wLength;
+ }
+ // return the value that was set
+ usbdev_buf_copyto_byid(ctx, buf, &ctctx->usb_config, len);
+ usbdev_sendbuf_byid(ctx, buf, len, ctctx->ep);
+ return kCtWaitIn;
+
+ case kUsbSetupReqSetFeature:
+ if (wValue == kUsbFeatureEndpointHalt) {
+ usbdev_halt(ctx, wIndex, 1);
+ } else if (wValue == kUsbFeatureDeviceRemoteWakeup) {
+ usbdev_rem_wake_en(ctx, 1);
+ }
+ // send zero length packet for status phase
+ usbdev_sendbuf_byid(ctx, buf, 0, ctctx->ep);
+ return kCtStatIn;
+
+ case kUsbSetupReqClearFeature:
+ if (wValue == kUsbFeatureEndpointHalt) {
+ usbdev_halt(ctx, wIndex, 0);
+ } else if (wValue == kUsbFeatureDeviceRemoteWakeup) {
+ usbdev_rem_wake_en(ctx, 0);
+ }
+ // send zero length packet for status phase
+ usbdev_sendbuf_byid(ctx, buf, 0, ctctx->ep);
+ return kCtStatIn;
+
+ case kUsbSetupReqGetStatus:
+ len = 2;
+ type = bmRequestType & kUsbReqTypeRecipientMask;
+ if (type == kUsbReqTypeDevice) {
+ stat = (usbdev_can_rem_wake(ctx) ? kUsbStatusRemWake : 0) |
+ kUsbStatusSelfPowered;
+ } else if (type == kUsbReqTypeEndpoint) {
+ stat = usbdev_halted(ctx, wIndex) ? kUsbStatusHalted : 0;
+ } else {
+ stat = 0;
+ }
+ if (wLength < len) {
+ len = wLength;
+ }
+ // return the value that was set
+ usbdev_buf_copyto_byid(ctx, buf, &stat, len);
+ usbdev_sendbuf_byid(ctx, buf, len, ctctx->ep);
+ return kCtWaitIn;
+
+ case kUsbSetupReqSetInterface:
+ // Don't support alternate interfaces, so just ignore
+ // send zero length packet for status phase
+ usbdev_sendbuf_byid(ctx, buf, 0, ctctx->ep);
+ return kCtStatIn;
+
+ case kUsbSetupReqGetInterface:
+ zero = 0;
+ len = 1;
+ if (wLength < len) {
+ len = wLength;
+ }
+ // Don't support interface, so return zero
+ usbdev_buf_copyto_byid(ctx, buf, &zero, len);
+ usbdev_sendbuf_byid(ctx, buf, len, ctctx->ep);
+ return kCtWaitIn;
+
+ case kUsbSetupReqSynchFrame:
+ zero = 0;
+ len = 2;
+ if (wLength < len) {
+ len = wLength;
+ }
+ // Don't support synch_frame so return zero
+ usbdev_buf_copyto_byid(ctx, buf, &zero, len);
+ usbdev_sendbuf_byid(ctx, buf, len, ctctx->ep);
+ return kCtWaitIn;
+ }
+ return kCtError;
+}
+
+static void ctrl_tx_done(void *ctctx_v) {
+ usb_controlep_ctx_t *ctctx = (usb_controlep_ctx_t *)ctctx_v;
+ void *ctx = ctctx->ctx;
+ TRC_C('A' + ctctx->ctrlstate);
+ switch (ctctx->ctrlstate) {
+ case kCtAddrStatIn:
+ // Now the status was sent on device 0 can switch to new device ID
+ usbdev_set_deviceid(ctx, ctctx->new_dev);
+ TRC_I(ctctx->new_dev, 8);
+ ctctx->ctrlstate = kCtIdle;
+ return;
+ case kCtStatIn:
+ ctctx->ctrlstate = kCtIdle;
+ return;
+ case kCtWaitIn:
+ ctctx->ctrlstate = kCtStatOut;
+ return;
+ default:
+ break;
+ }
+ TRC_S("USB: unexpected IN ");
+ TRC_I((ctctx->ctrlstate << 24), 32);
+}
+
+static void ctrl_rx(void *ctctx_v, usbbufid_t buf, int size, int setup) {
+ usb_controlep_ctx_t *ctctx = (usb_controlep_ctx_t *)ctctx_v;
+ void *ctx = ctctx->ctx;
+ volatile uint8_t *bp = (volatile uint8_t *)usbdev_buf_idtoaddr(ctx, buf);
+ if (size > BUF_LENGTH) {
+ size = BUF_LENGTH;
+ }
+
+ TRC_C('0' + ctctx->ctrlstate);
+ switch (ctctx->ctrlstate) {
+ case kCtIdle:
+ // Waiting to be set up
+ if (setup && (size == 8)) {
+ int bmRequestType = bp[0];
+ int bRequest = bp[1];
+ int wValue = (bp[3] << 8) | bp[2];
+ int wIndex = (bp[5] << 8) | bp[4];
+ int wLength = (bp[7] << 8) | bp[6];
+ TRC_C('0' + bRequest);
+
+ ctctx->ctrlstate = setup_req(ctctx, ctx, buf, bmRequestType, bRequest,
+ wValue, wIndex, wLength);
+ if (ctctx->ctrlstate != kCtError) {
+ return;
+ }
+ }
+ break;
+
+ case kCtStatOut:
+ // Have sent some data, waiting STATUS stage
+ if (!setup && (size == 0)) {
+ ctctx->ctrlstate = kCtIdle;
+ return;
+ }
+ // anything else is unexpected
+ break;
+
+ default:
+ // Error
+ break;
+ }
+ TRC_S("USB: unCT ");
+ TRC_I((ctctx->ctrlstate << 24) | setup << 16 | size, 32);
+ TRC_C(':');
+ for (int i = 0; i < size; i++) {
+ TRC_I(bp[i], 8);
+ TRC_C(' ');
+ }
+ usbdev_buf_free_byid(ctx, buf);
+ ctctx->ctrlstate = kCtIdle;
+}
+
+void usb_controlep_init(usb_controlep_ctx_t *ctctx, usbdev_ctx_t *ctx, int ep,
+ const uint8_t *cfg_dscr, size_t cfg_dscr_len) {
+ ctctx->ctx = ctx;
+ usbdev_endpoint_setup(ctx, ep, 1, ctctx, ctrl_tx_done, ctrl_rx, NULL);
+ ctctx->ctrlstate = kCtIdle;
+ ctctx->cfg_dscr = cfg_dscr;
+ ctctx->cfg_dscr_len = cfg_dscr_len;
+}
diff --git a/sw/lib/usb_controlep.h b/sw/lib/usb_controlep.h
new file mode 100644
index 0000000..3be4840
--- /dev/null
+++ b/sw/lib/usb_controlep.h
@@ -0,0 +1,96 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef __USB_CONTROLEP_H__
+#define __USB_CONTROLEP_H__
+#include <stddef.h>
+
+#include "common.h"
+#include "usbdev.h"
+
+typedef enum ctstate {
+ kCtIdle,
+ kCtWaitIn, // Queued IN data stage, waiting ack
+ kCtStatOut, // Waiting for OUT status stage
+ kCtAddrStatIn, // Queued status stage, waiting ack afterwhich set dev_addr
+ kCtStatIn, // Queued status stage, waiting ack
+ kCtError // Something bad
+} ctstate_t;
+
+typedef struct usb_controlep_ctx {
+ usbdev_ctx_t *ctx;
+ int ep;
+ ctstate_t ctrlstate;
+ uint32_t new_dev;
+ uint8_t usb_config;
+ const uint8_t *cfg_dscr;
+ size_t cfg_dscr_len;
+} usb_controlep_ctx_t;
+
+/**
+ * Initialize control endpoint
+ *
+ * @param ctctx uninitialized context for this instance
+ * @param ctx initialized context for usbdev driver
+ * @param ep endpoint (if this is other than 0 make sure you know why)
+ * @param cfg_dscr configuration descriptor for the device
+ * @param cfg_dscr_len length of cfg_dscr
+ */
+void usb_controlep_init(usb_controlep_ctx_t *ctctx, usbdev_ctx_t *ctx, int ep,
+ const uint8_t *cfg_dscr, size_t cfg_dscr_len);
+
+/********************************************************************/
+/* Below this point are macros used to construct the USB descriptor */
+/* Use them to initialize a uint8_t array for cfg_dscr */
+
+#define USB_CFG_DSCR_LEN 9
+#define USB_CFG_DSCR_HEAD(total_len, nint) \
+ /* This is the actual configuration descriptor */ \
+ USB_CFG_DSCR_LEN, /* bLength */ \
+ 2, /* bDescriptorType */ \
+ (total_len)&0xff, /* wTotalLength[0] */ \
+ (total_len) >> 8, /* wTotalLength[1] */ \
+ (nint), /* bNumInterfaces */ \
+ 1, /* bConfigurationValu */ \
+ 0, /* iConfiguration */ \
+ 0xC0, /* bmAttributes: must-be-one, self-powered */ \
+ 50, /* bMaxPower */ /* MUST be followed \
+ by (nint) \
+ Interface + \
+ Endpoint \
+ Descriptors */
+
+// KEEP BLANK LINE ABOVE, it is in the macro!
+
+#define USB_INTERFACE_DSCR_LEN 9
+#define VEND_INTERFACE_DSCR(inum, nep, subclass, protocol) \
+ /* interface descriptor, USB spec 9.6.5, page 267-269, Table 9-12 */ \
+ USB_INTERFACE_DSCR_LEN, /* bLength */ \
+ 4, /* bDescriptorType */ \
+ (inum), /* bInterfaceNumber */ \
+ 0, /* bAlternateSetting */ \
+ (nep), /* bNumEndpoints */ \
+ 0xff, /* bInterfaceClass (Vendor Specific) */ \
+ (subclass), /* bInterfaceSubClass */ \
+ (protocol), /* bInterfaceProtocol */ \
+ 0, /* iInterface */ /* MUST be followed by \
+ (nep) Endpoint \
+ Descriptors */
+
+// KEEP BLANK LINE ABOVE, it is in the macro!
+
+#define USB_EP_DSCR_LEN 7
+#define USB_BULK_EP_DSCR(in, ep, maxsize, interval) \
+ /* endpoint descriptor, USB spec 9.6.6, page 269-271, Table 9-13 */ \
+ USB_EP_DSCR_LEN, /* bLength */ \
+ 5, /* bDescriptorType */ \
+ (ep) | (((in) << 7) & 0x80), /* bEndpointAddress, top bit set for IN */ \
+ 0x02, /* bmAttributes (0x02=bulk, data) */ \
+ (maxsize)&0xff, /* wMaxPacketSize[0] */ \
+ (maxsize) >> 8, /* wMaxPacketSize[1] */ \
+ (interval), /* bInterval */
+
+// KEEP BLANK LINE ABOVE, it is in the macro!
+
+#endif
diff --git a/sw/lib/usb_simpleserial.c b/sw/lib/usb_simpleserial.c
new file mode 100644
index 0000000..0268768
--- /dev/null
+++ b/sw/lib/usb_simpleserial.c
@@ -0,0 +1,80 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+// Get NULL from here
+#include "usb_simpleserial.h"
+
+#include <stddef.h>
+
+#include "common.h"
+#include "usbdev.h"
+
+#define MAX_GATHER 16
+
+static void ss_rx(void *ssctx_v, usbbufid_t buf, int size, int setup) {
+ usb_ss_ctx_t *ssctx = (usb_ss_ctx_t *)ssctx_v;
+ void *ctx = ssctx->ctx;
+ volatile uint8_t *bp = (volatile uint8_t *)usbdev_buf_idtoaddr(ctx, buf);
+
+ if (size > BUF_LENGTH) {
+ size = BUF_LENGTH;
+ }
+
+ while (size--) {
+ ssctx->got_byte(*bp++);
+ }
+}
+
+// Called periodically by the main loop to ensure characters don't
+// stick around too long
+static void ss_flush(void *ssctx_v) {
+ usb_ss_ctx_t *ssctx = (usb_ss_ctx_t *)ssctx_v;
+ void *ctx = ssctx->ctx;
+ volatile uint32_t *bp_w;
+ if ((ssctx->cur_buf == -1) || (ssctx->cur_cpos <= 0)) {
+ return;
+ }
+ if ((ssctx->cur_cpos & 0x3) != 0) {
+ // unwritten data to copy over
+ bp_w = usbdev_buf_idtoaddr(ctx, ssctx->cur_buf);
+ // no -1 here because cpos is in the word we are writing
+ bp_w[(ssctx->cur_cpos / 4)] = ssctx->chold.data_w;
+ }
+ usbdev_sendbuf_byid(ctx, ssctx->cur_buf, ssctx->cur_cpos, ssctx->ep);
+ ssctx->cur_buf = -1; // given it to the hardware
+}
+
+// Simple send byte will gather data for a while and send
+void usb_simpleserial_send_byte(usb_ss_ctx_t *ssctx, uint8_t c) {
+ volatile uint32_t *bp_w;
+ if (ssctx->cur_buf == -1) {
+ ssctx->cur_buf = usbdev_buf_allocate_byid(ssctx->ctx);
+ ssctx->cur_cpos = 0;
+ }
+ // Abort if completely out of buffers and allocation returned -1
+ if (ssctx->cur_buf < 0) {
+ return;
+ }
+ ssctx->chold.data_b[ssctx->cur_cpos++ & 0x3] = c;
+ if ((ssctx->cur_cpos & 0x3) == 0) {
+ // just wrote last byte in word
+ bp_w = usbdev_buf_idtoaddr(ssctx->ctx, ssctx->cur_buf);
+ // -1 here because cpos already incremented to next word
+ bp_w[(ssctx->cur_cpos / 4) - 1] = ssctx->chold.data_w;
+ if (ssctx->cur_cpos >= MAX_GATHER) {
+ usbdev_sendbuf_byid(ssctx->ctx, ssctx->cur_buf, ssctx->cur_cpos,
+ ssctx->ep);
+ ssctx->cur_buf = -1; // given it to the hardware
+ }
+ }
+}
+
+void usb_simpleserial_init(usb_ss_ctx_t *ssctx, usbdev_ctx_t *ctx, int ep,
+ void (*got_byte)(uint8_t)) {
+ usbdev_endpoint_setup(ctx, ep, 1, ssctx, NULL, ss_rx, ss_flush);
+ ssctx->ctx = ctx;
+ ssctx->ep = ep;
+ ssctx->got_byte = got_byte;
+ ssctx->cur_buf = -1;
+}
diff --git a/sw/lib/usb_simpleserial.h b/sw/lib/usb_simpleserial.h
new file mode 100644
index 0000000..52ca8be
--- /dev/null
+++ b/sw/lib/usb_simpleserial.h
@@ -0,0 +1,42 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef __USB_SIMPLESERIAL_H__
+#define __USB_SIMPLESERIAL_H__
+
+#include "common.h"
+#include "usbdev.h"
+
+// This is only here because caller of _init needs it
+typedef struct usb_ss_ctx {
+ void *ctx;
+ int ep;
+ int cur_buf;
+ int cur_cpos;
+ union usb_ss_b2w {
+ uint32_t data_w;
+ uint8_t data_b[4];
+ } chold;
+ void (*got_byte)(uint8_t);
+} usb_ss_ctx_t;
+
+/**
+ * Send a byte on a simpleserial endpoint
+ * ssctx - instance context
+ * c - byte to send
+ */
+void usb_simpleserial_send_byte(usb_ss_ctx_t *ssctx, uint8_t c);
+
+/**
+ * Initialize a simpleserial endpoint
+ *
+ * ctx - initialized usbdev context
+ * ep - endpoint number for this instance
+ * ssctx - unintialized simpleserial instance context
+ * got_byte - callback function for when a byte is received
+ */
+void usb_simpleserial_init(usb_ss_ctx_t *ssctx, usbdev_ctx_t *ctx, int ep,
+ void (*got_byte)(uint8_t));
+
+#endif
diff --git a/sw/lib/usbdev.c b/sw/lib/usbdev.c
new file mode 100644
index 0000000..96d6b55
--- /dev/null
+++ b/sw/lib/usbdev.c
@@ -0,0 +1,225 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+// Get NULL from here
+#include "usbdev.h"
+
+#include <stddef.h>
+
+#include "common.h"
+
+#define USBDEV_BASE_ADDR 0x40020000
+
+#include "usbdev_regs.h"
+#define EXTRACT(n, f) ((n >> USBDEV_##f##_OFFSET) & USBDEV_##f##_MASK)
+
+// Free buffer pool is held on a simple stack
+// Initalize to all buffer IDs are free
+static void buf_init(usbdev_ctx_t *ctx) {
+ for (int i = 0; i < NUM_BUFS; i++) {
+ ctx->freebuf[i] = i;
+ }
+ ctx->nfree = NUM_BUFS;
+}
+
+// Allocating a buffer just pops next ID from the stack
+usbbufid_t usbdev_buf_allocate_byid(usbdev_ctx_t *ctx) {
+ if (ctx->nfree <= 0) {
+ return -1;
+ }
+ return ctx->freebuf[--ctx->nfree];
+}
+
+// Freeing a buffer just pushes the ID back on the stack
+int usbdev_buf_free_byid(usbdev_ctx_t *ctx, usbbufid_t buf) {
+ if ((ctx->nfree >= NUM_BUFS) || (buf >= NUM_BUFS)) {
+ return -1;
+ }
+ ctx->freebuf[ctx->nfree++] = buf;
+ return 0;
+}
+
+uint32_t *usbdev_buf_idtoaddr(usbdev_ctx_t *ctx, usbbufid_t buf) {
+ return (uint32_t *)(USBDEV_BUFFER(USBDEV_BASE_ADDR) + (buf * BUF_LENGTH));
+}
+
+void usbdev_buf_copyto_byid(usbdev_ctx_t *ctx, usbbufid_t buf, const void *from,
+ size_t len_bytes) {
+ int32_t *from_word = (int32_t *)from;
+ int len_words;
+ volatile uint32_t *bp = usbdev_buf_idtoaddr(ctx, buf);
+
+ if (len_bytes > BUF_LENGTH) {
+ len_bytes = BUF_LENGTH;
+ }
+ // This will round up if len_bytes is not on a multiple of int32_t
+ // Always ok to fill the extra bytes since the buffers are aligned
+ len_words = (len_bytes + sizeof(int32_t) - 1) / sizeof(int32_t);
+ for (int i = 0; i < len_words; i++) {
+ bp[i] = from_word[i];
+ }
+}
+
+// Supply as many buffers to the receive available fifo as possible
+inline static void fill_av_fifo(usbdev_ctx_t *ctx) {
+ while (!(REG32(USBDEV_USBSTAT()) & (1 << USBDEV_USBSTAT_AV_FULL))) {
+ usbbufid_t buf = usbdev_buf_allocate_byid(ctx);
+ if (buf < 0) {
+ // no more free buffers, can't fill AV FIFO
+ break;
+ }
+ REG32(USBDEV_AVBUFFER()) = buf;
+ }
+}
+
+void usbdev_sendbuf_byid(usbdev_ctx_t *ctx, usbbufid_t buf, size_t size,
+ int endpoint) {
+ uint32_t configin = USBDEV_CONFIGIN0() + (4 * endpoint);
+
+ if ((endpoint >= NUM_ENDPOINTS) || (buf >= NUM_BUFS)) {
+ return;
+ }
+
+ if (size > BUF_LENGTH) {
+ size = BUF_LENGTH;
+ }
+
+ REG32(configin) =
+ ((buf << USBDEV_CONFIGIN0_BUFFER0_OFFSET) |
+ (size << USBDEV_CONFIGIN0_SIZE0_OFFSET) | (1 << USBDEV_CONFIGIN0_RDY0));
+}
+
+void usbdev_poll(usbdev_ctx_t *ctx) {
+ uint32_t istate = REG32(USBDEV_INTR_STATE());
+
+ // Do this first to keep things going
+ fill_av_fifo(ctx);
+
+ // Process IN completions first so we get the fact that send completed
+ // before processing a response
+ if (istate & (1 << USBDEV_INTR_STATE_PKT_SENT)) {
+ uint32_t sentep = REG32(USBDEV_IN_SENT());
+ uint32_t configin = USBDEV_CONFIGIN0();
+ TRC_C('a' + sentep);
+ for (int ep = 0; ep < NUM_ENDPOINTS; ep++) {
+ if (sentep & (1 << ep)) {
+ // Free up the buffer and optionally callback
+ int32_t cfgin = REG32(configin + (4 * ep));
+ usbdev_buf_free_byid(ctx, EXTRACT(cfgin, CONFIGIN0_BUFFER0));
+ if (ctx->tx_done_callback[ep]) {
+ ctx->tx_done_callback[ep](ctx->ep_ctx[ep]);
+ }
+ }
+ }
+ // Write one to clear all the ones we handled
+ REG32(USBDEV_IN_SENT()) = sentep;
+ // Clear the interupt
+ REG32(USBDEV_INTR_STATE()) = (1 << USBDEV_INTR_STATE_PKT_SENT);
+ }
+
+ if (istate & (1 << USBDEV_INTR_STATE_PKT_RECEIVED)) {
+ while (!(REG32(USBDEV_USBSTAT()) & (1 << USBDEV_USBSTAT_RX_EMPTY))) {
+ uint32_t rxinfo = REG32(USBDEV_RXFIFO());
+ usbbufid_t buf = EXTRACT(rxinfo, RXFIFO_BUFFER);
+ int size = EXTRACT(rxinfo, RXFIFO_SIZE);
+ int endpoint = EXTRACT(rxinfo, RXFIFO_EP);
+ int setup = (rxinfo >> USBDEV_RXFIFO_SETUP) & 1;
+
+ if (ctx->rx_callback[endpoint]) {
+ ctx->rx_callback[endpoint](ctx->ep_ctx[endpoint], buf, size, setup);
+ } else {
+ TRC_S("USB: unexpected RX ");
+ TRC_I(rxinfo, 24);
+ }
+ usbdev_buf_free_byid(ctx, buf);
+ }
+ // Clear the interupt
+ REG32(USBDEV_INTR_STATE()) = (1 << USBDEV_INTR_STATE_PKT_RECEIVED);
+ }
+ if (istate & ~((1 << USBDEV_INTR_STATE_PKT_RECEIVED) |
+ (1 << USBDEV_INTR_STATE_PKT_SENT))) {
+ TRC_C('I');
+ TRC_I(istate, 12);
+ TRC_C(' ');
+ REG32(USBDEV_INTR_STATE()) =
+ istate & ~((1 << USBDEV_INTR_STATE_PKT_RECEIVED) |
+ (1 << USBDEV_INTR_STATE_PKT_SENT));
+ }
+ // TODO(mdhayter) - clean this up
+ // Frame ticks every 1ms, use to flush data every 16ms
+ // (faster in DPI but this seems to work ok)
+ // At reset frame count is 0, compare to 1 so no calls before SOF received
+ uint32_t usbframe = EXTRACT(REG32(USBDEV_USBSTAT()), USBSTAT_FRAME);
+ if ((usbframe & 0xf) == 1) {
+ if (ctx->flushed == 0) {
+ for (int i = 0; i < NUM_ENDPOINTS; i++) {
+ if (ctx->flush[i]) {
+ ctx->flush[i](ctx->ep_ctx[i]);
+ }
+ }
+ ctx->flushed = 1;
+ }
+ } else {
+ ctx->flushed = 0;
+ }
+ // TODO(mdhater) Errors? What Errors?
+}
+
+void usbdev_set_deviceid(usbdev_ctx_t *ctx, int deviceid) {
+ REG32(USBDEV_USBCTRL()) = (1 << USBDEV_USBCTRL_ENABLE) |
+ (deviceid << USBDEV_USBCTRL_DEVICE_ADDRESS_OFFSET);
+}
+
+void usbdev_halt(usbdev_ctx_t *ctx, int endpoint, int enable) {
+ uint32_t epbit = 1 << endpoint;
+ uint32_t stall = REG32(USBDEV_STALL());
+ if (enable) {
+ stall |= epbit;
+ } else {
+ stall &= ~epbit;
+ }
+ REG32(USBDEV_STALL()) = stall;
+ ctx->halted = stall;
+ // TODO future addition would be to callback the endpoint driver
+ // for now it just sees its traffic has stopped
+}
+
+// TODO got hang with this inline
+int usbdev_can_rem_wake(usbdev_ctx_t *ctx) { return ctx->can_wake; }
+
+void usbdev_endpoint_setup(usbdev_ctx_t *ctx, int ep, int enableout,
+ void *ep_ctx, void (*tx_done)(void *),
+ void (*rx)(void *, usbbufid_t, int, int),
+ void (*flush)(void *)) {
+ ctx->ep_ctx[ep] = ep_ctx;
+ ctx->tx_done_callback[ep] = tx_done;
+ ctx->rx_callback[ep] = rx;
+ ctx->flush[ep] = flush;
+ if (enableout) {
+ uint32_t rxen = REG32(USBDEV_RXENABLE());
+ rxen |= (1 << (ep + USBDEV_RXENABLE_OUT0));
+ REG32(USBDEV_RXENABLE()) = rxen;
+ }
+}
+
+void usbdev_init(usbdev_ctx_t *ctx) {
+ // setup context
+ for (int i = 0; i < NUM_ENDPOINTS; i++) {
+ usbdev_endpoint_setup(ctx, i, 0, NULL, NULL, NULL, NULL);
+ }
+ ctx->halted = 0;
+ ctx->can_wake = 0;
+ buf_init(ctx);
+
+ // All about polling...
+ REG32(USBDEV_INTR_ENABLE()) = 0;
+
+ // Provide buffers for any reception
+ fill_av_fifo(ctx);
+
+ REG32(USBDEV_RXENABLE()) =
+ ((1 << USBDEV_RXENABLE_SETUP0) | (1 << USBDEV_RXENABLE_OUT0));
+
+ REG32(USBDEV_USBCTRL()) = (1 << USBDEV_USBCTRL_ENABLE);
+}
diff --git a/sw/lib/usbdev.h b/sw/lib/usbdev.h
new file mode 100644
index 0000000..003a388
--- /dev/null
+++ b/sw/lib/usbdev.h
@@ -0,0 +1,183 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#ifndef _USBDEV_H_
+#define _USBDEV_H_
+
+#include <stddef.h>
+#include <stdint.h>
+
+// Hardware parameters
+#define NUM_BUFS 32
+#define BUF_LENGTH 64
+#define NUM_ENDPOINTS 12
+
+// USB buffers are held in the SRAM in the interface, referenced by ID
+// Buffer IDs are 0 to NUM_BUFS
+// Use negative buffer ID for error
+typedef int usbbufid_t;
+typedef struct usbdev_ctx usbdev_ctx_t;
+
+// Note: this is only needed here because the caller of init needs it
+struct usbdev_ctx {
+ // TODO: base_addr goes here once header files support using it
+ int can_wake;
+ uint8_t freebuf[NUM_BUFS];
+ uint32_t halted; // bit vector per endpoint
+ int nfree;
+ int flushed;
+ usbdev_ctx_t *ep_ctx[NUM_ENDPOINTS];
+ void (*tx_done_callback[NUM_ENDPOINTS])(void *);
+ void (*rx_callback[NUM_ENDPOINTS])(void *, usbbufid_t, int, int);
+ void (*flush[NUM_ENDPOINTS])(void *);
+};
+
+/**
+ * Allocate a buffer for the caller to use
+ *
+ * @param ctx usbdev context pointer
+ * @return buffer ID or negative for out of buffer error
+ */
+usbbufid_t usbdev_buf_allocate_byid(usbdev_ctx_t *ctx);
+
+/**
+ * Free a buffer when caller no longer needs it
+ *
+ * @param ctx usbdev context pointer
+ * @param buf buffer ID being returned to free pool
+ * @return 0 or -1 if the free pool is full (shouldn't happen)
+ */
+int usbdev_buf_free_byid(usbdev_ctx_t *ctx, usbbufid_t buf);
+
+/**
+ * Get memory address for accessing data in a buffer
+ *
+ * Hardware restriction: buffer can only be written with 32-bit words
+ * Ok to cast the return value to int8_t * for reading
+ *
+ * @param ctx usbdev context pointer
+ * @param buf buffer ID to access
+ * @return pointer to access the data of @p buf
+ */
+uint32_t *usbdev_buf_idtoaddr(usbdev_ctx_t *ctx, usbbufid_t buf);
+
+/**
+ * Copy from memory into a buffer, referencing by buffer ID
+ *
+ * Implementation restriction: from must be 4-byte aligned
+ * TODO(mdhayer) remove restriction
+ *
+ * @param ctx usbdev context pointer
+ * @param buf buffer ID to copy to
+ * @param from source address for data
+ * @param len_bytes length in bytes of data to copy
+ */
+void usbdev_buf_copyto_byid(usbdev_ctx_t *ctx, usbbufid_t buf, const void *from,
+ size_t len_bytes);
+
+/**
+ * Schedule a buffer for transmission on an endpoint
+ *
+ * Send happens on next IN request for that endpoint from the host.
+ * Once this call is made the buffer is owned by the hardware
+ *
+ * @param ctx usbdev context pointer
+ * @param buf buffer ID to send
+ * @param size length in bytes of data to send, zero is valid (used as ack)
+ * @param endpoint endpoint to send from
+ */
+void usbdev_sendbuf_byid(usbdev_ctx_t *ctx, usbbufid_t buf, size_t size,
+ int endpoint);
+
+/**
+ * Call regularly to poll the usbdev interface
+ *
+ * @param ctx usbdev context pointer
+ */
+void usbdev_poll(usbdev_ctx_t *ctx);
+
+/**
+ * Set the USB device ID
+ *
+ * Device ID must be zero at init. When the host assigns an ID
+ * with a SET_ADDRESS packet and the complete SETUP transaction is
+ * complete, this function should be called to set the new ID. Note
+ * on a reset the hardware will clear the device ID back to 0.
+ *
+ * @param usbdev context pointer
+ * @param new deviceid
+ */
+void usbdev_set_deviceid(usbdev_ctx_t *ctx, int deviceid);
+
+/**
+ * Halt or release an endpoint
+ *
+ * By default endpoints are enabled, but they can be halted but the host
+ *
+ * @param usbdev context pointer
+ * @param endpoint number
+ * @param enable set/clear
+ */
+void usbdev_halt(usbdev_ctx_t *ctx, int endpoint, int enable);
+
+/**
+ * Get halted status for an endpoint
+ *
+ * @param usbdev context pointer
+ * @return 1 if endpoint is halted else 0
+ */
+inline int usbdev_halted(usbdev_ctx_t *ctx, int endpoint) {
+ return (ctx->halted >> endpoint) & 0x1;
+}
+
+/**
+ * Enable or disable remote wake
+ *
+ * @param usbdev context pointer
+ * @param enable set/clear
+ */
+inline void usbdev_rem_wake_en(usbdev_ctx_t *ctx, int enable) {
+ ctx->can_wake = (enable) ? 1 : 0;
+}
+
+/**
+ * Get ability to wake the host
+ *
+ * @param usbdev context pointer
+ * @return 1 if remote wake is permitted else 0
+ */
+int usbdev_can_rem_wake(usbdev_ctx_t *ctx);
+
+/**
+ * Call to setup an endpoint
+ *
+ * @param ctx usbdev context pointer
+ * @param ep endpoint number
+ * @param enableout boolean, true to enable OUT transactions on the endpoint
+ * (OUT means host->device, ie receive by us)
+ * @param ep_ctx context pointer for callee
+ * @param tx_done(void *ep_ctx) callback once send has been Acked
+ * @param rx(void *ep_ctx, usbbufid_t buf, int size, int setup)
+ called when a packet is received
+ * @param flush(void *ep_ctx) called every 16ms based USB host timebase
+ */
+void usbdev_endpoint_setup(usbdev_ctx_t *ctx, int ep, int enableout,
+ void *ep_ctx, void (*tx_done)(void *),
+ void (*rx)(void *, usbbufid_t, int, int),
+ void (*flush)(void *));
+
+/**
+ * Initialize the usbdev interface
+ *
+ * @param ctx uninitialized usbdev context pointer
+ */
+void usbdev_init(usbdev_ctx_t *ctx);
+
+// Used for tracing what is going on
+#include "uart.h"
+#define TRC_S(s) uart_send_str(s)
+#define TRC_I(i, b) uart_send_uint(i, b)
+#define TRC_C(c) uart_send_char(c)
+
+#endif
diff --git a/sw/tests/hello_flash/Makefile b/sw/tests/hello_flash/Makefile
new file mode 100644
index 0000000..4f4c6c1
--- /dev/null
+++ b/sw/tests/hello_flash/Makefile
@@ -0,0 +1,12 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+NAME = hello_flash
+SRCS = hello_flash.c
+PROGRAM_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
+include ${PROGRAM_DIR}/../../exts/common/common.mk
diff --git a/sw/tests/hello_flash/hello_flash.c b/sw/tests/hello_flash/hello_flash.c
new file mode 100644
index 0000000..6624509
--- /dev/null
+++ b/sw/tests/hello_flash/hello_flash.c
@@ -0,0 +1,192 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "common.h"
+#include "flash_ctrl.h"
+#include "gpio.h"
+#include "uart.h"
+
+#define DATA_MAX 32
+
+/**
+ * Delay loop executing within 8 cycles on ibex
+ */
+static void delay_loop_ibex(unsigned long loops) {
+ int out; /* only to notify compiler of modifications to |loops| */
+ asm volatile(
+ "1: nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " addi %1, %1, -1 \n" // 1 cycle
+ " bnez %1, 1b \n" // 3 cycles
+ : "=&r"(out)
+ : "0"(loops));
+}
+
+static int usleep_ibex(unsigned long usec) {
+ unsigned long usec_cycles;
+ usec_cycles = CLK_FIXED_FREQ_HZ * usec / 1000 / 1000 / 8;
+
+ delay_loop_ibex(usec_cycles);
+ return 0;
+}
+
+static int usleep(unsigned long usec) { return usleep_ibex(usec); }
+
+static void break_on_error(uint32_t error) {
+ if (error) {
+ // inifinitely fetch instructions, will flag an assertion error
+ uart_send_str("Test Failed!\r\n");
+ while (1) {
+ usleep_ibex(100);
+ }
+ }
+
+ // otherwise do nothing and continue
+}
+
+#define MK_PRINT(c) (((c < 32) || (c > 126)) ? '_' : c)
+
+int main(int argc, char **argv) {
+ uart_init(UART_BAUD_RATE);
+
+ // Stupid flash testing
+ uint32_t num_words;
+ uint32_t i;
+ uint32_t prog_array[DATA_MAX];
+ uint32_t rd_array[DATA_MAX];
+ uint32_t max_size;
+ uint32_t start_addr;
+ uint32_t data_pat;
+ uint32_t flash_bank1_loc = FLASH_MEM_BASE_ADDR + FLASH_BANK_SZ;
+
+ // wait for flash to finish "initializing"
+ wait_flash_init();
+
+ // enable all access
+ flash_default_region(1, 1, 1);
+
+ // program flash
+ num_words = 32;
+ for (i = 0; i < num_words; i++) {
+ prog_array[i] = i;
+ }
+
+ break_on_error(prog_flash(flash_bank1_loc, num_words, prog_array));
+
+ // read flash back
+ num_words = 32;
+ break_on_error(read_flash(flash_bank1_loc, num_words, rd_array));
+
+ for (i = 0; i < num_words; i++) {
+ if (prog_array[i] != rd_array[i]) {
+ REG32(FLASH_CTRL_SCRATCH(0)) = rd_array[i];
+ break_on_error(1);
+ }
+ }
+
+ // erase flash and verify
+ // The controller auto rounds down to the closest page for page erase
+ break_on_error(page_erase(flash_bank1_loc + FLASH_PAGE_SZ - 1));
+
+ REG32(FLASH_CTRL_SCRATCH(0)) = 0xFACEDEAD;
+
+ // read flash back via host to ensure everything is cleared
+ for (i = 0; i < 256; i++) {
+ if (REG32(flash_bank1_loc + i * 4) != 0xFFFFFFFF) {
+ REG32(FLASH_CTRL_SCRATCH(0)) = 0xDEADBEEF;
+ break_on_error(1);
+ }
+ }
+
+ // do 4K programming
+ // employ the live programming method where overall payload >> flash fifo size
+ max_size = 1024;
+ start_addr = flash_bank1_loc + 0x8c68;
+ setup_flash_prog(start_addr, max_size);
+
+ for (i = 0; i < max_size; i++) {
+ data_pat = (i % 2) ? 0xA5A5A5A5 : 0x5A5A5A5A;
+ REG32(FLASH_CTRL_PROG_FIFO(FLASH_CTRL0_BASE_ADDR)) = data_pat + i;
+ }
+
+ // wait for operation finish
+ wait_done_and_ack();
+
+ // read back 4K programming
+ for (i = 0; i < max_size; i++) {
+ data_pat = (i % 2) ? 0xA5A5A5A5 : 0x5A5A5A5A;
+
+ if (REG32(start_addr + i * 4) != data_pat + i) {
+ REG32(FLASH_CTRL_SCRATCH(0)) = i << 16 | 0xDEAD;
+ break_on_error(1);
+ }
+ }
+
+ /////////////////////////////////////////////////////////////
+ // Begin flash memory protection testing
+ /////////////////////////////////////////////////////////////
+
+ // turn off default region all access
+ flash_default_region(0, 0, 0);
+
+ uint32_t region_base_page = FLASH_PAGES_PER_BANK;
+ uint32_t region_size = 1;
+ uint32_t good_addr_start =
+ FLASH_MEM_BASE_ADDR + region_base_page * FLASH_PAGE_SZ;
+ uint32_t good_addr_end = good_addr_start + region_size * FLASH_PAGE_SZ - 1;
+ uint32_t bad_addr_start =
+ good_addr_end + 1; // this is always aligned to a page
+ uint32_t good_words = 3;
+ uint32_t bad_words = 3;
+ uint32_t chk_addr = bad_addr_start - (FLASH_WORD_SZ * good_words);
+
+ mp_region_t region0 = {
+ 0, // region 0
+ region_base_page, // page 1 of bank1
+ region_size, // size of 1 page
+ 1, // allow read
+ 1, // allow program
+ 1 // allow erase
+ };
+ flash_cfg_region(region0);
+
+ for (uint32_t i = 0; i < good_words + bad_words; i++) {
+ prog_array[i] = 0xA5A5A5A5 + i;
+ }
+
+ break_on_error(!prog_flash(chk_addr, good_words + bad_words, prog_array));
+
+ // the good words should match
+ for (uint32_t i = 0; i < good_words; i++) {
+ if (REG32(chk_addr + i * 4) != prog_array[i]) {
+ break_on_error(1);
+ }
+ }
+
+ // the bad word contents should not have gone through
+ for (uint32_t i = good_words; i < good_words + bad_words; i++) {
+ if (REG32(chk_addr + i * 4) != 0xFFFFFFFF) {
+ break_on_error(1);
+ }
+ }
+
+ // attempt to erase bad page, should error
+ break_on_error(!page_erase(bad_addr_start));
+
+ // erase the good page
+ break_on_error(page_erase(good_addr_start));
+
+ // double check erase results
+ for (uint32_t i = 0; i < FLASH_WORDS_PER_PAGE; i++) {
+ if (REG32(good_addr_start + i * 4) != 0xFFFFFFFF) {
+ break_on_error(1);
+ }
+ }
+
+ // cleanly terminiate execution
+ uart_send_str("Test Passed!\r\n");
+ __asm__ volatile("wfi;");
+}
diff --git a/sw/tests/hello_usbdev/Makefile b/sw/tests/hello_usbdev/Makefile
new file mode 100644
index 0000000..2814e8d
--- /dev/null
+++ b/sw/tests/hello_usbdev/Makefile
@@ -0,0 +1,12 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the project
+
+NAME = hello_usbdev
+SRCS = $(NAME).c
+PROGRAM_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
+include ${PROGRAM_DIR}/../../exts/common/common.mk
diff --git a/sw/tests/hello_usbdev/hello_usbdev.c b/sw/tests/hello_usbdev/hello_usbdev.c
new file mode 100644
index 0000000..639c734
--- /dev/null
+++ b/sw/tests/hello_usbdev/hello_usbdev.c
@@ -0,0 +1,149 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "common.h"
+#include "gpio.h"
+#include "uart.h"
+#include "usb_controlep.h"
+#include "usb_simpleserial.h"
+#include "usbdev.h"
+
+// These just for the '/' printout
+#define USBDEV_BASE_ADDR 0x40020000
+#include "usbdev_regs.h"
+
+// Build Configuration descriptor array
+static uint8_t cfg_dscr[] = {
+ USB_CFG_DSCR_HEAD(
+ USB_CFG_DSCR_LEN + 2 * (USB_INTERFACE_DSCR_LEN + 2 * USB_EP_DSCR_LEN),
+ 2) VEND_INTERFACE_DSCR(0, 2, 0x50, 1) USB_BULK_EP_DSCR(0, 1, 32, 0)
+ USB_BULK_EP_DSCR(1, 1, 32, 4) VEND_INTERFACE_DSCR(1, 2, 0x50, 1)
+ USB_BULK_EP_DSCR(0, 2, 32, 0) USB_BULK_EP_DSCR(1, 2, 32, 4)};
+// The array above may not end aligned on a 4-byte boundary
+// and is probably at the end of the initialized data section
+// Conversion to srec needs this to be aligned so force it by
+// initializing an int32 (volatile else it is not used and can go away)
+static volatile int32_t sdata_align = 42;
+
+/* context areas */
+static usbdev_ctx_t usbdev_ctx;
+static usb_controlep_ctx_t control_ctx;
+static usb_ss_ctx_t ss_ctx[2];
+
+/**
+ * Delay loop executing within 8 cycles on ibex
+ */
+static void delay_loop_ibex(unsigned long loops) {
+ int out; /* only to notify compiler of modifications to |loops| */
+ asm volatile(
+ "1: nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " addi %1, %1, -1 \n" // 1 cycle
+ " bnez %1, 1b \n" // 3 cycles
+ : "=&r"(out)
+ : "0"(loops));
+}
+
+static int usleep_ibex(unsigned long usec) {
+ unsigned long usec_cycles;
+ usec_cycles = CLK_FIXED_FREQ_HZ * usec / 1000 / 1000 / 8;
+
+ delay_loop_ibex(usec_cycles);
+ return 0;
+}
+
+static int usleep(unsigned long usec) { return usleep_ibex(usec); }
+
+// called from ctr0 when something bad happens
+// char I=illegal instruction, A=lsu error (address), E=ecall
+void trap_handler(uint32_t mepc, char c) {
+ uart_send_char(c);
+ uart_send_uint(mepc, 32);
+ while (1) {
+ gpio_write_all(0xAA00); // pattern
+ usleep(200 * 1000);
+ gpio_write_all(0x5500); // pattern
+ usleep(100 * 1000);
+ }
+}
+
+#define MK_PRINT(c) \
+ (((c != 0xa) && (c != 0xd) && ((c < 32) || (c > 126))) ? '_' : c)
+
+/* Inbound USB characters get printed to the UART via these callbacks */
+/* Not ideal because the UART is slower */
+static void serial_rx0(uint8_t c) { uart_send_char(MK_PRINT(c)); }
+/* Add one to rx character so you can tell it is the second instance */
+static void serial_rx1(uint8_t c) { uart_send_char(MK_PRINT(c + 1)); }
+
+int main(int argc, char **argv) {
+ uart_init(UART_BAUD_RATE);
+
+ // Enable GPIO: 0-7 and 16 is input, 8-15 is output
+ gpio_init(0xFF00);
+
+ // Add DATE and TIME because I keep fooling myself with old versions
+ uart_send_str(
+ "Hello USB! "__DATE__
+ " "__TIME__
+ "\r\n");
+ uart_send_str("Characters from UART go to USB and GPIO\r\n");
+ uart_send_str("Characters from USB go to UART\r\n");
+
+ // Give a LED pattern as startup indicator for 5 seconds
+ gpio_write_all(0xAA00); // pattern
+ usleep(1000);
+ gpio_write_all(0x5500); // pattern
+ // usbdev_init here so dpi code will not start until simulation
+ // got through all the printing (which takes a while if --trace)
+ usbdev_init(&usbdev_ctx);
+ usb_controlep_init(&control_ctx, &usbdev_ctx, 0, cfg_dscr, sizeof(cfg_dscr));
+ usb_simpleserial_init(&ss_ctx[0], &usbdev_ctx, 1, serial_rx0);
+ usb_simpleserial_init(&ss_ctx[1], &usbdev_ctx, 2, serial_rx1);
+
+ uint32_t gpio_in;
+ uint32_t gpio_in_prev = 0;
+ uint32_t gpio_in_changes;
+
+ while (1) {
+ usbdev_poll(&usbdev_ctx);
+ // report changed switches over UART
+ gpio_in = gpio_read() & 0x100FF; // 0-7 is switch input, 16 is FTDI
+ gpio_in_changes = (gpio_in & ~gpio_in_prev) | (~gpio_in & gpio_in_prev);
+ for (int b = 0; b < 8; b++) {
+ if (gpio_in_changes & (1 << b)) {
+ int val_now = (gpio_in >> b) & 0x01;
+ uart_send_str("GPIO: Switch ");
+ uart_send_char(b + 48);
+ uart_send_str(" changed to ");
+ uart_send_char(val_now + 48);
+ uart_send_str("\r\n");
+ }
+ }
+ if (gpio_in_changes & 0x10000) {
+ uart_send_str("FTDI control changed. Enable ");
+ uart_send_str((gpio_in & 0x10000) ? "JTAG\r\n" : "SPI\r\n");
+ }
+ gpio_in_prev = gpio_in;
+
+ // UART echo
+ char rcv_char;
+ while (uart_rcv_char(&rcv_char) != -1) {
+ uart_send_char(rcv_char);
+ if (rcv_char == '/') {
+ uart_send_char('I');
+ uart_send_uint(REG32(USBDEV_INTR_STATE()), 12);
+ uart_send_char('-');
+ uart_send_uint(REG32(USBDEV_USBSTAT()), 32);
+ uart_send_char(' ');
+ } else {
+ usb_simpleserial_send_byte(&ss_ctx[0], rcv_char);
+ usb_simpleserial_send_byte(&ss_ctx[1], rcv_char + 1);
+ }
+ gpio_write_all(rcv_char << 8);
+ }
+ }
+}
diff --git a/sw/tests/hello_world/Makefile b/sw/tests/hello_world/Makefile
new file mode 100644
index 0000000..f947497
--- /dev/null
+++ b/sw/tests/hello_world/Makefile
@@ -0,0 +1,12 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+NAME = hello_world
+SRCS = hello_world.c
+PROGRAM_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
+include ${PROGRAM_DIR}/../../exts/common/common.mk
diff --git a/sw/tests/hello_world/hello_world.c b/sw/tests/hello_world/hello_world.c
new file mode 100644
index 0000000..9b40986
--- /dev/null
+++ b/sw/tests/hello_world/hello_world.c
@@ -0,0 +1,130 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include "common.h"
+#include "gpio.h"
+#include "spi_device.h"
+#include "uart.h"
+
+#define SPI_MAX 32
+
+/**
+ * Delay loop executing within 8 cycles on ibex
+ */
+static void delay_loop_ibex(unsigned long loops) {
+ int out; /* only to notify compiler of modifications to |loops| */
+ asm volatile(
+ "1: nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " nop \n" // 1 cycle
+ " addi %1, %1, -1 \n" // 1 cycle
+ " bnez %1, 1b \n" // 3 cycles
+ : "=&r"(out)
+ : "0"(loops));
+}
+
+static int usleep_ibex(unsigned long usec) {
+ unsigned long usec_cycles;
+ usec_cycles = CLK_FIXED_FREQ_HZ * usec / 1000 / 1000 / 8;
+
+ delay_loop_ibex(usec_cycles);
+ return 0;
+}
+
+static int usleep(unsigned long usec) { return usleep_ibex(usec); }
+
+// called from ctr0 when something bad happens
+// char I=illegal instruction, A=lsu error (address), E=ecall
+void trap_handler(uint32_t mepc, char c) {
+ uart_send_char(c);
+ uart_send_uint(mepc, 32);
+ while (1) {
+ gpio_write_all(0xAA00); // pattern
+ usleep(200 * 1000);
+ gpio_write_all(0x5500); // pattern
+ usleep(100 * 1000);
+ }
+}
+
+#define MK_PRINT(c) (((c < 32) || (c > 126)) ? '_' : c)
+
+int main(int argc, char **argv) {
+ uart_init(UART_BAUD_RATE);
+
+ // Enable GPIO: 0-7 and 16 is input, 8-15 is output
+ gpio_init(0xFF00);
+
+ spid_init();
+ // Add DATE and TIME because I keep fooling myself with old versions
+ uart_send_str(
+ "Hello World! "__DATE__
+ " "__TIME__
+ "\r\n");
+ uart_send_str("Watch the LEDs!\r\n");
+
+ // Give a LED pattern as startup indicator for 5 seconds
+ gpio_write_all(0xFF00); // all LEDs on
+ for (int i = 0; i < 32; i++) {
+ usleep(100 * 1000); // 100 ms
+
+ gpio_write_bit(8 + (i % 8), (i / 8));
+ }
+
+ // Now have UART <-> Buttons/LEDs demo
+ // all LEDs off
+ gpio_write_all(0x0000);
+ uart_send_str("Try out the switches on the board\r\n");
+ uart_send_str("or type anything into the console window.\r\n");
+ uart_send_str("The LEDs show the ASCII code of the last character.\r\n");
+
+ uint32_t gpio_in;
+ uint32_t gpio_in_prev = 0;
+ uint32_t gpio_in_changes;
+ uint8_t spi_buf[SPI_MAX];
+ uint32_t spi_in;
+
+ spid_send("SPI!", 4);
+
+ while (1) {
+ usleep(10 * 1000); // 10 ms
+
+ // report changed switches over UART
+ gpio_in = gpio_read() & 0x100FF; // 0-7 is switch input, 16 is FTDI
+ gpio_in_changes = (gpio_in & ~gpio_in_prev) | (~gpio_in & gpio_in_prev);
+ for (int b = 0; b < 8; b++) {
+ if (gpio_in_changes & (1 << b)) {
+ int val_now = (gpio_in >> b) & 0x01;
+ uart_send_str("GPIO: Switch ");
+ uart_send_char(b + 48);
+ uart_send_str(" changed to ");
+ uart_send_char(val_now + 48);
+ uart_send_str("\r\n");
+ }
+ }
+ if (gpio_in_changes & 0x10000) {
+ uart_send_str("FTDI control changed. Enable ");
+ uart_send_str((gpio_in & 0x10000) ? "JTAG\r\n" : "SPI\r\n");
+ }
+ gpio_in_prev = gpio_in;
+
+ // SPI character echo
+ spi_in = spid_read_nb(spi_buf, SPI_MAX);
+ if (spi_in) {
+ uint32_t d = (*(uint32_t *)spi_buf) ^ 0x01010101;
+ spid_send(&d, 4);
+ uart_send_str("SPI: ");
+ for (int i = 0; i < spi_in; i++) {
+ uart_send_char(MK_PRINT(spi_buf[i]));
+ }
+ uart_send_str("\r\n");
+ }
+ // UART echo
+ char rcv_char;
+ while (uart_rcv_char(&rcv_char) != -1) {
+ uart_send_char(rcv_char);
+ gpio_write_all(rcv_char << 8);
+ }
+ }
+}
diff --git a/sw/tests/sanity_hmac/Makefile b/sw/tests/sanity_hmac/Makefile
new file mode 100644
index 0000000..28da267
--- /dev/null
+++ b/sw/tests/sanity_hmac/Makefile
@@ -0,0 +1,12 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+NAME = sanity_hmac
+SRCS = sanity_hmac.c
+PROGRAM_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
+include ${PROGRAM_DIR}/../../exts/common/common.mk
diff --git a/sw/tests/sanity_hmac/sanity_hmac.c b/sw/tests/sanity_hmac/sanity_hmac.c
new file mode 100644
index 0000000..95ffdfe
--- /dev/null
+++ b/sw/tests/sanity_hmac/sanity_hmac.c
@@ -0,0 +1,68 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include <stdlib.h>
+#include <string.h>
+
+#include "common.h"
+#include "flash_ctrl.h"
+#include "hmac.h"
+#include "hmac_regs.h"
+#include "uart.h"
+
+typedef union digest {
+ uint8_t b[32];
+ uint32_t w[8];
+} digest_t;
+
+typedef struct test_data {
+ uint32_t digest[8];
+ char sha_input[512];
+} test_data_t;
+
+test_data_t test = {
+ {0xdc96c23d, 0xaf36e268, 0xcb68ff71, 0xe92f76e2, 0xb8a8379d, 0x426dc745,
+ 0x19f5cff7, 0x4ec9c6d6},
+ "Every one suspects himself of at least one of the cardinal virtues, and "
+ "this is mine: I am one of the few honest people that I have ever known"};
+
+int main(int argc, char **argv) {
+ uint32_t error = 0;
+ digest_t digest;
+
+ uart_init(UART_BAUD_RATE);
+
+ hmac_cfg_t setup = {.mode = Sha256,
+ .input_endian_swap = 1,
+ .digest_endian_swap = 1,
+ .length_lower = 0,
+ .length_upper = 0,
+ .keys = {0}};
+
+ // length in bits
+ setup.length_lower = strlen(test.sha_input) << 3;
+
+ hmac_init(setup);
+
+ hmac_write(test.sha_input, strlen(test.sha_input));
+
+ error |= hmac_done(digest.w);
+
+ for (uint32_t i = 0; i < 8; i++) {
+ if (digest.w[i] != test.digest[i]) {
+ REG32(FLASH_CTRL_SCRATCH(0)) = digest.w[i];
+ error++;
+ break;
+ }
+ }
+
+ if (error) {
+ uart_send_str("FAIL!\n");
+ while (1) {
+ }
+ } else {
+ uart_send_str("PASS!\n");
+ __asm__ volatile("wfi;");
+ }
+}
diff --git a/sw/tests/sanity_timer/Makefile b/sw/tests/sanity_timer/Makefile
new file mode 100644
index 0000000..a7a68ec
--- /dev/null
+++ b/sw/tests/sanity_timer/Makefile
@@ -0,0 +1,12 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+NAME = sanity_timer
+SRCS = sanity_timer.c
+PROGRAM_DIR := $(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+include ${PROGRAM_DIR}/../../exts/common/options.mk
+include ${PROGRAM_DIR}/../../exts/common/common.mk
diff --git a/sw/tests/sanity_timer/sanity_timer.c b/sw/tests/sanity_timer/sanity_timer.c
new file mode 100644
index 0000000..34c7027
--- /dev/null
+++ b/sw/tests/sanity_timer/sanity_timer.c
@@ -0,0 +1,43 @@
+// Copyright lowRISC contributors.
+// Licensed under the Apache License, Version 2.0, see LICENSE for details.
+// SPDX-License-Identifier: Apache-2.0
+
+#include <stdlib.h>
+#include <string.h>
+
+#include "common.h"
+#include "irq.h"
+#include "rv_timer.h"
+#include "uart.h"
+
+static uint32_t intr_handling_success = 0;
+static const uint32_t hart = 0;
+
+int main(int argc, char **argv) {
+ uint64_t cmp = 0x00000000000000FF;
+
+ uart_init(UART_BAUD_RATE);
+
+ irq_global_ctrl(true);
+ irq_timer_ctrl(true);
+ rv_timer_set_us_tick(hart);
+ rv_timer_set_cmp(hart, cmp);
+ rv_timer_ctrl(hart, true);
+ rv_timer_intr_enable(hart, true);
+
+ while (1) {
+ if (intr_handling_success) {
+ break;
+ }
+ }
+
+ uart_send_str("PASS!\n");
+ __asm__ volatile("wfi;");
+}
+
+// Override weak default function
+void handler_irq_timer(void) {
+ rv_timer_ctrl(hart, false);
+ rv_timer_clr_all_intrs();
+ intr_handling_success = 1;
+}
diff --git a/sw/vendor/coremark/LICENSE.md b/sw/vendor/coremark/LICENSE.md
new file mode 100644
index 0000000..14e53e9
--- /dev/null
+++ b/sw/vendor/coremark/LICENSE.md
@@ -0,0 +1,100 @@
+# COREMARK® ACCEPTABLE USE AGREEMENT
+
+This ACCEPTABLE USE AGREEMENT (this “Agreement”) is offered by Embedded Microprocessor Benchmark Consortium, a California nonprofit corporation (“Licensor”), to users of its CoreMark® software (“Licensee”) exclusively on the following terms.
+
+Licensor offers benchmarking software (“Software”) pursuant to an open source license, but carefully controls use of its benchmarks and their associated goodwill. Licensor has registered its trademark in one of the benchmarks available through the Software, COREMARK, Ser. No. 85/487,290; Reg. No. 4,179,307 (the “Trademark”), and promotes the use of a standard metric as a benchmark for assessing the performance of embedded systems. Solely on the terms described herein, Licensee may use and display the Trademark in connection with the generation of data regarding measurement and analysis of computer and embedded system benchmarking via the Software (the “Licensed Use”).
+
+## Article 1 – License Grant.
+1.1. License. Subject to the terms and conditions of this Agreement, Licensor hereby grants to Licensee, and Licensee hereby accepts from Licensor, a personal, non-exclusive, royalty-free, revocable right and license to use and display the Trademark during the term of this Agreement (the “Term”), solely and exclusively in connection with the Licensed Use. During the Term, Licensee (i) shall not modify or otherwise create derivative works of the Trademark, and (ii) may use the Trademark only to the extent permitted under this License. Neither Licensee nor any affiliate or agent thereof shall otherwise use the Trademark without the prior express written consent of Licensor, which may be withheld in its sole and absolute discretion. All rights not expressly granted to Licensee hereunder shall remain the exclusive property of Licensor.
+
+1.2. Modifications to the Software. Licensee shall not use the Trademark in connection with any use of a modified, derivative, or otherwise altered copy of the Software.
+
+1.3. Licensor’s Use. Nothing in this Agreement shall preclude Licensor or any of its successors or assigns from using or permitting other entities to use the Trademark, whether or not such entity directly or indirectly competes or conflicts with Licensee’s Licensed Use in any manner.
+
+1.4. Term and Termination. This Agreement is perpetual unless terminated by either of the parties. Licensee may terminate this Agreement for convenience, without cause or liability, for any reason or for no reason whatsoever, upon ten (10) business days written notice. Licensor may terminate this Agreement effective immediately upon notice of breach. Upon termination, Licensee shall immediately remove all implementations of the Trademark from the Licensed Use, and delete all digitals files and records of all materials related to the Trademark.
+
+## Article 2 – Ownership.
+2.1. Ownership. Licensee acknowledges and agrees that Licensor is the owner of all right, title, and interest in and to the Trademark, and all such right, title, and interest shall remain with Licensor. Licensee shall not contest, dispute, challenge, oppose, or seek to cancel Licensor’s right, title, and interest in and to the Trademark. Licensee shall not prosecute any application for registration of the Trademark. Licensee shall display appropriate notices regarding ownership of the Trademark in connection with the Licensed Use.
+
+2.2. Goodwill. Licensee acknowledges that Licensee shall not acquire any right, title, or interest in the Trademark by virtue of this Agreement other than the license granted hereunder, and disclaims any such right, title, interest, or ownership. All goodwill and reputation generated by Licensee’s use of the Trademark shall inure to the exclusive benefit of Licensor. Licensee shall not by any act or omission use the Trademark in any manner that disparages or reflects adversely on Licensor or its Licensed Use or reputation. Licensee shall not take any action that would interfere with or prejudice Licensor’s ownership or registration of the Trademark, the validity of the Trademark or the validity of the license granted by this Agreement. If Licensor determines and notifies Licensee that any act taken in connection with the Licensed Use (i) is inaccurate, unlawful or offensive to good taste; (ii) fails to provide for proper trademark notices, or (iii) otherwise violates Licensee’s obligations under this Agreement, the license granted under this Agreement shall terminate.
+
+## Article 3 – Indemnification.
+3.1. Indemnification Generally. Licensee agrees to indemnify, defend, and hold harmless (collectively “indemnify” or “indemnification”) Licensor, including Licensor’s members, managers, officers, and employees (collectively “Related Persons”), from and against, and pay or reimburse Licensor and such Related Persons for, any and all third-party actions, claims, demands, proceedings, investigations, inquiries (collectively, “Claims”), and any and all liabilities, obligations, fines, deficiencies, costs, expenses, royalties, losses, and damages (including reasonable outside counsel fees and expenses) associated with such Claims, to the extent that such Claim arises out of (i) Licensee’s material breach of this Agreement, or (ii) any allegation(s) that Licensee’s actions infringe or violate any third-party intellectual property right, including without limitation, any U.S. copyright, patent, or trademark, or are otherwise found to be tortious or criminal (whether or not such indemnified person is a named party in a legal proceeding).
+
+3.2. Notice and Defense of Claims. Licensor shall promptly notify Licensee of any Claim for which indemnification is sought, following actual knowledge of such Claim, provided however that the failure to give such notice shall not relieve Licensee of its obligations hereunder except to the extent that Licensee is materially prejudiced by such failure. In the event that any third-party Claim is brought, Licensee shall have the right and option to undertake and control the defense of such action with counsel of its choice, provided however that (i) Licensor at its own expense may participate and appear on an equal footing with Licensee in the defense of any such Claim, (ii) Licensor may undertake and control such defense in the event of the material failure of Licensee to undertake and control the same; and (iii) the defense of any Claim relating to the intellectual property rights of Licensor or its licensors and any related counterclaims shall be solely controlled by Licensor with counsel of its choice. Licensee shall not consent to judgment or concede or settle or compromise any Claim without the prior written approval of Licensor (whose approval shall not be unreasonably withheld), unless such concession or settlement or compromise includes a full and unconditional release of Licensor and any applicable Related Persons from all liabilities in respect of such Claim.
+
+## Article 4 – Miscellaneous.
+4.1. Relationship of the Parties. This Agreement does not create a partnership, franchise, joint venture, agency, fiduciary, or employment relationship between the parties.
+
+4.2. No Third-Party Beneficiaries. Except for the rights of Related Persons under Article 3 (Indemnification), there are no third-party beneficiaries to this Agreement.
+
+4.3. Assignment. Licensee’s rights hereunder are non-assignable, and may not be sublicensed.
+
+4.4. Equitable Relief. Licensee acknowledges that the remedies available at law for any breach of this Agreement will, by their nature, be inadequate. Accordingly, Licensor may obtain injunctive relief or other equitable relief to restrain a breach or threatened breach of this Agreement or to specifically enforce this Agreement, without proving that any monetary damages have been sustained, and without the requirement of posting of a bond prior to obtaining such equitable relief.
+
+4.5. Governing Law. This Agreement will be interpreted, construed, and enforced in all respects in accordance with the laws of the State of California, without reference to its conflict of law principles.
+
+4.6. Attorneys’ Fees. If any legal action, arbitration or other proceeding is brought for the enforcement of this Agreement, or because of an alleged dispute, breach, default, or misrepresentation in connection with any of the provisions of this Agreement, the successful or prevailing party shall be entitled to recover its reasonable attorneys’ fees and other reasonable costs incurred in that action or proceeding, in addition to any other relief to which it may be entitled.
+
+4.7. Amendment; Waiver. This Agreement may not be amended, nor may any rights under it be waived, except in writing by Licensor.
+
+4.8. Severability. If any provision of this Agreement is held by a court of competent jurisdiction to be contrary to law, the provision shall be modified by the court and interpreted so as best to accomplish the objectives of the original provision to the fullest extent
+permitted by law, and the remaining provisions of this Agreement shall remain in effect.
+
+4.9. Entire Agreement. This Agreement constitutes the entire agreement between the parties and supersedes all prior and contemporaneous agreements, proposals or representations, written or oral, concerning its subject matter.
+
+
+# Apache License
+
+Version 2.0, January 2004
+
+http://www.apache.org/licenses/
+
+## TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+ You must give any other recipients of the Work or Derivative Works a copy of this License; and
+ You must cause any modified files to carry prominent notices stating that You changed the files; and
+ You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and
+ If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
diff --git a/sw/vendor/coremark/Makefile b/sw/vendor/coremark/Makefile
new file mode 100644
index 0000000..c653bd5
--- /dev/null
+++ b/sw/vendor/coremark/Makefile
@@ -0,0 +1,139 @@
+# Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+#
+# Licensed 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.
+#
+# Original Author: Shay Gal-on
+
+# Make sure the default target is to simply build and run the benchmark.
+RSTAMP = v1.0
+
+.PHONY: run score
+run: $(OUTFILE) rerun score
+
+score:
+ @echo "Check run1.log and run2.log for results."
+ @echo "See README.md for run and reporting rules."
+
+ifndef PORT_DIR
+# Ports for a couple of common self hosted platforms
+UNAME=$(shell if command -v uname 2> /dev/null; then uname ; fi)
+ifneq (,$(findstring CYGWIN,$(UNAME)))
+PORT_DIR=cygwin
+endif
+ifneq (,$(findstring Linux,$(UNAME)))
+MACHINE=$(shell uname -m)
+ifneq (,$(findstring 64,$(MACHINE)))
+PORT_DIR=linux64
+else
+PORT_DIR=linux
+endif
+endif
+endif
+ifndef PORT_DIR
+$(error PLEASE define PORT_DIR! (e.g. make PORT_DIR=simple))
+endif
+vpath %.c $(PORT_DIR)
+vpath %.h $(PORT_DIR)
+vpath %.mak $(PORT_DIR)
+include $(PORT_DIR)/core_portme.mak
+
+ifndef $(ITERATIONS)
+ITERATIONS=0
+endif
+ifdef REBUILD
+FORCE_REBUILD=force_rebuild
+endif
+
+CFLAGS += -DITERATIONS=$(ITERATIONS)
+
+CORE_FILES = core_list_join core_main core_matrix core_state core_util
+ORIG_SRCS = $(addsuffix .c,$(CORE_FILES))
+SRCS = $(ORIG_SRCS) $(PORT_SRCS)
+OBJS = $(addprefix $(OPATH),$(addsuffix $(OEXT),$(CORE_FILES)) $(PORT_OBJS))
+OUTNAME = coremark$(EXE)
+OUTFILE = $(OPATH)$(OUTNAME)
+LOUTCMD = $(OFLAG) $(OUTFILE) $(LFLAGS_END)
+OUTCMD = $(OUTFLAG) $(OUTFILE) $(LFLAGS_END)
+
+HEADERS = coremark.h
+CHECK_FILES = $(ORIG_SRCS) $(HEADERS)
+
+$(OPATH):
+ $(MKDIR) $(OPATH)
+
+.PHONY: compile link
+ifdef SEPARATE_COMPILE
+$(OPATH)$(PORT_DIR):
+ $(MKDIR) $(OPATH)$(PORT_DIR)
+
+compile: $(OPATH) $(OPATH)$(PORT_DIR) $(OBJS) $(HEADERS)
+link: compile
+ $(LD) $(LFLAGS) $(XLFLAGS) $(OBJS) $(LOUTCMD)
+
+else
+
+compile: $(OPATH) $(SRCS) $(HEADERS)
+ $(CC) $(CFLAGS) $(XCFLAGS) $(SRCS) $(OUTCMD)
+link: compile
+ @echo "Link performed along with compile"
+
+endif
+
+$(OUTFILE): $(SRCS) $(HEADERS) Makefile core_portme.mak $(FORCE_REBUILD)
+ $(MAKE) port_prebuild
+ $(MAKE) link -$(MAKEFLAGS)
+ $(MAKE) port_postbuild
+
+.PHONY: rerun
+rerun:
+ $(MAKE) XCFLAGS="$(XCFLAGS) -DPERFORMANCE_RUN=1" load run1.log
+ $(MAKE) XCFLAGS="$(XCFLAGS) -DVALIDATION_RUN=1" load run2.log
+
+PARAM1=$(PORT_PARAMS) 0x0 0x0 0x66 $(ITERATIONS)
+PARAM2=$(PORT_PARAMS) 0x3415 0x3415 0x66 $(ITERATIONS)
+PARAM3=$(PORT_PARAMS) 8 8 8 $(ITERATIONS)
+
+run1.log-PARAM=$(PARAM1) 7 1 2000
+run2.log-PARAM=$(PARAM2) 7 1 2000
+run3.log-PARAM=$(PARAM3) 7 1 1200
+
+run1.log run2.log run3.log: load
+ $(MAKE) port_prerun
+ $(RUN) $(OUTFILE) $($(@)-PARAM) > $(OPATH)$@
+ $(MAKE) port_postrun
+
+.PHONY: gen_pgo_data
+gen_pgo_data: run3.log
+
+.PHONY: load
+load: $(OUTFILE)
+ $(MAKE) port_preload
+ $(LOAD) $(OUTFILE)
+ $(MAKE) port_postload
+
+.PHONY: clean
+clean:
+ rm -f $(OUTFILE) $(OPATH)*.log *.info $(OPATH)index.html $(PORT_CLEAN)
+
+.PHONY: force_rebuild
+force_rebuild:
+ echo "Forcing Rebuild"
+
+.PHONY: check
+check:
+ md5sum -c coremark.md5
+
+ifdef ETC
+# Targets related to testing and releasing CoreMark. Not part of the general release!
+include Makefile.internal
+endif
diff --git a/sw/vendor/coremark/README.md b/sw/vendor/coremark/README.md
new file mode 100644
index 0000000..35e717c
--- /dev/null
+++ b/sw/vendor/coremark/README.md
@@ -0,0 +1,394 @@
+
+# Introduction
+
+CoreMark's primary goals are simplicity and providing a method for testing only a processor's core features. For more information about EEMBC's comprehensive embedded benchmark suites, please see www.eembc.org.
+
+# Building and Running
+
+To build and run the benchmark, type
+
+`> make`
+
+Full results are available in the files `run1.log` and `run2.log`. CoreMark result can be found in `run1.log`.
+
+## Cross Compiling
+
+For cross compile platforms please adjust `core_portme.mak`, `core_portme.h` (and possibly `core_portme.c`) according to the specific platform used. When porting to a new platform, it is recommended to copy one of the default port folders (e.g. `mkdir <platform> && cp linux/* <platform>`), adjust the porting files, and run:
+~~~
+% make PORT_DIR=<platform>
+~~~
+
+## Make Targets
+`run` - Default target, creates `run1.log` and `run2.log`.
+`run1.log` - Run the benchmark with performance parameters, and output to `run1.log`
+`run2.log` - Run the benchmark with validation parameters, and output to `run2.log`
+`run3.log` - Run the benchmark with profile generation parameters, and output to `run3.log`
+`compile` - compile the benchmark executable
+`link` - link the benchmark executable
+`check` - test MD5 of sources that may not be modified
+`clean` - clean temporary files
+
+### Make flag: `ITERATIONS`
+By default, the benchmark will run between 10-100 seconds. To override, use `ITERATIONS=N`
+~~~
+% make ITERATIONS=10
+~~~
+Will run the benchmark for 10 iterations. It is recommended to set a specific number of iterations in certain situations e.g.:
+
+* Running with a simulator
+* Measuring power/energy
+* Timing cannot be restarted
+
+Minimum required run time: **Results are only valid for reporting if the benchmark ran for at least 10 secs!**
+
+### Make flag: `XCFLAGS`
+To add compiler flags from the command line, use `XCFLAGS` e.g.:
+
+~~~
+% make XCFLAGS="-g -DMULTITHREAD=4 -DUSE_FORK=1"
+~~~
+
+### Make flag: `CORE_DEBUG`
+
+Define to compile for a debug run if you get incorrect CRC.
+
+~~~
+% make XCFLAGS="-DCORE_DEBUG=1"
+~~~
+
+### Make flag: `REBUILD`
+
+Force a rebuild of the executable.
+
+## Systems Without `make`
+The following files need to be compiled:
+* `core_list_join.c`
+* `core_main.c`
+* `core_matrix.c`
+* `core_state.c`
+* `core_util.c`
+* `PORT_DIR/core_portme.c`
+
+For example:
+~~~
+% gcc -O2 -o coremark.exe core_list_join.c core_main.c core_matrix.c core_state.c core_util.c simple/core_portme.c -DPERFORMANCE_RUN=1 -DITERATIONS=1000
+% ./coremark.exe > run1.log
+~~~
+The above will compile the benchmark for a performance run and 1000 iterations. Output is redirected to `run1.log`.
+
+# Parallel Execution
+Use `XCFLAGS=-DMULTITHREAD=N` where N is number of threads to run in parallel. Several implementations are available to execute in multiple contexts, or you can implement your own in `core_portme.c`.
+
+~~~
+% make XCFLAGS="-DMULTITHREAD=4 -DUSE_PTHREAD"
+~~~
+
+Above will compile the benchmark for execution on 4 cores, using POSIX Threads API.
+
+# Run Parameters for the Benchmark Executable
+CoreMark's executable takes several parameters as follows (but only if `main()` accepts arguments):
+1st - A seed value used for initialization of data.
+2nd - A seed value used for initialization of data.
+3rd - A seed value used for initialization of data.
+4th - Number of iterations (0 for auto : default value)
+5th - Reserved for internal use.
+6th - Reserved for internal use.
+7th - For malloc users only, ovreride the size of the input data buffer.
+
+The run target from make will run coremark with 2 different data initialization seeds.
+
+## Alternative parameters:
+If not using `malloc` or command line arguments are not supported, the buffer size
+for the algorithms must be defined via the compiler define `TOTAL_DATA_SIZE`.
+`TOTAL_DATA_SIZE` must be set to 2000 bytes (default) for standard runs.
+The default for such a target when testing different configurations could be:
+
+~~~
+% make XCFLAGS="-DTOTAL_DATA_SIZE=6000 -DMAIN_HAS_NOARGC=1"
+~~~
+
+# Submitting Results
+
+CoreMark results can be submitted on the web. Open a web browser and go to the [submission page](https://www.eembc.org/coremark/submit.php). After registering an account you may enter a score.
+
+# Run Rules
+What is and is not allowed.
+
+## Required
+1. The benchmark needs to run for at least 10 seconds.
+2. All validation must succeed for seeds `0,0,0x66` and `0x3415,0x3415,0x66`, buffer size of 2000 bytes total.
+ * If not using command line arguments to main:
+~~~
+ % make XCFLAGS="-DPERFORMANCE_RUN=1" REBUILD=1 run1.log
+ % make XCFLAGS="-DVALIDATION_RUN=1" REBUILD=1 run2.log
+~~~
+3. If using profile guided optimization, profile must be generated using seeds of `8,8,8`, and buffer size of 1200 bytes total.
+~~~
+ % make XCFLAGS="-DTOTAL_DATA_SIZE=1200 -DPROFILE_RUN=1" REBUILD=1 run3.log
+~~~
+4. All source files must be compiled with the same flags.
+5. All data type sizes must match size in bits such that:
+ * `ee_u8` is an unsigned 8-bit datatype.
+ * `ee_s16` is a signed 16-bit datatype.
+ * `ee_u16` is an unsigned 16-bit datatype.
+ * `ee_s32` is a signed 32-bit datatype.
+ * `ee_u32` is an unsigned 32-bit datatype.
+
+## Allowed
+
+1. Changing number of iterations
+2. Changing toolchain and build/load/run options
+3. Changing method of acquiring a data memory block
+5. Changing the method of acquiring seed values
+6. Changing implementation `in core_portme.c`
+7. Changing configuration values in `core_portme.h`
+8. Changing `core_portme.mak`
+
+## NOT ALLOWED
+1. Changing of source file other then `core_portme*` (use `make check` to validate)
+
+# Reporting rules
+Use the following syntax to report results on a data sheet:
+
+CoreMark 1.0 : N / C [/ P] [/ M]
+
+N - Number of iterations per second with seeds 0,0,0x66,size=2000)
+
+C - Compiler version and flags
+
+P - Parameters such as data and code allocation specifics
+
+* This parameter *may* be omitted if all data was allocated on the heap in RAM.
+* This parameter *may not* be omitted when reporting CoreMark/MHz
+
+M - Type of parallel execution (if used) and number of contexts
+* This parameter may be omitted if parallel execution was not used.
+
+e.g.:
+
+~~~
+CoreMark 1.0 : 128 / GCC 4.1.2 -O2 -fprofile-use / Heap in TCRAM / FORK:2
+~~~
+or
+~~~
+CoreMark 1.0 : 1400 / GCC 3.4 -O4
+~~~
+
+If reporting scaling results, the results must be reported as follows:
+
+CoreMark/MHz 1.0 : N / C / P [/ M]
+
+P - When reporting scaling results, memory parameter must also indicate memory frequency:core frequency ratio.
+1. If the core has cache and cache frequency to core frequency ratio is configurable, that must also be included.
+
+e.g.:
+
+~~~
+CoreMark/MHz 1.0 : 1.47 / GCC 4.1.2 -O2 / DDR3(Heap) 30:1 Memory 1:1 Cache
+~~~
+
+# Log File Format
+The log files have the following format
+
+~~~
+2K performance run parameters for coremark. (Run type)
+CoreMark Size : 666 (Buffer size)
+Total ticks : 25875 (platform dependent value)
+Total time (secs) : 25.875000 (actual time in seconds)
+Iterations/Sec : 3864.734300 (Performance value to report)
+Iterations : 100000 (number of iterations used)
+Compiler version : GCC3.4.4 (Compiler and version)
+Compiler flags : -O2 (Compiler and linker flags)
+Memory location : Code in flash, data in on chip RAM
+seedcrc : 0xe9f5 (identifier for the input seeds)
+[0]crclist : 0xe714 (validation for list part)
+[0]crcmatrix : 0x1fd7 (validation for matrix part)
+[0]crcstate : 0x8e3a (validation for state part)
+[0]crcfinal : 0x33ff (iteration dependent output)
+Correct operation validated. See README.md for run and reporting rules. (*Only when run is successful*)
+CoreMark 1.0 : 6508.490622 / GCC3.4.4 -O2 / Heap (*Only on a successful performance run*)
+~~~
+
+# Theory of Operation
+
+This section describes the initial goals of CoreMark and their implementation.
+
+## Small and easy to understand
+
+* X number of source code lines for timed portion of the benchmark.
+* Meaningful names for variables and functions.
+* Comments for each block of code more than 10 lines long.
+
+## Portability
+
+A thin abstraction layer will be provided for I/O and timing in a separate file. All I/O and timing of the benchmark will be done through this layer.
+
+### Code / data size
+
+* Compile with gcc on x86 and make sure all sizes are according to requirements.
+* If dynamic memory allocation is used, take total memory allocated into account as well.
+* Avoid recursive functions and keep track of stack usage.
+* Use the same memory block as data site for all algorithms, and initialize the data before each algorithm – while this means that initialization with data happens during the timed portion, it will only happen once during the timed portion and so have negligible effect on the results.
+
+## Controlled output
+
+This may be the most difficult goal. Compilers are constantly improving and getting better at analyzing code. To create work that cannot be computed at compile time and must be computed at run time, we will rely on two assumptions:
+
+* Some system functions (e.g. time, scanf) and parameters cannot be computed at compile time. In most cases, marking a variable volatile means the compiler is force to read this variable every time it is read. This will be used to introduce a factor into the input that cannot be precomputed at compile time. Since the results are input dependent, that will make sure that computation has to happen at run time.
+
+* Either a system function or I/O (e.g. scanf) or command line parameters or volatile variables will be used before the timed portion to generate data which is not available at compile time. Specific method used is not relevant as long as it can be controlled, and that it cannot be computed or eliminated by the compiler at compile time. E.g. if the clock() functions is a compiler stub, it may not be used. The derived values will be reported on the output so that verification can be done on a different machine.
+
+* We cannot rely on command line parameters since some embedded systems do not have the capability to provide command line parameters. All 3 methods above will be implemented (time based, scanf and command line parameters) and all 3 are valid if the compiler cannot determine the value at compile time.
+
+* It is important to note that The actual values that are to be supplied at run time will be standardized. The methodology is not intended to provide random data, but simply to provide controlled data that cannot be precomputed at compile time.
+
+* Printed results must be valid at run time. This will be used to make sure the computation has been executed.
+
+* Some embedded systems do not provide “printf” or other I/O functionality. All I/O will be done through a thin abstraction interface to allow execution on such systems (e.g. allow output via JTAG).
+
+## Key Algorithms
+
+### Linked List
+
+The following linked list structure will be used:
+
+~~~
+typedef struct list_data_s {
+ ee_s16 data16;
+ ee_s16 idx;
+} list_data;
+
+typedef struct list_head_s {
+ struct list_head_s *next;
+ struct list_data_s *info;
+} list_head;
+~~~
+
+While adding a level of indirection accessing the data, this structure is realistic and used in many embedded applications for small to medium lists.
+
+The list itself will be initialized on a block of memory that will be passed in to the initialization function. While in general linked lists use malloc for new nodes, embedded applications sometime control the memory for small data structures such as arrays and lists directly to avoid the overhead of system calls, so this approach is realistic.
+
+The linked list will be initialized such that 1/4 of the list pointers point to sequential areas in memory, and 3/4 of the list pointers are distributed in a non sequential manner. This is done to emulate a linked list that had add/remove happen for a while disrupting the neat order, and then a series of adds that are likely to come from sequential memory locations.
+
+For the benchmark itself:
+- Multiple find operations are going to be performed. These find operations may result in the whole list being traversed. The result of each find will become part of the output chain.
+- The list will be sorted using merge sort based on the data16 value, and then derive CRC of the data16 item in order for part of the list. The CRC will become part of the output chain.
+- The list will be sorted again using merge sort based on the idx value. This sort will guarantee that the list is returned to the primary state before leaving the function, so that multiple iterations of the function will have the same result. CRC of the data16 for part of the list will again be calculated and become part of the output chain.
+
+The actual `data16` in each cell will be pseudo random based on a single 16b input that cannot be determined at compile time. In addition, the part of the list which is used for CRC will also be passed to the function, and determined based on an input that cannot be determined at run time.
+
+### Matrix Multiply
+
+This very simple algorithm forms the basis of many more complex algorithms. The tight inner loop is the focus of many optimizations (compiler as well as hardware based) and is thus relevant for embedded processing.
+
+The total available data space will be divided to 3 parts:
+1. NxN matrix A.
+2. NxN matrix B.
+3. NxN matrix C.
+
+E.g. for 2K we will have 3 12x12 matrices (assuming data type of 32b 12(len)*12(wid)*4(size)*3(num) =1728 bytes).
+
+Matrix A will be initialized with small values (upper 3/4 of the bits all zero).
+Matrix B will be initialized with medium values (upper half of the bits all zero).
+Matrix C will be used for the result.
+
+For the benchmark itself:
+- Multiple A by a constant into C, add the upper bits of each of the values in the result matrix. The result will become part of the output chain.
+- Multiple A by column X of B into C, add the upper bits of each of the values in the result matrix. The result will become part of the output chain.
+- Multiple A by B into C, add the upper bits of each of the values in the result matrix. The result will become part of the output chain.
+
+The actual values for A and B must be derived based on input that is not available at compile time.
+
+### State Machine
+
+This part of the code needs to exercise switch and if statements. As such, we will use a small Moore state machine. In particular, this will be a state machine that identifies string input as numbers and divides them according to format.
+
+The state machine will parse the input string until either a “,” separator or end of input is encountered. An invalid number will cause the state machine to return invalid state and a valid number will cause the state machine to return with type of number format (int/float/scientific).
+
+This code will perform a realistic task, be small enough to easily understand, and exercise the required functionality. The other option used in embedded systems is a mealy based state machine, which is driven by a table. The table then determines the number of states and complexity of transitions. This approach, however, tests mainly the load/store and function call mechanisms and less the handling of branches. If analysis of the final results shows that the load/store functionality of the processor is not exercised thoroughly, it may be a good addition to the benchmark (codesize allowing).
+
+For input, the memory block will be initialized with comma separated values of mixed formats, as well as invalid inputs.
+
+For the benchmark itself:
+- Invoke the state machine on all of the input and count final states and state transitions. CRC of all final states and transitions will become part of the output chain.
+- Modify the input at intervals (inject errors) and repeat the state machine operation.
+- Modify the input back to original form.
+
+The actual input must be initialized based on data that cannot be determined at compile time. In addition the intervals for modification of the input and the actual modification must be based on input that cannot be determined at compile time.
+
+# Validation
+
+This release was tested on the following platforms:
+* x86 cygwin and gcc 3.4 (Quad, dual and single core systems)
+* x86 linux (Ubuntu/Fedora) and gcc (4.2/4.1) (Quad and single core systems)
+* MIPS64 BE linux and gcc 3.4 16 cores system
+* MIPS32 BE linux with CodeSourcery compiler 4.2-177 on Malta/Linux with a 1004K 3-core system
+* PPC simulator with gcc 4.2.2 (No OS)
+* PPC 64b BE linux (yellowdog) with gcc 3.4 and 4.1 (Dual core system)
+* BF533 with VDSP50
+* Renesas R8C/H8 MCU with HEW 4.05
+* NXP LPC1700 armcc v4.0.0.524
+* NEC 78K with IAR v4.61
+* ARM simulator with armcc v4
+
+# Memory Analysis
+
+Valgrind 3.4.0 used and no errors reported.
+
+# Balance Analysis
+
+Number of instructions executed for each function tested with cachegrind and found balanced with gcc and -O0.
+
+# Statistics
+
+Lines:
+~~~
+Lines Blank Cmnts Source AESL
+===== ===== ===== ===== ========== =======================================
+ 469 66 170 251 627.5 core_list_join.c (C)
+ 330 18 54 268 670.0 core_main.c (C)
+ 256 32 80 146 365.0 core_matrix.c (C)
+ 240 16 51 186 465.0 core_state.c (C)
+ 165 11 20 134 335.0 core_util.c (C)
+ 150 23 36 98 245.0 coremark.h (C)
+ 1610 166 411 1083 2707.5 ----- Benchmark ----- (6 files)
+ 293 15 74 212 530.0 linux/core_portme.c (C)
+ 235 30 104 104 260.0 linux/core_portme.h (C)
+ 528 45 178 316 790.0 ----- Porting ----- (2 files)
+
+* For comparison, here are the stats for Dhrystone
+Lines Blank Cmnts Source AESL
+===== ===== ===== ===== ========== =======================================
+ 311 15 242 54 135.0 dhry.h (C)
+ 789 132 119 553 1382.5 dhry_1.c (C)
+ 186 26 68 107 267.5 dhry_2.c (C)
+ 1286 173 429 714 1785.0 ----- C ----- (3 files)
+~~~
+
+# Credits
+Many thanks to all of the individuals who helped with the development or testing of CoreMark including (Sorted by company name; note that company names may no longer be accurate as this was written in 2009).
+* Alan Anderson, ADI
+* Adhikary Rajiv, ADI
+* Elena Stohr, ARM
+* Ian Rickards, ARM
+* Andrew Pickard, ARM
+* Trent Parker, CAVIUM
+* Shay Gal-On, EEMBC
+* Markus Levy, EEMBC
+* Peter Torelli, EEMBC
+* Ron Olson, IBM
+* Eyal Barzilay, MIPS
+* Jens Eltze, NEC
+* Hirohiko Ono, NEC
+* Ulrich Drees, NEC
+* Frank Roscheda, NEC
+* Rob Cosaro, NXP
+* Shumpei Kawasaki, RENESAS
+
+# Legal
+Please refer to LICENSE.md in this reposity for a description of your rights to use this code.
+
+# Copyright
+Copyright © 2009 EEMBC All rights reserved.
+CoreMark is a trademark of EEMBC and EEMBC is a registered trademark of the Embedded Microprocessor Benchmark Consortium.
+
diff --git a/sw/vendor/coremark/barebones/core_portme.c b/sw/vendor/coremark/barebones/core_portme.c
new file mode 100755
index 0000000..3364681
--- /dev/null
+++ b/sw/vendor/coremark/barebones/core_portme.c
@@ -0,0 +1,128 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+#include "coremark.h"
+#include "core_portme.h"
+
+#if VALIDATION_RUN
+ volatile ee_s32 seed1_volatile=0x3415;
+ volatile ee_s32 seed2_volatile=0x3415;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PERFORMANCE_RUN
+ volatile ee_s32 seed1_volatile=0x0;
+ volatile ee_s32 seed2_volatile=0x0;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PROFILE_RUN
+ volatile ee_s32 seed1_volatile=0x8;
+ volatile ee_s32 seed2_volatile=0x8;
+ volatile ee_s32 seed3_volatile=0x8;
+#endif
+ volatile ee_s32 seed4_volatile=ITERATIONS;
+ volatile ee_s32 seed5_volatile=0;
+/* Porting : Timing functions
+ How to capture time and convert to seconds must be ported to whatever is supported by the platform.
+ e.g. Read value from on board RTC, read value from cpu clock cycles performance counter etc.
+ Sample implementation for standard time.h and windows.h definitions included.
+*/
+CORETIMETYPE barebones_clock() {
+ #error "You must implement a method to measure time in barebones_clock()! This function should return current time.\n"
+}
+/* Define : TIMER_RES_DIVIDER
+ Divider to trade off timer resolution and total time that can be measured.
+
+ Use lower values to increase resolution, but make sure that overflow does not occur.
+ If there are issues with the return value overflowing, increase this value.
+ */
+#define GETMYTIME(_t) (*_t=barebones_clock())
+#define MYTIMEDIFF(fin,ini) ((fin)-(ini))
+#define TIMER_RES_DIVIDER 1
+#define SAMPLE_TIME_IMPLEMENTATION 1
+#define EE_TICKS_PER_SEC (CLOCKS_PER_SEC / TIMER_RES_DIVIDER)
+
+/** Define Host specific (POSIX), or target specific global time variables. */
+static CORETIMETYPE start_time_val, stop_time_val;
+
+/* Function : start_time
+ This function will be called right before starting the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or zeroing some system parameters - e.g. setting the cpu clocks cycles to 0.
+*/
+void start_time(void) {
+ GETMYTIME(&start_time_val );
+}
+/* Function : stop_time
+ This function will be called right after ending the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or other system parameters - e.g. reading the current value of cpu cycles counter.
+*/
+void stop_time(void) {
+ GETMYTIME(&stop_time_val );
+}
+/* Function : get_time
+ Return an abstract "ticks" number that signifies time on the system.
+
+ Actual value returned may be cpu cycles, milliseconds or any other value,
+ as long as it can be converted to seconds by <time_in_secs>.
+ This methodology is taken to accomodate any hardware or simulated platform.
+ The sample implementation returns millisecs by default,
+ and the resolution is controlled by <TIMER_RES_DIVIDER>
+*/
+CORE_TICKS get_time(void) {
+ CORE_TICKS elapsed=(CORE_TICKS)(MYTIMEDIFF(stop_time_val, start_time_val));
+ return elapsed;
+}
+/* Function : time_in_secs
+ Convert the value returned by get_time to seconds.
+
+ The <secs_ret> type is used to accomodate systems with no support for floating point.
+ Default implementation implemented by the EE_TICKS_PER_SEC macro above.
+*/
+secs_ret time_in_secs(CORE_TICKS ticks) {
+ secs_ret retval=((secs_ret)ticks) / (secs_ret)EE_TICKS_PER_SEC;
+ return retval;
+}
+
+ee_u32 default_num_contexts=1;
+
+/* Function : portable_init
+ Target specific initialization code
+ Test for some common mistakes.
+*/
+void portable_init(core_portable *p, int *argc, char *argv[])
+{
+ #error "Call board initialization routines in portable init (if needed), in particular initialize UART!\n"
+ if (sizeof(ee_ptr_int) != sizeof(ee_u8 *)) {
+ ee_printf("ERROR! Please define ee_ptr_int to a type that holds a pointer!\n");
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR! Please define ee_u32 to a 32b unsigned type!\n");
+ }
+ p->portable_id=1;
+}
+/* Function : portable_fini
+ Target specific final code
+*/
+void portable_fini(core_portable *p)
+{
+ p->portable_id=0;
+}
+
+
diff --git a/sw/vendor/coremark/barebones/core_portme.h b/sw/vendor/coremark/barebones/core_portme.h
new file mode 100755
index 0000000..23a1558
--- /dev/null
+++ b/sw/vendor/coremark/barebones/core_portme.h
@@ -0,0 +1,199 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+/* Topic : Description
+ This file contains configuration constants required to execute on different platforms
+*/
+#ifndef CORE_PORTME_H
+#define CORE_PORTME_H
+/************************/
+/* Data types and settings */
+/************************/
+/* Configuration : HAS_FLOAT
+ Define to 1 if the platform supports floating point.
+*/
+#ifndef HAS_FLOAT
+#define HAS_FLOAT 1
+#endif
+/* Configuration : HAS_TIME_H
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef HAS_TIME_H
+#define HAS_TIME_H 1
+#endif
+/* Configuration : USE_CLOCK
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef USE_CLOCK
+#define USE_CLOCK 1
+#endif
+/* Configuration : HAS_STDIO
+ Define to 1 if the platform has stdio.h.
+*/
+#ifndef HAS_STDIO
+#define HAS_STDIO 0
+#endif
+/* Configuration : HAS_PRINTF
+ Define to 1 if the platform has stdio.h and implements the printf function.
+*/
+#ifndef HAS_PRINTF
+#define HAS_PRINTF 0
+#endif
+
+
+/* Definitions : COMPILER_VERSION, COMPILER_FLAGS, MEM_LOCATION
+ Initialize these strings per platform
+*/
+#ifndef COMPILER_VERSION
+ #ifdef __GNUC__
+ #define COMPILER_VERSION "GCC"__VERSION__
+ #else
+ #define COMPILER_VERSION "Please put compiler version here (e.g. gcc 4.1)"
+ #endif
+#endif
+#ifndef COMPILER_FLAGS
+ #define COMPILER_FLAGS FLAGS_STR /* "Please put compiler flags here (e.g. -o3)" */
+#endif
+#ifndef MEM_LOCATION
+ #define MEM_LOCATION "STACK"
+#endif
+
+/* Data Types :
+ To avoid compiler issues, define the data types that need ot be used for 8b, 16b and 32b in <core_portme.h>.
+
+ *Imprtant* :
+ ee_ptr_int needs to be the data type used to hold pointers, otherwise coremark may fail!!!
+*/
+typedef signed short ee_s16;
+typedef unsigned short ee_u16;
+typedef signed int ee_s32;
+typedef double ee_f32;
+typedef unsigned char ee_u8;
+typedef unsigned int ee_u32;
+typedef ee_u32 ee_ptr_int;
+typedef size_t ee_size_t;
+#define NULL ((void *)0)
+/* align_mem :
+ This macro is used to align an offset to point to a 32b value. It is used in the Matrix algorithm to initialize the input memory blocks.
+*/
+#define align_mem(x) (void *)(4 + (((ee_ptr_int)(x) - 1) & ~3))
+
+/* Configuration : CORE_TICKS
+ Define type of return from the timing functions.
+ */
+#define CORETIMETYPE ee_u32
+typedef ee_u32 CORE_TICKS;
+
+/* Configuration : SEED_METHOD
+ Defines method to get seed values that cannot be computed at compile time.
+
+ Valid values :
+ SEED_ARG - from command line.
+ SEED_FUNC - from a system function.
+ SEED_VOLATILE - from volatile variables.
+*/
+#ifndef SEED_METHOD
+#define SEED_METHOD SEED_VOLATILE
+#endif
+
+/* Configuration : MEM_METHOD
+ Defines method to get a block of memry.
+
+ Valid values :
+ MEM_MALLOC - for platforms that implement malloc and have malloc.h.
+ MEM_STATIC - to use a static memory array.
+ MEM_STACK - to allocate the data block on the stack (NYI).
+*/
+#ifndef MEM_METHOD
+#define MEM_METHOD MEM_STACK
+#endif
+
+/* Configuration : MULTITHREAD
+ Define for parallel execution
+
+ Valid values :
+ 1 - only one context (default).
+ N>1 - will execute N copies in parallel.
+
+ Note :
+ If this flag is defined to more then 1, an implementation for launching parallel contexts must be defined.
+
+ Two sample implementations are provided. Use <USE_PTHREAD> or <USE_FORK> to enable them.
+
+ It is valid to have a different implementation of <core_start_parallel> and <core_end_parallel> in <core_portme.c>,
+ to fit a particular architecture.
+*/
+#ifndef MULTITHREAD
+#define MULTITHREAD 1
+#define USE_PTHREAD 0
+#define USE_FORK 0
+#define USE_SOCKET 0
+#endif
+
+/* Configuration : MAIN_HAS_NOARGC
+ Needed if platform does not support getting arguments to main.
+
+ Valid values :
+ 0 - argc/argv to main is supported
+ 1 - argc/argv to main is not supported
+
+ Note :
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef MAIN_HAS_NOARGC
+#define MAIN_HAS_NOARGC 0
+#endif
+
+/* Configuration : MAIN_HAS_NORETURN
+ Needed if platform does not support returning a value from main.
+
+ Valid values :
+ 0 - main returns an int, and return value will be 0.
+ 1 - platform does not support returning a value from main
+*/
+#ifndef MAIN_HAS_NORETURN
+#define MAIN_HAS_NORETURN 0
+#endif
+
+/* Variable : default_num_contexts
+ Not used for this simple port, must cintain the value 1.
+*/
+extern ee_u32 default_num_contexts;
+
+typedef struct CORE_PORTABLE_S {
+ ee_u8 portable_id;
+} core_portable;
+
+/* target specific init/fini */
+void portable_init(core_portable *p, int *argc, char *argv[]);
+void portable_fini(core_portable *p);
+
+#if !defined(PROFILE_RUN) && !defined(PERFORMANCE_RUN) && !defined(VALIDATION_RUN)
+#if (TOTAL_DATA_SIZE==1200)
+#define PROFILE_RUN 1
+#elif (TOTAL_DATA_SIZE==2000)
+#define PERFORMANCE_RUN 1
+#else
+#define VALIDATION_RUN 1
+#endif
+#endif
+
+int ee_printf(const char *fmt, ...);
+
+#endif /* CORE_PORTME_H */
diff --git a/sw/vendor/coremark/barebones/core_portme.mak b/sw/vendor/coremark/barebones/core_portme.mak
new file mode 100755
index 0000000..8159469
--- /dev/null
+++ b/sw/vendor/coremark/barebones/core_portme.mak
@@ -0,0 +1,87 @@
+# Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+#
+# Licensed 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.
+#
+# Original Author: Shay Gal-on
+
+#File : core_portme.mak
+
+# Flag : OUTFLAG
+# Use this flag to define how to to get an executable (e.g -o)
+OUTFLAG= -o
+# Flag : CC
+# Use this flag to define compiler to use
+CC = gcc
+# Flag : LD
+# Use this flag to define compiler to use
+LD = gld
+# Flag : AS
+# Use this flag to define compiler to use
+AS = gas
+# Flag : CFLAGS
+# Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS="other flags"
+PORT_CFLAGS = -O0 -g
+FLAGS_STR = "$(PORT_CFLAGS) $(XCFLAGS) $(XLFLAGS) $(LFLAGS_END)"
+CFLAGS = $(PORT_CFLAGS) -I$(PORT_DIR) -I. -DFLAGS_STR=\"$(FLAGS_STR)\"
+#Flag : LFLAGS_END
+# Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts).
+# Note : On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.
+SEPARATE_COMPILE=1
+# Flag : SEPARATE_COMPILE
+# You must also define below how to create an object file, and how to link.
+OBJOUT = -o
+LFLAGS =
+ASFLAGS =
+OFLAG = -o
+COUT = -c
+
+LFLAGS_END =
+# Flag : PORT_SRCS
+# Port specific source files can be added here
+# You may also need cvt.c if the fcvt functions are not provided as intrinsics by your compiler!
+PORT_SRCS = $(PORT_DIR)/core_portme.c $(PORT_DIR)/ee_printf.c
+vpath %.c $(PORT_DIR)
+vpath %.s $(PORT_DIR)
+
+# Flag : LOAD
+# For a simple port, we assume self hosted compile and run, no load needed.
+
+# Flag : RUN
+# For a simple port, we assume self hosted compile and run, simple invocation of the executable
+
+LOAD = echo "Please set LOAD to the process of loading the executable to the flash"
+RUN = echo "Please set LOAD to the process of running the executable (e.g. via jtag, or board reset)"
+
+OEXT = .o
+EXE = .bin
+
+$(OPATH)$(PORT_DIR)/%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+$(OPATH)%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+$(OPATH)$(PORT_DIR)/%$(OEXT) : %.s
+ $(AS) $(ASFLAGS) $< $(OBJOUT) $@
+
+# Target : port_pre% and port_post%
+# For the purpose of this simple port, no pre or post steps needed.
+
+.PHONY : port_prebuild port_postbuild port_prerun port_postrun port_preload port_postload
+port_pre% port_post% :
+
+# FLAG : OPATH
+# Path to the output folder. Default - current folder.
+OPATH = ./
+MKDIR = mkdir -p
+
diff --git a/sw/vendor/coremark/barebones/cvt.c b/sw/vendor/coremark/barebones/cvt.c
new file mode 100755
index 0000000..ee0506d
--- /dev/null
+++ b/sw/vendor/coremark/barebones/cvt.c
@@ -0,0 +1,117 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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 <math.h>
+#define CVTBUFSIZE 80
+static char CVTBUF[CVTBUFSIZE];
+
+static char *cvt(double arg, int ndigits, int *decpt, int *sign, char *buf, int eflag)
+{
+ int r2;
+ double fi, fj;
+ char *p, *p1;
+
+ if (ndigits < 0) ndigits = 0;
+ if (ndigits >= CVTBUFSIZE - 1) ndigits = CVTBUFSIZE - 2;
+ r2 = 0;
+ *sign = 0;
+ p = &buf[0];
+ if (arg < 0)
+ {
+ *sign = 1;
+ arg = -arg;
+ }
+ arg = modf(arg, &fi);
+ p1 = &buf[CVTBUFSIZE];
+
+ if (fi != 0)
+ {
+ p1 = &buf[CVTBUFSIZE];
+ while (fi != 0)
+ {
+ fj = modf(fi / 10, &fi);
+ *--p1 = (int)((fj + .03) * 10) + '0';
+ r2++;
+ }
+ while (p1 < &buf[CVTBUFSIZE]) *p++ = *p1++;
+ }
+ else if (arg > 0)
+ {
+ while ((fj = arg * 10) < 1)
+ {
+ arg = fj;
+ r2--;
+ }
+ }
+ p1 = &buf[ndigits];
+ if (eflag == 0) p1 += r2;
+ *decpt = r2;
+ if (p1 < &buf[0])
+ {
+ buf[0] = '\0';
+ return buf;
+ }
+ while (p <= p1 && p < &buf[CVTBUFSIZE])
+ {
+ arg *= 10;
+ arg = modf(arg, &fj);
+ *p++ = (int) fj + '0';
+ }
+ if (p1 >= &buf[CVTBUFSIZE])
+ {
+ buf[CVTBUFSIZE - 1] = '\0';
+ return buf;
+ }
+ p = p1;
+ *p1 += 5;
+ while (*p1 > '9')
+ {
+ *p1 = '0';
+ if (p1 > buf)
+ ++*--p1;
+ else
+ {
+ *p1 = '1';
+ (*decpt)++;
+ if (eflag == 0)
+ {
+ if (p > buf) *p = '0';
+ p++;
+ }
+ }
+ }
+ *p = '\0';
+ return buf;
+}
+
+char *ecvt(double arg, int ndigits, int *decpt, int *sign)
+{
+ return cvt(arg, ndigits, decpt, sign, CVTBUF, 1);
+}
+
+char *ecvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf)
+{
+ return cvt(arg, ndigits, decpt, sign, buf, 1);
+}
+
+char *fcvt(double arg, int ndigits, int *decpt, int *sign)
+{
+ return cvt(arg, ndigits, decpt, sign, CVTBUF, 0);
+}
+
+char *fcvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf)
+{
+ return cvt(arg, ndigits, decpt, sign, buf, 0);
+}
diff --git a/sw/vendor/coremark/barebones/ee_printf.c b/sw/vendor/coremark/barebones/ee_printf.c
new file mode 100755
index 0000000..655e7e6
--- /dev/null
+++ b/sw/vendor/coremark/barebones/ee_printf.c
@@ -0,0 +1,600 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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 <coremark.h>
+#include <stdarg.h>
+
+#define ZEROPAD (1<<0) /* Pad with zero */
+#define SIGN (1<<1) /* Unsigned/signed long */
+#define PLUS (1<<2) /* Show plus */
+#define SPACE (1<<3) /* Spacer */
+#define LEFT (1<<4) /* Left justified */
+#define HEX_PREP (1<<5) /* 0x */
+#define UPPERCASE (1<<6) /* 'ABCDEF' */
+
+#define is_digit(c) ((c) >= '0' && (c) <= '9')
+
+static char *digits = "0123456789abcdefghijklmnopqrstuvwxyz";
+static char *upper_digits = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+static ee_size_t strnlen(const char *s, ee_size_t count);
+
+static ee_size_t strnlen(const char *s, ee_size_t count)
+{
+ const char *sc;
+ for (sc = s; *sc != '\0' && count--; ++sc);
+ return sc - s;
+}
+
+static int skip_atoi(const char **s)
+{
+ int i = 0;
+ while (is_digit(**s)) i = i*10 + *((*s)++) - '0';
+ return i;
+}
+
+static char *number(char *str, long num, int base, int size, int precision, int type)
+{
+ char c, sign, tmp[66];
+ char *dig = digits;
+ int i;
+
+ if (type & UPPERCASE) { dig = upper_digits; }
+ if (type & LEFT) {type &= ~ZEROPAD; }
+ if (base < 2 || base > 36) { return 0; }
+
+ c = (type & ZEROPAD) ? '0' : ' ';
+ sign = 0;
+ if (type & SIGN) {
+ if (num < 0) {
+ sign = '-';
+ num = -num;
+ size--;
+ } else if (type & PLUS) {
+ sign = '+';
+ size--;
+ } else if (type & SPACE) {
+ sign = ' ';
+ size--;
+ }
+ }
+
+ if (type & HEX_PREP) {
+ if (base == 16){
+ size -= 2;
+ } else if (base == 8) {
+ size--;
+ }
+ }
+
+ i = 0;
+
+ if (num == 0) {
+ tmp[i++] = '0';
+ } else {
+ while (num != 0) {
+ tmp[i++] = dig[((unsigned long) num) % (unsigned) base];
+ num = ((unsigned long) num) / (unsigned) base;
+ }
+ }
+
+ if (i > precision) {
+ precision = i;
+ }
+ size -= precision;
+ if (!(type & (ZEROPAD | LEFT))) {
+ while (size-- > 0) {
+ *str++ = ' ';
+ }
+ }
+ if (sign) {
+ *str++ = sign;
+ }
+
+ if (type & HEX_PREP)
+ {
+ if (base == 8) {
+ *str++ = '0';
+ }else if (base == 16) {
+ *str++ = '0';
+ *str++ = digits[33];
+ }
+ }
+
+ if (!(type & LEFT)) {
+ while (size-- > 0) {
+ *str++ = c;
+ }
+ }
+ while (i < precision--) { *str++ = '0';}
+ while (i-- > 0) { *str++ = tmp[i]; }
+ while (size-- > 0) {*str++ = ' '; }
+
+ return str;
+}
+
+static char *eaddr(char *str, unsigned char *addr, int size, int precision, int type)
+{
+ char tmp[24];
+ char *dig = digits;
+ int i, len;
+
+ if (type & UPPERCASE) dig = upper_digits;
+ len = 0;
+ for (i = 0; i < 6; i++)
+ {
+ if (i != 0) tmp[len++] = ':';
+ tmp[len++] = dig[addr[i] >> 4];
+ tmp[len++] = dig[addr[i] & 0x0F];
+ }
+
+ if (!(type & LEFT)) while (len < size--) *str++ = ' ';
+ for (i = 0; i < len; ++i) *str++ = tmp[i];
+ while (len < size--) *str++ = ' ';
+
+ return str;
+}
+
+static char *iaddr(char *str, unsigned char *addr, int size, int precision, int type)
+{
+ char tmp[24];
+ int i, n, len;
+
+ len = 0;
+ for (i = 0; i < 4; i++)
+ {
+ if (i != 0) tmp[len++] = '.';
+ n = addr[i];
+
+ if (n == 0)
+ tmp[len++] = digits[0];
+ else
+ {
+ if (n >= 100)
+ {
+ tmp[len++] = digits[n / 100];
+ n = n % 100;
+ tmp[len++] = digits[n / 10];
+ n = n % 10;
+ }
+ else if (n >= 10)
+ {
+ tmp[len++] = digits[n / 10];
+ n = n % 10;
+ }
+
+ tmp[len++] = digits[n];
+ }
+ }
+
+ if (!(type & LEFT)) while (len < size--) *str++ = ' ';
+ for (i = 0; i < len; ++i) *str++ = tmp[i];
+ while (len < size--) *str++ = ' ';
+
+ return str;
+}
+
+#if HAS_FLOAT
+
+char *ecvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf);
+char *fcvtbuf(double arg, int ndigits, int *decpt, int *sign, char *buf);
+static void ee_bufcpy(char *d, char *s, int count);
+
+void ee_bufcpy(char *pd, char *ps, int count) {
+ char *pe=ps+count;
+ while (ps!=pe)
+ *pd++=*ps++;
+}
+
+static void parse_float(double value, char *buffer, char fmt, int precision)
+{
+ int decpt, sign, exp, pos;
+ char *digits = NULL;
+ char cvtbuf[80];
+ int capexp = 0;
+ int magnitude;
+
+ if (fmt == 'G' || fmt == 'E')
+ {
+ capexp = 1;
+ fmt += 'a' - 'A';
+ }
+
+ if (fmt == 'g')
+ {
+ digits = ecvtbuf(value, precision, &decpt, &sign, cvtbuf);
+ magnitude = decpt - 1;
+ if (magnitude < -4 || magnitude > precision - 1)
+ {
+ fmt = 'e';
+ precision -= 1;
+ }
+ else
+ {
+ fmt = 'f';
+ precision -= decpt;
+ }
+ }
+
+ if (fmt == 'e')
+ {
+ digits = ecvtbuf(value, precision + 1, &decpt, &sign, cvtbuf);
+
+ if (sign) *buffer++ = '-';
+ *buffer++ = *digits;
+ if (precision > 0) *buffer++ = '.';
+ ee_bufcpy(buffer, digits + 1, precision);
+ buffer += precision;
+ *buffer++ = capexp ? 'E' : 'e';
+
+ if (decpt == 0)
+ {
+ if (value == 0.0)
+ exp = 0;
+ else
+ exp = -1;
+ }
+ else
+ exp = decpt - 1;
+
+ if (exp < 0)
+ {
+ *buffer++ = '-';
+ exp = -exp;
+ }
+ else
+ *buffer++ = '+';
+
+ buffer[2] = (exp % 10) + '0';
+ exp = exp / 10;
+ buffer[1] = (exp % 10) + '0';
+ exp = exp / 10;
+ buffer[0] = (exp % 10) + '0';
+ buffer += 3;
+ }
+ else if (fmt == 'f')
+ {
+ digits = fcvtbuf(value, precision, &decpt, &sign, cvtbuf);
+ if (sign) *buffer++ = '-';
+ if (*digits)
+ {
+ if (decpt <= 0)
+ {
+ *buffer++ = '0';
+ *buffer++ = '.';
+ for (pos = 0; pos < -decpt; pos++) *buffer++ = '0';
+ while (*digits) *buffer++ = *digits++;
+ }
+ else
+ {
+ pos = 0;
+ while (*digits)
+ {
+ if (pos++ == decpt) *buffer++ = '.';
+ *buffer++ = *digits++;
+ }
+ }
+ }
+ else
+ {
+ *buffer++ = '0';
+ if (precision > 0)
+ {
+ *buffer++ = '.';
+ for (pos = 0; pos < precision; pos++) *buffer++ = '0';
+ }
+ }
+ }
+
+ *buffer = '\0';
+}
+
+static void decimal_point(char *buffer)
+{
+ while (*buffer)
+ {
+ if (*buffer == '.') return;
+ if (*buffer == 'e' || *buffer == 'E') break;
+ buffer++;
+ }
+
+ if (*buffer)
+ {
+ int n = strnlen(buffer,256);
+ while (n > 0)
+ {
+ buffer[n + 1] = buffer[n];
+ n--;
+ }
+
+ *buffer = '.';
+ }
+ else
+ {
+ *buffer++ = '.';
+ *buffer = '\0';
+ }
+}
+
+static void cropzeros(char *buffer)
+{
+ char *stop;
+
+ while (*buffer && *buffer != '.') buffer++;
+ if (*buffer++)
+ {
+ while (*buffer && *buffer != 'e' && *buffer != 'E') buffer++;
+ stop = buffer--;
+ while (*buffer == '0') buffer--;
+ if (*buffer == '.') buffer--;
+ while (buffer!=stop)
+ *++buffer=0;
+ }
+}
+
+static char *flt(char *str, double num, int size, int precision, char fmt, int flags)
+{
+ char tmp[80];
+ char c, sign;
+ int n, i;
+
+ // Left align means no zero padding
+ if (flags & LEFT) flags &= ~ZEROPAD;
+
+ // Determine padding and sign char
+ c = (flags & ZEROPAD) ? '0' : ' ';
+ sign = 0;
+ if (flags & SIGN)
+ {
+ if (num < 0.0)
+ {
+ sign = '-';
+ num = -num;
+ size--;
+ }
+ else if (flags & PLUS)
+ {
+ sign = '+';
+ size--;
+ }
+ else if (flags & SPACE)
+ {
+ sign = ' ';
+ size--;
+ }
+ }
+
+ // Compute the precision value
+ if (precision < 0)
+ precision = 6; // Default precision: 6
+
+ // Convert floating point number to text
+ parse_float(num, tmp, fmt, precision);
+
+ if ((flags & HEX_PREP) && precision == 0) decimal_point(tmp);
+ if (fmt == 'g' && !(flags & HEX_PREP)) cropzeros(tmp);
+
+ n = strnlen(tmp,256);
+
+ // Output number with alignment and padding
+ size -= n;
+ if (!(flags & (ZEROPAD | LEFT))) while (size-- > 0) *str++ = ' ';
+ if (sign) *str++ = sign;
+ if (!(flags & LEFT)) while (size-- > 0) *str++ = c;
+ for (i = 0; i < n; i++) *str++ = tmp[i];
+ while (size-- > 0) *str++ = ' ';
+
+ return str;
+}
+
+#endif
+
+static int ee_vsprintf(char *buf, const char *fmt, va_list args)
+{
+ int len;
+ unsigned long num;
+ int i, base;
+ char *str;
+ char *s;
+
+ int flags; // Flags to number()
+
+ int field_width; // Width of output field
+ int precision; // Min. # of digits for integers; max number of chars for from string
+ int qualifier; // 'h', 'l', or 'L' for integer fields
+
+ for (str = buf; *fmt; fmt++)
+ {
+ if (*fmt != '%')
+ {
+ *str++ = *fmt;
+ continue;
+ }
+
+ // Process flags
+ flags = 0;
+repeat:
+ fmt++; // This also skips first '%'
+ switch (*fmt)
+ {
+ case '-': flags |= LEFT; goto repeat;
+ case '+': flags |= PLUS; goto repeat;
+ case ' ': flags |= SPACE; goto repeat;
+ case '#': flags |= HEX_PREP; goto repeat;
+ case '0': flags |= ZEROPAD; goto repeat;
+ }
+
+ // Get field width
+ field_width = -1;
+ if (is_digit(*fmt))
+ field_width = skip_atoi(&fmt);
+ else if (*fmt == '*')
+ {
+ fmt++;
+ field_width = va_arg(args, int);
+ if (field_width < 0)
+ {
+ field_width = -field_width;
+ flags |= LEFT;
+ }
+ }
+
+ // Get the precision
+ precision = -1;
+ if (*fmt == '.')
+ {
+ ++fmt;
+ if (is_digit(*fmt))
+ precision = skip_atoi(&fmt);
+ else if (*fmt == '*')
+ {
+ ++fmt;
+ precision = va_arg(args, int);
+ }
+ if (precision < 0) precision = 0;
+ }
+
+ // Get the conversion qualifier
+ qualifier = -1;
+ if (*fmt == 'l' || *fmt == 'L')
+ {
+ qualifier = *fmt;
+ fmt++;
+ }
+
+ // Default base
+ base = 10;
+
+ switch (*fmt)
+ {
+ case 'c':
+ if (!(flags & LEFT)) while (--field_width > 0) *str++ = ' ';
+ *str++ = (unsigned char) va_arg(args, int);
+ while (--field_width > 0) *str++ = ' ';
+ continue;
+
+ case 's':
+ s = va_arg(args, char *);
+ if (!s) s = "<NULL>";
+ len = strnlen(s, precision);
+ if (!(flags & LEFT)) while (len < field_width--) *str++ = ' ';
+ for (i = 0; i < len; ++i) *str++ = *s++;
+ while (len < field_width--) *str++ = ' ';
+ continue;
+
+ case 'p':
+ if (field_width == -1)
+ {
+ field_width = 2 * sizeof(void *);
+ flags |= ZEROPAD;
+ }
+ str = number(str, (unsigned long) va_arg(args, void *), 16, field_width, precision, flags);
+ continue;
+
+ case 'A':
+ flags |= UPPERCASE;
+
+ case 'a':
+ if (qualifier == 'l')
+ str = eaddr(str, va_arg(args, unsigned char *), field_width, precision, flags);
+ else
+ str = iaddr(str, va_arg(args, unsigned char *), field_width, precision, flags);
+ continue;
+
+ // Integer number formats - set up the flags and "break"
+ case 'o':
+ base = 8;
+ break;
+
+ case 'X':
+ flags |= UPPERCASE;
+
+ case 'x':
+ base = 16;
+ break;
+
+ case 'd':
+ case 'i':
+ flags |= SIGN;
+
+ case 'u':
+ break;
+
+#if HAS_FLOAT
+
+ case 'f':
+ str = flt(str, va_arg(args, double), field_width, precision, *fmt, flags | SIGN);
+ continue;
+
+#endif
+
+ default:
+ if (*fmt != '%') *str++ = '%';
+ if (*fmt)
+ *str++ = *fmt;
+ else
+ --fmt;
+ continue;
+ }
+
+ if (qualifier == 'l')
+ num = va_arg(args, unsigned long);
+ else if (flags & SIGN)
+ num = va_arg(args, int);
+ else
+ num = va_arg(args, unsigned int);
+
+ str = number(str, num, base, field_width, precision, flags);
+ }
+
+ *str = '\0';
+ return str - buf;
+}
+
+void uart_send_char(char c) {
+#error "You must implement the method uart_send_char to use this file!\n";
+/* Output of a char to a UART usually follows the following model:
+ Wait until UART is ready
+ Write char to UART
+ Wait until UART is done
+
+ Or in code:
+ while (*UART_CONTROL_ADDRESS != UART_READY);
+ *UART_DATA_ADDRESS = c;
+ while (*UART_CONTROL_ADDRESS != UART_READY);
+
+ Check the UART sample code on your platform or the board documentation.
+*/
+}
+
+int ee_printf(const char *fmt, ...)
+{
+ char buf[256],*p;
+ va_list args;
+ int n=0;
+
+ va_start(args, fmt);
+ ee_vsprintf(buf, fmt, args);
+ va_end(args);
+ p=buf;
+ while (*p) {
+ uart_send_char(*p);
+ n++;
+ p++;
+ }
+
+ return n;
+}
+
diff --git a/sw/vendor/coremark/core_list_join.c b/sw/vendor/coremark/core_list_join.c
new file mode 100644
index 0000000..a515428
--- /dev/null
+++ b/sw/vendor/coremark/core_list_join.c
@@ -0,0 +1,495 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include "coremark.h"
+/*
+Topic: Description
+ Benchmark using a linked list.
+
+ Linked list is a common data structure used in many applications.
+
+ For our purposes, this will excercise the memory units of the processor.
+ In particular, usage of the list pointers to find and alter data.
+
+ We are not using Malloc since some platforms do not support this library.
+
+ Instead, the memory block being passed in is used to create a list,
+ and the benchmark takes care not to add more items then can be
+ accomodated by the memory block. The porting layer will make sure
+ that we have a valid memory block.
+
+ All operations are done in place, without using any extra memory.
+
+ The list itself contains list pointers and pointers to data items.
+ Data items contain the following:
+
+ idx - An index that captures the initial order of the list.
+ data - Variable data initialized based on the input parameters. The 16b are divided as follows:
+ o Upper 8b are backup of original data.
+ o Bit 7 indicates if the lower 7 bits are to be used as is or calculated.
+ o Bits 0-2 indicate type of operation to perform to get a 7b value.
+ o Bits 3-6 provide input for the operation.
+
+*/
+
+/* local functions */
+
+list_head *core_list_find(list_head *list,list_data *info);
+list_head *core_list_reverse(list_head *list);
+list_head *core_list_remove(list_head *item);
+list_head *core_list_undo_remove(list_head *item_removed, list_head *item_modified);
+list_head *core_list_insert_new(list_head *insert_point
+ , list_data *info, list_head **memblock, list_data **datablock
+ , list_head *memblock_end, list_data *datablock_end);
+typedef ee_s32(*list_cmp)(list_data *a, list_data *b, core_results *res);
+list_head *core_list_mergesort(list_head *list, list_cmp cmp, core_results *res);
+
+ee_s16 calc_func(ee_s16 *pdata, core_results *res) {
+ ee_s16 data=*pdata;
+ ee_s16 retval;
+ ee_u8 optype=(data>>7) & 1; /* bit 7 indicates if the function result has been cached */
+ if (optype) /* if cached, use cache */
+ return (data & 0x007f);
+ else { /* otherwise calculate and cache the result */
+ ee_s16 flag=data & 0x7; /* bits 0-2 is type of function to perform */
+ ee_s16 dtype=((data>>3) & 0xf); /* bits 3-6 is specific data for the operation */
+ dtype |= dtype << 4; /* replicate the lower 4 bits to get an 8b value */
+ switch (flag) {
+ case 0:
+ if (dtype<0x22) /* set min period for bit corruption */
+ dtype=0x22;
+ retval=core_bench_state(res->size,res->memblock[3],res->seed1,res->seed2,dtype,res->crc);
+ if (res->crcstate==0)
+ res->crcstate=retval;
+ break;
+ case 1:
+ retval=core_bench_matrix(&(res->mat),dtype,res->crc);
+ if (res->crcmatrix==0)
+ res->crcmatrix=retval;
+ break;
+ default:
+ retval=data;
+ break;
+ }
+ res->crc=crcu16(retval,res->crc);
+ retval &= 0x007f;
+ *pdata = (data & 0xff00) | 0x0080 | retval; /* cache the result */
+ return retval;
+ }
+}
+/* Function: cmp_complex
+ Compare the data item in a list cell.
+
+ Can be used by mergesort.
+*/
+ee_s32 cmp_complex(list_data *a, list_data *b, core_results *res) {
+ ee_s16 val1=calc_func(&(a->data16),res);
+ ee_s16 val2=calc_func(&(b->data16),res);
+ return val1 - val2;
+}
+
+/* Function: cmp_idx
+ Compare the idx item in a list cell, and regen the data.
+
+ Can be used by mergesort.
+*/
+ee_s32 cmp_idx(list_data *a, list_data *b, core_results *res) {
+ if (res==NULL) {
+ a->data16 = (a->data16 & 0xff00) | (0x00ff & (a->data16>>8));
+ b->data16 = (b->data16 & 0xff00) | (0x00ff & (b->data16>>8));
+ }
+ return a->idx - b->idx;
+}
+
+void copy_info(list_data *to,list_data *from) {
+ to->data16=from->data16;
+ to->idx=from->idx;
+}
+
+/* Benchmark for linked list:
+ - Try to find multiple data items.
+ - List sort
+ - Operate on data from list (crc)
+ - Single remove/reinsert
+ * At the end of this function, the list is back to original state
+*/
+ee_u16 core_bench_list(core_results *res, ee_s16 finder_idx) {
+ ee_u16 retval=0;
+ ee_u16 found=0,missed=0;
+ list_head *list=res->list;
+ ee_s16 find_num=res->seed3;
+ list_head *this_find;
+ list_head *finder, *remover;
+ list_data info;
+ ee_s16 i;
+
+ info.idx=finder_idx;
+ /* find <find_num> values in the list, and change the list each time (reverse and cache if value found) */
+ for (i=0; i<find_num; i++) {
+ info.data16= (i & 0xff) ;
+ this_find=core_list_find(list,&info);
+ list=core_list_reverse(list);
+ if (this_find==NULL) {
+ missed++;
+ retval+=(list->next->info->data16 >> 8) & 1;
+ }
+ else {
+ found++;
+ if (this_find->info->data16 & 0x1) /* use found value */
+ retval+=(this_find->info->data16 >> 9) & 1;
+ /* and cache next item at the head of the list (if any) */
+ if (this_find->next != NULL) {
+ finder = this_find->next;
+ this_find->next = finder->next;
+ finder->next=list->next;
+ list->next=finder;
+ }
+ }
+ if (info.idx>=0)
+ info.idx++;
+#if CORE_DEBUG
+ ee_printf("List find %d: [%d,%d,%d]\n",i,retval,missed,found);
+#endif
+ }
+ retval+=found*4-missed;
+ /* sort the list by data content and remove one item*/
+ if (finder_idx>0)
+ list=core_list_mergesort(list,cmp_complex,res);
+ remover=core_list_remove(list->next);
+ /* CRC data content of list from location of index N forward, and then undo remove */
+ finder=core_list_find(list,&info);
+ if (!finder)
+ finder=list->next;
+ while (finder) {
+ retval=crc16(list->info->data16,retval);
+ finder=finder->next;
+ }
+#if CORE_DEBUG
+ ee_printf("List sort 1: %04x\n",retval);
+#endif
+ remover=core_list_undo_remove(remover,list->next);
+ /* sort the list by index, in effect returning the list to original state */
+ list=core_list_mergesort(list,cmp_idx,NULL);
+ /* CRC data content of list */
+ finder=list->next;
+ while (finder) {
+ retval=crc16(list->info->data16,retval);
+ finder=finder->next;
+ }
+#if CORE_DEBUG
+ ee_printf("List sort 2: %04x\n",retval);
+#endif
+ return retval;
+}
+/* Function: core_list_init
+ Initialize list with data.
+
+ Parameters:
+ blksize - Size of memory to be initialized.
+ memblock - Pointer to memory block.
+ seed - Actual values chosen depend on the seed parameter.
+ The seed parameter MUST be supplied from a source that cannot be determined at compile time
+
+ Returns:
+ Pointer to the head of the list.
+
+*/
+list_head *core_list_init(ee_u32 blksize, list_head *memblock, ee_s16 seed) {
+ /* calculated pointers for the list */
+ ee_u32 per_item=16+sizeof(struct list_data_s);
+ ee_u32 size=(blksize/per_item)-2; /* to accomodate systems with 64b pointers, and make sure same code is executed, set max list elements */
+ list_head *memblock_end=memblock+size;
+ list_data *datablock=(list_data *)(memblock_end);
+ list_data *datablock_end=datablock+size;
+ /* some useful variables */
+ ee_u32 i;
+ list_head *finder,*list=memblock;
+ list_data info;
+
+ /* create a fake items for the list head and tail */
+ list->next=NULL;
+ list->info=datablock;
+ list->info->idx=0x0000;
+ list->info->data16=(ee_s16)0x8080;
+ memblock++;
+ datablock++;
+ info.idx=0x7fff;
+ info.data16=(ee_s16)0xffff;
+ core_list_insert_new(list,&info,&memblock,&datablock,memblock_end,datablock_end);
+
+ /* then insert size items */
+ for (i=0; i<size; i++) {
+ ee_u16 datpat=((ee_u16)(seed^i) & 0xf);
+ ee_u16 dat=(datpat<<3) | (i&0x7); /* alternate between algorithms */
+ info.data16=(dat<<8) | dat; /* fill the data with actual data and upper bits with rebuild value */
+ core_list_insert_new(list,&info,&memblock,&datablock,memblock_end,datablock_end);
+ }
+ /* and now index the list so we know initial seed order of the list */
+ finder=list->next;
+ i=1;
+ while (finder->next!=NULL) {
+ if (i<size/5) /* first 20% of the list in order */
+ finder->info->idx=i++;
+ else {
+ ee_u16 pat=(ee_u16)(i++ ^ seed); /* get a pseudo random number */
+ finder->info->idx=0x3fff & (((i & 0x07) << 8) | pat); /* make sure the mixed items end up after the ones in sequence */
+ }
+ finder=finder->next;
+ }
+ list = core_list_mergesort(list,cmp_idx,NULL);
+#if CORE_DEBUG
+ ee_printf("Initialized list:\n");
+ finder=list;
+ while (finder) {
+ ee_printf("[%04x,%04x]",finder->info->idx,(ee_u16)finder->info->data16);
+ finder=finder->next;
+ }
+ ee_printf("\n");
+#endif
+ return list;
+}
+
+/* Function: core_list_insert
+ Insert an item to the list
+
+ Parameters:
+ insert_point - where to insert the item.
+ info - data for the cell.
+ memblock - pointer for the list header
+ datablock - pointer for the list data
+ memblock_end - end of region for list headers
+ datablock_end - end of region for list data
+
+ Returns:
+ Pointer to new item.
+*/
+list_head *core_list_insert_new(list_head *insert_point, list_data *info, list_head **memblock, list_data **datablock
+ , list_head *memblock_end, list_data *datablock_end) {
+ list_head *newitem;
+
+ if ((*memblock+1) >= memblock_end)
+ return NULL;
+ if ((*datablock+1) >= datablock_end)
+ return NULL;
+
+ newitem=*memblock;
+ (*memblock)++;
+ newitem->next=insert_point->next;
+ insert_point->next=newitem;
+
+ newitem->info=*datablock;
+ (*datablock)++;
+ copy_info(newitem->info,info);
+
+ return newitem;
+}
+
+/* Function: core_list_remove
+ Remove an item from the list.
+
+ Operation:
+ For a singly linked list, remove by copying the data from the next item
+ over to the current cell, and unlinking the next item.
+
+ Note:
+ since there is always a fake item at the end of the list, no need to check for NULL.
+
+ Returns:
+ Removed item.
+*/
+list_head *core_list_remove(list_head *item) {
+ list_data *tmp;
+ list_head *ret=item->next;
+ /* swap data pointers */
+ tmp=item->info;
+ item->info=ret->info;
+ ret->info=tmp;
+ /* and eliminate item */
+ item->next=item->next->next;
+ ret->next=NULL;
+ return ret;
+}
+
+/* Function: core_list_undo_remove
+ Undo a remove operation.
+
+ Operation:
+ Since we want each iteration of the benchmark to be exactly the same,
+ we need to be able to undo a remove.
+ Link the removed item back into the list, and switch the info items.
+
+ Parameters:
+ item_removed - Return value from the <core_list_remove>
+ item_modified - List item that was modified during <core_list_remove>
+
+ Returns:
+ The item that was linked back to the list.
+
+*/
+list_head *core_list_undo_remove(list_head *item_removed, list_head *item_modified) {
+ list_data *tmp;
+ /* swap data pointers */
+ tmp=item_removed->info;
+ item_removed->info=item_modified->info;
+ item_modified->info=tmp;
+ /* and insert item */
+ item_removed->next=item_modified->next;
+ item_modified->next=item_removed;
+ return item_removed;
+}
+
+/* Function: core_list_find
+ Find an item in the list
+
+ Operation:
+ Find an item by idx (if not 0) or specific data value
+
+ Parameters:
+ list - list head
+ info - idx or data to find
+
+ Returns:
+ Found item, or NULL if not found.
+*/
+list_head *core_list_find(list_head *list,list_data *info) {
+ if (info->idx>=0) {
+ while (list && (list->info->idx != info->idx))
+ list=list->next;
+ return list;
+ } else {
+ while (list && ((list->info->data16 & 0xff) != info->data16))
+ list=list->next;
+ return list;
+ }
+}
+/* Function: core_list_reverse
+ Reverse a list
+
+ Operation:
+ Rearrange the pointers so the list is reversed.
+
+ Parameters:
+ list - list head
+ info - idx or data to find
+
+ Returns:
+ Found item, or NULL if not found.
+*/
+
+list_head *core_list_reverse(list_head *list) {
+ list_head *next=NULL, *tmp;
+ while (list) {
+ tmp=list->next;
+ list->next=next;
+ next=list;
+ list=tmp;
+ }
+ return next;
+}
+/* Function: core_list_mergesort
+ Sort the list in place without recursion.
+
+ Description:
+ Use mergesort, as for linked list this is a realistic solution.
+ Also, since this is aimed at embedded, care was taken to use iterative rather then recursive algorithm.
+ The sort can either return the list to original order (by idx) ,
+ or use the data item to invoke other other algorithms and change the order of the list.
+
+ Parameters:
+ list - list to be sorted.
+ cmp - cmp function to use
+
+ Returns:
+ New head of the list.
+
+ Note:
+ We have a special header for the list that will always be first,
+ but the algorithm could theoretically modify where the list starts.
+
+ */
+list_head *core_list_mergesort(list_head *list, list_cmp cmp, core_results *res) {
+ list_head *p, *q, *e, *tail;
+ ee_s32 insize, nmerges, psize, qsize, i;
+
+ insize = 1;
+
+ while (1) {
+ p = list;
+ list = NULL;
+ tail = NULL;
+
+ nmerges = 0; /* count number of merges we do in this pass */
+
+ while (p) {
+ nmerges++; /* there exists a merge to be done */
+ /* step `insize' places along from p */
+ q = p;
+ psize = 0;
+ for (i = 0; i < insize; i++) {
+ psize++;
+ q = q->next;
+ if (!q) break;
+ }
+
+ /* if q hasn't fallen off end, we have two lists to merge */
+ qsize = insize;
+
+ /* now we have two lists; merge them */
+ while (psize > 0 || (qsize > 0 && q)) {
+
+ /* decide whether next element of merge comes from p or q */
+ if (psize == 0) {
+ /* p is empty; e must come from q. */
+ e = q; q = q->next; qsize--;
+ } else if (qsize == 0 || !q) {
+ /* q is empty; e must come from p. */
+ e = p; p = p->next; psize--;
+ } else if (cmp(p->info,q->info,res) <= 0) {
+ /* First element of p is lower (or same); e must come from p. */
+ e = p; p = p->next; psize--;
+ } else {
+ /* First element of q is lower; e must come from q. */
+ e = q; q = q->next; qsize--;
+ }
+
+ /* add the next element to the merged list */
+ if (tail) {
+ tail->next = e;
+ } else {
+ list = e;
+ }
+ tail = e;
+ }
+
+ /* now p has stepped `insize' places along, and q has too */
+ p = q;
+ }
+
+ tail->next = NULL;
+
+ /* If we have done only one merge, we're finished. */
+ if (nmerges <= 1) /* allow for nmerges==0, the empty list case */
+ return list;
+
+ /* Otherwise repeat, merging lists twice the size */
+ insize *= 2;
+ }
+#if COMPILER_REQUIRES_SORT_RETURN
+ return list;
+#endif
+}
diff --git a/sw/vendor/coremark/core_main.c b/sw/vendor/coremark/core_main.c
new file mode 100644
index 0000000..6161974
--- /dev/null
+++ b/sw/vendor/coremark/core_main.c
@@ -0,0 +1,356 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+/* File: core_main.c
+ This file contains the framework to acquire a block of memory, seed initial parameters, tun t he benchmark and report the results.
+*/
+#include "coremark.h"
+
+/* Function: iterate
+ Run the benchmark for a specified number of iterations.
+
+ Operation:
+ For each type of benchmarked algorithm:
+ a - Initialize the data block for the algorithm.
+ b - Execute the algorithm N times.
+
+ Returns:
+ NULL.
+*/
+static ee_u16 list_known_crc[] = {(ee_u16)0xd4b0,(ee_u16)0x3340,(ee_u16)0x6a79,(ee_u16)0xe714,(ee_u16)0xe3c1};
+static ee_u16 matrix_known_crc[] = {(ee_u16)0xbe52,(ee_u16)0x1199,(ee_u16)0x5608,(ee_u16)0x1fd7,(ee_u16)0x0747};
+static ee_u16 state_known_crc[] = {(ee_u16)0x5e47,(ee_u16)0x39bf,(ee_u16)0xe5a4,(ee_u16)0x8e3a,(ee_u16)0x8d84};
+void *iterate(void *pres) {
+ ee_u32 i;
+ ee_u16 crc;
+ core_results *res=(core_results *)pres;
+ ee_u32 iterations=res->iterations;
+ res->crc=0;
+ res->crclist=0;
+ res->crcmatrix=0;
+ res->crcstate=0;
+
+ for (i=0; i<iterations; i++) {
+ crc=core_bench_list(res,1);
+ res->crc=crcu16(crc,res->crc);
+ crc=core_bench_list(res,-1);
+ res->crc=crcu16(crc,res->crc);
+ if (i==0) res->crclist=res->crc;
+ }
+ return NULL;
+}
+
+#if (SEED_METHOD==SEED_ARG)
+ee_s32 get_seed_args(int i, int argc, char *argv[]);
+#define get_seed(x) (ee_s16)get_seed_args(x,argc,argv)
+#define get_seed_32(x) get_seed_args(x,argc,argv)
+#else /* via function or volatile */
+ee_s32 get_seed_32(int i);
+#define get_seed(x) (ee_s16)get_seed_32(x)
+#endif
+
+#if (MEM_METHOD==MEM_STATIC)
+ee_u8 static_memblk[TOTAL_DATA_SIZE];
+#endif
+char *mem_name[3] = {"Static","Heap","Stack"};
+/* Function: main
+ Main entry routine for the benchmark.
+ This function is responsible for the following steps:
+
+ 1 - Initialize input seeds from a source that cannot be determined at compile time.
+ 2 - Initialize memory block for use.
+ 3 - Run and time the benchmark.
+ 4 - Report results, testing the validity of the output if the seeds are known.
+
+ Arguments:
+ 1 - first seed : Any value
+ 2 - second seed : Must be identical to first for iterations to be identical
+ 3 - third seed : Any value, should be at least an order of magnitude less then the input size, but bigger then 32.
+ 4 - Iterations : Special, if set to 0, iterations will be automatically determined such that the benchmark will run between 10 to 100 secs
+
+*/
+
+#if MAIN_HAS_NOARGC
+MAIN_RETURN_TYPE main(void) {
+ int argc=0;
+ char *argv[1];
+#else
+MAIN_RETURN_TYPE main(int argc, char *argv[]) {
+#endif
+ ee_u16 i,j=0,num_algorithms=0;
+ ee_s16 known_id=-1,total_errors=0;
+ ee_u16 seedcrc=0;
+ CORE_TICKS total_time;
+ core_results results[MULTITHREAD];
+#if (MEM_METHOD==MEM_STACK)
+ ee_u8 stack_memblock[TOTAL_DATA_SIZE*MULTITHREAD];
+#endif
+ /* first call any initializations needed */
+ portable_init(&(results[0].port), &argc, argv);
+ /* First some checks to make sure benchmark will run ok */
+ if (sizeof(struct list_head_s)>128) {
+ ee_printf("list_head structure too big for comparable data!\n");
+ return MAIN_RETURN_VAL;
+ }
+ results[0].seed1=get_seed(1);
+ results[0].seed2=get_seed(2);
+ results[0].seed3=get_seed(3);
+ results[0].iterations=get_seed_32(4);
+#if CORE_DEBUG
+ results[0].iterations=1;
+#endif
+ results[0].execs=get_seed_32(5);
+ if (results[0].execs==0) { /* if not supplied, execute all algorithms */
+ results[0].execs=ALL_ALGORITHMS_MASK;
+ }
+ /* put in some default values based on one seed only for easy testing */
+ if ((results[0].seed1==0) && (results[0].seed2==0) && (results[0].seed3==0)) { /* validation run */
+ results[0].seed1=0;
+ results[0].seed2=0;
+ results[0].seed3=0x66;
+ }
+ if ((results[0].seed1==1) && (results[0].seed2==0) && (results[0].seed3==0)) { /* perfromance run */
+ results[0].seed1=0x3415;
+ results[0].seed2=0x3415;
+ results[0].seed3=0x66;
+ }
+#if (MEM_METHOD==MEM_STATIC)
+ results[0].memblock[0]=(void *)static_memblk;
+ results[0].size=TOTAL_DATA_SIZE;
+ results[0].err=0;
+ #if (MULTITHREAD>1)
+ #error "Cannot use a static data area with multiple contexts!"
+ #endif
+#elif (MEM_METHOD==MEM_MALLOC)
+ for (i=0 ; i<MULTITHREAD; i++) {
+ ee_s32 malloc_override=get_seed(7);
+ if (malloc_override != 0)
+ results[i].size=malloc_override;
+ else
+ results[i].size=TOTAL_DATA_SIZE;
+ results[i].memblock[0]=portable_malloc(results[i].size);
+ results[i].seed1=results[0].seed1;
+ results[i].seed2=results[0].seed2;
+ results[i].seed3=results[0].seed3;
+ results[i].err=0;
+ results[i].execs=results[0].execs;
+ }
+#elif (MEM_METHOD==MEM_STACK)
+ for (i=0 ; i<MULTITHREAD; i++) {
+ results[i].memblock[0]=stack_memblock+i*TOTAL_DATA_SIZE;
+ results[i].size=TOTAL_DATA_SIZE;
+ results[i].seed1=results[0].seed1;
+ results[i].seed2=results[0].seed2;
+ results[i].seed3=results[0].seed3;
+ results[i].err=0;
+ results[i].execs=results[0].execs;
+ }
+#else
+#error "Please define a way to initialize a memory block."
+#endif
+ /* Data init */
+ /* Find out how space much we have based on number of algorithms */
+ for (i=0; i<NUM_ALGORITHMS; i++) {
+ if ((1<<(ee_u32)i) & results[0].execs)
+ num_algorithms++;
+ }
+ for (i=0 ; i<MULTITHREAD; i++)
+ results[i].size=results[i].size/num_algorithms;
+ /* Assign pointers */
+ for (i=0; i<NUM_ALGORITHMS; i++) {
+ ee_u32 ctx;
+ if ((1<<(ee_u32)i) & results[0].execs) {
+ for (ctx=0 ; ctx<MULTITHREAD; ctx++)
+ results[ctx].memblock[i+1]=(char *)(results[ctx].memblock[0])+results[0].size*j;
+ j++;
+ }
+ }
+ /* call inits */
+ for (i=0 ; i<MULTITHREAD; i++) {
+ if (results[i].execs & ID_LIST) {
+ results[i].list=core_list_init(results[0].size,results[i].memblock[1],results[i].seed1);
+ }
+ if (results[i].execs & ID_MATRIX) {
+ core_init_matrix(results[0].size, results[i].memblock[2], (ee_s32)results[i].seed1 | (((ee_s32)results[i].seed2) << 16), &(results[i].mat) );
+ }
+ if (results[i].execs & ID_STATE) {
+ core_init_state(results[0].size,results[i].seed1,results[i].memblock[3]);
+ }
+ }
+
+ /* automatically determine number of iterations if not set */
+ if (results[0].iterations==0) {
+ secs_ret secs_passed=0;
+ ee_u32 divisor;
+ results[0].iterations=1;
+ while (secs_passed < (secs_ret)1) {
+ results[0].iterations*=10;
+ start_time();
+ iterate(&results[0]);
+ stop_time();
+ secs_passed=time_in_secs(get_time());
+ }
+ /* now we know it executes for at least 1 sec, set actual run time at about 10 secs */
+ divisor=(ee_u32)secs_passed;
+ if (divisor==0) /* some machines cast float to int as 0 since this conversion is not defined by ANSI, but we know at least one second passed */
+ divisor=1;
+ results[0].iterations*=1+10/divisor;
+ }
+ /* perform actual benchmark */
+ start_time();
+#if (MULTITHREAD>1)
+ if (default_num_contexts>MULTITHREAD) {
+ default_num_contexts=MULTITHREAD;
+ }
+ for (i=0 ; i<default_num_contexts; i++) {
+ results[i].iterations=results[0].iterations;
+ results[i].execs=results[0].execs;
+ core_start_parallel(&results[i]);
+ }
+ for (i=0 ; i<default_num_contexts; i++) {
+ core_stop_parallel(&results[i]);
+ }
+#else
+ iterate(&results[0]);
+#endif
+ stop_time();
+ total_time=get_time();
+ /* get a function of the input to report */
+ seedcrc=crc16(results[0].seed1,seedcrc);
+ seedcrc=crc16(results[0].seed2,seedcrc);
+ seedcrc=crc16(results[0].seed3,seedcrc);
+ seedcrc=crc16(results[0].size,seedcrc);
+
+ switch (seedcrc) { /* test known output for common seeds */
+ case 0x8a02: /* seed1=0, seed2=0, seed3=0x66, size 2000 per algorithm */
+ known_id=0;
+ ee_printf("6k performance run parameters for coremark.\n");
+ break;
+ case 0x7b05: /* seed1=0x3415, seed2=0x3415, seed3=0x66, size 2000 per algorithm */
+ known_id=1;
+ ee_printf("6k validation run parameters for coremark.\n");
+ break;
+ case 0x4eaf: /* seed1=0x8, seed2=0x8, seed3=0x8, size 400 per algorithm */
+ known_id=2;
+ ee_printf("Profile generation run parameters for coremark.\n");
+ break;
+ case 0xe9f5: /* seed1=0, seed2=0, seed3=0x66, size 666 per algorithm */
+ known_id=3;
+ ee_printf("2K performance run parameters for coremark.\n");
+ break;
+ case 0x18f2: /* seed1=0x3415, seed2=0x3415, seed3=0x66, size 666 per algorithm */
+ known_id=4;
+ ee_printf("2K validation run parameters for coremark.\n");
+ break;
+ default:
+ total_errors=-1;
+ break;
+ }
+ if (known_id>=0) {
+ for (i=0 ; i<default_num_contexts; i++) {
+ results[i].err=0;
+ if ((results[i].execs & ID_LIST) &&
+ (results[i].crclist!=list_known_crc[known_id])) {
+ ee_printf("[%u]ERROR! list crc 0x%04x - should be 0x%04x\n",i,results[i].crclist,list_known_crc[known_id]);
+ results[i].err++;
+ }
+ if ((results[i].execs & ID_MATRIX) &&
+ (results[i].crcmatrix!=matrix_known_crc[known_id])) {
+ ee_printf("[%u]ERROR! matrix crc 0x%04x - should be 0x%04x\n",i,results[i].crcmatrix,matrix_known_crc[known_id]);
+ results[i].err++;
+ }
+ if ((results[i].execs & ID_STATE) &&
+ (results[i].crcstate!=state_known_crc[known_id])) {
+ ee_printf("[%u]ERROR! state crc 0x%04x - should be 0x%04x\n",i,results[i].crcstate,state_known_crc[known_id]);
+ results[i].err++;
+ }
+ total_errors+=results[i].err;
+ }
+ }
+ total_errors+=check_data_types();
+ /* and report results */
+ ee_printf("CoreMark Size : %lu\n", (long unsigned) results[0].size);
+ ee_printf("Total ticks : %lu\n", (long unsigned) total_time);
+#if HAS_FLOAT
+ ee_printf("Total time (secs): %f\n",time_in_secs(total_time));
+ if (time_in_secs(total_time) > 0)
+ ee_printf("Iterations/Sec : %f\n",default_num_contexts*results[0].iterations/time_in_secs(total_time));
+#else
+ ee_printf("Total time (secs): %d\n",time_in_secs(total_time));
+ if (time_in_secs(total_time) > 0)
+ ee_printf("Iterations/Sec : %d\n",default_num_contexts*results[0].iterations/time_in_secs(total_time));
+#endif
+ if (time_in_secs(total_time) < 10) {
+ ee_printf("ERROR! Must execute for at least 10 secs for a valid result!\n");
+ total_errors++;
+ }
+
+ ee_printf("Iterations : %lu\n", (long unsigned) default_num_contexts*results[0].iterations);
+ ee_printf("Compiler version : %s\n",COMPILER_VERSION);
+ ee_printf("Compiler flags : %s\n",COMPILER_FLAGS);
+#if (MULTITHREAD>1)
+ ee_printf("Parallel %s : %d\n",PARALLEL_METHOD,default_num_contexts);
+#endif
+ ee_printf("Memory location : %s\n",MEM_LOCATION);
+ /* output for verification */
+ ee_printf("seedcrc : 0x%04x\n",seedcrc);
+ if (results[0].execs & ID_LIST)
+ for (i=0 ; i<default_num_contexts; i++)
+ ee_printf("[%d]crclist : 0x%04x\n",i,results[i].crclist);
+ if (results[0].execs & ID_MATRIX)
+ for (i=0 ; i<default_num_contexts; i++)
+ ee_printf("[%d]crcmatrix : 0x%04x\n",i,results[i].crcmatrix);
+ if (results[0].execs & ID_STATE)
+ for (i=0 ; i<default_num_contexts; i++)
+ ee_printf("[%d]crcstate : 0x%04x\n",i,results[i].crcstate);
+ for (i=0 ; i<default_num_contexts; i++)
+ ee_printf("[%d]crcfinal : 0x%04x\n",i,results[i].crc);
+ if (total_errors==0) {
+ ee_printf("Correct operation validated. See README.md for run and reporting rules.\n");
+#if HAS_FLOAT
+ if (known_id==3) {
+ ee_printf("CoreMark 1.0 : %f / %s %s",default_num_contexts*results[0].iterations/time_in_secs(total_time),COMPILER_VERSION,COMPILER_FLAGS);
+#if defined(MEM_LOCATION) && !defined(MEM_LOCATION_UNSPEC)
+ ee_printf(" / %s",MEM_LOCATION);
+#else
+ ee_printf(" / %s",mem_name[MEM_METHOD]);
+#endif
+
+#if (MULTITHREAD>1)
+ ee_printf(" / %d:%s",default_num_contexts,PARALLEL_METHOD);
+#endif
+ ee_printf("\n");
+ }
+#endif
+ }
+ if (total_errors>0)
+ ee_printf("Errors detected\n");
+ if (total_errors<0)
+ ee_printf("Cannot validate operation for these seed values, please compare with results on a known platform.\n");
+
+#if (MEM_METHOD==MEM_MALLOC)
+ for (i=0 ; i<MULTITHREAD; i++)
+ portable_free(results[i].memblock[0]);
+#endif
+ /* And last call any target specific code for finalizing */
+ portable_fini(&(results[0].port));
+
+ return MAIN_RETURN_VAL;
+}
+
+
diff --git a/sw/vendor/coremark/core_matrix.c b/sw/vendor/coremark/core_matrix.c
new file mode 100644
index 0000000..ebfa1d7
--- /dev/null
+++ b/sw/vendor/coremark/core_matrix.c
@@ -0,0 +1,308 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include "coremark.h"
+/*
+Topic: Description
+ Matrix manipulation benchmark
+
+ This very simple algorithm forms the basis of many more complex algorithms.
+
+ The tight inner loop is the focus of many optimizations (compiler as well as hardware based)
+ and is thus relevant for embedded processing.
+
+ The total available data space will be divided to 3 parts:
+ NxN Matrix A - initialized with small values (upper 3/4 of the bits all zero).
+ NxN Matrix B - initialized with medium values (upper half of the bits all zero).
+ NxN Matrix C - used for the result.
+
+ The actual values for A and B must be derived based on input that is not available at compile time.
+*/
+ee_s16 matrix_test(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B, MATDAT val);
+ee_s16 matrix_sum(ee_u32 N, MATRES *C, MATDAT clipval);
+void matrix_mul_const(ee_u32 N, MATRES *C, MATDAT *A, MATDAT val);
+void matrix_mul_vect(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B);
+void matrix_mul_matrix(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B);
+void matrix_mul_matrix_bitextract(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B);
+void matrix_add_const(ee_u32 N, MATDAT *A, MATDAT val);
+
+#define matrix_test_next(x) (x+1)
+#define matrix_clip(x,y) ((y) ? (x) & 0x0ff : (x) & 0x0ffff)
+#define matrix_big(x) (0xf000 | (x))
+#define bit_extract(x,from,to) (((x)>>(from)) & (~(0xffffffff << (to))))
+
+#if CORE_DEBUG
+void printmat(MATDAT *A, ee_u32 N, char *name) {
+ ee_u32 i,j;
+ ee_printf("Matrix %s [%dx%d]:\n",name,N,N);
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ if (j!=0)
+ ee_printf(",");
+ ee_printf("%d",A[i*N+j]);
+ }
+ ee_printf("\n");
+ }
+}
+void printmatC(MATRES *C, ee_u32 N, char *name) {
+ ee_u32 i,j;
+ ee_printf("Matrix %s [%dx%d]:\n",name,N,N);
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ if (j!=0)
+ ee_printf(",");
+ ee_printf("%d",C[i*N+j]);
+ }
+ ee_printf("\n");
+ }
+}
+#endif
+/* Function: core_bench_matrix
+ Benchmark function
+
+ Iterate <matrix_test> N times,
+ changing the matrix values slightly by a constant amount each time.
+*/
+ee_u16 core_bench_matrix(mat_params *p, ee_s16 seed, ee_u16 crc) {
+ ee_u32 N=p->N;
+ MATRES *C=p->C;
+ MATDAT *A=p->A;
+ MATDAT *B=p->B;
+ MATDAT val=(MATDAT)seed;
+
+ crc=crc16(matrix_test(N,C,A,B,val),crc);
+
+ return crc;
+}
+
+/* Function: matrix_test
+ Perform matrix manipulation.
+
+ Parameters:
+ N - Dimensions of the matrix.
+ C - memory for result matrix.
+ A - input matrix
+ B - operator matrix (not changed during operations)
+
+ Returns:
+ A CRC value that captures all results calculated in the function.
+ In particular, crc of the value calculated on the result matrix
+ after each step by <matrix_sum>.
+
+ Operation:
+
+ 1 - Add a constant value to all elements of a matrix.
+ 2 - Multiply a matrix by a constant.
+ 3 - Multiply a matrix by a vector.
+ 4 - Multiply a matrix by a matrix.
+ 5 - Add a constant value to all elements of a matrix.
+
+ After the last step, matrix A is back to original contents.
+*/
+ee_s16 matrix_test(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B, MATDAT val) {
+ ee_u16 crc=0;
+ MATDAT clipval=matrix_big(val);
+
+ matrix_add_const(N,A,val); /* make sure data changes */
+#if CORE_DEBUG
+ printmat(A,N,"matrix_add_const");
+#endif
+ matrix_mul_const(N,C,A,val);
+ crc=crc16(matrix_sum(N,C,clipval),crc);
+#if CORE_DEBUG
+ printmatC(C,N,"matrix_mul_const");
+#endif
+ matrix_mul_vect(N,C,A,B);
+ crc=crc16(matrix_sum(N,C,clipval),crc);
+#if CORE_DEBUG
+ printmatC(C,N,"matrix_mul_vect");
+#endif
+ matrix_mul_matrix(N,C,A,B);
+ crc=crc16(matrix_sum(N,C,clipval),crc);
+#if CORE_DEBUG
+ printmatC(C,N,"matrix_mul_matrix");
+#endif
+ matrix_mul_matrix_bitextract(N,C,A,B);
+ crc=crc16(matrix_sum(N,C,clipval),crc);
+#if CORE_DEBUG
+ printmatC(C,N,"matrix_mul_matrix_bitextract");
+#endif
+
+ matrix_add_const(N,A,-val); /* return matrix to initial value */
+ return crc;
+}
+
+/* Function : matrix_init
+ Initialize the memory block for matrix benchmarking.
+
+ Parameters:
+ blksize - Size of memory to be initialized.
+ memblk - Pointer to memory block.
+ seed - Actual values chosen depend on the seed parameter.
+ p - pointers to <mat_params> containing initialized matrixes.
+
+ Returns:
+ Matrix dimensions.
+
+ Note:
+ The seed parameter MUST be supplied from a source that cannot be determined at compile time
+*/
+ee_u32 core_init_matrix(ee_u32 blksize, void *memblk, ee_s32 seed, mat_params *p) {
+ ee_u32 N=0;
+ MATDAT *A;
+ MATDAT *B;
+ ee_s32 order=1;
+ MATDAT val;
+ ee_u32 i=0,j=0;
+ if (seed==0)
+ seed=1;
+ while (j<blksize) {
+ i++;
+ j=i*i*2*4;
+ }
+ N=i-1;
+ A=(MATDAT *)align_mem(memblk);
+ B=A+N*N;
+
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ seed = ( ( order * seed ) % 65536 );
+ val = (seed + order);
+ val=matrix_clip(val,0);
+ B[i*N+j] = val;
+ val = (val + order);
+ val=matrix_clip(val,1);
+ A[i*N+j] = val;
+ order++;
+ }
+ }
+
+ p->A=A;
+ p->B=B;
+ p->C=(MATRES *)align_mem(B+N*N);
+ p->N=N;
+#if CORE_DEBUG
+ printmat(A,N,"A");
+ printmat(B,N,"B");
+#endif
+ return N;
+}
+
+/* Function: matrix_sum
+ Calculate a function that depends on the values of elements in the matrix.
+
+ For each element, accumulate into a temporary variable.
+
+ As long as this value is under the parameter clipval,
+ add 1 to the result if the element is bigger then the previous.
+
+ Otherwise, reset the accumulator and add 10 to the result.
+*/
+ee_s16 matrix_sum(ee_u32 N, MATRES *C, MATDAT clipval) {
+ MATRES tmp=0,prev=0,cur=0;
+ ee_s16 ret=0;
+ ee_u32 i,j;
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ cur=C[i*N+j];
+ tmp+=cur;
+ if (tmp>clipval) {
+ ret+=10;
+ tmp=0;
+ } else {
+ ret += (cur>prev) ? 1 : 0;
+ }
+ prev=cur;
+ }
+ }
+ return ret;
+}
+
+/* Function: matrix_mul_const
+ Multiply a matrix by a constant.
+ This could be used as a scaler for instance.
+*/
+void matrix_mul_const(ee_u32 N, MATRES *C, MATDAT *A, MATDAT val) {
+ ee_u32 i,j;
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ C[i*N+j]=(MATRES)A[i*N+j] * (MATRES)val;
+ }
+ }
+}
+
+/* Function: matrix_add_const
+ Add a constant value to all elements of a matrix.
+*/
+void matrix_add_const(ee_u32 N, MATDAT *A, MATDAT val) {
+ ee_u32 i,j;
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ A[i*N+j] += val;
+ }
+ }
+}
+
+/* Function: matrix_mul_vect
+ Multiply a matrix by a vector.
+ This is common in many simple filters (e.g. fir where a vector of coefficients is applied to the matrix.)
+*/
+void matrix_mul_vect(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B) {
+ ee_u32 i,j;
+ for (i=0; i<N; i++) {
+ C[i]=0;
+ for (j=0; j<N; j++) {
+ C[i]+=(MATRES)A[i*N+j] * (MATRES)B[j];
+ }
+ }
+}
+
+/* Function: matrix_mul_matrix
+ Multiply a matrix by a matrix.
+ Basic code is used in many algorithms, mostly with minor changes such as scaling.
+*/
+void matrix_mul_matrix(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B) {
+ ee_u32 i,j,k;
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ C[i*N+j]=0;
+ for(k=0;k<N;k++)
+ {
+ C[i*N+j]+=(MATRES)A[i*N+k] * (MATRES)B[k*N+j];
+ }
+ }
+ }
+}
+
+/* Function: matrix_mul_matrix_bitextract
+ Multiply a matrix by a matrix, and extract some bits from the result.
+ Basic code is used in many algorithms, mostly with minor changes such as scaling.
+*/
+void matrix_mul_matrix_bitextract(ee_u32 N, MATRES *C, MATDAT *A, MATDAT *B) {
+ ee_u32 i,j,k;
+ for (i=0; i<N; i++) {
+ for (j=0; j<N; j++) {
+ C[i*N+j]=0;
+ for(k=0;k<N;k++)
+ {
+ MATRES tmp=(MATRES)A[i*N+k] * (MATRES)B[k*N+j];
+ C[i*N+j]+=bit_extract(tmp,2,4)*bit_extract(tmp,5,7);
+ }
+ }
+ }
+}
diff --git a/sw/vendor/coremark/core_state.c b/sw/vendor/coremark/core_state.c
new file mode 100644
index 0000000..bb31933
--- /dev/null
+++ b/sw/vendor/coremark/core_state.c
@@ -0,0 +1,277 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include "coremark.h"
+/* local functions */
+enum CORE_STATE core_state_transition( ee_u8 **instr , ee_u32 *transition_count);
+
+/*
+Topic: Description
+ Simple state machines like this one are used in many embedded products.
+
+ For more complex state machines, sometimes a state transition table implementation is used instead,
+ trading speed of direct coding for ease of maintenance.
+
+ Since the main goal of using a state machine in CoreMark is to excercise the switch/if behaviour,
+ we are using a small moore machine.
+
+ In particular, this machine tests type of string input,
+ trying to determine whether the input is a number or something else.
+ (see core_state.png).
+*/
+
+/* Function: core_bench_state
+ Benchmark function
+
+ Go over the input twice, once direct, and once after introducing some corruption.
+*/
+ee_u16 core_bench_state(ee_u32 blksize, ee_u8 *memblock,
+ ee_s16 seed1, ee_s16 seed2, ee_s16 step, ee_u16 crc)
+{
+ ee_u32 final_counts[NUM_CORE_STATES];
+ ee_u32 track_counts[NUM_CORE_STATES];
+ ee_u8 *p=memblock;
+ ee_u32 i;
+
+
+#if CORE_DEBUG
+ ee_printf("State Bench: %d,%d,%d,%04x\n",seed1,seed2,step,crc);
+#endif
+ for (i=0; i<NUM_CORE_STATES; i++) {
+ final_counts[i]=track_counts[i]=0;
+ }
+ /* run the state machine over the input */
+ while (*p!=0) {
+ enum CORE_STATE fstate=core_state_transition(&p,track_counts);
+ final_counts[fstate]++;
+#if CORE_DEBUG
+ ee_printf("%d,",fstate);
+ }
+ ee_printf("\n");
+#else
+ }
+#endif
+ p=memblock;
+ while (p < (memblock+blksize)) { /* insert some corruption */
+ if (*p!=',')
+ *p^=(ee_u8)seed1;
+ p+=step;
+ }
+ p=memblock;
+ /* run the state machine over the input again */
+ while (*p!=0) {
+ enum CORE_STATE fstate=core_state_transition(&p,track_counts);
+ final_counts[fstate]++;
+#if CORE_DEBUG
+ ee_printf("%d,",fstate);
+ }
+ ee_printf("\n");
+#else
+ }
+#endif
+ p=memblock;
+ while (p < (memblock+blksize)) { /* undo corruption is seed1 and seed2 are equal */
+ if (*p!=',')
+ *p^=(ee_u8)seed2;
+ p+=step;
+ }
+ /* end timing */
+ for (i=0; i<NUM_CORE_STATES; i++) {
+ crc=crcu32(final_counts[i],crc);
+ crc=crcu32(track_counts[i],crc);
+ }
+ return crc;
+}
+
+/* Default initialization patterns */
+static ee_u8 *intpat[4] ={(ee_u8 *)"5012",(ee_u8 *)"1234",(ee_u8 *)"-874",(ee_u8 *)"+122"};
+static ee_u8 *floatpat[4]={(ee_u8 *)"35.54400",(ee_u8 *)".1234500",(ee_u8 *)"-110.700",(ee_u8 *)"+0.64400"};
+static ee_u8 *scipat[4] ={(ee_u8 *)"5.500e+3",(ee_u8 *)"-.123e-2",(ee_u8 *)"-87e+832",(ee_u8 *)"+0.6e-12"};
+static ee_u8 *errpat[4] ={(ee_u8 *)"T0.3e-1F",(ee_u8 *)"-T.T++Tq",(ee_u8 *)"1T3.4e4z",(ee_u8 *)"34.0e-T^"};
+
+/* Function: core_init_state
+ Initialize the input data for the state machine.
+
+ Populate the input with several predetermined strings, interspersed.
+ Actual patterns chosen depend on the seed parameter.
+
+ Note:
+ The seed parameter MUST be supplied from a source that cannot be determined at compile time
+*/
+void core_init_state(ee_u32 size, ee_s16 seed, ee_u8 *p) {
+ ee_u32 total=0,next=0,i;
+ ee_u8 *buf=0;
+#if CORE_DEBUG
+ ee_u8 *start=p;
+ ee_printf("State: %d,%d\n",size,seed);
+#endif
+ size--;
+ next=0;
+ while ((total+next+1)<size) {
+ if (next>0) {
+ for(i=0;i<next;i++)
+ *(p+total+i)=buf[i];
+ *(p+total+i)=',';
+ total+=next+1;
+ }
+ seed++;
+ switch (seed & 0x7) {
+ case 0: /* int */
+ case 1: /* int */
+ case 2: /* int */
+ buf=intpat[(seed>>3) & 0x3];
+ next=4;
+ break;
+ case 3: /* float */
+ case 4: /* float */
+ buf=floatpat[(seed>>3) & 0x3];
+ next=8;
+ break;
+ case 5: /* scientific */
+ case 6: /* scientific */
+ buf=scipat[(seed>>3) & 0x3];
+ next=8;
+ break;
+ case 7: /* invalid */
+ buf=errpat[(seed>>3) & 0x3];
+ next=8;
+ break;
+ default: /* Never happen, just to make some compilers happy */
+ break;
+ }
+ }
+ size++;
+ while (total<size) { /* fill the rest with 0 */
+ *(p+total)=0;
+ total++;
+ }
+#if CORE_DEBUG
+ ee_printf("State Input: %s\n",start);
+#endif
+}
+
+static ee_u8 ee_isdigit(ee_u8 c) {
+ ee_u8 retval;
+ retval = ((c>='0') & (c<='9')) ? 1 : 0;
+ return retval;
+}
+
+/* Function: core_state_transition
+ Actual state machine.
+
+ The state machine will continue scanning until either:
+ 1 - an invalid input is detcted.
+ 2 - a valid number has been detected.
+
+ The input pointer is updated to point to the end of the token, and the end state is returned (either specific format determined or invalid).
+*/
+
+enum CORE_STATE core_state_transition( ee_u8 **instr , ee_u32 *transition_count) {
+ ee_u8 *str=*instr;
+ ee_u8 NEXT_SYMBOL;
+ enum CORE_STATE state=CORE_START;
+ for( ; *str && state != CORE_INVALID; str++ ) {
+ NEXT_SYMBOL = *str;
+ if (NEXT_SYMBOL==',') /* end of this input */ {
+ str++;
+ break;
+ }
+ switch(state) {
+ case CORE_START:
+ if(ee_isdigit(NEXT_SYMBOL)) {
+ state = CORE_INT;
+ }
+ else if( NEXT_SYMBOL == '+' || NEXT_SYMBOL == '-' ) {
+ state = CORE_S1;
+ }
+ else if( NEXT_SYMBOL == '.' ) {
+ state = CORE_FLOAT;
+ }
+ else {
+ state = CORE_INVALID;
+ transition_count[CORE_INVALID]++;
+ }
+ transition_count[CORE_START]++;
+ break;
+ case CORE_S1:
+ if(ee_isdigit(NEXT_SYMBOL)) {
+ state = CORE_INT;
+ transition_count[CORE_S1]++;
+ }
+ else if( NEXT_SYMBOL == '.' ) {
+ state = CORE_FLOAT;
+ transition_count[CORE_S1]++;
+ }
+ else {
+ state = CORE_INVALID;
+ transition_count[CORE_S1]++;
+ }
+ break;
+ case CORE_INT:
+ if( NEXT_SYMBOL == '.' ) {
+ state = CORE_FLOAT;
+ transition_count[CORE_INT]++;
+ }
+ else if(!ee_isdigit(NEXT_SYMBOL)) {
+ state = CORE_INVALID;
+ transition_count[CORE_INT]++;
+ }
+ break;
+ case CORE_FLOAT:
+ if( NEXT_SYMBOL == 'E' || NEXT_SYMBOL == 'e' ) {
+ state = CORE_S2;
+ transition_count[CORE_FLOAT]++;
+ }
+ else if(!ee_isdigit(NEXT_SYMBOL)) {
+ state = CORE_INVALID;
+ transition_count[CORE_FLOAT]++;
+ }
+ break;
+ case CORE_S2:
+ if( NEXT_SYMBOL == '+' || NEXT_SYMBOL == '-' ) {
+ state = CORE_EXPONENT;
+ transition_count[CORE_S2]++;
+ }
+ else {
+ state = CORE_INVALID;
+ transition_count[CORE_S2]++;
+ }
+ break;
+ case CORE_EXPONENT:
+ if(ee_isdigit(NEXT_SYMBOL)) {
+ state = CORE_SCIENTIFIC;
+ transition_count[CORE_EXPONENT]++;
+ }
+ else {
+ state = CORE_INVALID;
+ transition_count[CORE_EXPONENT]++;
+ }
+ break;
+ case CORE_SCIENTIFIC:
+ if(!ee_isdigit(NEXT_SYMBOL)) {
+ state = CORE_INVALID;
+ transition_count[CORE_INVALID]++;
+ }
+ break;
+ default:
+ break;
+ }
+ }
+ *instr=str;
+ return state;
+}
diff --git a/sw/vendor/coremark/core_util.c b/sw/vendor/coremark/core_util.c
new file mode 100644
index 0000000..581adcc
--- /dev/null
+++ b/sw/vendor/coremark/core_util.c
@@ -0,0 +1,210 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include "coremark.h"
+/* Function: get_seed
+ Get a values that cannot be determined at compile time.
+
+ Since different embedded systems and compilers are used, 3 different methods are provided:
+ 1 - Using a volatile variable. This method is only valid if the compiler is forced to generate code that
+ reads the value of a volatile variable from memory at run time.
+ Please note, if using this method, you would need to modify core_portme.c to generate training profile.
+ 2 - Command line arguments. This is the preferred method if command line arguments are supported.
+ 3 - System function. If none of the first 2 methods is available on the platform,
+ a system function which is not a stub can be used.
+
+ e.g. read the value on GPIO pins connected to switches, or invoke special simulator functions.
+*/
+#if (SEED_METHOD==SEED_VOLATILE)
+ extern volatile ee_s32 seed1_volatile;
+ extern volatile ee_s32 seed2_volatile;
+ extern volatile ee_s32 seed3_volatile;
+ extern volatile ee_s32 seed4_volatile;
+ extern volatile ee_s32 seed5_volatile;
+ ee_s32 get_seed_32(int i) {
+ ee_s32 retval;
+ switch (i) {
+ case 1:
+ retval=seed1_volatile;
+ break;
+ case 2:
+ retval=seed2_volatile;
+ break;
+ case 3:
+ retval=seed3_volatile;
+ break;
+ case 4:
+ retval=seed4_volatile;
+ break;
+ case 5:
+ retval=seed5_volatile;
+ break;
+ default:
+ retval=0;
+ break;
+ }
+ return retval;
+ }
+#elif (SEED_METHOD==SEED_ARG)
+ee_s32 parseval(char *valstring) {
+ ee_s32 retval=0;
+ ee_s32 neg=1;
+ int hexmode=0;
+ if (*valstring == '-') {
+ neg=-1;
+ valstring++;
+ }
+ if ((valstring[0] == '0') && (valstring[1] == 'x')) {
+ hexmode=1;
+ valstring+=2;
+ }
+ /* first look for digits */
+ if (hexmode) {
+ while (((*valstring >= '0') && (*valstring <= '9')) || ((*valstring >= 'a') && (*valstring <= 'f'))) {
+ ee_s32 digit=*valstring-'0';
+ if (digit>9)
+ digit=10+*valstring-'a';
+ retval*=16;
+ retval+=digit;
+ valstring++;
+ }
+ } else {
+ while ((*valstring >= '0') && (*valstring <= '9')) {
+ ee_s32 digit=*valstring-'0';
+ retval*=10;
+ retval+=digit;
+ valstring++;
+ }
+ }
+ /* now add qualifiers */
+ if (*valstring=='K')
+ retval*=1024;
+ if (*valstring=='M')
+ retval*=1024*1024;
+
+ retval*=neg;
+ return retval;
+}
+
+ee_s32 get_seed_args(int i, int argc, char *argv[]) {
+ if (argc>i)
+ return parseval(argv[i]);
+ return 0;
+}
+
+#elif (SEED_METHOD==SEED_FUNC)
+/* If using OS based function, you must define and implement the functions below in core_portme.h and core_portme.c ! */
+ee_s32 get_seed_32(int i) {
+ ee_s32 retval;
+ switch (i) {
+ case 1:
+ retval=portme_sys1();
+ break;
+ case 2:
+ retval=portme_sys2();
+ break;
+ case 3:
+ retval=portme_sys3();
+ break;
+ case 4:
+ retval=portme_sys4();
+ break;
+ case 5:
+ retval=portme_sys5();
+ break;
+ default:
+ retval=0;
+ break;
+ }
+ return retval;
+}
+#endif
+
+/* Function: crc*
+ Service functions to calculate 16b CRC code.
+
+*/
+ee_u16 crcu8(ee_u8 data, ee_u16 crc )
+{
+ ee_u8 i=0,x16=0,carry=0;
+
+ for (i = 0; i < 8; i++)
+ {
+ x16 = (ee_u8)((data & 1) ^ ((ee_u8)crc & 1));
+ data >>= 1;
+
+ if (x16 == 1)
+ {
+ crc ^= 0x4002;
+ carry = 1;
+ }
+ else
+ carry = 0;
+ crc >>= 1;
+ if (carry)
+ crc |= 0x8000;
+ else
+ crc &= 0x7fff;
+ }
+ return crc;
+}
+ee_u16 crcu16(ee_u16 newval, ee_u16 crc) {
+ crc=crcu8( (ee_u8) (newval) ,crc);
+ crc=crcu8( (ee_u8) ((newval)>>8) ,crc);
+ return crc;
+}
+ee_u16 crcu32(ee_u32 newval, ee_u16 crc) {
+ crc=crc16((ee_s16) newval ,crc);
+ crc=crc16((ee_s16) (newval>>16) ,crc);
+ return crc;
+}
+ee_u16 crc16(ee_s16 newval, ee_u16 crc) {
+ return crcu16((ee_u16)newval, crc);
+}
+
+ee_u8 check_data_types() {
+ ee_u8 retval=0;
+ if (sizeof(ee_u8) != 1) {
+ ee_printf("ERROR: ee_u8 is not an 8b datatype!\n");
+ retval++;
+ }
+ if (sizeof(ee_u16) != 2) {
+ ee_printf("ERROR: ee_u16 is not a 16b datatype!\n");
+ retval++;
+ }
+ if (sizeof(ee_s16) != 2) {
+ ee_printf("ERROR: ee_s16 is not a 16b datatype!\n");
+ retval++;
+ }
+ if (sizeof(ee_s32) != 4) {
+ ee_printf("ERROR: ee_s32 is not a 32b datatype!\n");
+ retval++;
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR: ee_u32 is not a 32b datatype!\n");
+ retval++;
+ }
+ if (sizeof(ee_ptr_int) != sizeof(int *)) {
+ ee_printf("ERROR: ee_ptr_int is not a datatype that holds an int pointer!\n");
+ retval++;
+ }
+ if (retval>0) {
+ ee_printf("ERROR: Please modify the datatypes in core_portme.h!\n");
+ }
+ return retval;
+}
diff --git a/sw/vendor/coremark/coremark.h b/sw/vendor/coremark/coremark.h
new file mode 100644
index 0000000..dc9f8c7
--- /dev/null
+++ b/sw/vendor/coremark/coremark.h
@@ -0,0 +1,174 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+/* Topic: Description
+ This file contains declarations of the various benchmark functions.
+*/
+
+/* Configuration: TOTAL_DATA_SIZE
+ Define total size for data algorithms will operate on
+*/
+#ifndef TOTAL_DATA_SIZE
+#define TOTAL_DATA_SIZE 2*1000
+#endif
+
+#define SEED_ARG 0
+#define SEED_FUNC 1
+#define SEED_VOLATILE 2
+
+#define MEM_STATIC 0
+#define MEM_MALLOC 1
+#define MEM_STACK 2
+
+#include "core_portme.h"
+
+#if HAS_STDIO
+#include <stdio.h>
+#endif
+#if HAS_PRINTF
+#define ee_printf printf
+#endif
+
+/* Actual benchmark execution in iterate */
+void *iterate(void *pres);
+
+/* Typedef: secs_ret
+ For machines that have floating point support, get number of seconds as a double.
+ Otherwise an unsigned int.
+*/
+#if HAS_FLOAT
+typedef double secs_ret;
+#else
+typedef ee_u32 secs_ret;
+#endif
+
+#if MAIN_HAS_NORETURN
+#define MAIN_RETURN_VAL
+#define MAIN_RETURN_TYPE void
+#else
+#define MAIN_RETURN_VAL 0
+#define MAIN_RETURN_TYPE int
+#endif
+
+void start_time(void);
+void stop_time(void);
+CORE_TICKS get_time(void);
+secs_ret time_in_secs(CORE_TICKS ticks);
+
+/* Misc useful functions */
+ee_u16 crcu8(ee_u8 data, ee_u16 crc);
+ee_u16 crc16(ee_s16 newval, ee_u16 crc);
+ee_u16 crcu16(ee_u16 newval, ee_u16 crc);
+ee_u16 crcu32(ee_u32 newval, ee_u16 crc);
+ee_u8 check_data_types();
+void *portable_malloc(ee_size_t size);
+void portable_free(void *p);
+ee_s32 parseval(char *valstring);
+
+/* Algorithm IDS */
+#define ID_LIST (1<<0)
+#define ID_MATRIX (1<<1)
+#define ID_STATE (1<<2)
+#define ALL_ALGORITHMS_MASK (ID_LIST|ID_MATRIX|ID_STATE)
+#define NUM_ALGORITHMS 3
+
+/* list data structures */
+typedef struct list_data_s {
+ ee_s16 data16;
+ ee_s16 idx;
+} list_data;
+
+typedef struct list_head_s {
+ struct list_head_s *next;
+ struct list_data_s *info;
+} list_head;
+
+
+/*matrix benchmark related stuff */
+#define MATDAT_INT 1
+#if MATDAT_INT
+typedef ee_s16 MATDAT;
+typedef ee_s32 MATRES;
+#else
+typedef ee_f16 MATDAT;
+typedef ee_f32 MATRES;
+#endif
+
+typedef struct MAT_PARAMS_S {
+ int N;
+ MATDAT *A;
+ MATDAT *B;
+ MATRES *C;
+} mat_params;
+
+/* state machine related stuff */
+/* List of all the possible states for the FSM */
+typedef enum CORE_STATE {
+ CORE_START=0,
+ CORE_INVALID,
+ CORE_S1,
+ CORE_S2,
+ CORE_INT,
+ CORE_FLOAT,
+ CORE_EXPONENT,
+ CORE_SCIENTIFIC,
+ NUM_CORE_STATES
+} core_state_e ;
+
+
+/* Helper structure to hold results */
+typedef struct RESULTS_S {
+ /* inputs */
+ ee_s16 seed1; /* Initializing seed */
+ ee_s16 seed2; /* Initializing seed */
+ ee_s16 seed3; /* Initializing seed */
+ void *memblock[4]; /* Pointer to safe memory location */
+ ee_u32 size; /* Size of the data */
+ ee_u32 iterations; /* Number of iterations to execute */
+ ee_u32 execs; /* Bitmask of operations to execute */
+ struct list_head_s *list;
+ mat_params mat;
+ /* outputs */
+ ee_u16 crc;
+ ee_u16 crclist;
+ ee_u16 crcmatrix;
+ ee_u16 crcstate;
+ ee_s16 err;
+ /* ultithread specific */
+ core_portable port;
+} core_results;
+
+/* Multicore execution handling */
+#if (MULTITHREAD>1)
+ee_u8 core_start_parallel(core_results *res);
+ee_u8 core_stop_parallel(core_results *res);
+#endif
+
+/* list benchmark functions */
+list_head *core_list_init(ee_u32 blksize, list_head *memblock, ee_s16 seed);
+ee_u16 core_bench_list(core_results *res, ee_s16 finder_idx);
+
+/* state benchmark functions */
+void core_init_state(ee_u32 size, ee_s16 seed, ee_u8 *p);
+ee_u16 core_bench_state(ee_u32 blksize, ee_u8 *memblock,
+ ee_s16 seed1, ee_s16 seed2, ee_s16 step, ee_u16 crc);
+
+/* matrix benchmark functions */
+ee_u32 core_init_matrix(ee_u32 blksize, void *memblk, ee_s32 seed, mat_params *p);
+ee_u16 core_bench_matrix(mat_params *p, ee_s16 seed, ee_u16 crc);
+
diff --git a/sw/vendor/coremark/coremark.md5 b/sw/vendor/coremark/coremark.md5
new file mode 100644
index 0000000..3bf79a4
--- /dev/null
+++ b/sw/vendor/coremark/coremark.md5
@@ -0,0 +1,6 @@
+f837f8c5c5c6c0f5ef33bb1badc5ebef core_list_join.c
+3c7e2aeca881577ae02d628ad56a584a core_main.c
+6fef286af62d28486aa6e6c61fb11841 core_matrix.c
+640f7d70fab3ce61da49d0f9eef04f7f core_state.c
+85a5a29a1c55be49787bc1e1e7082f80 core_util.c
+30d72446fe6d2cb8d58e2a3276ea478c coremark.h
diff --git a/sw/vendor/coremark/cygwin/core_portme.c b/sw/vendor/coremark/cygwin/core_portme.c
new file mode 100755
index 0000000..fe8d299
--- /dev/null
+++ b/sw/vendor/coremark/cygwin/core_portme.c
@@ -0,0 +1,336 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include "coremark.h"
+#if CALLGRIND_RUN
+#include <valgrind/callgrind.h>
+#endif
+
+#if (MEM_METHOD==MEM_MALLOC)
+#include <malloc.h>
+/* Function: portable_malloc
+ Provide malloc() functionality in a platform specific way.
+*/
+void *portable_malloc(size_t size) {
+ return malloc(size);
+}
+/* Function: portable_free
+ Provide free() functionality in a platform specific way.
+*/
+void portable_free(void *p) {
+ free(p);
+}
+#else
+void *portable_malloc(size_t size) {
+ return NULL;
+}
+void portable_free(void *p) {
+ p=NULL;
+}
+#endif
+
+#if (SEED_METHOD==SEED_VOLATILE)
+#if VALIDATION_RUN
+ volatile ee_s32 seed1_volatile=0x3415;
+ volatile ee_s32 seed2_volatile=0x3415;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PERFORMANCE_RUN
+ volatile ee_s32 seed1_volatile=0x0;
+ volatile ee_s32 seed2_volatile=0x0;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PROFILE_RUN
+ volatile ee_s32 seed1_volatile=0x8;
+ volatile ee_s32 seed2_volatile=0x8;
+ volatile ee_s32 seed3_volatile=0x8;
+#endif
+ volatile ee_s32 seed4_volatile=ITERATIONS;
+ volatile ee_s32 seed5_volatile=0;
+#endif
+/* Porting: Timing functions
+ How to capture time and convert to seconds must be ported to whatever is supported by the platform.
+ e.g. Read value from on board RTC, read value from cpu clock cycles performance counter etc.
+ Sample implementation for standard time.h and windows.h definitions included.
+*/
+/* Define: TIMER_RES_DIVIDER
+ Divider to trade off timer resolution and total time that can be measured.
+
+ Use lower values to increase resolution, but make sure that overflow does not occur.
+ If there are issues with the return value overflowing, increase this value.
+ */
+#if USE_CLOCK
+ #define NSECS_PER_SEC CLOCKS_PER_SEC
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE clock_t
+ #define GETMYTIME(_t) (*_t=clock())
+ #define MYTIMEDIFF(fin,ini) ((fin)-(ini))
+ #define TIMER_RES_DIVIDER 1
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#elif defined(_MSC_VER)
+ #define NSECS_PER_SEC 10000000
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE FILETIME
+ #define GETMYTIME(_t) GetSystemTimeAsFileTime(_t)
+ #define MYTIMEDIFF(fin,ini) (((*(__int64*)&fin)-(*(__int64*)&ini))/TIMER_RES_DIVIDER)
+ /* setting to millisces resolution by default with MSDEV */
+ #ifndef TIMER_RES_DIVIDER
+ #define TIMER_RES_DIVIDER 1000
+ #endif
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#elif HAS_TIME_H
+ #define NSECS_PER_SEC 1000000000
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE struct timespec
+ #define GETMYTIME(_t) clock_gettime(CLOCK_REALTIME,_t)
+ #define MYTIMEDIFF(fin,ini) ((fin.tv_sec-ini.tv_sec)*(NSECS_PER_SEC/TIMER_RES_DIVIDER)+(fin.tv_nsec-ini.tv_nsec)/TIMER_RES_DIVIDER)
+ /* setting to 1/1000 of a second resolution by default with linux */
+ #ifndef TIMER_RES_DIVIDER
+ #define TIMER_RES_DIVIDER 1000000
+ #endif
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#else
+ #define SAMPLE_TIME_IMPLEMENTATION 0
+#endif
+#define EE_TICKS_PER_SEC (NSECS_PER_SEC / TIMER_RES_DIVIDER)
+
+#if SAMPLE_TIME_IMPLEMENTATION
+/** Define Host specific (POSIX), or target specific global time variables. */
+static CORETIMETYPE start_time_val, stop_time_val;
+
+/* Function: start_time
+ This function will be called right before starting the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or zeroing some system parameters - e.g. setting the cpu clocks cycles to 0.
+*/
+void start_time(void) {
+ GETMYTIME(&start_time_val );
+#if CALLGRIND_RUN
+ CALLGRIND_START_INSTRUMENTATION
+#endif
+#if MICA
+ asm volatile("int3");/*1 */
+#endif
+}
+/* Function: stop_time
+ This function will be called right after ending the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or other system parameters - e.g. reading the current value of cpu cycles counter.
+*/
+void stop_time(void) {
+#if CALLGRIND_RUN
+ CALLGRIND_STOP_INSTRUMENTATION
+#endif
+#if MICA
+ asm volatile("int3");/*1 */
+#endif
+ GETMYTIME(&stop_time_val );
+}
+/* Function: get_time
+ Return an abstract "ticks" number that signifies time on the system.
+
+ Actual value returned may be cpu cycles, milliseconds or any other value,
+ as long as it can be converted to seconds by <time_in_secs>.
+ This methodology is taken to accomodate any hardware or simulated platform.
+ The sample implementation returns millisecs by default,
+ and the resolution is controlled by <TIMER_RES_DIVIDER>
+*/
+CORE_TICKS get_time(void) {
+ CORE_TICKS elapsed=(CORE_TICKS)(MYTIMEDIFF(stop_time_val, start_time_val));
+ return elapsed;
+}
+/* Function: time_in_secs
+ Convert the value returned by get_time to seconds.
+
+ The <secs_ret> type is used to accomodate systems with no support for floating point.
+ Default implementation implemented by the EE_TICKS_PER_SEC macro above.
+*/
+secs_ret time_in_secs(CORE_TICKS ticks) {
+ secs_ret retval=((secs_ret)ticks) / (secs_ret)EE_TICKS_PER_SEC;
+ return retval;
+}
+#else
+#error "Please implement timing functionality in core_portme.c"
+#endif /* SAMPLE_TIME_IMPLEMENTATION */
+
+ee_u32 default_num_contexts=MULTITHREAD;
+
+/* Function: portable_init
+ Target specific initialization code
+ Test for some common mistakes.
+*/
+void portable_init(core_portable *p, int *argc, char *argv[])
+{
+#if PRINT_ARGS
+ int i;
+ for (i=0; i<*argc; i++) {
+ ee_printf("Arg[%d]=%s\n",i,argv[i]);
+ }
+#endif
+ if (sizeof(ee_ptr_int) != sizeof(ee_u8 *)) {
+ ee_printf("ERROR! Please define ee_ptr_int to a type that holds a pointer!\n");
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR! Please define ee_u32 to a 32b unsigned type!\n");
+ }
+#if (MAIN_HAS_NOARGC && (SEED_METHOD==SEED_ARG))
+ ee_printf("ERROR! Main has no argc, but SEED_METHOD defined to SEED_ARG!\n");
+#endif
+
+#if (MULTITHREAD>1) && (SEED_METHOD==SEED_ARG)
+ int nargs=*argc,i;
+ if ((nargs>1) && (*argv[1]=='M')) {
+ default_num_contexts=parseval(argv[1]+1);
+ if (default_num_contexts>MULTITHREAD)
+ default_num_contexts=MULTITHREAD;
+ /* Shift args since first arg is directed to the portable part and not to coremark main */
+ --nargs;
+ for (i=1; i<nargs; i++)
+ argv[i]=argv[i+1];
+ *argc=nargs;
+ }
+#endif /* sample of potential platform specific init via command line, reset the number of contexts being used if first argument is M<n>*/
+ p->portable_id=1;
+}
+/* Function: portable_fini
+ Target specific final code
+*/
+void portable_fini(core_portable *p)
+{
+ p->portable_id=0;
+}
+
+#if (MULTITHREAD>1)
+
+/* Function: core_start_parallel
+ Start benchmarking in a parallel context.
+
+ Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets.
+ Other implementations using MCAPI or other standards can easily be devised.
+*/
+/* Function: core_stop_parallel
+ Stop a parallel context execution of coremark, and gather the results.
+
+ Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets.
+ Other implementations using MCAPI or other standards can easily be devised.
+*/
+#if USE_PTHREAD
+ee_u8 core_start_parallel(core_results *res) {
+ return (ee_u8)pthread_create(&(res->port.thread),NULL,iterate,(void *)res);
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ void *retval;
+ return (ee_u8)pthread_join(res->port.thread,&retval);
+}
+#elif USE_FORK
+static int key_id=0;
+ee_u8 core_start_parallel(core_results *res) {
+ key_t key=4321+key_id;
+ key_id++;
+ res->port.pid=fork();
+ res->port.shmid=shmget(key, 8, IPC_CREAT | 0666);
+ if (res->port.shmid<0) {
+ ee_printf("ERROR in shmget!\n");
+ }
+ if (res->port.pid==0) {
+ iterate(res);
+ res->port.shm=shmat(res->port.shmid, NULL, 0);
+ /* copy the validation values to the shared memory area and quit*/
+ if (res->port.shm == (char *) -1) {
+ ee_printf("ERROR in child shmat!\n");
+ } else {
+ memcpy(res->port.shm,&(res->crc),8);
+ shmdt(res->port.shm);
+ }
+ exit(0);
+ }
+ return 1;
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ int status;
+ pid_t wpid = waitpid(res->port.pid,&status,WUNTRACED);
+ if (wpid != res->port.pid) {
+ ee_printf("ERROR waiting for child.\n");
+ if (errno == ECHILD) ee_printf("errno=No such child %d\n",res->port.pid);
+ if (errno == EINTR) ee_printf("errno=Interrupted\n");
+ return 0;
+ }
+ /* after process is done, get the values from the shared memory area */
+ res->port.shm=shmat(res->port.shmid, NULL, 0);
+ if (res->port.shm == (char *) -1) {
+ ee_printf("ERROR in parent shmat!\n");
+ return 0;
+ }
+ memcpy(&(res->crc),res->port.shm,8);
+ shmdt(res->port.shm);
+ return 1;
+}
+#elif USE_SOCKET
+static int key_id=0;
+ee_u8 core_start_parallel(core_results *res) {
+ int bound, buffer_length=8;
+ res->port.sa.sin_family = AF_INET;
+ res->port.sa.sin_addr.s_addr = htonl(0x7F000001);
+ res->port.sa.sin_port = htons(7654+key_id);
+ key_id++;
+ res->port.pid=fork();
+ if (res->port.pid==0) { /* benchmark child */
+ iterate(res);
+ res->port.sock = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);
+ if (-1 == res->port.sock) /* if socket failed to initialize, exit */ {
+ ee_printf("Error Creating Socket");
+ } else {
+ int bytes_sent = sendto(res->port.sock, &(res->crc), buffer_length, 0,(struct sockaddr*)&(res->port.sa), sizeof (struct sockaddr_in));
+ if (bytes_sent < 0)
+ ee_printf("Error sending packet: %s\n", strerror(errno));
+ close(res->port.sock); /* close the socket */
+ }
+ exit(0);
+ }
+ /* parent process, open the socket */
+ res->port.sock = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);
+ bound = bind(res->port.sock,(struct sockaddr*)&(res->port.sa), sizeof(struct sockaddr));
+ if (bound < 0)
+ ee_printf("bind(): %s\n",strerror(errno));
+ return 1;
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ int status;
+ int fromlen=sizeof(struct sockaddr);
+ int recsize = recvfrom(res->port.sock, &(res->crc), 8, 0, (struct sockaddr*)&(res->port.sa), &fromlen);
+ if (recsize < 0) {
+ ee_printf("Error in receive: %s\n", strerror(errno));
+ return 0;
+ }
+ pid_t wpid = waitpid(res->port.pid,&status,WUNTRACED);
+ if (wpid != res->port.pid) {
+ ee_printf("ERROR waiting for child.\n");
+ if (errno == ECHILD) ee_printf("errno=No such child %d\n",res->port.pid);
+ if (errno == EINTR) ee_printf("errno=Interrupted\n");
+ return 0;
+ }
+ return 1;
+}
+#else /* no standard multicore implementation */
+#error "Please implement multicore functionality in core_portme.c to use multiple contexts."
+#endif /* multithread implementations */
+#endif
diff --git a/sw/vendor/coremark/cygwin/core_portme.h b/sw/vendor/coremark/cygwin/core_portme.h
new file mode 100755
index 0000000..9471b12
--- /dev/null
+++ b/sw/vendor/coremark/cygwin/core_portme.h
@@ -0,0 +1,293 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+/* Topic: Description
+ This file contains configuration constants required to execute on different platforms
+*/
+#ifndef CORE_PORTME_H
+#define CORE_PORTME_H
+/************************/
+/* Data types and settings */
+/************************/
+/* Configuration: HAS_FLOAT
+ Define to 1 if the platform supports floating point.
+*/
+#ifndef HAS_FLOAT
+#define HAS_FLOAT 1
+#endif
+/* Configuration: HAS_TIME_H
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef HAS_TIME_H
+#define HAS_TIME_H 1
+#endif
+/* Configuration: USE_CLOCK
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef USE_CLOCK
+#define USE_CLOCK 0
+#endif
+/* Configuration: HAS_STDIO
+ Define to 1 if the platform has stdio.h.
+*/
+#ifndef HAS_STDIO
+#define HAS_STDIO 1
+#endif
+/* Configuration: HAS_PRINTF
+ Define to 1 if the platform has stdio.h and implements the printf function.
+*/
+#ifndef HAS_PRINTF
+#define HAS_PRINTF 1
+#endif
+
+/* Configuration: CORE_TICKS
+ Define type of return from the timing functions.
+ */
+#if defined(_MSC_VER)
+#include <windows.h>
+typedef size_t CORE_TICKS;
+#elif HAS_TIME_H
+#include <time.h>
+typedef clock_t CORE_TICKS;
+#else
+#error "Please define type of CORE_TICKS and implement start_time, end_time get_time and time_in_secs functions!"
+#endif
+
+/* Definitions: COMPILER_VERSION, COMPILER_FLAGS, MEM_LOCATION
+ Initialize these strings per platform
+*/
+#ifndef COMPILER_VERSION
+ #ifdef __GNUC__
+ #define COMPILER_VERSION "GCC"__VERSION__
+ #else
+ #define COMPILER_VERSION "Please put compiler version here (e.g. gcc 4.1)"
+ #endif
+#endif
+#ifndef COMPILER_FLAGS
+ #define COMPILER_FLAGS FLAGS_STR /* "Please put compiler flags here (e.g. -o3)" */
+#endif
+#ifndef MEM_LOCATION
+ #define MEM_LOCATION "Please put data memory location here\n\t\t\t(e.g. code in flash, data on heap etc)"
+ #define MEM_LOCATION_UNSPEC 1
+#endif
+
+/* Data Types:
+ To avoid compiler issues, define the data types that need ot be used for 8b, 16b and 32b in <core_portme.h>.
+
+ *Imprtant*:
+ ee_ptr_int needs to be the data type used to hold pointers, otherwise coremark may fail!!!
+*/
+typedef signed short ee_s16;
+typedef unsigned short ee_u16;
+typedef signed int ee_s32;
+typedef double ee_f32;
+typedef unsigned char ee_u8;
+typedef unsigned int ee_u32;
+typedef ee_u32 ee_ptr_int;
+typedef size_t ee_size_t;
+/* align_mem:
+ This macro is used to align an offset to point to a 32b value. It is used in the Matrix algorithm to initialize the input memory blocks.
+*/
+#define align_mem(x) (void *)(4 + (((ee_ptr_int)(x) - 1) & ~3))
+
+/* Configuration: SEED_METHOD
+ Defines method to get seed values that cannot be computed at compile time.
+
+ Valid values:
+ SEED_ARG - from command line.
+ SEED_FUNC - from a system function.
+ SEED_VOLATILE - from volatile variables.
+*/
+#ifndef SEED_METHOD
+#define SEED_METHOD SEED_ARG
+#endif
+
+/* Configuration: MEM_METHOD
+ Defines method to get a block of memry.
+
+ Valid values:
+ MEM_MALLOC - for platforms that implement malloc and have malloc.h.
+ MEM_STATIC - to use a static memory array.
+ MEM_STACK - to allocate the data block on the stack (NYI).
+*/
+#ifndef MEM_METHOD
+#define MEM_METHOD MEM_MALLOC
+#endif
+
+/* Configuration: MULTITHREAD
+ Define for parallel execution
+
+ Valid values:
+ 1 - only one context (default).
+ N>1 - will execute N copies in parallel.
+
+ Note:
+ If this flag is defined to more then 1, an implementation for launching parallel contexts must be defined.
+
+ Two sample implementations are provided. Use <USE_PTHREAD> or <USE_FORK> to enable them.
+
+ It is valid to have a different implementation of <core_start_parallel> and <core_end_parallel> in <core_portme.c>,
+ to fit a particular architecture.
+*/
+#ifndef MULTITHREAD
+#define MULTITHREAD 1
+#endif
+
+/* Configuration: USE_PTHREAD
+ Sample implementation for launching parallel contexts
+ This implementation uses pthread_thread_create and pthread_join.
+
+ Valid values:
+ 0 - Do not use pthreads API.
+ 1 - Use pthreads API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_PTHREAD
+#define USE_PTHREAD 0
+#endif
+
+/* Configuration: USE_FORK
+ Sample implementation for launching parallel contexts
+ This implementation uses fork, waitpid, shmget,shmat and shmdt.
+
+ Valid values:
+ 0 - Do not use fork API.
+ 1 - Use fork API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_FORK
+#define USE_FORK 0
+#endif
+
+/* Configuration: USE_SOCKET
+ Sample implementation for launching parallel contexts
+ This implementation uses fork, socket, sendto and recvfrom
+
+ Valid values:
+ 0 - Do not use fork and sockets API.
+ 1 - Use fork and sockets API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_SOCKET
+#define USE_SOCKET 0
+#endif
+
+/* Configuration: MAIN_HAS_NOARGC
+ Needed if platform does not support getting arguments to main.
+
+ Valid values:
+ 0 - argc/argv to main is supported
+ 1 - argc/argv to main is not supported
+*/
+#ifndef MAIN_HAS_NOARGC
+#define MAIN_HAS_NOARGC 0
+#endif
+
+/* Configuration: MAIN_HAS_NORETURN
+ Needed if platform does not support returning a value from main.
+
+ Valid values:
+ 0 - main returns an int, and return value will be 0.
+ 1 - platform does not support returning a value from main
+*/
+#ifndef MAIN_HAS_NORETURN
+#define MAIN_HAS_NORETURN 0
+#endif
+
+/* Variable: default_num_contexts
+ Number of contexts to spawn in multicore context.
+ Override this global value to change number of contexts used.
+
+ Note:
+ This value may not be set higher then the <MULTITHREAD> define.
+
+ To experiment, you can set the <MULTITHREAD> define to the highest value expected, and use argc/argv in the <portable_init> to set this value from the command line.
+*/
+extern ee_u32 default_num_contexts;
+
+#if (MULTITHREAD>1)
+#if USE_PTHREAD
+ #include <pthread.h>
+ #define PARALLEL_METHOD "PThreads"
+#elif USE_FORK
+ #include <unistd.h>
+ #include <errno.h>
+ #include <sys/wait.h>
+ #include <sys/shm.h>
+ #include <string.h> /* for memcpy */
+ #define PARALLEL_METHOD "Fork"
+#elif USE_SOCKET
+ #include <sys/types.h>
+ #include <sys/socket.h>
+ #include <netinet/in.h>
+ #include <arpa/inet.h>
+ #include <sys/wait.h>
+ #include <stdio.h>
+ #include <stdlib.h>
+ #include <string.h>
+ #include <unistd.h>
+ #include <errno.h>
+ #define PARALLEL_METHOD "Sockets"
+#else
+ #define PARALLEL_METHOD "Proprietary"
+ #error "Please implement multicore functionality in core_portme.c to use multiple contexts."
+#endif /* Method for multithreading */
+#endif /* MULTITHREAD > 1 */
+
+typedef struct CORE_PORTABLE_S {
+#if (MULTITHREAD>1)
+ #if USE_PTHREAD
+ pthread_t thread;
+ #elif USE_FORK
+ pid_t pid;
+ int shmid;
+ void *shm;
+ #elif USE_SOCKET
+ pid_t pid;
+ int sock;
+ struct sockaddr_in sa;
+ #endif /* Method for multithreading */
+#endif /* MULTITHREAD>1 */
+ ee_u8 portable_id;
+} core_portable;
+
+/* target specific init/fini */
+void portable_init(core_portable *p, int *argc, char *argv[]);
+void portable_fini(core_portable *p);
+
+#if (SEED_METHOD==SEED_VOLATILE)
+ #if (VALIDATION_RUN || PERFORMANCE_RUN || PROFILE_RUN)
+ #define RUN_TYPE_FLAG 1
+ #else
+ #if (TOTAL_DATA_SIZE==1200)
+ #define PROFILE_RUN 1
+ #else
+ #define PERFORMANCE_RUN 1
+ #endif
+ #endif
+#endif /* SEED_METHOD==SEED_VOLATILE */
+
+#endif /* CORE_PORTME_H */
diff --git a/sw/vendor/coremark/cygwin/core_portme.mak b/sw/vendor/coremark/cygwin/core_portme.mak
new file mode 100755
index 0000000..721ba2e
--- /dev/null
+++ b/sw/vendor/coremark/cygwin/core_portme.mak
@@ -0,0 +1,141 @@
+# Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+#
+# Licensed 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.
+#
+# Original Author: Shay Gal-on
+
+#File: core_portme.mak
+
+# Flag: OUTFLAG
+# Use this flag to define how to to get an executable (e.g -o)
+OUTFLAG= -o
+# Flag: CC
+# Use this flag to define compiler to use
+CC = gcc
+# Flag: CFLAGS
+# Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS="other flags"
+PORT_CFLAGS = -O2
+FLAGS_STR = "$(PORT_CFLAGS) $(XCFLAGS) $(XLFLAGS) $(LFLAGS_END)"
+CFLAGS = $(PORT_CFLAGS) -I$(PORT_DIR) -I. -DFLAGS_STR=\"$(FLAGS_STR)\"
+#Flag: LFLAGS_END
+# Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts).
+# Note: On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.
+LFLAGS_END =
+# Flag: PORT_SRCS
+# Port specific source files can be added here
+PORT_SRCS = $(PORT_DIR)/core_portme.c
+# Flag: LOAD
+# Define this flag if you need to load to a target, as in a cross compile environment.
+
+# Flag: RUN
+# Define this flag if running does not consist of simple invocation of the binary.
+# In a cross compile environment, you need to define this.
+
+#For flashing and using a tera term macro, you could use
+#LOAD = flash ADDR
+#RUN = ttpmacro coremark.ttl
+
+#For copying to target and executing via SSH connection, you could use
+#LOAD = scp $(OUTFILE) user@target:~
+#RUN = ssh user@target -c
+
+#For native compilation and execution
+LOAD = echo Loading done
+RUN =
+
+OEXT = .o
+EXE = .exe
+
+# Flag: SEPARATE_COMPILE
+# Define if you need to separate compilation from link stage.
+# In this case, you also need to define below how to create an object file, and how to link.
+ifdef SEPARATE_COMPILE
+
+LD = gcc
+OBJOUT = -o
+LFLAGS =
+OFLAG = -o
+COUT = -c
+# Flag: PORT_OBJS
+# Port specific object files can be added here
+PORT_OBJS = $(PORT_DIR)/core_portme$(OEXT)
+PORT_CLEAN = *$(OEXT)
+
+$(OPATH)%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+endif
+
+# Target: port_prebuild
+# Generate any files that are needed before actual build starts.
+# E.g. generate profile guidance files. Sample PGO generation for gcc enabled with PGO=1
+# - First, check if PGO was defined on the command line, if so, need to add -fprofile-use to compile line.
+# - Second, if PGO reference has not yet been generated, add a step to the prebuild that will build a profile-generate version and run it.
+# Note - Using REBUILD=1
+#
+# Use make PGO=1 to invoke this sample processing.
+
+ifdef PGO
+ ifeq (,$(findstring $(PGO),gen))
+ PGO_STAGE=build_pgo_gcc
+ CFLAGS+=-fprofile-use
+ endif
+ PORT_CLEAN+=*.gcda *.gcno gmon.out
+endif
+
+.PHONY: port_prebuild
+port_prebuild: $(PGO_STAGE)
+
+.PHONY: build_pgo_gcc
+build_pgo_gcc:
+ $(MAKE) PGO=gen XCFLAGS="$(XCFLAGS) -fprofile-generate -DTOTAL_DATA_SIZE=1200" ITERATIONS=10 gen_pgo_data REBUILD=1
+
+# Target: port_postbuild
+# Generate any files that are needed after actual build end.
+# E.g. change format to srec, bin, zip in order to be able to load into flash
+.PHONY: port_postbuild
+port_postbuild:
+
+# Target: port_postrun
+# Do platform specific after run stuff.
+# E.g. reset the board, backup the logfiles etc.
+.PHONY: port_postrun
+port_postrun:
+
+# Target: port_prerun
+# Do platform specific after run stuff.
+# E.g. reset the board, backup the logfiles etc.
+.PHONY: port_prerun
+port_prerun:
+
+# Target: port_postload
+# Do platform specific after load stuff.
+# E.g. reset the reset power to the flash eraser
+.PHONY: port_postload
+port_postload:
+
+# Target: port_preload
+# Do platform specific before load stuff.
+# E.g. reset the reset power to the flash eraser
+.PHONY: port_preload
+port_preload:
+
+
+# FLAG: OPATH
+# Path to the output folder. Default - current folder.
+OPATH = ./
+MKDIR = mkdir -p
+
+# FLAG: PERL
+# Define perl executable to calculate the geomean if running separate.
+PERL=perl
diff --git a/sw/vendor/coremark/docs/READM.md b/sw/vendor/coremark/docs/READM.md
new file mode 100644
index 0000000..6f71f42
--- /dev/null
+++ b/sw/vendor/coremark/docs/READM.md
@@ -0,0 +1 @@
+This folder contains the original, unaltered documents from the CoreMark V1.0 release.
diff --git a/sw/vendor/coremark/docs/balance_O0_joined.png b/sw/vendor/coremark/docs/balance_O0_joined.png
new file mode 100644
index 0000000..46b4158
--- /dev/null
+++ b/sw/vendor/coremark/docs/balance_O0_joined.png
Binary files differ
diff --git a/sw/vendor/coremark/docs/coremark_profile_o0_joined.png b/sw/vendor/coremark/docs/coremark_profile_o0_joined.png
new file mode 100644
index 0000000..5504dd0
--- /dev/null
+++ b/sw/vendor/coremark/docs/coremark_profile_o0_joined.png
Binary files differ
diff --git a/sw/vendor/coremark/docs/html/files/PIC32/core_portme-mak.html b/sw/vendor/coremark/docs/html/files/PIC32/core_portme-mak.html
new file mode 100644
index 0000000..c222bac
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/PIC32/core_portme-mak.html
@@ -0,0 +1,68 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>core_portme.mak - CoreMark</title><link rel="stylesheet" type="text/css" href="../../styles/main.css"><script language=JavaScript src="../../javascript/main.js"></script><script language=JavaScript src="../../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_portme.mak"></a>core_portme.mak</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_portme.mak" >core_portme.mak</a></td><td class=SDescription></td></tr><tr class="SGroup"><td class=SEntry><a href="#Variables" >Variables</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#OUTFLAG" >OUTFLAG</a></td><td class=SDescription>Use this flag to define how to to get an executable (e.g -o)</td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#CFLAGS" >CFLAGS</a></td><td class=SDescription>Use this flag to define compiler options. </td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#LFLAGS_END" >LFLAGS_END</a></td><td class=SDescription>Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. </td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#SEPARATE_COMPILE" >SEPARATE_COMPILE</a></td><td class=SDescription>Define if you need to separate compilation from link stage. </td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#PORT_OBJS" >PORT_OBJS</a></td><td class=SDescription>Port specific object files can be added here</td></tr><tr class="SGroup"><td class=SEntry><a href="#Build_Targets" >Build Targets</a></td><td class=SDescription></td></tr><tr class="SBuildTarget SIndent1 SMarked"><td class=SEntry><a href="#port_prebuild" >port_prebuild</a></td><td class=SDescription>Generate any files that are needed before actual build starts. </td></tr><tr class="SBuildTarget SIndent1"><td class=SEntry><a href="#port_postbuild" >port_postbuild</a></td><td class=SDescription>Generate any files that are needed after actual build end. </td></tr><tr class="SBuildTarget SIndent1 SMarked"><td class=SEntry><a href="#port_postrun" >port_postrun</a></td><td class=SDescription>Do platform specific after run stuff. </td></tr><tr class="SBuildTarget SIndent1"><td class=SEntry><a href="#port_prerun" >port_prerun</a></td><td class=SDescription>Do platform specific after run stuff. </td></tr><tr class="SBuildTarget SIndent1 SMarked"><td class=SEntry><a href="#port_postload" >port_postload</a></td><td class=SDescription>Do platform specific after load stuff. </td></tr><tr class="SBuildTarget SIndent1"><td class=SEntry><a href="#port_preload" >port_preload</a></td><td class=SDescription>Do platform specific before load stuff. </td></tr><tr class="SGroup"><td class=SEntry><a href="#Variables" >Variables</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#OPATH" >OPATH</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#PERL" >PERL</a></td><td class=SDescription>Define perl executable to calculate the geomean if running separate.</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Variables"></a>Variables</h3></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="OUTFLAG"></a>OUTFLAG</h3><div class=CBody><p>Use this flag to define how to to get an executable (e.g -o)</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="CFLAGS"></a>CFLAGS</h3><div class=CBody><p>Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS=”other flags”</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="LFLAGS_END"></a>LFLAGS_END</h3><div class=CBody><p>Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts). Note: On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="SEPARATE_COMPILE"></a>SEPARATE_COMPILE</h3><div class=CBody><p>Define if you need to separate compilation from link stage. In this case, you also need to define below how to create an object file, and how to link.</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="PORT_OBJS"></a>PORT_OBJS</h3><div class=CBody><p>Port specific object files can be added here</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Build_Targets"></a>Build Targets</h3></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_prebuild"></a>port_prebuild</h3><div class=CBody><p>Generate any files that are needed before actual build starts. E.g. generate profile guidance files. Sample PGO generation for gcc enabled with PGO=1</p><ul><li>First, check if PGO was defined on the command line, if so, need to add -fprofile-use to compile line.</li><li>Second, if PGO reference has not yet been generated, add a step to the prebuild that will build a profile-generate version and run it.</li></ul><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>Note</td><td class=CDLDescription>Using REBUILD=1</td></tr></table><p>Use make PGO=1 to invoke this sample processing.</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_postbuild"></a>port_postbuild</h3><div class=CBody><p>Generate any files that are needed after actual build end. E.g. change format to srec, bin, zip in order to be able to load into flash</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_postrun"></a>port_postrun</h3><div class=CBody><p>Do platform specific after run stuff. E.g. reset the board, backup the logfiles etc.</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_prerun"></a>port_prerun</h3><div class=CBody><p>Do platform specific after run stuff. E.g. reset the board, backup the logfiles etc.</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_postload"></a>port_postload</h3><div class=CBody><p>Do platform specific after load stuff. E.g. reset the reset power to the flash eraser</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_preload"></a>port_preload</h3><div class=CBody><p>Do platform specific before load stuff. E.g. reset the reset power to the flash eraser</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Variables"></a>Variables</h3></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="OPATH"></a>OPATH</h3><div class=CBody><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>Path to the output folder. Default</td><td class=CDLDescription>current folder.</td></tr></table></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="PERL"></a>PERL</h3><div class=CBody><p>Define perl executable to calculate the geomean if running separate.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile id=MSelected>core_portme.mak</div></div><div class=MEntry><div class=MFile><a href="../core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/core_list_join-c.html b/sw/vendor/coremark/docs/html/files/core_list_join-c.html
new file mode 100644
index 0000000..6ee2aee
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/core_list_join-c.html
@@ -0,0 +1,58 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>/cygdrive/d/dev/code/coremark/core_list_join.c - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_list_join.c"></a>core_list_join.c</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_list_join.c" >core_list_join.c</a></td><td class=SDescription></td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Description" >Description</a></td><td class=SDescription>Benchmark using a linked list.</td></tr><tr class="SGroup"><td class=SEntry><a href="#Functions" >Functions</a></td><td class=SDescription></td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#cmp_complex" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">cmp_complex</a></td><td class=SDescription>Compare the data item in a list cell.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#cmp_idx" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">cmp_idx</a></td><td class=SDescription>Compare the idx item in a list cell, and regen the data.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_list_init" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">core_list_init</a></td><td class=SDescription>Initialize list with data.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#core_list_insert" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')">core_list_insert</a></td><td class=SDescription>Insert an item to the list</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_list_remove" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')">core_list_remove</a></td><td class=SDescription>Remove an item from the list.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#core_list_undo_remove" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')">core_list_undo_remove</a></td><td class=SDescription>Undo a remove operation.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_list_find" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')">core_list_find</a></td><td class=SDescription>Find an item in the list</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#core_list_reverse" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')">core_list_reverse</a></td><td class=SDescription>Reverse a list</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_list_mergesort" id=link9 onMouseOver="ShowTip(event, 'tt9', 'link9')" onMouseOut="HideTip('tt9')">core_list_mergesort</a></td><td class=SDescription>Sort the list in place without recursion.</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Description"></a>Description</h3><div class=CBody><p>Benchmark using a linked list.</p><p>Linked list is a common data structure used in many applications.</p><p>For our purposes, this will excercise the memory units of the processor. In particular, usage of the list pointers to find and alter data.</p><p>We are not using Malloc since some platforms do not support this library.</p><p>Instead, the memory block being passed in is used to create a list, and the benchmark takes care not to add more items then can be accomodated by the memory block. The porting layer will make sure that we have a valid memory block.</p><p>All operations are done in place, without using any extra memory.</p><p>The list itself contains list pointers and pointers to data items. Data items contain the following:</p><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>idx</td><td class=CDLDescription>An index that captures the initial order of the list.</td></tr><tr><td class=CDLEntry>data</td><td class=CDLDescription>Variable data initialized based on the input parameters. The 16b are divided as follows:</td></tr></table><ul><li>Upper 8b are backup of original data.</li><li>Bit 7 indicates if the lower 7 bits are to be used as is or calculated.</li><li>Bits 0-2 indicate type of operation to perform to get a 7b value.</li><li>Bits 3-6 provide input for the operation.</li></ul></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Functions"></a>Functions</h3></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="cmp_complex"></a>cmp_complex</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_complex(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Compare the data item in a list cell.</p><p>Can be used by mergesort.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="cmp_idx"></a>cmp_idx</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_idx(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Compare the idx item in a list cell, and regen the data.</p><p>Can be used by mergesort.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_init"></a>core_list_init</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_init(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Initialize list with data.</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>blksize</td><td class=CDLDescription>Size of memory to be initialized.</td></tr><tr><td class=CDLEntry>memblock</td><td class=CDLDescription>Pointer to memory block.</td></tr><tr><td class=CDLEntry>seed</td><td class=CDLDescription>Actual values chosen depend on the seed parameter. The seed parameter MUST be supplied from a source that cannot be determined at compile time</td></tr></table><h4 class=CHeading>Returns</h4><p>Pointer to the head of the list.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_insert"></a>core_list_insert</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_insert_new(</td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>insert_point,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>**</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PTypePrefix nowrap>list_data </td><td class=PType nowrap>**datablock </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock_end,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>datablock_end</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Insert an item to the list</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>insert_point</td><td class=CDLDescription>where to insert the item.</td></tr><tr><td class=CDLEntry>info</td><td class=CDLDescription>data for the cell.</td></tr><tr><td class=CDLEntry>memblock</td><td class=CDLDescription>pointer for the list header</td></tr><tr><td class=CDLEntry>datablock</td><td class=CDLDescription>pointer for the list data</td></tr><tr><td class=CDLEntry>memblock_end</td><td class=CDLDescription>end of region for list headers</td></tr><tr><td class=CDLEntry>datablock_end</td><td class=CDLDescription>end of region for list data</td></tr></table><h4 class=CHeading>Returns</h4><p>Pointer to new item.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_remove"></a>core_list_remove</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Remove an item from the list.</p><h4 class=CHeading>Operation</h4><p>For a singly linked list, remove by copying the data from the next item over to the current cell, and unlinking the next item.</p><h4 class=CHeading>Note</h4><p>since there is always a fake item at the end of the list, no need to check for NULL.</p><h4 class=CHeading>Returns</h4><p>Removed item.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_undo_remove"></a>core_list_undo_remove</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_undo_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_removed,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_modified</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Undo a remove operation.</p><h4 class=CHeading>Operation</h4><p>Since we want each iteration of the benchmark to be exactly the same, we need to be able to undo a remove. Link the removed item back into the list, and switch the info items.</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>item_removed</td><td class=CDLDescription>Return value from the <a href="#core_list_remove" class=LFunction id=link10 onMouseOver="ShowTip(event, 'tt5', 'link10')" onMouseOut="HideTip('tt5')">core_list_remove</a></td></tr><tr><td class=CDLEntry>item_modified</td><td class=CDLDescription>List item that was modified during <a href="#core_list_remove" class=LFunction id=link11 onMouseOver="ShowTip(event, 'tt5', 'link11')" onMouseOut="HideTip('tt5')">core_list_remove</a></td></tr></table><h4 class=CHeading>Returns</h4><p>The item that was linked back to the list.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_find"></a>core_list_find</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_find(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Find an item in the list</p><h4 class=CHeading>Operation</h4><p>Find an item by idx (if not 0) or specific data value</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>list</td><td class=CDLDescription>list head</td></tr><tr><td class=CDLEntry>info</td><td class=CDLDescription>idx or data to find</td></tr></table><h4 class=CHeading>Returns</h4><p>Found item, or NULL if not found.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_reverse"></a>core_list_reverse</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_reverse(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Reverse a list</p><h4 class=CHeading>Operation</h4><p>Rearrange the pointers so the list is reversed.</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>list</td><td class=CDLDescription>list head</td></tr><tr><td class=CDLEntry>info</td><td class=CDLDescription>idx or data to find</td></tr></table><h4 class=CHeading>Returns</h4><p>Found item, or NULL if not found.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_list_mergesort"></a>core_list_mergesort</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_mergesort(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_cmp </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>cmp,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Sort the list in place without recursion.</p><h4 class=CHeading>Description</h4><p>Use mergesort, as for linked list this is a realistic solution. Also, since this is aimed at embedded, care was taken to use iterative rather then recursive algorithm. The sort can either return the list to original order (by idx) , or use the data item to invoke other other algorithms and change the order of the list.</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>list</td><td class=CDLDescription>list to be sorted.</td></tr><tr><td class=CDLEntry>cmp</td><td class=CDLDescription>cmp function to use</td></tr></table><h4 class=CHeading>Returns</h4><p>New head of the list.</p><h4 class=CHeading>Note</h4><p>We have a special header for the list that will always be first, but the algorithm could theoretically modify where the list starts.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile id=MSelected>core_list_join.c</div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_complex(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Compare the data item in a list cell.</div></div><div class=CToolTip id="tt2"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_idx(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Compare the idx item in a list cell, and regen the data.</div></div><div class=CToolTip id="tt3"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_init(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Initialize list with data.</div></div><div class=CToolTip id="tt4"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_insert_new(</td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>insert_point,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>**</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PTypePrefix nowrap>list_data </td><td class=PType nowrap>**datablock </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock_end,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>datablock_end</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Insert an item to the list</div></div><div class=CToolTip id="tt5"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Remove an item from the list.</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_undo_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_removed,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_modified</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Undo a remove operation.</div></div><div class=CToolTip id="tt7"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_find(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Find an item in the list</div></div><div class=CToolTip id="tt8"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_reverse(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Reverse a list</div></div><div class=CToolTip id="tt9"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_mergesort(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_cmp </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>cmp,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Sort the list in place without recursion.</div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/core_main-c.html b/sw/vendor/coremark/docs/html/files/core_main-c.html
new file mode 100644
index 0000000..8477441
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/core_main-c.html
@@ -0,0 +1,42 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>core_main.c - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_main.c"></a>core_main.c</h1><div class=CBody><p>This file contains the framework to acquire a block of memory, seed initial parameters, tun t he benchmark and report the results.</p><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_main.c" >core_main.c</a></td><td class=SDescription>This file contains the framework to acquire a block of memory, seed initial parameters, tun t he benchmark and report the results.</td></tr><tr class="SGroup"><td class=SEntry><a href="#Functions" >Functions</a></td><td class=SDescription></td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#iterate" >iterate</a></td><td class=SDescription>Run the benchmark for a specified number of iterations.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#main" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">main</a></td><td class=SDescription>Main entry routine for the benchmark. </td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Functions"></a>Functions</h3></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="iterate"></a>iterate</h3><div class=CBody><p>Run the benchmark for a specified number of iterations.</p><h4 class=CHeading>Operation</h4><p>For each type of benchmarked algorithm: a - Initialize the data block for the algorithm. b - Execute the algorithm N times.</p><h4 class=CHeading>Returns</h4><p>NULL.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="main"></a>main</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>#if MAIN_HAS_NOARGC MAIN_RETURN_TYPE main(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Main entry routine for the benchmark. This function is responsible for the following steps:</p><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>Initialize input seeds from a source that cannot be determined at compile time.</td></tr><tr><td class=CDLEntry>2</td><td class=CDLDescription>Initialize memory block for use.</td></tr><tr><td class=CDLEntry>3</td><td class=CDLDescription>Run and time the benchmark.</td></tr><tr><td class=CDLEntry>4</td><td class=CDLDescription>Report results, testing the validity of the output if the seeds are known.</td></tr></table><h4 class=CHeading>Arguments</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>first seed : Any value</td></tr><tr><td class=CDLEntry>2</td><td class=CDLDescription>second seed : Must be identical to first for iterations to be identical</td></tr><tr><td class=CDLEntry>3</td><td class=CDLDescription>third seed : Any value, should be at least an order of magnitude less then the input size, but bigger then 32.</td></tr><tr><td class=CDLEntry>4</td><td class=CDLDescription>Iterations : Special, if set to 0, iterations will be automatically determined such that the benchmark will run between 10 to 100 secs</td></tr></table></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile id=MSelected>core_main.c</div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>#if MAIN_HAS_NOARGC MAIN_RETURN_TYPE main(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Main entry routine for the benchmark. </div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/core_matrix-c.html b/sw/vendor/coremark/docs/html/files/core_matrix-c.html
new file mode 100644
index 0000000..2ad041b
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/core_matrix-c.html
@@ -0,0 +1,56 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>/cygdrive/d/dev/code/coremark/core_matrix.c - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_matrix.c"></a>core_matrix.c</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_matrix.c" >core_matrix.c</a></td><td class=SDescription></td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Description" >Description</a></td><td class=SDescription>Matrix manipulation benchmark</td></tr><tr class="SGroup"><td class=SEntry><a href="#Functions" >Functions</a></td><td class=SDescription></td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_bench_matrix" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">core_bench_matrix</a></td><td class=SDescription>Benchmark function</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#matrix_test" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">matrix_test</a></td><td class=SDescription>Perform matrix manipulation.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#matrix_sum" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">matrix_sum</a></td><td class=SDescription>Calculate a function that depends on the values of elements in the matrix.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#matrix_mul_const" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')">matrix_mul_const</a></td><td class=SDescription>Multiply a matrix by a constant. </td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#matrix_add_const" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')">matrix_add_const</a></td><td class=SDescription>Add a constant value to all elements of a matrix.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#matrix_mul_vect" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')">matrix_mul_vect</a></td><td class=SDescription>Multiply a matrix by a vector. </td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#matrix_mul_matrix" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')">matrix_mul_matrix</a></td><td class=SDescription>Multiply a matrix by a matrix. </td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#matrix_mul_matrix_bitextract" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')">matrix_mul_matrix_bitextract</a></td><td class=SDescription>Multiply a matrix by a matrix, and extract some bits from the result. </td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Description"></a>Description</h3><div class=CBody><p>Matrix manipulation benchmark</p><p>This very simple algorithm forms the basis of many more complex algorithms.</p><p>The tight inner loop is the focus of many optimizations (compiler as well as hardware based) and is thus relevant for embedded processing.</p><h4 class=CHeading>The total available data space will be divided to 3 parts</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>NxN Matrix A</td><td class=CDLDescription>initialized with small values (upper 3/4 of the bits all zero).</td></tr><tr><td class=CDLEntry>NxN Matrix B</td><td class=CDLDescription>initialized with medium values (upper half of the bits all zero).</td></tr><tr><td class=CDLEntry>NxN Matrix C</td><td class=CDLDescription>used for the result.</td></tr></table><p>The actual values for A and B must be derived based on input that is not available at compile time.</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Functions"></a>Functions</h3></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_bench_matrix"></a>core_bench_matrix</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_matrix(</td><td class=PType nowrap>mat_params </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Benchmark function</p><p>Iterate <a href="#matrix_test" class=LFunction id=link9 onMouseOver="ShowTip(event, 'tt2', 'link9')" onMouseOut="HideTip('tt2')">matrix_test</a> N times, changing the matrix values slightly by a constant amount each time.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_test"></a>matrix_test</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_test(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Perform matrix manipulation.</p><h4 class=CHeading>Parameters</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>N</td><td class=CDLDescription>Dimensions of the matrix.</td></tr><tr><td class=CDLEntry>C</td><td class=CDLDescription>memory for result matrix.</td></tr><tr><td class=CDLEntry>A</td><td class=CDLDescription>input matrix</td></tr><tr><td class=CDLEntry>B</td><td class=CDLDescription>operator matrix (not changed during operations)</td></tr></table><h4 class=CHeading>Returns</h4><p>A CRC value that captures all results calculated in the function. In particular, crc of the value calculated on the result matrix after each step by <a href="#matrix_sum" class=LFunction id=link10 onMouseOver="ShowTip(event, 'tt3', 'link10')" onMouseOut="HideTip('tt3')">matrix_sum</a>.</p><h4 class=CHeading>Operation</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>Add a constant value to all elements of a matrix.</td></tr><tr><td class=CDLEntry>2</td><td class=CDLDescription>Multiply a matrix by a constant.</td></tr><tr><td class=CDLEntry>3</td><td class=CDLDescription>Multiply a matrix by a vector.</td></tr><tr><td class=CDLEntry>4</td><td class=CDLDescription>Multiply a matrix by a matrix.</td></tr><tr><td class=CDLEntry>5</td><td class=CDLDescription>Add a constant value to all elements of a matrix.</td></tr></table><p>After the last step, matrix A is back to original contents.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_sum"></a>matrix_sum</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_sum(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>clipval</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Calculate a function that depends on the values of elements in the matrix.</p><p>For each element, accumulate into a temporary variable.</p><p>As long as this value is under the parameter clipval, add 1 to the result if the element is bigger then the previous.</p><p>Otherwise, reset the accumulator and add 10 to the result.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_mul_const"></a>matrix_mul_const</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Multiply a matrix by a constant. This could be used as a scaler for instance.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_add_const"></a>matrix_add_const</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_add_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Add a constant value to all elements of a matrix.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_mul_vect"></a>matrix_mul_vect</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_vect(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Multiply a matrix by a vector. This is common in many simple filters (e.g. fir where a vector of coefficients is applied to the matrix.)</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_mul_matrix"></a>matrix_mul_matrix</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Multiply a matrix by a matrix. Basic code is used in many algorithms, mostly with minor changes such as scaling.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="matrix_mul_matrix_bitextract"></a>matrix_mul_matrix_bitextract</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix_bitextract(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Multiply a matrix by a matrix, and extract some bits from the result. Basic code is used in many algorithms, mostly with minor changes such as scaling.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile id=MSelected>core_matrix.c</div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_matrix(</td><td class=PType nowrap>mat_params </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Benchmark function</div></div><div class=CToolTip id="tt2"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_test(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Perform matrix manipulation.</div></div><div class=CToolTip id="tt3"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_sum(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>clipval</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Calculate a function that depends on the values of elements in the matrix.</div></div><div class=CToolTip id="tt4"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a constant. </div></div><div class=CToolTip id="tt5"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_add_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Add a constant value to all elements of a matrix.</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_vect(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a vector. </div></div><div class=CToolTip id="tt7"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a matrix. </div></div><div class=CToolTip id="tt8"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix_bitextract(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a matrix, and extract some bits from the result. </div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/core_state-c.html b/sw/vendor/coremark/docs/html/files/core_state-c.html
new file mode 100644
index 0000000..9f80359
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/core_state-c.html
@@ -0,0 +1,46 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>/cygdrive/d/dev/code/coremark/core_state.c - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_state.c"></a>core_state.c</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_state.c" >core_state.c</a></td><td class=SDescription></td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Description" >Description</a></td><td class=SDescription>Simple state machines like this one are used in many embedded products.</td></tr><tr class="SGroup"><td class=SEntry><a href="#Functions" >Functions</a></td><td class=SDescription></td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_bench_state" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">core_bench_state</a></td><td class=SDescription>Benchmark function</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#core_init_state" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">core_init_state</a></td><td class=SDescription>Initialize the input data for the state machine.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_state_transition" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">core_state_transition</a></td><td class=SDescription>Actual state machine.</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Description"></a>Description</h3><div class=CBody><p>Simple state machines like this one are used in many embedded products.</p><p>For more complex state machines, sometimes a state transition table implementation is used instead, trading speed of direct coding for ease of maintenance.</p><p>Since the main goal of using a state machine in CoreMark is to excercise the switch/if behaviour, we are using a small moore machine.</p><p>In particular, this machine tests type of string input, trying to determine whether the input is a number or something else. <a href="#Image1" class=CImageLink>(see core_state)</a>.</p><blockquote><div class=CImage><a name="Image1"></a><div class=CImageCaption>core_state</div><img src="docs/core_state.png" width="768" height="570"></div></blockquote></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Functions"></a>Functions</h3></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_bench_state"></a>core_bench_state</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed1,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed2,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>step,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Benchmark function</p><p>Go over the input twice, once direct, and once after introducing some corruption.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_init_state"></a>core_init_state</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void core_init_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>size,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Initialize the input data for the state machine.</p><p>Populate the input with several predetermined strings, interspersed. Actual patterns chosen depend on the seed parameter.</p><h4 class=CHeading>Note</h4><p>The seed parameter MUST be supplied from a source that cannot be determined at compile time</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_state_transition"></a>core_state_transition</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>enum CORE_STATE core_state_transition(</td><td class=PTypePrefix nowrap>ee_u8 </td><td class=PType nowrap>**instr </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>transition_count</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Actual state machine.</p><h4 class=CHeading>The state machine will continue scanning until either</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>an invalid input is detcted.</td></tr><tr><td class=CDLEntry>2</td><td class=CDLDescription>a valid number has been detected.</td></tr></table><p>The input pointer is updated to point to the end of the token, and the end state is returned (either specific format determined or invalid).</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile id=MSelected>core_state.c</div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed1,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed2,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>step,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Benchmark function</div></div><div class=CToolTip id="tt2"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void core_init_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>size,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Initialize the input data for the state machine.</div></div><div class=CToolTip id="tt3"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>enum CORE_STATE core_state_transition(</td><td class=PTypePrefix nowrap>ee_u8 </td><td class=PType nowrap>**instr </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>transition_count</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Actual state machine.</div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/core_util-c.html b/sw/vendor/coremark/docs/html/files/core_util-c.html
new file mode 100644
index 0000000..3ebdb38
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/core_util-c.html
@@ -0,0 +1,42 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>/cygdrive/d/dev/code/coremark/core_util.c - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_util.c"></a>core_util.c</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_util.c" >core_util.c</a></td><td class=SDescription></td></tr><tr class="SGroup"><td class=SEntry><a href="#Functions" >Functions</a></td><td class=SDescription></td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#get_seed" >get_seed</a></td><td class=SDescription>Get a values that cannot be determined at compile time.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#crc*" >crc*</a></td><td class=SDescription>Service functions to calculate 16b CRC code.</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Functions"></a>Functions</h3></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="get_seed"></a>get_seed</h3><div class=CBody><p>Get a values that cannot be determined at compile time.</p><h4 class=CHeading>Since different embedded systems and compilers are used, 3 different methods are provided</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>Using a volatile variable. This method is only valid if the compiler is forced to generate code that reads the value of a volatile variable from memory at run time. Please note, if using this method, you would need to modify core_portme.c to generate training profile.</td></tr><tr><td class=CDLEntry>2</td><td class=CDLDescription>Command line arguments. This is the preferred method if command line arguments are supported.</td></tr><tr><td class=CDLEntry>3</td><td class=CDLDescription>System function. If none of the first 2 methods is available on the platform, a system function which is not a stub can be used.</td></tr></table><p>e.g. read the value on GPIO pins connected to switches, or invoke special simulator functions.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="crc*"></a>crc*</h3><div class=CBody><p>Service functions to calculate 16b CRC code.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile id=MSelected>core_util.c</div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/coremark-h.html b/sw/vendor/coremark/docs/html/files/coremark-h.html
new file mode 100644
index 0000000..337bc1a
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/coremark-h.html
@@ -0,0 +1,46 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>/cygdrive/d/dev/code/coremark/coremark.h - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="coremark.h"></a>coremark.h</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#coremark.h" >coremark.h</a></td><td class=SDescription></td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Description" >Description</a></td><td class=SDescription>This file contains declarations of the various benchmark functions.</td></tr><tr class="SGroup"><td class=SEntry><a href="#Configuration" >Configuration</a></td><td class=SDescription></td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#TOTAL_DATA_SIZE" >TOTAL_DATA_SIZE</a></td><td class=SDescription>Define total size for data algorithms will operate on</td></tr><tr class="SGroup"><td class=SEntry><a href="#Types" >Types</a></td><td class=SDescription></td></tr><tr class="SType SIndent1 SMarked"><td class=SEntry><a href="#secs_ret" >secs_ret</a></td><td class=SDescription>For machines that have floating point support, get number of seconds as a double. </td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Description"></a>Description</h3><div class=CBody><p>This file contains declarations of the various benchmark functions.</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Configuration"></a>Configuration</h3></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="TOTAL_DATA_SIZE"></a>TOTAL_DATA_SIZE</h3><div class=CBody><p>Define total size for data algorithms will operate on</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Types"></a>Types</h3></div></div>
+
+<div class="CType"><div class=CTopic><h3 class=CTitle><a name="secs_ret"></a>secs_ret</h3><div class=CBody><p>For machines that have floating point support, get number of seconds as a double. Otherwise an unsigned int.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile id=MSelected>coremark.h</div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/docs/core_state.png b/sw/vendor/coremark/docs/html/files/docs/core_state.png
new file mode 100644
index 0000000..9b5a4ea
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/docs/core_state.png
Binary files differ
diff --git a/sw/vendor/coremark/docs/html/files/linux/core_portme-c.html b/sw/vendor/coremark/docs/html/files/linux/core_portme-c.html
new file mode 100644
index 0000000..c8fd812
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/linux/core_portme-c.html
@@ -0,0 +1,58 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>core_portme.c - CoreMark</title><link rel="stylesheet" type="text/css" href="../../styles/main.css"><script language=JavaScript src="../../javascript/main.js"></script><script language=JavaScript src="../../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_portme.c"></a>core_portme.c</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_portme.c" >core_portme.c</a></td><td class=SDescription></td></tr><tr class="SFunction SMarked"><td class=SEntry><a href="#portable_malloc" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">portable_malloc</a></td><td class=SDescription>Provide malloc() functionality in a platform specific way.</td></tr><tr class="SFunction"><td class=SEntry><a href="#portable_free" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">portable_free</a></td><td class=SDescription>Provide free() functionality in a platform specific way.</td></tr><tr class="SGroup"><td class=SEntry><a href="#TIMER_RES_DIVIDER" >TIMER_RES_DIVIDER</a></td><td class=SDescription>Divider to trade off timer resolution and total time that can be measured.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#start_time" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">start_time</a></td><td class=SDescription>This function will be called right before starting the timed portion of the benchmark.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#stop_time" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')">stop_time</a></td><td class=SDescription>This function will be called right after ending the timed portion of the benchmark.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#get_time" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')">get_time</a></td><td class=SDescription>Return an abstract “ticks” number that signifies time on the system.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#time_in_secs" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')">time_in_secs</a></td><td class=SDescription>Convert the value returned by get_time to seconds.</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#portable_init" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')">portable_init</a></td><td class=SDescription>Target specific initialization code Test for some common mistakes.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#portable_fini" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')">portable_fini</a></td><td class=SDescription>Target specific final code</td></tr><tr class="SFunction SIndent1 SMarked"><td class=SEntry><a href="#core_start_parallel" >core_start_parallel</a></td><td class=SDescription>Start benchmarking in a parallel context.</td></tr><tr class="SFunction SIndent1"><td class=SEntry><a href="#core_stop_parallel" >core_stop_parallel</a></td><td class=SDescription>Stop a parallel context execution of coremark, and gather the results.</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="portable_malloc"></a>portable_malloc</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void *portable_malloc(</td><td class=PType nowrap>size_t </td><td class=PParameter nowrap>size</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Provide malloc() functionality in a platform specific way.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="portable_free"></a>portable_free</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_free(</td><td class=PType nowrap>void </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Provide free() functionality in a platform specific way.</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="TIMER_RES_DIVIDER"></a>TIMER_RES_DIVIDER</h3><div class=CBody><p>Divider to trade off timer resolution and total time that can be measured.</p><p>Use lower values to increase resolution, but make sure that overflow does not occur. If there are issues with the return value overflowing, increase this value.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="start_time"></a>start_time</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void start_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>This function will be called right before starting the timed portion of the benchmark.</p><p>Implementation may be capturing a system timer (as implemented in the example code) or zeroing some system parameters - e.g. setting the cpu clocks cycles to 0.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="stop_time"></a>stop_time</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void stop_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>This function will be called right after ending the timed portion of the benchmark.</p><p>Implementation may be capturing a system timer (as implemented in the example code) or other system parameters - e.g. reading the current value of cpu cycles counter.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="get_time"></a>get_time</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>CORE_TICKS get_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Return an abstract “ticks” number that signifies time on the system.</p><p>Actual value returned may be cpu cycles, milliseconds or any other value, as long as it can be converted to seconds by <a href="#time_in_secs" class=LFunction id=link9 onMouseOver="ShowTip(event, 'tt6', 'link9')" onMouseOut="HideTip('tt6')">time_in_secs</a>. This methodology is taken to accomodate any hardware or simulated platform. The sample implementation returns millisecs by default, and the resolution is controlled by <a href="#TIMER_RES_DIVIDER" class=LGroup id=link10 onMouseOver="ShowTip(event, 'tt9', 'link10')" onMouseOut="HideTip('tt9')">TIMER_RES_DIVIDER</a></p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="time_in_secs"></a>time_in_secs</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>secs_ret time_in_secs(</td><td class=PType nowrap>CORE_TICKS </td><td class=PParameter nowrap>ticks</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Convert the value returned by get_time to seconds.</p><p>The <a href="../coremark-h.html#secs_ret" class=LType id=link11 onMouseOver="ShowTip(event, 'tt10', 'link11')" onMouseOut="HideTip('tt10')">secs_ret</a> type is used to accomodate systems with no support for floating point. Default implementation implemented by the EE_TICKS_PER_SEC macro above.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="portable_init"></a>portable_init</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_init(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>int </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argc,</td></tr><tr><td></td><td class=PType nowrap>char </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argv[]</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Target specific initialization code Test for some common mistakes.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="portable_fini"></a>portable_fini</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_fini(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote><p>Target specific final code</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_start_parallel"></a>core_start_parallel</h3><div class=CBody><p>Start benchmarking in a parallel context.</p><p>Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets. Other implementations using MCAPI or other standards can easily be devised.</p></div></div></div>
+
+<div class="CFunction"><div class=CTopic><h3 class=CTitle><a name="core_stop_parallel"></a>core_stop_parallel</h3><div class=CBody><p>Stop a parallel context execution of coremark, and gather the results.</p><p>Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets. Other implementations using MCAPI or other standards can easily be devised.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile id=MSelected>PORT_DIR/<span class=HB> </span>core_portme.c</div></div><div class=MEntry><div class=MFile><a href="core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void *portable_malloc(</td><td class=PType nowrap>size_t </td><td class=PParameter nowrap>size</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Provide malloc() functionality in a platform specific way.</div></div><div class=CToolTip id="tt2"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_free(</td><td class=PType nowrap>void </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Provide free() functionality in a platform specific way.</div></div><div class=CToolTip id="tt3"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void start_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>This function will be called right before starting the timed portion of the benchmark.</div></div><div class=CToolTip id="tt4"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void stop_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>This function will be called right after ending the timed portion of the benchmark.</div></div><div class=CToolTip id="tt5"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>CORE_TICKS get_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Return an abstract “ticks” number that signifies time on the system.</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>secs_ret time_in_secs(</td><td class=PType nowrap>CORE_TICKS </td><td class=PParameter nowrap>ticks</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Convert the value returned by get_time to seconds.</div></div><div class=CToolTip id="tt7"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_init(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>int </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argc,</td></tr><tr><td></td><td class=PType nowrap>char </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argv[]</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific initialization code Test for some common mistakes.</div></div><div class=CToolTip id="tt8"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_fini(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific final code</div></div><div class=CToolTip id="tt9"><div class=CGroup>Divider to trade off timer resolution and total time that can be measured.</div></div><div class=CToolTip id="tt10"><div class=CType>For machines that have floating point support, get number of seconds as a double. </div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/linux/core_portme-h.html b/sw/vendor/coremark/docs/html/files/linux/core_portme-h.html
new file mode 100644
index 0000000..90810f1
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/linux/core_portme-h.html
@@ -0,0 +1,72 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>core_portme.h - CoreMark</title><link rel="stylesheet" type="text/css" href="../../styles/main.css"><script language=JavaScript src="../../javascript/main.js"></script><script language=JavaScript src="../../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_portme.h"></a>core_portme.h</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_portme.h" >core_portme.h</a></td><td class=SDescription></td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Description" >Description</a></td><td class=SDescription>This file contains configuration constants required to execute on different platforms</td></tr><tr class="SGroup"><td class=SEntry><a href="#Configuration" >Configuration</a></td><td class=SDescription></td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#HAS_FLOAT" >HAS_FLOAT</a></td><td class=SDescription>Define to 1 if the platform supports floating point.</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#HAS_TIME_H" >HAS_TIME_H</a></td><td class=SDescription>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#USE_CLOCK" >USE_CLOCK</a></td><td class=SDescription>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#HAS_STDIO" >HAS_STDIO</a></td><td class=SDescription>Define to 1 if the platform has stdio.h.</td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#HAS_PRINTF" >HAS_PRINTF</a></td><td class=SDescription>Define to 1 if the platform has stdio.h and implements the printf function.</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#CORE_TICKS" >CORE_TICKS</a></td><td class=SDescription>Define type of return from the timing functions.</td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#SEED_METHOD" >SEED_METHOD</a></td><td class=SDescription>Defines method to get seed values that cannot be computed at compile time.</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#MEM_METHOD" >MEM_METHOD</a></td><td class=SDescription>Defines method to get a block of memry.</td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#MULTITHREAD" >MULTITHREAD</a></td><td class=SDescription>Define for parallel execution</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#USE_PTHREAD" >USE_PTHREAD</a></td><td class=SDescription>Sample implementation for launching parallel contexts This implementation uses pthread_thread_create and pthread_join.</td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#USE_FORK" >USE_FORK</a></td><td class=SDescription>Sample implementation for launching parallel contexts This implementation uses fork, waitpid, shmget,shmat and shmdt.</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#USE_SOCKET" >USE_SOCKET</a></td><td class=SDescription>Sample implementation for launching parallel contexts This implementation uses fork, socket, sendto and recvfrom</td></tr><tr class="SConfiguration SIndent1 SMarked"><td class=SEntry><a href="#MAIN_HAS_NOARGC" >MAIN_HAS_NOARGC</a></td><td class=SDescription>Needed if platform does not support getting arguments to main.</td></tr><tr class="SConfiguration SIndent1"><td class=SEntry><a href="#MAIN_HAS_NORETURN" >MAIN_HAS_NORETURN</a></td><td class=SDescription>Needed if platform does not support returning a value from main.</td></tr><tr class="SGroup"><td class=SEntry><a href="#Variables" >Variables</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#default_num_contexts" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">default_num_contexts</a></td><td class=SDescription>Number of contexts to spawn in multicore context. </td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Description"></a>Description</h3><div class=CBody><p>This file contains configuration constants required to execute on different platforms</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Configuration"></a>Configuration</h3></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="HAS_FLOAT"></a>HAS_FLOAT</h3><div class=CBody><p>Define to 1 if the platform supports floating point.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="HAS_TIME_H"></a>HAS_TIME_H</h3><div class=CBody><p>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="USE_CLOCK"></a>USE_CLOCK</h3><div class=CBody><p>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="HAS_STDIO"></a>HAS_STDIO</h3><div class=CBody><p>Define to 1 if the platform has stdio.h.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="HAS_PRINTF"></a>HAS_PRINTF</h3><div class=CBody><p>Define to 1 if the platform has stdio.h and implements the printf function.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="CORE_TICKS"></a>CORE_TICKS</h3><div class=CBody><p>Define type of return from the timing functions.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="SEED_METHOD"></a>SEED_METHOD</h3><div class=CBody><p>Defines method to get seed values that cannot be computed at compile time.</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>SEED_ARG</td><td class=CDLDescription>from command line.</td></tr><tr><td class=CDLEntry>SEED_FUNC</td><td class=CDLDescription>from a system function.</td></tr><tr><td class=CDLEntry>SEED_VOLATILE</td><td class=CDLDescription>from volatile variables.</td></tr></table></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="MEM_METHOD"></a>MEM_METHOD</h3><div class=CBody><p>Defines method to get a block of memry.</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>MEM_MALLOC</td><td class=CDLDescription>for platforms that implement malloc and have malloc.h.</td></tr><tr><td class=CDLEntry>MEM_STATIC</td><td class=CDLDescription>to use a static memory array.</td></tr><tr><td class=CDLEntry>MEM_STACK</td><td class=CDLDescription>to allocate the data block on the stack (NYI).</td></tr></table></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="MULTITHREAD"></a>MULTITHREAD</h3><div class=CBody><p>Define for parallel execution</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>only one context (default).</td></tr><tr><td class=CDLEntry>N>1</td><td class=CDLDescription>will execute N copies in parallel.</td></tr></table><h4 class=CHeading>Note</h4><p>If this flag is defined to more then 1, an implementation for launching parallel contexts must be defined.</p><p>Two sample implementations are provided. Use <a href="#USE_PTHREAD" class=LConfiguration id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">USE_PTHREAD</a> or <a href="#USE_FORK" class=LConfiguration id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">USE_FORK</a> to enable them.</p><p>It is valid to have a different implementation of <a href="core_portme-c.html#core_start_parallel" class=LFunction id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')">core_start_parallel</a> and <core_end_parallel> in <a href="core_portme-c.html#core_portme.c" class=LFile >core_portme.c</a>, to fit a particular architecture.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="USE_PTHREAD"></a>USE_PTHREAD</h3><div class=CBody><p>Sample implementation for launching parallel contexts This implementation uses pthread_thread_create and pthread_join.</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>0</td><td class=CDLDescription>Do not use pthreads API.</td></tr><tr><td class=CDLEntry>1</td><td class=CDLDescription>Use pthreads API</td></tr></table><h4 class=CHeading>Note</h4><p>This flag only matters if MULTITHREAD has been defined to a value greater then 1.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="USE_FORK"></a>USE_FORK</h3><div class=CBody><p>Sample implementation for launching parallel contexts This implementation uses fork, waitpid, shmget,shmat and shmdt.</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>0</td><td class=CDLDescription>Do not use fork API.</td></tr><tr><td class=CDLEntry>1</td><td class=CDLDescription>Use fork API</td></tr></table><h4 class=CHeading>Note</h4><p>This flag only matters if MULTITHREAD has been defined to a value greater then 1.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="USE_SOCKET"></a>USE_SOCKET</h3><div class=CBody><p>Sample implementation for launching parallel contexts This implementation uses fork, socket, sendto and recvfrom</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>0</td><td class=CDLDescription>Do not use fork and sockets API.</td></tr><tr><td class=CDLEntry>1</td><td class=CDLDescription>Use fork and sockets API</td></tr></table><h4 class=CHeading>Note</h4><p>This flag only matters if MULTITHREAD has been defined to a value greater then 1.</p></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="MAIN_HAS_NOARGC"></a>MAIN_HAS_NOARGC</h3><div class=CBody><p>Needed if platform does not support getting arguments to main.</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>0</td><td class=CDLDescription>argc/argv to main is supported</td></tr><tr><td class=CDLEntry>1</td><td class=CDLDescription>argc/argv to main is not supported</td></tr></table></div></div></div>
+
+<div class="CConfiguration"><div class=CTopic><h3 class=CTitle><a name="MAIN_HAS_NORETURN"></a>MAIN_HAS_NORETURN</h3><div class=CBody><p>Needed if platform does not support returning a value from main.</p><h4 class=CHeading>Valid values</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>0</td><td class=CDLDescription>main returns an int, and return value will be 0.</td></tr><tr><td class=CDLEntry>1</td><td class=CDLDescription>platform does not support returning a value from main</td></tr></table></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Variables"></a>Variables</h3></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="default_num_contexts"></a>default_num_contexts</h3><div class=CBody><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td>extern ee_u32 default_num_contexts</td></tr></table></blockquote><p>Number of contexts to spawn in multicore context. Override this global value to change number of contexts used.</p><h4 class=CHeading>Note</h4><p>This value may not be set higher then the <a href="#MULTITHREAD" class=LConfiguration id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')">MULTITHREAD</a> define.</p><p>To experiment, you can set the <a href="#MULTITHREAD" class=LConfiguration id=link6 onMouseOver="ShowTip(event, 'tt5', 'link6')" onMouseOut="HideTip('tt5')">MULTITHREAD</a> define to the highest value expected, and use argc/argv in the <a href="core_portme-c.html#portable_init" class=LFunction id=link7 onMouseOver="ShowTip(event, 'tt6', 'link7')" onMouseOut="HideTip('tt6')">portable_init</a> to set this value from the command line.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile id=MSelected>PORT_DIR/<span class=HB> </span>core_portme.h</div></div><div class=MEntry><div class=MFile><a href="core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CVariable><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td>extern ee_u32 default_num_contexts</td></tr></table></blockquote>Number of contexts to spawn in multicore context. </div></div><div class=CToolTip id="tt2"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses pthread_thread_create and pthread_join.</div></div><div class=CToolTip id="tt3"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses fork, waitpid, shmget,shmat and shmdt.</div></div><div class=CToolTip id="tt4"><div class=CFunction>Start benchmarking in a parallel context.</div></div><div class=CToolTip id="tt5"><div class=CConfiguration>Define for parallel execution</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_init(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>int </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argc,</td></tr><tr><td></td><td class=PType nowrap>char </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argv[]</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific initialization code Test for some common mistakes.</div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/linux/core_portme-mak.html b/sw/vendor/coremark/docs/html/files/linux/core_portme-mak.html
new file mode 100644
index 0000000..ffd6cbe
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/linux/core_portme-mak.html
@@ -0,0 +1,76 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>core_portme.mak - CoreMark</title><link rel="stylesheet" type="text/css" href="../../styles/main.css"><script language=JavaScript src="../../javascript/main.js"></script><script language=JavaScript src="../../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="core_portme.mak"></a>core_portme.mak</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#core_portme.mak" >core_portme.mak</a></td><td class=SDescription></td></tr><tr class="SGroup"><td class=SEntry><a href="#Variables" >Variables</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#OUTFLAG" >OUTFLAG</a></td><td class=SDescription>Use this flag to define how to to get an executable (e.g -o)</td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#CC" >CC</a></td><td class=SDescription>Use this flag to define compiler to use</td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#CFLAGS" >CFLAGS</a></td><td class=SDescription>Use this flag to define compiler options. </td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#LFLAGS_END" >LFLAGS_END</a></td><td class=SDescription>Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. </td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#PORT_SRCS" >PORT_SRCS</a></td><td class=SDescription>Port specific source files can be added here</td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#LOAD" >LOAD</a></td><td class=SDescription>Define this flag if you need to load to a target, as in a cross compile environment.</td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#RUN" >RUN</a></td><td class=SDescription>Define this flag if running does not consist of simple invocation of the binary. </td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#SEPARATE_COMPILE" >SEPARATE_COMPILE</a></td><td class=SDescription>Define if you need to separate compilation from link stage. </td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#PORT_OBJS" >PORT_OBJS</a></td><td class=SDescription>Port specific object files can be added here</td></tr><tr class="SGroup"><td class=SEntry><a href="#Build_Targets" >Build Targets</a></td><td class=SDescription></td></tr><tr class="SBuildTarget SIndent1 SMarked"><td class=SEntry><a href="#port_prebuild" >port_prebuild</a></td><td class=SDescription>Generate any files that are needed before actual build starts. </td></tr><tr class="SBuildTarget SIndent1"><td class=SEntry><a href="#port_postbuild" >port_postbuild</a></td><td class=SDescription>Generate any files that are needed after actual build end. </td></tr><tr class="SBuildTarget SIndent1 SMarked"><td class=SEntry><a href="#port_postrun" >port_postrun</a></td><td class=SDescription>Do platform specific after run stuff. </td></tr><tr class="SBuildTarget SIndent1"><td class=SEntry><a href="#port_prerun" >port_prerun</a></td><td class=SDescription>Do platform specific after run stuff. </td></tr><tr class="SBuildTarget SIndent1 SMarked"><td class=SEntry><a href="#port_postload" >port_postload</a></td><td class=SDescription>Do platform specific after load stuff. </td></tr><tr class="SBuildTarget SIndent1"><td class=SEntry><a href="#port_preload" >port_preload</a></td><td class=SDescription>Do platform specific before load stuff. </td></tr><tr class="SGroup"><td class=SEntry><a href="#Variables" >Variables</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1 SMarked"><td class=SEntry><a href="#OPATH" >OPATH</a></td><td class=SDescription></td></tr><tr class="SVariable SIndent1"><td class=SEntry><a href="#PERL" >PERL</a></td><td class=SDescription>Define perl executable to calculate the geomean if running separate.</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Variables"></a>Variables</h3></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="OUTFLAG"></a>OUTFLAG</h3><div class=CBody><p>Use this flag to define how to to get an executable (e.g -o)</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="CC"></a>CC</h3><div class=CBody><p>Use this flag to define compiler to use</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="CFLAGS"></a>CFLAGS</h3><div class=CBody><p>Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS=”other flags”</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="LFLAGS_END"></a>LFLAGS_END</h3><div class=CBody><p>Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts). Note: On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="PORT_SRCS"></a>PORT_SRCS</h3><div class=CBody><p>Port specific source files can be added here</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="LOAD"></a>LOAD</h3><div class=CBody><p>Define this flag if you need to load to a target, as in a cross compile environment.</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="RUN"></a>RUN</h3><div class=CBody><p>Define this flag if running does not consist of simple invocation of the binary. In a cross compile environment, you need to define this.</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="SEPARATE_COMPILE"></a>SEPARATE_COMPILE</h3><div class=CBody><p>Define if you need to separate compilation from link stage. In this case, you also need to define below how to create an object file, and how to link.</p></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="PORT_OBJS"></a>PORT_OBJS</h3><div class=CBody><p>Port specific object files can be added here</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Build_Targets"></a>Build Targets</h3></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_prebuild"></a>port_prebuild</h3><div class=CBody><p>Generate any files that are needed before actual build starts. E.g. generate profile guidance files. Sample PGO generation for gcc enabled with PGO=1</p><ul><li>First, check if PGO was defined on the command line, if so, need to add -fprofile-use to compile line.</li><li>Second, if PGO reference has not yet been generated, add a step to the prebuild that will build a profile-generate version and run it.</li></ul><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>Note</td><td class=CDLDescription>Using REBUILD=1</td></tr></table><p>Use make PGO=1 to invoke this sample processing.</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_postbuild"></a>port_postbuild</h3><div class=CBody><p>Generate any files that are needed after actual build end. E.g. change format to srec, bin, zip in order to be able to load into flash</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_postrun"></a>port_postrun</h3><div class=CBody><p>Do platform specific after run stuff. E.g. reset the board, backup the logfiles etc.</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_prerun"></a>port_prerun</h3><div class=CBody><p>Do platform specific after run stuff. E.g. reset the board, backup the logfiles etc.</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_postload"></a>port_postload</h3><div class=CBody><p>Do platform specific after load stuff. E.g. reset the reset power to the flash eraser</p></div></div></div>
+
+<div class="CBuildTarget"><div class=CTopic><h3 class=CTitle><a name="port_preload"></a>port_preload</h3><div class=CBody><p>Do platform specific before load stuff. E.g. reset the reset power to the flash eraser</p></div></div></div>
+
+<div class="CGroup"><div class=CTopic><h3 class=CTitle><a name="Variables"></a>Variables</h3></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="OPATH"></a>OPATH</h3><div class=CBody><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>Path to the output folder. Default</td><td class=CDLDescription>current folder.</td></tr></table></div></div></div>
+
+<div class="CVariable"><div class=CTopic><h3 class=CTitle><a name="PERL"></a>PERL</h3><div class=CBody><p>Define perl executable to calculate the geomean if running separate.</p></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile id=MSelected>PORT_DIR/<span class=HB> </span>core_portme.mak</div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/files/readme-txt.html b/sw/vendor/coremark/docs/html/files/readme-txt.html
new file mode 100644
index 0000000..2b57f37
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/readme-txt.html
@@ -0,0 +1,71 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="CoreMark"></a>CoreMark</h1><div class=CBody><!--START_ND_SUMMARY--><div class=Summary><div class=STitle>Summary</div><div class=SBorder><table border=0 cellspacing=0 cellpadding=0 class=STable><tr class="SMain"><td class=SEntry><a href="#CoreMark" >CoreMark</a></td><td class=SDescription></td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Welcome" >Welcome</a></td><td class=SDescription>Copyright © 2009 EEMBC All rights reserved. </td></tr><tr class="SGeneric"><td class=SEntry><a href="#Building_and_running" >Building and running</a></td><td class=SDescription>Download the release files from the www.coremark.org. </td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Documentation" >Documentation</a></td><td class=SDescription>When you unpack the documentation (tar -vzxf coremark_<version>_docs.tgz) a docs folder will be created. </td></tr><tr class="SGeneric"><td class=SEntry><a href="#Submitting_results" >Submitting results</a></td><td class=SDescription>CoreMark results can be submitted on the web.</td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Run_rules" >Run rules</a></td><td class=SDescription>What is and is not allowed.</td></tr><tr class="SGeneric"><td class=SEntry><a href="#Reporting_rules" >Reporting rules</a></td><td class=SDescription>How to report results on a data sheet?</td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Log_File_Format" >Log File Format</a></td><td class=SDescription>The log files have the following format</td></tr><tr class="SGeneric"><td class=SEntry><a href="#Legal" >Legal</a></td><td class=SDescription>See LICENSE.txt or the word document file under docs/LICENSE.doc. </td></tr><tr class="SGeneric SMarked"><td class=SEntry><a href="#Credits" >Credits</a></td><td class=SDescription>Many thanks to all of the individuals who helped with the development or testing of CoreMark including (Sorted by company name)</td></tr></table></div></div><!--END_ND_SUMMARY--></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Welcome"></a>Welcome</h3><div class=CBody><p>Copyright © 2009 EEMBC All rights reserved. CoreMark is a trademark of EEMBC and EEMBC is a registered trademark of the Embedded Microprocessor Benchmark Consortium.</p><p>CoreMark’s primary goals are simplicity and providing a method for testing only a processor’s core features.</p><p>For more information about EEMBC’s comprehensive embedded benchmark suites, please see www.eembc.org.</p></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Building_and_running"></a>Building and running</h3><div class=CBody><p>Download the release files from the www.coremark.org. You can verify the download using the coremark_<version>.md5 file</p><blockquote><pre>md5sum -c coremark_<version>.md5</pre></blockquote><p>Unpack the distribution (tar -vzxf coremark_<version>.tgz && tar -vzxf coremark_<version>_docs.tgz) then change to the coremark_<version> folder.</p><p>To build and run the benchmark, type</p><blockquote><pre>make</pre></blockquote><p>Full results are available in the files run1.log and run2.log. CoreMark result can be found in run1.log.</p><p>For self hosted Linux or Cygwin platforms, a simple make should work.</p><h4 class=CHeading>Cross Compile</h4><p>For cross compile platforms please adjust <a href="linux/core_portme-mak.html#core_portme.mak" class=LFile >core_portme.mak</a>, <a href="linux/core_portme-h.html#core_portme.h" class=LFile >core_portme.h</a> (and possibly <a href="linux/core_portme-c.html#core_portme.c" class=LFile >core_portme.c</a>) according to the specific platform used. When porting to a new platform, it is recommended to copy one of the default port folders (e.g. mkdir <platform> && cp linux/* <platform>), adjust the porting files, and run</p><blockquote><pre>make PORT_DIR=<platform></pre></blockquote><h4 class=CHeading>Systems without make</h4><p>The following files need to be compiled:</p><ul><li><a href="core_list_join-c.html#core_list_join.c" class=LFile >core_list_join.c</a></li><li><a href="core_main-c.html#core_main.c" class=LFile id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">core_main.c</a></li><li><a href="core_matrix-c.html#core_matrix.c" class=LFile >core_matrix.c</a></li><li><a href="core_state-c.html#core_state.c" class=LFile >core_state.c</a></li><li><a href="core_util-c.html#core_util.c" class=LFile >core_util.c</a></li><li><PORT_DIR>/<a href="linux/core_portme-c.html#core_portme.c" class=LFile >core_portme.c</a></li></ul><p>For example</p><blockquote><pre>gcc -O2 -o coremark.exe core_list_join.c core_main.c core_matrix.c core_state.c core_util.c simple/core_portme.c -DPERFORMANCE_RUN=1 -DITERATIONS=1000
+./coremark.exe > run1.log</pre></blockquote><p>The above will compile the benchmark for a performance run and 1000 iterations. Output is redirected to run1.log.</p><h4 class=CHeading>Make targets</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>run</td><td class=CDLDescription>Default target, creates run1.log and run2.log.</td></tr><tr><td class=CDLEntry>run1.log</td><td class=CDLDescription>Run the benchmark with performance parameters, and output to run1.log</td></tr><tr><td class=CDLEntry>run2.log</td><td class=CDLDescription>Run the benchmark with validation parameters, and output to run2.log</td></tr><tr><td class=CDLEntry>run3.log</td><td class=CDLDescription>Run the benchmark with profile generation parameters, and output to run3.log</td></tr><tr><td class=CDLEntry>compile</td><td class=CDLDescription>compile the benchmark executable</td></tr><tr><td class=CDLEntry>link</td><td class=CDLDescription>link the benchmark executable</td></tr><tr><td class=CDLEntry>check</td><td class=CDLDescription>test MD5 of sources that may not be modified</td></tr><tr><td class=CDLEntry>clean</td><td class=CDLDescription>clean temporary files</td></tr></table><h4 class=CHeading>ITERATIONS</h4><p>By default, the benchmark will run between 10-100 seconds. To override, use ITERATIONS=N</p><blockquote><pre>make ITERATIONS=10</pre></blockquote><p>Will run the benchmark for 10 iterations. It is recommended to set a specific number of iterations in certain situations e.g.:</p><ul><li>Running with a simulator</li><li>Measuring power/energy</li><li>Timing cannot be restarted</li></ul><h4 class=CHeading>Minimum required run time</h4><p>Results are only valid for reporting if the benchmark ran for at least 10 secs!</p><h4 class=CHeading>XCFLAGS</h4><p>To add compiler flags from the command line, use XCFLAGS e.g.</p><blockquote><pre>make XCFLAGS="-g -DMULTITHREAD=4 -DUSE_FORK=1"</pre></blockquote><ul><li>CORE_DEBUG</li></ul><p>Define to compile for a debug run if you get incorrect CRC.</p><blockquote><pre>make XCFLAGS="-DCORE_DEBUG=1"</pre></blockquote><ul><li>Parallel Execution</li></ul><p>Use XCFLAGS=-DMULTITHREAD=N where N is number of threads to run in parallel. Several implementations are available to execute in multiple contexts, or you can implement your own in <a href="linux/core_portme-c.html#core_portme.c" class=LFile >core_portme.c</a>.</p><blockquote><pre>make XCFLAGS="-DMULTITHREAD=4 -DUSE_PTHREAD"</pre></blockquote><p>Above will compile the benchmark for execution on 4 cores, using POSIX Threads API.</p><h4 class=CHeading>REBUILD</h4><p>To force rebuild, add the flag REBUILD to the command line</p><blockquote><pre>make REBUILD=1</pre></blockquote><p>Check core_portme.mak for more important options.</p><h4 class=CHeading>Run parameters for the benchmark executable</h4><p>Coremark executable takes several parameters as follows (if main accepts arguments). 1st - A seed value used for initialization of data. 2nd - A seed value used for initialization of data. 3rd - A seed value used for initialization of data. 4th - Number of iterations (0 for auto : default value) 5th - Reserved for internal use. 6th - Reserved for internal use. 7th - For malloc users only, ovreride the size of the input data buffer.</p><p>The run target from make will run coremark with 2 different data initialization seeds.</p><h4 class=CHeading>Alternative parameters</h4><p>If not using malloc or command line arguments are not supported, the buffer size for the algorithms must be defined via the compiler define TOTAL_DATA_SIZE. TOTAL_DATA_SIZE must be set to 2000 bytes (default) for standard runs. The default for such a target when testing different configurations could be ...</p><blockquote><pre>make XCFLAGS="-DTOTAL_DATA_SIZE=6000 -DMAIN_HAS_NOARGC=1"</pre></blockquote></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Documentation"></a>Documentation</h3><div class=CBody><p>When you unpack the documentation (tar -vzxf coremark_<version>_docs.tgz) a docs folder will be created. Check the file docs/html/index.html and the website <a href="http://www.coremark.org" class=LURL target=_top>http://www.coremark.org</a> for more info.</p></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Submitting_results"></a>Submitting results</h3><div class=CBody><p>CoreMark results can be submitted on the web.</p><p>Open a web browser and go to <a href="http://www.coremark.org/benchmark/index.php?pg=benchmark" class=LURL target=_top>http://www.coremark.org<span class=HB>- </span>/benchmark<span class=HB>- </span>/index.php?pg=benchmark</a> Select the link to add a new score and follow the instructions.</p></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Run_rules"></a>Run rules</h3><div class=CBody><p>What is and is not allowed.</p><h4 class=CHeading>Required</h4><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>1</td><td class=CDLDescription>The benchmark needs to run for at least 10 seconds.</td></tr><tr><td class=CDLEntry>2</td><td class=CDLDescription>All validation must succeed for seeds 0,0,0x66 and 0x3415,0x3415,0x66, buffer size of 2000 bytes total.</td></tr></table><ul><li>If not using command line arguments to main:</li></ul><blockquote><pre>make XCFLAGS="-DPERFORMANCE_RUN=1" REBUILD=1 run1.log
+make XCFLAGS="-DVALIDATION_RUN=1" REBUILD=1 run2.log</pre></blockquote><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>3</td><td class=CDLDescription>If using profile guided optimization, profile must be generated using seeds of 8,8,8, and buffer size of 1200 bytes total.</td></tr></table><blockquote><pre>make XCFLAGS="-DTOTAL_DATA_SIZE=1200 -DPROFILE_RUN=1" REBUILD=1 run3.log</pre></blockquote><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>4</td><td class=CDLDescription>All source files must be compiled with the same flags.</td></tr><tr><td class=CDLEntry>5</td><td class=CDLDescription>All data type sizes must match size in bits such that:</td></tr></table><ul><li>ee_u8 is an 8 bits datatype.</li><li>ee_s16 is an 16 bits datatype.</li><li>ee_u16 is an 16 bits datatype.</li><li>ee_s32 is an 32 bits datatype.</li><li>ee_u32 is an 32 bits datatype.</li></ul><h4 class=CHeading>Allowed</h4><ul><li>Changing number of iterations</li><li>Changing toolchain and build/load/run options</li><li>Changing method of acquiring a data memory block</li><li>Changing the method of acquiring seed values</li><li>Changing implementation in core_portme.c</li><li>Changing configuration values in core_portme.h</li><li>Changing core_portme.mak</li></ul><h4 class=CHeading>Not allowed</h4><ul><li>Changing of source file other then core_portme* (use make check to validate)</li></ul></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Reporting_rules"></a>Reporting rules</h3><div class=CBody><p>How to report results on a data sheet?</p><p>CoreMark 1.0 : N / C [/ P] [/ M]</p><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>N</td><td class=CDLDescription>Number of iterations per second with seeds 0,0,0x66,size=2000)</td></tr><tr><td class=CDLEntry>C</td><td class=CDLDescription>Compiler version and flags</td></tr><tr><td class=CDLEntry>P</td><td class=CDLDescription>Parameters such as data and code allocation specifics</td></tr></table><ul><li>This parameter <b>may</b> be omitted if all data was allocated on the heap in RAM.</li><li>This parameter <b>may not</b> be omitted when reporting CoreMark/MHz</li></ul><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>M</td><td class=CDLDescription>Type of parallel execution (if used) and number of contexts This parameter may be omitted if parallel execution was not used.</td></tr></table><p>e.g.</p><blockquote><pre>CoreMark 1.0 : 128 / GCC 4.1.2 -O2 -fprofile-use / Heap in TCRAM / FORK:2</pre></blockquote><p>or</p><blockquote><pre>CoreMark 1.0 : 1400 / GCC 3.4 -O4</pre></blockquote><h4 class=CHeading>If reporting scaling results, the results must be reported as follows</h4><p>CoreMark/MHz 1.0 : N / C / P [/ M]</p><table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList><tr><td class=CDLEntry>P</td><td class=CDLDescription>When reporting scaling results, memory parameter must also indicate memory frequency:core frequency ratio.</td></tr></table><ul><li>If the core has cache and cache frequency to core frequency ratio is configurable, that must also be included.</li></ul><p>e.g.</p><blockquote><pre>CoreMark/MHz 1.0 : 1.47 / GCC 4.1.2 -O2 / DDR3(Heap) 30:1 Memory 1:1 Cache</pre></blockquote></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Log_File_Format"></a>Log File Format</h3><div class=CBody><p>The log files have the following format</p><blockquote><pre>2K performance run parameters for coremark. (Run type)
+CoreMark Size : 666 (Buffer size)
+Total ticks : 25875 (platform dependent value)
+Total time (secs) : 25.875000 (actual time in seconds)
+Iterations/Sec : 3864.734300 (Performance value to report)
+Iterations : 100000 (number of iterations used)
+Compiler version : GCC3.4.4 (Compiler and version)
+Compiler flags : -O2 (Compiler and linker flags)
+Memory location : Code in flash, data in on chip RAM
+seedcrc : 0xe9f5 (identifier for the input seeds)
+[0]crclist : 0xe714 (validation for list part)
+[0]crcmatrix : 0x1fd7 (validation for matrix part)
+[0]crcstate : 0x8e3a (validation for state part)
+[0]crcfinal : 0x33ff (iteration dependent output)
+Correct operation validated. See README.md for run and reporting rules. (*Only when run is successful*)
+CoreMark 1.0 : 6508.490622 / GCC3.4.4 -O2 / Heap (*Only on a successful performance run*)</pre></blockquote></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Legal"></a>Legal</h3><div class=CBody><p>See LICENSE.txt or the word document file under docs/LICENSE.doc. For more information on your legal rights to use this benchmark, please see <a href="http://www.coremark.org/download/register.php?pg=register" class=LURL target=_top>http://www.coremark.org<span class=HB>- </span>/download<span class=HB>- </span>/register.php?pg=register</a></p></div></div></div>
+
+<div class="CGeneric"><div class=CTopic><h3 class=CTitle><a name="Credits"></a>Credits</h3><div class=CBody><p>Many thanks to all of the individuals who helped with the development or testing of CoreMark including (Sorted by company name)</p><ul><li>Alan Anderson, ADI</li><li>Adhikary Rajiv, ADI</li><li>Elena Stohr, ARM</li><li>Ian Rickards, ARM</li><li>Andrew Pickard, ARM</li><li>Trent Parker, CAVIUM</li><li>Shay Gal-On, EEMBC</li><li>Markus Levy, EEMBC</li><li>Ron Olson, IBM</li><li>Eyal Barzilay, MIPS</li><li>Jens Eltze, NEC</li><li>Hirohiko Ono, NEC</li><li>Ulrich Drees, NEC</li><li>Frank Roscheda, NEC</li><li>Rob Cosaro, NXP</li><li>Shumpei Kawasaki, RENESAS</li></ul></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile id=MSelected>CoreMark</div></div><div class=MEntry><div class=MFile><a href="release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFile>This file contains the framework to acquire a block of memory, seed initial parameters, tun t he benchmark and report the results.</div></div><!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
diff --git a/sw/vendor/coremark/docs/html/files/release_notes-txt.html b/sw/vendor/coremark/docs/html/files/release_notes-txt.html
new file mode 100644
index 0000000..6658c71
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/files/release_notes-txt.html
@@ -0,0 +1,56 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Release Notes - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Content><div class="CFile"><div class=CTopic id=MainTopic><h1 class=CTitle><a name="Release_Notes"></a>Release Notes</h1><div class=CBody><p>Version: 1.01</p><h4 class=CHeading>History</h4><p>Version 1.01</p><ul><li>Added validation testing the sizes of datatypes.</li></ul><p>Version 1.00</p><ul><li>First public version.</li></ul><h4 class=CHeading>Validation</h4><p>This release was tested on the following platforms</p><ul><li>x86 cygwin and gcc 3.4 (Quad, dual and single core systems)</li><li>x86 linux (Ubuntu/Fedora) and gcc (4.2/4.1) (Quad and single core systems)</li><li>MIPS64 BE linux and gcc 3.4 16 cores system</li><li>MIPS32 BE linux with CodeSourcery compiler 4.2-177 on Malta/Linux with a 1004K 3-core system</li><li>PPC simulator with gcc 4.2.2 (No OS)</li><li>PPC 64b BE linux (yellowdog) with gcc 3.4 and 4.1 (Dual core system)</li><li>BF533 with VDSP50</li><li>Renesas R8C/H8 MCU with HEW 4.05</li><li>NXP LPC1700 armcc v4.0.0.524</li><li>NEC 78K with IAR v4.61</li><li>ARM simulator with armcc v4</li></ul><h4 class=CHeading>Coverage</h4><p>GCOV results can be found on SVN under cover.</p><h4 class=CHeading>Memory analysis</h4><p>Valgrind 3.4.0 used and no errors reported.</p><h4 class=CHeading>Balance analysis</h4><p>Number of instructions executed for each function tested with cachegrind and found balanced with gcc and -O0.</p><h4 class=CHeading>Statistics</h4><h4 class=CHeading>Lines</h4><blockquote><pre>Lines Blank Cmnts Source AESL
+===== ===== ===== ===== ========== =======================================
+ 469 66 170 251 627.5 core_list_join.c (C)
+ 330 18 54 268 670.0 core_main.c (C)
+ 256 32 80 146 365.0 core_matrix.c (C)
+ 240 16 51 186 465.0 core_state.c (C)
+ 165 11 20 134 335.0 core_util.c (C)
+ 150 23 36 98 245.0 coremark.h (C)
+ 1610 166 411 1083 2707.5 ----- Benchmark ----- (6 files)
+ 293 15 74 212 530.0 linux/core_portme.c (C)
+ 235 30 104 104 260.0 linux/core_portme.h (C)
+ 528 45 178 316 790.0 ----- Porting ----- (2 files)
+
+
+* For comparison, here are the stats for Dhrystone
+Lines Blank Cmnts Source AESL
+===== ===== ===== ===== ========== =======================================
+ 311 15 242 54 135.0 dhry.h (C)
+ 789 132 119 553 1382.5 dhry_1.c (C)
+ 186 26 68 107 267.5 dhry_2.c (C)
+ 1286 173 429 714 1785.0 ----- C ----- (3 files)</pre></blockquote></div></div></div>
+
+</div><!--Content-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile id=MSelected>Release Notes</div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="../index/General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="../index/Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="../index/BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index.html b/sw/vendor/coremark/docs/html/index.html
new file mode 100644
index 0000000..f7a8868
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index.html
@@ -0,0 +1 @@
+<html><head><meta http-equiv="Refresh" CONTENT="0; URL=files/readme-txt.html"></head></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/BuildTargets.html b/sw/vendor/coremark/docs/html/index/BuildTargets.html
new file mode 100644
index 0000000..635c0ff
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/BuildTargets.html
@@ -0,0 +1,31 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Build Target Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Build Target Index</div><div class=INavigationBar>$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · <a href="#P">P</a> · Q · R · S · T · U · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="P"></a>P</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_postbuild</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postbuild" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postbuild" id=link2 onMouseOver="ShowTip(event, 'tt1', 'link2')" onMouseOut="HideTip('tt1')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_postload</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postload" id=link3 onMouseOver="ShowTip(event, 'tt2', 'link3')" onMouseOut="HideTip('tt2')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postload" id=link4 onMouseOver="ShowTip(event, 'tt2', 'link4')" onMouseOut="HideTip('tt2')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_postrun</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postrun" id=link5 onMouseOver="ShowTip(event, 'tt3', 'link5')" onMouseOut="HideTip('tt3')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postrun" id=link6 onMouseOver="ShowTip(event, 'tt3', 'link6')" onMouseOut="HideTip('tt3')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_prebuild</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prebuild" id=link7 onMouseOver="ShowTip(event, 'tt4', 'link7')" onMouseOut="HideTip('tt4')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prebuild" id=link8 onMouseOver="ShowTip(event, 'tt4', 'link8')" onMouseOut="HideTip('tt4')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_preload</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_preload" id=link9 onMouseOver="ShowTip(event, 'tt5', 'link9')" onMouseOut="HideTip('tt5')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_preload" id=link10 onMouseOver="ShowTip(event, 'tt5', 'link10')" onMouseOut="HideTip('tt5')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_prerun</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prerun" id=link11 onMouseOver="ShowTip(event, 'tt6', 'link11')" onMouseOut="HideTip('tt6')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prerun" id=link12 onMouseOver="ShowTip(event, 'tt6', 'link12')" onMouseOut="HideTip('tt6')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CBuildTarget>Generate any files that are needed after actual build end. </div></div><div class=CToolTip id="tt2"><div class=CBuildTarget>Do platform specific after load stuff. </div></div><div class=CToolTip id="tt3"><div class=CBuildTarget>Do platform specific after run stuff. </div></div><div class=CToolTip id="tt4"><div class=CBuildTarget>Generate any files that are needed before actual build starts. </div></div><div class=CToolTip id="tt5"><div class=CBuildTarget>Do platform specific before load stuff. </div></div><div class=CToolTip id="tt6"><div class=CBuildTarget>Do platform specific after run stuff. </div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Build Targets</div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/Configuration.html b/sw/vendor/coremark/docs/html/index/Configuration.html
new file mode 100644
index 0000000..8e5ef3a
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/Configuration.html
@@ -0,0 +1,51 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Configuration Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Configuration Index</div><div class=INavigationBar>$#! · 0-9 · A · B · <a href="#C">C</a> · D · E · F · G · <a href="#H">H</a> · I · J · K · L · <a href="#M">M</a> · N · O · P · Q · R · <a href="#S">S</a> · <a href="#T">T</a> · <a href="#U">U</a> · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="C"></a>C</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#CORE_TICKS" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>CORE_TICKS</a></td></tr><tr><td class=IHeading><a name="H"></a>H</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_FLOAT" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')" class=ISymbol>HAS_FLOAT</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_PRINTF" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')" class=ISymbol>HAS_PRINTF</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_STDIO" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')" class=ISymbol>HAS_STDIO</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_TIME_H" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')" class=ISymbol>HAS_TIME_H</a></td></tr><tr><td class=IHeading><a name="M"></a>M</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NOARGC" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')" class=ISymbol>MAIN_HAS_NOARGC</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NORETURN" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')" class=ISymbol>MAIN_HAS_NORETURN</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MEM_METHOD" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')" class=ISymbol>MEM_METHOD</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MULTITHREAD" id=link9 onMouseOver="ShowTip(event, 'tt9', 'link9')" onMouseOut="HideTip('tt9')" class=ISymbol>MULTITHREAD</a></td></tr><tr><td class=IHeading><a name="S"></a>S</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#SEED_METHOD" id=link10 onMouseOver="ShowTip(event, 'tt10', 'link10')" onMouseOut="HideTip('tt10')" class=ISymbol>SEED_METHOD</a></td></tr><tr><td class=IHeading><a name="T"></a>T</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#TOTAL_DATA_SIZE" id=link11 onMouseOver="ShowTip(event, 'tt11', 'link11')" onMouseOut="HideTip('tt11')" class=ISymbol>TOTAL_DATA_SIZE</a></td></tr><tr><td class=IHeading><a name="U"></a>U</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_CLOCK" id=link12 onMouseOver="ShowTip(event, 'tt12', 'link12')" onMouseOut="HideTip('tt12')" class=ISymbol>USE_CLOCK</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_FORK" id=link13 onMouseOver="ShowTip(event, 'tt13', 'link13')" onMouseOut="HideTip('tt13')" class=ISymbol>USE_FORK</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_PTHREAD" id=link14 onMouseOver="ShowTip(event, 'tt14', 'link14')" onMouseOut="HideTip('tt14')" class=ISymbol>USE_PTHREAD</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_SOCKET" id=link15 onMouseOver="ShowTip(event, 'tt15', 'link15')" onMouseOut="HideTip('tt15')" class=ISymbol>USE_SOCKET</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CConfiguration>Define type of return from the timing functions.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt2"><div class=CConfiguration>Define to 1 if the platform supports floating point.</div></div><div class=CToolTip id="tt3"><div class=CConfiguration>Define to 1 if the platform has stdio.h and implements the printf function.</div></div><div class=CToolTip id="tt4"><div class=CConfiguration>Define to 1 if the platform has stdio.h.</div></div><div class=CToolTip id="tt5"><div class=CConfiguration>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt6"><div class=CConfiguration>Needed if platform does not support getting arguments to main.</div></div><div class=CToolTip id="tt7"><div class=CConfiguration>Needed if platform does not support returning a value from main.</div></div><div class=CToolTip id="tt8"><div class=CConfiguration>Defines method to get a block of memry.</div></div><div class=CToolTip id="tt9"><div class=CConfiguration>Define for parallel execution</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt10"><div class=CConfiguration>Defines method to get seed values that cannot be computed at compile time.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt11"><div class=CConfiguration>Define total size for data algorithms will operate on</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt12"><div class=CConfiguration>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</div></div><div class=CToolTip id="tt13"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses fork, waitpid, shmget,shmat and shmdt.</div></div><div class=CToolTip id="tt14"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses pthread_thread_create and pthread_join.</div></div><div class=CToolTip id="tt15"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses fork, socket, sendto and recvfrom</div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Configurations</div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/Configurations.html b/sw/vendor/coremark/docs/html/index/Configurations.html
new file mode 100644
index 0000000..0faee64
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/Configurations.html
@@ -0,0 +1,45 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Configuration Index</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Generated by Natural Docs, version Development Release 01-12-2008 (1.35 base) -->
+<!-- http://www.naturaldocs.org -->
+
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Configuration Index</div><div class=INavigationBar>$#! · 0-9 · A · B · C · D · E · F · G · <a href="#H">H</a> · I · J · K · L · <a href="#M">M</a> · N · O · P · Q · R · <a href="#S">S</a> · <a href="#T">T</a> · U · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="H"></a>H</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#HAS_FLOAT" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>HAS_FLOAT</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#HAS_STDIO" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')" class=ISymbol>HAS_STDIO</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#HAS_TIME_H" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')" class=ISymbol>HAS_TIME_H</a></td></tr><tr><td class=IHeading><a name="M"></a>M</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#MEM_METHOD" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')" class=ISymbol>MEM_METHOD</a></td></tr><tr><td class=IHeading><a name="S"></a>S</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#SEED_METHOD" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')" class=ISymbol>SEED_METHOD</a></td></tr><tr><td class=IHeading><a name="T"></a>T</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#TOTAL_DATA_SIZE" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')" class=ISymbol>TOTAL_DATA_SIZE</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CConfiguration>Define to 1 if the platform supports floating point.</div></div><div class=CToolTip id="tt2"><div class=CConfiguration>Define to 1 if the platform has stdio.h and implements the printf function.</div></div><div class=CToolTip id="tt3"><div class=CConfiguration>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt4"><div class=CConfiguration>Defines method to get a block of memry. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt5"><div class=CConfiguration>Defines method to get seed values that cannot be computed at compile time. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt6"><div class=CConfiguration>Define total size for data algorithms will operate on</div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Generated by Natural Docs</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark Version 0.1a</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_list-c.html">core_list.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_portme-c.html">core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_results</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Index</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="Classes.html">Classes</a></div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Configurations</div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="Classes">Classes</option><option value="Configurations">Configurations</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/Files.html b/sw/vendor/coremark/docs/html/index/Files.html
new file mode 100644
index 0000000..7e6d2fa
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/Files.html
@@ -0,0 +1,35 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>File Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>File Index</div><div class=INavigationBar>$#! · 0-9 · A · B · <a href="#C">C</a> · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · <a href="#R">R</a> · S · T · U · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="C"></a>C</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_join.c" class=ISymbol>core_list_join.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_main-c.html#core_main.c" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>core_main.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#core_matrix.c" class=ISymbol>core_matrix.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#core_portme.c" class=ISymbol>core_portme.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#core_portme.h" class=ISymbol>core_portme.h</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>core_portme.mak</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#core_portme.mak" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#core_portme.mak" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_state.c" class=ISymbol>core_state.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_util-c.html#core_util.c" class=ISymbol>core_util.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#CoreMark" class=ISymbol>CoreMark</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#coremark.h" class=ISymbol>coremark.h</a></td></tr><tr><td class=IHeading><a name="R"></a>R</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/release_notes-txt.html#Release_Notes" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')" class=ISymbol>Release Notes</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFile>This file contains the framework to acquire a block of memory, seed initial parameters, tun t he benchmark and report the results.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt2"><div class=CFile>Version: 1.01</div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Files</div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/Functions.html b/sw/vendor/coremark/docs/html/index/Functions.html
new file mode 100644
index 0000000..a249d51
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/Functions.html
@@ -0,0 +1,55 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Function Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Function Index</div><div class=INavigationBar>$#! · 0-9 · A · B · <a href="#C">C</a> · D · E · F · <a href="#G">G</a> · H · <a href="#I">I</a> · J · K · L · <a href="#M">M</a> · N · O · <a href="#P">P</a> · Q · R · <a href="#S">S</a> · <a href="#T">T</a> · U · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="C"></a>C</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#cmp_complex" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>cmp_complex</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#cmp_idx" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')" class=ISymbol>cmp_idx</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#core_bench_matrix" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')" class=ISymbol>core_bench_matrix</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_bench_state" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')" class=ISymbol>core_bench_state</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_init_state" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')" class=ISymbol>core_init_state</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_find" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')" class=ISymbol>core_list_find</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_init" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')" class=ISymbol>core_list_init</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_insert" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')" class=ISymbol>core_list_insert</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_mergesort" id=link9 onMouseOver="ShowTip(event, 'tt9', 'link9')" onMouseOut="HideTip('tt9')" class=ISymbol>core_list_mergesort</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_remove" id=link10 onMouseOver="ShowTip(event, 'tt10', 'link10')" onMouseOut="HideTip('tt10')" class=ISymbol>core_list_remove</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_reverse" id=link11 onMouseOver="ShowTip(event, 'tt11', 'link11')" onMouseOut="HideTip('tt11')" class=ISymbol>core_list_reverse</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_undo_remove" id=link12 onMouseOver="ShowTip(event, 'tt12', 'link12')" onMouseOut="HideTip('tt12')" class=ISymbol>core_list_undo_remove</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#core_start_parallel" id=link13 onMouseOver="ShowTip(event, 'tt13', 'link13')" onMouseOut="HideTip('tt13')" class=ISymbol>core_start_parallel</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_state_transition" id=link14 onMouseOver="ShowTip(event, 'tt14', 'link14')" onMouseOut="HideTip('tt14')" class=ISymbol>core_state_transition</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#core_stop_parallel" id=link15 onMouseOver="ShowTip(event, 'tt15', 'link15')" onMouseOut="HideTip('tt15')" class=ISymbol>core_stop_parallel</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/core_util-c.html#crc*" id=link16 onMouseOver="ShowTip(event, 'tt16', 'link16')" onMouseOut="HideTip('tt16')" class=ISymbol>crc*</a></td></tr><tr><td class=IHeading><a name="G"></a>G</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/core_util-c.html#get_seed" id=link17 onMouseOver="ShowTip(event, 'tt17', 'link17')" onMouseOut="HideTip('tt17')" class=ISymbol>get_seed</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#get_time" id=link18 onMouseOver="ShowTip(event, 'tt18', 'link18')" onMouseOut="HideTip('tt18')" class=ISymbol>get_time</a></td></tr><tr><td class=IHeading><a name="I"></a>I</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/core_main-c.html#iterate" id=link19 onMouseOver="ShowTip(event, 'tt19', 'link19')" onMouseOut="HideTip('tt19')" class=ISymbol>iterate</a></td></tr><tr><td class=IHeading><a name="M"></a>M</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/core_main-c.html#main" id=link20 onMouseOver="ShowTip(event, 'tt20', 'link20')" onMouseOut="HideTip('tt20')" class=ISymbol>main</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_add_const" id=link21 onMouseOver="ShowTip(event, 'tt21', 'link21')" onMouseOut="HideTip('tt21')" class=ISymbol>matrix_add_const</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_const" id=link22 onMouseOver="ShowTip(event, 'tt22', 'link22')" onMouseOut="HideTip('tt22')" class=ISymbol>matrix_mul_const</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix" id=link23 onMouseOver="ShowTip(event, 'tt23', 'link23')" onMouseOut="HideTip('tt23')" class=ISymbol>matrix_mul_matrix</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix_bitextract" id=link24 onMouseOver="ShowTip(event, 'tt24', 'link24')" onMouseOut="HideTip('tt24')" class=ISymbol>matrix_mul_matrix_bitextract</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_vect" id=link25 onMouseOver="ShowTip(event, 'tt25', 'link25')" onMouseOut="HideTip('tt25')" class=ISymbol>matrix_mul_vect</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_sum" id=link26 onMouseOver="ShowTip(event, 'tt26', 'link26')" onMouseOut="HideTip('tt26')" class=ISymbol>matrix_sum</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_test" id=link27 onMouseOver="ShowTip(event, 'tt27', 'link27')" onMouseOut="HideTip('tt27')" class=ISymbol>matrix_test</a></td></tr><tr><td class=IHeading><a name="P"></a>P</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_fini" id=link28 onMouseOver="ShowTip(event, 'tt28', 'link28')" onMouseOut="HideTip('tt28')" class=ISymbol>portable_fini</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_free" id=link29 onMouseOver="ShowTip(event, 'tt29', 'link29')" onMouseOut="HideTip('tt29')" class=ISymbol>portable_free</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_init" id=link30 onMouseOver="ShowTip(event, 'tt30', 'link30')" onMouseOut="HideTip('tt30')" class=ISymbol>portable_init</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_malloc" id=link31 onMouseOver="ShowTip(event, 'tt31', 'link31')" onMouseOut="HideTip('tt31')" class=ISymbol>portable_malloc</a></td></tr><tr><td class=IHeading><a name="S"></a>S</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#start_time" id=link32 onMouseOver="ShowTip(event, 'tt32', 'link32')" onMouseOut="HideTip('tt32')" class=ISymbol>start_time</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#stop_time" id=link33 onMouseOver="ShowTip(event, 'tt33', 'link33')" onMouseOut="HideTip('tt33')" class=ISymbol>stop_time</a></td></tr><tr><td class=IHeading><a name="T"></a>T</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#time_in_secs" id=link34 onMouseOver="ShowTip(event, 'tt34', 'link34')" onMouseOut="HideTip('tt34')" class=ISymbol>time_in_secs</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_complex(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Compare the data item in a list cell.</div></div><div class=CToolTip id="tt2"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_idx(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Compare the idx item in a list cell, and regen the data.</div></div><div class=CToolTip id="tt3"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_matrix(</td><td class=PType nowrap>mat_params </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Benchmark function</div></div><div class=CToolTip id="tt4"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed1,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed2,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>step,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Benchmark function</div></div><div class=CToolTip id="tt5"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void core_init_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>size,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Initialize the input data for the state machine.</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_find(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Find an item in the list</div></div><div class=CToolTip id="tt7"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_init(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Initialize list with data.</div></div><div class=CToolTip id="tt8"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_insert_new(</td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>insert_point,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>**</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PTypePrefix nowrap>list_data </td><td class=PType nowrap>**datablock </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock_end,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>datablock_end</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Insert an item to the list</div></div><div class=CToolTip id="tt9"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_mergesort(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_cmp </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>cmp,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Sort the list in place without recursion.</div></div><div class=CToolTip id="tt10"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Remove an item from the list.</div></div><div class=CToolTip id="tt11"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_reverse(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Reverse a list</div></div><div class=CToolTip id="tt12"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_undo_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_removed,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_modified</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Undo a remove operation.</div></div><div class=CToolTip id="tt13"><div class=CFunction>Start benchmarking in a parallel context.</div></div><div class=CToolTip id="tt14"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>enum CORE_STATE core_state_transition(</td><td class=PTypePrefix nowrap>ee_u8 </td><td class=PType nowrap>**instr </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>transition_count</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Actual state machine.</div></div><div class=CToolTip id="tt15"><div class=CFunction>Stop a parallel context execution of coremark, and gather the results.</div></div><div class=CToolTip id="tt16"><div class=CFunction>Service functions to calculate 16b CRC code.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt17"><div class=CFunction>Get a values that cannot be determined at compile time.</div></div><div class=CToolTip id="tt18"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>CORE_TICKS get_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Return an abstract “ticks” number that signifies time on the system.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt19"><div class=CFunction>Run the benchmark for a specified number of iterations.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt20"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>#if MAIN_HAS_NOARGC MAIN_RETURN_TYPE main(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Main entry routine for the benchmark. </div></div><div class=CToolTip id="tt21"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_add_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Add a constant value to all elements of a matrix.</div></div><div class=CToolTip id="tt22"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a constant. </div></div><div class=CToolTip id="tt23"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a matrix. </div></div><div class=CToolTip id="tt24"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix_bitextract(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a matrix, and extract some bits from the result. </div></div><div class=CToolTip id="tt25"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_vect(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a vector. </div></div><div class=CToolTip id="tt26"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_sum(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>clipval</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Calculate a function that depends on the values of elements in the matrix.</div></div><div class=CToolTip id="tt27"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_test(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Perform matrix manipulation.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt28"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_fini(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific final code</div></div><div class=CToolTip id="tt29"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_free(</td><td class=PType nowrap>void </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Provide free() functionality in a platform specific way.</div></div><div class=CToolTip id="tt30"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_init(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>int </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argc,</td></tr><tr><td></td><td class=PType nowrap>char </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argv[]</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific initialization code Test for some common mistakes.</div></div><div class=CToolTip id="tt31"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void *portable_malloc(</td><td class=PType nowrap>size_t </td><td class=PParameter nowrap>size</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Provide malloc() functionality in a platform specific way.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt32"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void start_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>This function will be called right before starting the timed portion of the benchmark.</div></div><div class=CToolTip id="tt33"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void stop_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>This function will be called right after ending the timed portion of the benchmark.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt34"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>secs_ret time_in_secs(</td><td class=PType nowrap>CORE_TICKS </td><td class=PParameter nowrap>ticks</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Convert the value returned by get_time to seconds.</div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Functions</div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/General.html b/sw/vendor/coremark/docs/html/index/General.html
new file mode 100644
index 0000000..bd47b29
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/General.html
@@ -0,0 +1,75 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Index</div><div class=INavigationBar>$#! · 0-9 · A · <a href="#B">B</a> · <a href="#C">C</a> · <a href="#D">D</a> · E · <a href="#F">F</a> · <a href="#G">G</a> · <a href="#H">H</a> · <a href="#I">I</a> · J · K · <a href="#L">L</a> · <a href="#M">M</a> · N · <a href="#O">O</a> · <a href="#P">P</a> · Q · <a href="#R">R</a> · <a href="General2.html#S">S</a> · <a href="General2.html#T">T</a> · <a href="General2.html#U">U</a> · <a href="General2.html#V">V</a> · <a href="General2.html#W">W</a> · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="B"></a>B</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>Build Targets</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#Build_Targets" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#Build_Targets" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Building_and_running" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>Building and running</a></td></tr><tr><td class=IHeading><a name="C"></a>C</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#CC" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')" class=ISymbol>CC</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>CFLAGS</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#CFLAGS" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#CFLAGS" id=link4 onMouseOver="ShowTip(event, 'tt3', 'link4')" onMouseOut="HideTip('tt3')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#cmp_complex" id=link5 onMouseOver="ShowTip(event, 'tt4', 'link5')" onMouseOut="HideTip('tt4')" class=ISymbol>cmp_complex</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#cmp_idx" id=link6 onMouseOver="ShowTip(event, 'tt5', 'link6')" onMouseOut="HideTip('tt5')" class=ISymbol>cmp_idx</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>Configuration</span><div class=ISubIndex><a href="../files/coremark-h.html#Configuration" class=IFile>coremark.h</a><a href="../files/linux/core_portme-h.html#Configuration" class=IFile>linux/<span class=HB> </span>core_portme.h</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#core_bench_matrix" id=link7 onMouseOver="ShowTip(event, 'tt6', 'link7')" onMouseOut="HideTip('tt6')" class=ISymbol>core_bench_matrix</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_bench_state" id=link8 onMouseOver="ShowTip(event, 'tt7', 'link8')" onMouseOut="HideTip('tt7')" class=ISymbol>core_bench_state</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_init_state" id=link9 onMouseOver="ShowTip(event, 'tt8', 'link9')" onMouseOut="HideTip('tt8')" class=ISymbol>core_init_state</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_find" id=link10 onMouseOver="ShowTip(event, 'tt9', 'link10')" onMouseOut="HideTip('tt9')" class=ISymbol>core_list_find</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_init" id=link11 onMouseOver="ShowTip(event, 'tt10', 'link11')" onMouseOut="HideTip('tt10')" class=ISymbol>core_list_init</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_insert" id=link12 onMouseOver="ShowTip(event, 'tt11', 'link12')" onMouseOut="HideTip('tt11')" class=ISymbol>core_list_insert</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_join.c" class=ISymbol>core_list_join.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_mergesort" id=link13 onMouseOver="ShowTip(event, 'tt12', 'link13')" onMouseOut="HideTip('tt12')" class=ISymbol>core_list_mergesort</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_remove" id=link14 onMouseOver="ShowTip(event, 'tt13', 'link14')" onMouseOut="HideTip('tt13')" class=ISymbol>core_list_remove</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_reverse" id=link15 onMouseOver="ShowTip(event, 'tt14', 'link15')" onMouseOut="HideTip('tt14')" class=ISymbol>core_list_reverse</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_list_join-c.html#core_list_undo_remove" id=link16 onMouseOver="ShowTip(event, 'tt15', 'link16')" onMouseOut="HideTip('tt15')" class=ISymbol>core_list_undo_remove</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_main-c.html#core_main.c" id=link17 onMouseOver="ShowTip(event, 'tt16', 'link17')" onMouseOut="HideTip('tt16')" class=ISymbol>core_main.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#core_matrix.c" class=ISymbol>core_matrix.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#core_portme.c" class=ISymbol>core_portme.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#core_portme.h" class=ISymbol>core_portme.h</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>core_portme.mak</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#core_portme.mak" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#core_portme.mak" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#core_start_parallel" id=link18 onMouseOver="ShowTip(event, 'tt17', 'link18')" onMouseOut="HideTip('tt17')" class=ISymbol>core_start_parallel</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_state.c" class=ISymbol>core_state.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_state-c.html#core_state_transition" id=link19 onMouseOver="ShowTip(event, 'tt18', 'link19')" onMouseOut="HideTip('tt18')" class=ISymbol>core_state_transition</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#core_stop_parallel" id=link20 onMouseOver="ShowTip(event, 'tt19', 'link20')" onMouseOut="HideTip('tt19')" class=ISymbol>core_stop_parallel</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#CORE_TICKS" id=link21 onMouseOver="ShowTip(event, 'tt20', 'link21')" onMouseOut="HideTip('tt20')" class=ISymbol>CORE_TICKS</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_util-c.html#core_util.c" class=ISymbol>core_util.c</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#CoreMark" class=ISymbol>CoreMark</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#coremark.h" class=ISymbol>coremark.h</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_util-c.html#crc*" id=link22 onMouseOver="ShowTip(event, 'tt21', 'link22')" onMouseOut="HideTip('tt21')" class=ISymbol>crc*</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Credits" id=link23 onMouseOver="ShowTip(event, 'tt22', 'link23')" onMouseOut="HideTip('tt22')" class=ISymbol>Credits</a></td></tr><tr><td class=IHeading><a name="D"></a>D</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#default_num_contexts" id=link24 onMouseOver="ShowTip(event, 'tt23', 'link24')" onMouseOut="HideTip('tt23')" class=ISymbol>default_num_contexts</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>Description</span><div class=ISubIndex><a href="../files/core_list_join-c.html#Description" id=link25 onMouseOver="ShowTip(event, 'tt24', 'link25')" onMouseOut="HideTip('tt24')" class=IFile>core_list_join.c</a><a href="../files/core_matrix-c.html#Description" id=link26 onMouseOver="ShowTip(event, 'tt24', 'link26')" onMouseOut="HideTip('tt24')" class=IFile>core_matrix.c</a><a href="../files/core_state-c.html#Description" id=link27 onMouseOver="ShowTip(event, 'tt24', 'link27')" onMouseOut="HideTip('tt24')" class=IFile>core_state.c</a><a href="../files/coremark-h.html#Description" id=link28 onMouseOver="ShowTip(event, 'tt24', 'link28')" onMouseOut="HideTip('tt24')" class=IFile>coremark.h</a><a href="../files/linux/core_portme-h.html#Description" id=link29 onMouseOver="ShowTip(event, 'tt24', 'link29')" onMouseOut="HideTip('tt24')" class=IFile>linux/<span class=HB> </span>core_portme.h</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Documentation" id=link30 onMouseOver="ShowTip(event, 'tt25', 'link30')" onMouseOut="HideTip('tt25')" class=ISymbol>Documentation</a></td></tr><tr><td class=IHeading><a name="F"></a>F</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><span class=ISymbol>Functions</span><div class=ISubIndex><a href="../files/core_list_join-c.html#Functions" class=IFile>core_list_join.c</a><a href="../files/core_main-c.html#Functions" class=IFile>core_main.c</a><a href="../files/core_matrix-c.html#Functions" class=IFile>core_matrix.c</a><a href="../files/core_state-c.html#Functions" class=IFile>core_state.c</a><a href="../files/core_util-c.html#Functions" class=IFile>core_util.c</a></div></td></tr><tr><td class=IHeading><a name="G"></a>G</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/core_util-c.html#get_seed" id=link31 onMouseOver="ShowTip(event, 'tt26', 'link31')" onMouseOut="HideTip('tt26')" class=ISymbol>get_seed</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#get_time" id=link32 onMouseOver="ShowTip(event, 'tt27', 'link32')" onMouseOut="HideTip('tt27')" class=ISymbol>get_time</a></td></tr><tr><td class=IHeading><a name="H"></a>H</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_FLOAT" id=link33 onMouseOver="ShowTip(event, 'tt28', 'link33')" onMouseOut="HideTip('tt28')" class=ISymbol>HAS_FLOAT</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_PRINTF" id=link34 onMouseOver="ShowTip(event, 'tt29', 'link34')" onMouseOut="HideTip('tt29')" class=ISymbol>HAS_PRINTF</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_STDIO" id=link35 onMouseOver="ShowTip(event, 'tt30', 'link35')" onMouseOut="HideTip('tt30')" class=ISymbol>HAS_STDIO</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#HAS_TIME_H" id=link36 onMouseOver="ShowTip(event, 'tt31', 'link36')" onMouseOut="HideTip('tt31')" class=ISymbol>HAS_TIME_H</a></td></tr><tr><td class=IHeading><a name="I"></a>I</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/core_main-c.html#iterate" id=link37 onMouseOver="ShowTip(event, 'tt32', 'link37')" onMouseOut="HideTip('tt32')" class=ISymbol>iterate</a></td></tr><tr><td class=IHeading><a name="L"></a>L</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Legal" id=link38 onMouseOver="ShowTip(event, 'tt33', 'link38')" onMouseOut="HideTip('tt33')" class=ISymbol>Legal</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>LFLAGS_END</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#LFLAGS_END" id=link39 onMouseOver="ShowTip(event, 'tt34', 'link39')" onMouseOut="HideTip('tt34')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#LFLAGS_END" id=link40 onMouseOver="ShowTip(event, 'tt34', 'link40')" onMouseOut="HideTip('tt34')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#LOAD" id=link41 onMouseOver="ShowTip(event, 'tt35', 'link41')" onMouseOut="HideTip('tt35')" class=ISymbol>LOAD</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Log_File_Format" id=link42 onMouseOver="ShowTip(event, 'tt36', 'link42')" onMouseOut="HideTip('tt36')" class=ISymbol>Log File Format</a></td></tr><tr><td class=IHeading><a name="M"></a>M</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/core_main-c.html#main" id=link43 onMouseOver="ShowTip(event, 'tt37', 'link43')" onMouseOut="HideTip('tt37')" class=ISymbol>main</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NOARGC" id=link44 onMouseOver="ShowTip(event, 'tt38', 'link44')" onMouseOut="HideTip('tt38')" class=ISymbol>MAIN_HAS_NOARGC</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NORETURN" id=link45 onMouseOver="ShowTip(event, 'tt39', 'link45')" onMouseOut="HideTip('tt39')" class=ISymbol>MAIN_HAS_NORETURN</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_add_const" id=link46 onMouseOver="ShowTip(event, 'tt40', 'link46')" onMouseOut="HideTip('tt40')" class=ISymbol>matrix_add_const</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_const" id=link47 onMouseOver="ShowTip(event, 'tt41', 'link47')" onMouseOut="HideTip('tt41')" class=ISymbol>matrix_mul_const</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix" id=link48 onMouseOver="ShowTip(event, 'tt42', 'link48')" onMouseOut="HideTip('tt42')" class=ISymbol>matrix_mul_matrix</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix_bitextract" id=link49 onMouseOver="ShowTip(event, 'tt43', 'link49')" onMouseOut="HideTip('tt43')" class=ISymbol>matrix_mul_matrix_bitextract</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_vect" id=link50 onMouseOver="ShowTip(event, 'tt44', 'link50')" onMouseOut="HideTip('tt44')" class=ISymbol>matrix_mul_vect</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_sum" id=link51 onMouseOver="ShowTip(event, 'tt45', 'link51')" onMouseOut="HideTip('tt45')" class=ISymbol>matrix_sum</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/core_matrix-c.html#matrix_test" id=link52 onMouseOver="ShowTip(event, 'tt46', 'link52')" onMouseOut="HideTip('tt46')" class=ISymbol>matrix_test</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MEM_METHOD" id=link53 onMouseOver="ShowTip(event, 'tt47', 'link53')" onMouseOut="HideTip('tt47')" class=ISymbol>MEM_METHOD</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#MULTITHREAD" id=link54 onMouseOver="ShowTip(event, 'tt48', 'link54')" onMouseOut="HideTip('tt48')" class=ISymbol>MULTITHREAD</a></td></tr><tr><td class=IHeading><a name="O"></a>O</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>OPATH</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OPATH" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OPATH" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><span class=ISymbol>OUTFLAG</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OUTFLAG" id=link55 onMouseOver="ShowTip(event, 'tt49', 'link55')" onMouseOut="HideTip('tt49')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OUTFLAG" id=link56 onMouseOver="ShowTip(event, 'tt49', 'link56')" onMouseOut="HideTip('tt49')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=IHeading><a name="P"></a>P</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>PERL</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PERL" id=link57 onMouseOver="ShowTip(event, 'tt50', 'link57')" onMouseOut="HideTip('tt50')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PERL" id=link58 onMouseOver="ShowTip(event, 'tt50', 'link58')" onMouseOut="HideTip('tt50')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>PORT_OBJS</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PORT_OBJS" id=link59 onMouseOver="ShowTip(event, 'tt51', 'link59')" onMouseOut="HideTip('tt51')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PORT_OBJS" id=link60 onMouseOver="ShowTip(event, 'tt51', 'link60')" onMouseOut="HideTip('tt51')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_postbuild</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postbuild" id=link61 onMouseOver="ShowTip(event, 'tt52', 'link61')" onMouseOut="HideTip('tt52')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postbuild" id=link62 onMouseOver="ShowTip(event, 'tt52', 'link62')" onMouseOut="HideTip('tt52')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_postload</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postload" id=link63 onMouseOver="ShowTip(event, 'tt53', 'link63')" onMouseOut="HideTip('tt53')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postload" id=link64 onMouseOver="ShowTip(event, 'tt53', 'link64')" onMouseOut="HideTip('tt53')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_postrun</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postrun" id=link65 onMouseOver="ShowTip(event, 'tt54', 'link65')" onMouseOut="HideTip('tt54')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postrun" id=link66 onMouseOver="ShowTip(event, 'tt54', 'link66')" onMouseOut="HideTip('tt54')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_prebuild</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prebuild" id=link67 onMouseOver="ShowTip(event, 'tt55', 'link67')" onMouseOut="HideTip('tt55')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prebuild" id=link68 onMouseOver="ShowTip(event, 'tt55', 'link68')" onMouseOut="HideTip('tt55')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_preload</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_preload" id=link69 onMouseOver="ShowTip(event, 'tt56', 'link69')" onMouseOut="HideTip('tt56')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_preload" id=link70 onMouseOver="ShowTip(event, 'tt56', 'link70')" onMouseOut="HideTip('tt56')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>port_prerun</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prerun" id=link71 onMouseOver="ShowTip(event, 'tt57', 'link71')" onMouseOut="HideTip('tt57')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prerun" id=link72 onMouseOver="ShowTip(event, 'tt57', 'link72')" onMouseOut="HideTip('tt57')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#PORT_SRCS" id=link73 onMouseOver="ShowTip(event, 'tt58', 'link73')" onMouseOut="HideTip('tt58')" class=ISymbol>PORT_SRCS</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_fini" id=link74 onMouseOver="ShowTip(event, 'tt59', 'link74')" onMouseOut="HideTip('tt59')" class=ISymbol>portable_fini</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_free" id=link75 onMouseOver="ShowTip(event, 'tt60', 'link75')" onMouseOut="HideTip('tt60')" class=ISymbol>portable_free</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_init" id=link76 onMouseOver="ShowTip(event, 'tt61', 'link76')" onMouseOut="HideTip('tt61')" class=ISymbol>portable_init</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#portable_malloc" id=link77 onMouseOver="ShowTip(event, 'tt62', 'link77')" onMouseOut="HideTip('tt62')" class=ISymbol>portable_malloc</a></td></tr><tr><td class=IHeading><a name="R"></a>R</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/release_notes-txt.html#Release_Notes" id=link78 onMouseOver="ShowTip(event, 'tt63', 'link78')" onMouseOut="HideTip('tt63')" class=ISymbol>Release Notes</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Reporting_rules" id=link79 onMouseOver="ShowTip(event, 'tt64', 'link79')" onMouseOut="HideTip('tt64')" class=ISymbol>Reporting rules</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#RUN" id=link80 onMouseOver="ShowTip(event, 'tt65', 'link80')" onMouseOut="HideTip('tt65')" class=ISymbol>RUN</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Run_rules" id=link81 onMouseOver="ShowTip(event, 'tt66', 'link81')" onMouseOut="HideTip('tt66')" class=ISymbol>Run rules</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CGeneric>Download the release files from the www.coremark.org. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt2"><div class=CVariable>Use this flag to define compiler to use</div></div><div class=CToolTip id="tt3"><div class=CVariable>Use this flag to define compiler options. </div></div><div class=CToolTip id="tt4"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_complex(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Compare the data item in a list cell.</div></div><div class=CToolTip id="tt5"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s32 cmp_idx(</td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>a,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>b,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Compare the idx item in a list cell, and regen the data.</div></div><div class=CToolTip id="tt6"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_matrix(</td><td class=PType nowrap>mat_params </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Benchmark function</div></div><div class=CToolTip id="tt7"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_u16 core_bench_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed1,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed2,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>step,</td></tr><tr><td></td><td class=PType nowrap>ee_u16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>crc</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Benchmark function</div></div><div class=CToolTip id="tt8"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void core_init_state(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>size,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed,</td></tr><tr><td></td><td class=PType nowrap>ee_u8 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Initialize the input data for the state machine.</div></div><div class=CToolTip id="tt9"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_find(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Find an item in the list</div></div><div class=CToolTip id="tt10"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_init(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>blksize,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PType nowrap>ee_s16 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>seed</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Initialize list with data.</div></div><div class=CToolTip id="tt11"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_insert_new(</td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>insert_point,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>info,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>**</td><td class=PParameter nowrap>memblock,</td></tr><tr><td></td><td class=PTypePrefix nowrap>list_data </td><td class=PType nowrap>**datablock </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>memblock_end,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>list_data </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>datablock_end</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Insert an item to the list</div></div><div class=CToolTip id="tt12"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_mergesort(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list,</td></tr><tr><td></td><td class=PType nowrap>list_cmp </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>cmp,</td></tr><tr><td></td><td class=PType nowrap>core_results </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>res</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Sort the list in place without recursion.</div></div><div class=CToolTip id="tt13"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Remove an item from the list.</div></div><div class=CToolTip id="tt14"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_reverse(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>list</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Reverse a list</div></div><div class=CToolTip id="tt15"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>list_head *core_list_undo_remove(</td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_removed,</td></tr><tr><td></td><td class=PType nowrap>list_head </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>item_modified</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Undo a remove operation.</div></div><div class=CToolTip id="tt16"><div class=CFile>This file contains the framework to acquire a block of memory, seed initial parameters, tun t he benchmark and report the results.</div></div><div class=CToolTip id="tt17"><div class=CFunction>Start benchmarking in a parallel context.</div></div><div class=CToolTip id="tt18"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>enum CORE_STATE core_state_transition(</td><td class=PTypePrefix nowrap>ee_u8 </td><td class=PType nowrap>**instr </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>,</td></tr><tr><td></td><td class=PTypePrefix nowrap></td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>transition_count</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Actual state machine.</div></div><div class=CToolTip id="tt19"><div class=CFunction>Stop a parallel context execution of coremark, and gather the results.</div></div><div class=CToolTip id="tt20"><div class=CConfiguration>Define type of return from the timing functions.</div></div><div class=CToolTip id="tt21"><div class=CFunction>Service functions to calculate 16b CRC code.</div></div><div class=CToolTip id="tt22"><div class=CGeneric>Many thanks to all of the individuals who helped with the development or testing of CoreMark including (Sorted by company name)</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt23"><div class=CVariable><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td>extern ee_u32 default_num_contexts</td></tr></table></blockquote>Number of contexts to spawn in multicore context. </div></div><div class=CToolTip id="tt24"><div class=CGeneric>Benchmark using a linked list.</div></div><div class=CToolTip id="tt25"><div class=CGeneric>When you unpack the documentation (tar -vzxf coremark_version_docs.tgz) a docs folder will be created. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt26"><div class=CFunction>Get a values that cannot be determined at compile time.</div></div><div class=CToolTip id="tt27"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>CORE_TICKS get_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Return an abstract “ticks” number that signifies time on the system.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt28"><div class=CConfiguration>Define to 1 if the platform supports floating point.</div></div><div class=CToolTip id="tt29"><div class=CConfiguration>Define to 1 if the platform has stdio.h and implements the printf function.</div></div><div class=CToolTip id="tt30"><div class=CConfiguration>Define to 1 if the platform has stdio.h.</div></div><div class=CToolTip id="tt31"><div class=CConfiguration>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt32"><div class=CFunction>Run the benchmark for a specified number of iterations.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt33"><div class=CGeneric>See LICENSE.txt or the word document file under docs/LICENSE.doc. </div></div><div class=CToolTip id="tt34"><div class=CVariable>Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. </div></div><div class=CToolTip id="tt35"><div class=CVariable>Define this flag if you need to load to a target, as in a cross compile environment.</div></div><div class=CToolTip id="tt36"><div class=CGeneric>The log files have the following format</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt37"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>#if MAIN_HAS_NOARGC MAIN_RETURN_TYPE main(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Main entry routine for the benchmark. </div></div><div class=CToolTip id="tt38"><div class=CConfiguration>Needed if platform does not support getting arguments to main.</div></div><div class=CToolTip id="tt39"><div class=CConfiguration>Needed if platform does not support returning a value from main.</div></div><div class=CToolTip id="tt40"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_add_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Add a constant value to all elements of a matrix.</div></div><div class=CToolTip id="tt41"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_const(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a constant. </div></div><div class=CToolTip id="tt42"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a matrix. </div></div><div class=CToolTip id="tt43"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_matrix_bitextract(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a matrix, and extract some bits from the result. </div></div><div class=CToolTip id="tt44"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void matrix_mul_vect(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Multiply a matrix by a vector. </div></div><div class=CToolTip id="tt45"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_sum(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>clipval</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Calculate a function that depends on the values of elements in the matrix.</div></div><div class=CToolTip id="tt46"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>ee_s16 matrix_test(</td><td class=PType nowrap>ee_u32 </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>N,</td></tr><tr><td></td><td class=PType nowrap>MATRES </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>C,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>A,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>B,</td></tr><tr><td></td><td class=PType nowrap>MATDAT </td><td class=PParameterPrefix nowrap></td><td class=PParameter nowrap>val</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Perform matrix manipulation.</div></div><div class=CToolTip id="tt47"><div class=CConfiguration>Defines method to get a block of memry.</div></div><div class=CToolTip id="tt48"><div class=CConfiguration>Define for parallel execution</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt49"><div class=CVariable>Use this flag to define how to to get an executable (e.g -o)</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt50"><div class=CVariable>Define perl executable to calculate the geomean if running separate.</div></div><div class=CToolTip id="tt51"><div class=CVariable>Port specific object files can be added here</div></div><div class=CToolTip id="tt52"><div class=CBuildTarget>Generate any files that are needed after actual build end. </div></div><div class=CToolTip id="tt53"><div class=CBuildTarget>Do platform specific after load stuff. </div></div><div class=CToolTip id="tt54"><div class=CBuildTarget>Do platform specific after run stuff. </div></div><div class=CToolTip id="tt55"><div class=CBuildTarget>Generate any files that are needed before actual build starts. </div></div><div class=CToolTip id="tt56"><div class=CBuildTarget>Do platform specific before load stuff. </div></div><div class=CToolTip id="tt57"><div class=CBuildTarget>Do platform specific after run stuff. </div></div><div class=CToolTip id="tt58"><div class=CVariable>Port specific source files can be added here</div></div><div class=CToolTip id="tt59"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_fini(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific final code</div></div><div class=CToolTip id="tt60"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_free(</td><td class=PType nowrap>void </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Provide free() functionality in a platform specific way.</div></div><div class=CToolTip id="tt61"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void portable_init(</td><td class=PType nowrap>core_portable </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>p,</td></tr><tr><td></td><td class=PType nowrap>int </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argc,</td></tr><tr><td></td><td class=PType nowrap>char </td><td class=PParameterPrefix nowrap>*</td><td class=PParameter nowrap>argv[]</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Target specific initialization code Test for some common mistakes.</div></div><div class=CToolTip id="tt62"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void *portable_malloc(</td><td class=PType nowrap>size_t </td><td class=PParameter nowrap>size</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Provide malloc() functionality in a platform specific way.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt63"><div class=CFile>Version: 1.01</div></div><div class=CToolTip id="tt64"><div class=CGeneric>How to report results on a data sheet?</div></div><div class=CToolTip id="tt65"><div class=CVariable>Define this flag if running does not consist of simple invocation of the binary. </div></div><div class=CToolTip id="tt66"><div class=CGeneric>What is and is not allowed.</div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex id=MSelected>Everything</div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/General2.html b/sw/vendor/coremark/docs/html/index/General2.html
new file mode 100644
index 0000000..3852ab5
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/General2.html
@@ -0,0 +1,47 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Index</div><div class=INavigationBar>$#! · 0-9 · A · <a href="General.html#B">B</a> · <a href="General.html#C">C</a> · <a href="General.html#D">D</a> · E · <a href="General.html#F">F</a> · <a href="General.html#G">G</a> · <a href="General.html#H">H</a> · <a href="General.html#I">I</a> · J · K · <a href="General.html#L">L</a> · <a href="General.html#M">M</a> · N · <a href="General.html#O">O</a> · <a href="General.html#P">P</a> · Q · <a href="General.html#R">R</a> · <a href="#S">S</a> · <a href="#T">T</a> · <a href="#U">U</a> · <a href="#V">V</a> · <a href="#W">W</a> · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="S"></a>S</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#secs_ret" id=link82 onMouseOver="ShowTip(event, 'tt67', 'link82')" onMouseOut="HideTip('tt67')" class=ISymbol>secs_ret</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#SEED_METHOD" id=link83 onMouseOver="ShowTip(event, 'tt68', 'link83')" onMouseOut="HideTip('tt68')" class=ISymbol>SEED_METHOD</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>SEPARATE_COMPILE</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#SEPARATE_COMPILE" id=link84 onMouseOver="ShowTip(event, 'tt69', 'link84')" onMouseOut="HideTip('tt69')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#SEPARATE_COMPILE" id=link85 onMouseOver="ShowTip(event, 'tt69', 'link85')" onMouseOut="HideTip('tt69')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#start_time" id=link86 onMouseOver="ShowTip(event, 'tt70', 'link86')" onMouseOut="HideTip('tt70')" class=ISymbol>start_time</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#stop_time" id=link87 onMouseOver="ShowTip(event, 'tt71', 'link87')" onMouseOut="HideTip('tt71')" class=ISymbol>stop_time</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Submitting_results" id=link88 onMouseOver="ShowTip(event, 'tt72', 'link88')" onMouseOut="HideTip('tt72')" class=ISymbol>Submitting results</a></td></tr><tr><td class=IHeading><a name="T"></a>T</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#time_in_secs" id=link89 onMouseOver="ShowTip(event, 'tt73', 'link89')" onMouseOut="HideTip('tt73')" class=ISymbol>time_in_secs</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-c.html#TIMER_RES_DIVIDER" id=link90 onMouseOver="ShowTip(event, 'tt74', 'link90')" onMouseOut="HideTip('tt74')" class=ISymbol>TIMER_RES_DIVIDER</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#TOTAL_DATA_SIZE" id=link91 onMouseOver="ShowTip(event, 'tt75', 'link91')" onMouseOut="HideTip('tt75')" class=ISymbol>TOTAL_DATA_SIZE</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#Types" class=ISymbol>Types</a></td></tr><tr><td class=IHeading><a name="U"></a>U</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_CLOCK" id=link92 onMouseOver="ShowTip(event, 'tt76', 'link92')" onMouseOut="HideTip('tt76')" class=ISymbol>USE_CLOCK</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_FORK" id=link93 onMouseOver="ShowTip(event, 'tt77', 'link93')" onMouseOut="HideTip('tt77')" class=ISymbol>USE_FORK</a></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_PTHREAD" id=link94 onMouseOver="ShowTip(event, 'tt78', 'link94')" onMouseOut="HideTip('tt78')" class=ISymbol>USE_PTHREAD</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#USE_SOCKET" id=link95 onMouseOver="ShowTip(event, 'tt79', 'link95')" onMouseOut="HideTip('tt79')" class=ISymbol>USE_SOCKET</a></td></tr><tr><td class=IHeading><a name="V"></a>V</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><span class=ISymbol>Variables</span><div class=ISubIndex><a href="../files/linux/core_portme-h.html#Variables" class=IFile>linux/<span class=HB> </span>core_portme.h</a><a href="../files/linux/core_portme-mak.html#Variables" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#Variables" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=IHeading><a name="W"></a>W</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/readme-txt.html#Welcome" id=link96 onMouseOver="ShowTip(event, 'tt80', 'link96')" onMouseOut="HideTip('tt80')" class=ISymbol>Welcome</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt67"><div class=CType>For machines that have floating point support, get number of seconds as a double. </div></div><div class=CToolTip id="tt68"><div class=CConfiguration>Defines method to get seed values that cannot be computed at compile time.</div></div><div class=CToolTip id="tt69"><div class=CVariable>Define if you need to separate compilation from link stage. </div></div><div class=CToolTip id="tt70"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void start_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>This function will be called right before starting the timed portion of the benchmark.</div></div><div class=CToolTip id="tt71"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>void stop_time(</td><td class=PParameter nowrap>void</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>This function will be called right after ending the timed portion of the benchmark.</div></div><div class=CToolTip id="tt72"><div class=CGeneric>CoreMark results can be submitted on the web.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt73"><div class=CFunction><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td><table border=0 cellspacing=0 cellpadding=0><tr><td class=PBeforeParameters nowrap>secs_ret time_in_secs(</td><td class=PType nowrap>CORE_TICKS </td><td class=PParameter nowrap>ticks</td><td class=PAfterParameters nowrap>)</td></tr></table></td></tr></table></blockquote>Convert the value returned by get_time to seconds.</div></div><div class=CToolTip id="tt74"><div class=CGroup>Divider to trade off timer resolution and total time that can be measured.</div></div><div class=CToolTip id="tt75"><div class=CConfiguration>Define total size for data algorithms will operate on</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt76"><div class=CConfiguration>Define to 1 if platform has the time.h header file, and implementation of functions thereof.</div></div><div class=CToolTip id="tt77"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses fork, waitpid, shmget,shmat and shmdt.</div></div><div class=CToolTip id="tt78"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses pthread_thread_create and pthread_join.</div></div><div class=CToolTip id="tt79"><div class=CConfiguration>Sample implementation for launching parallel contexts This implementation uses fork, socket, sendto and recvfrom</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt80"><div class=CGeneric>Copyright © 2009 EEMBC All rights reserved. </div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex id=MSelected>Everything</div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/Types.html b/sw/vendor/coremark/docs/html/index/Types.html
new file mode 100644
index 0000000..1f44136
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/Types.html
@@ -0,0 +1,31 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Type Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Type Index</div><div class=INavigationBar>$#! · 0-9 · A · B · C · D · E · F · G · H · I · J · K · L · M · N · O · P · Q · R · <a href="#S">S</a> · T · U · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="S"></a>S</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/coremark-h.html#secs_ret" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>secs_ret</a></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CType>For machines that have floating point support, get number of seconds as a double. </div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Types</div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex><a href="Variables.html">Variables</a></div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/index/Variables.html b/sw/vendor/coremark/docs/html/index/Variables.html
new file mode 100644
index 0000000..8c050da
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/index/Variables.html
@@ -0,0 +1,55 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><title>Variable Index - CoreMark</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="IndexPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=IPageTitle>Variable Index</div><div class=INavigationBar>$#! · 0-9 · A · B · <a href="#C">C</a> · <a href="#D">D</a> · E · F · G · H · I · J · K · <a href="#L">L</a> · M · N · <a href="#O">O</a> · <a href="#P">P</a> · Q · <a href="#R">R</a> · <a href="#S">S</a> · T · U · V · W · X · Y · Z</div><table border=0 cellspacing=0 cellpadding=0><tr><td class=IHeading id=IFirstHeading><a name="C"></a>C</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#CC" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')" class=ISymbol>CC</a></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><span class=ISymbol>CFLAGS</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#CFLAGS" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#CFLAGS" id=link3 onMouseOver="ShowTip(event, 'tt2', 'link3')" onMouseOut="HideTip('tt2')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=IHeading><a name="D"></a>D</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-h.html#default_num_contexts" id=link4 onMouseOver="ShowTip(event, 'tt3', 'link4')" onMouseOut="HideTip('tt3')" class=ISymbol>default_num_contexts</a></td></tr><tr><td class=IHeading><a name="L"></a>L</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>LFLAGS_END</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#LFLAGS_END" id=link5 onMouseOver="ShowTip(event, 'tt4', 'link5')" onMouseOut="HideTip('tt4')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#LFLAGS_END" id=link6 onMouseOver="ShowTip(event, 'tt4', 'link6')" onMouseOut="HideTip('tt4')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#LOAD" id=link7 onMouseOver="ShowTip(event, 'tt5', 'link7')" onMouseOut="HideTip('tt5')" class=ISymbol>LOAD</a></td></tr><tr><td class=IHeading><a name="O"></a>O</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>OPATH</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OPATH" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OPATH" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><span class=ISymbol>OUTFLAG</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OUTFLAG" id=link8 onMouseOver="ShowTip(event, 'tt6', 'link8')" onMouseOut="HideTip('tt6')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OUTFLAG" id=link9 onMouseOver="ShowTip(event, 'tt6', 'link9')" onMouseOut="HideTip('tt6')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=IHeading><a name="P"></a>P</td><td></td></tr><tr><td class=ISymbolPrefix id=IFirstSymbolPrefix> </td><td class=IEntry><span class=ISymbol>PERL</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PERL" id=link10 onMouseOver="ShowTip(event, 'tt7', 'link10')" onMouseOut="HideTip('tt7')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PERL" id=link11 onMouseOver="ShowTip(event, 'tt7', 'link11')" onMouseOut="HideTip('tt7')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix> </td><td class=IEntry><span class=ISymbol>PORT_OBJS</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PORT_OBJS" id=link12 onMouseOver="ShowTip(event, 'tt8', 'link12')" onMouseOut="HideTip('tt8')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PORT_OBJS" id=link13 onMouseOver="ShowTip(event, 'tt8', 'link13')" onMouseOut="HideTip('tt8')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr><tr><td class=ISymbolPrefix id=ILastSymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#PORT_SRCS" id=link14 onMouseOver="ShowTip(event, 'tt9', 'link14')" onMouseOut="HideTip('tt9')" class=ISymbol>PORT_SRCS</a></td></tr><tr><td class=IHeading><a name="R"></a>R</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><a href="../files/linux/core_portme-mak.html#RUN" id=link15 onMouseOver="ShowTip(event, 'tt10', 'link15')" onMouseOut="HideTip('tt10')" class=ISymbol>RUN</a></td></tr><tr><td class=IHeading><a name="S"></a>S</td><td></td></tr><tr><td class=ISymbolPrefix id=IOnlySymbolPrefix> </td><td class=IEntry><span class=ISymbol>SEPARATE_COMPILE</span><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#SEPARATE_COMPILE" id=link16 onMouseOver="ShowTip(event, 'tt11', 'link16')" onMouseOut="HideTip('tt11')" class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#SEPARATE_COMPILE" id=link17 onMouseOver="ShowTip(event, 'tt11', 'link17')" onMouseOut="HideTip('tt11')" class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></td></tr></table>
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt1"><div class=CVariable>Use this flag to define compiler to use</div></div><div class=CToolTip id="tt2"><div class=CVariable>Use this flag to define compiler options. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt3"><div class=CVariable><blockquote><table border=0 cellspacing=0 cellpadding=0 class=Prototype><tr><td>extern ee_u32 default_num_contexts</td></tr></table></blockquote>Number of contexts to spawn in multicore context. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt4"><div class=CVariable>Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. </div></div><div class=CToolTip id="tt5"><div class=CVariable>Define this flag if you need to load to a target, as in a cross compile environment.</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt6"><div class=CVariable>Use this flag to define how to to get an executable (e.g -o)</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt7"><div class=CVariable>Define perl executable to calculate the geomean if running separate.</div></div><div class=CToolTip id="tt8"><div class=CVariable>Port specific object files can be added here</div></div><div class=CToolTip id="tt9"><div class=CVariable>Port specific source files can be added here</div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt10"><div class=CVariable>Define this flag if running does not consist of simple invocation of the binary. </div></div><!--END_ND_TOOLTIPS-->
+
+
+<!--START_ND_TOOLTIPS-->
+<div class=CToolTip id="tt11"><div class=CVariable>Define if you need to separate compilation from link stage. </div></div><!--END_ND_TOOLTIPS-->
+
+</div><!--Index-->
+
+
+<div id=Footer><a href="http://www.naturaldocs.org">Copyright 2009 EEMBC</a></div><!--Footer-->
+
+
+<div id=Menu><div class=MTitle>CoreMark<div class=MSubTitle>(c) EEMBC</div></div><div class=MEntry><div class=MFile><a href="../files/readme-txt.html">CoreMark</a></div></div><div class=MEntry><div class=MFile><a href="../files/release_notes-txt.html">Release Notes</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent2')">Source</a><div class=MGroupContent id=MGroupContent2><div class=MEntry><div class=MFile><a href="../files/core_list_join-c.html">core_list_join.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_main-c.html">core_main.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_matrix-c.html">core_matrix.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/PIC32/core_portme-mak.html">core_portme.mak</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_state-c.html">core_state.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/core_util-c.html">core_util.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/coremark-h.html">coremark.h</a></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent1')">Porting</a><div class=MGroupContent id=MGroupContent1><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-c.html">PORT_DIR/<span class=HB> </span>core_portme.c</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-h.html">PORT_DIR/<span class=HB> </span>core_portme.h</a></div></div><div class=MEntry><div class=MFile><a href="../files/linux/core_portme-mak.html">PORT_DIR/<span class=HB> </span>core_portme.mak</a></div></div></div></div></div></div></div></div><div class=MEntry><div class=MGroup><a href="javascript:ToggleMenu('MGroupContent3')">Index</a><div class=MGroupContent id=MGroupContent3><div class=MEntry><div class=MIndex><a href="General.html">Everything</a></div></div><div class=MEntry><div class=MIndex><a href="Files.html">Files</a></div></div><div class=MEntry><div class=MIndex><a href="Functions.html">Functions</a></div></div><div class=MEntry><div class=MIndex><a href="Types.html">Types</a></div></div><div class=MEntry><div class=MIndex><a href="Configuration.html">Configurations</a></div></div><div class=MEntry><div class=MIndex id=MSelected>Variables</div></div><div class=MEntry><div class=MIndex><a href="BuildTargets.html">Build Targets</a></div></div></div></div></div><script type="text/javascript"><!--
+var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
+--></script><div id=MSearchPanel class=MSearchPanelInactive><input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="BuildTargets">Build Targets</option><option value="Configuration">Configuration</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Types">Types</option><option value="Variables">Variables</option></select></div></div><!--Menu-->
+
+
+<div id=MSearchResultsWindow><iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe><a href="javascript:searchPanel.CloseResultsWindow()" id=MSearchResultsWindowClose>Close</a></div>
+
+
+<script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/javascript/main.js b/sw/vendor/coremark/docs/html/javascript/main.js
new file mode 100644
index 0000000..91991f5
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/javascript/main.js
@@ -0,0 +1,836 @@
+// This file is part of Natural Docs, which is Copyright (C) 2003-2008 Greg Valure
+// Natural Docs is licensed under the GPL
+
+
+//
+// Browser Styles
+// ____________________________________________________________________________
+
+var agt=navigator.userAgent.toLowerCase();
+var browserType;
+var browserVer;
+
+if (agt.indexOf("opera") != -1)
+ {
+ browserType = "Opera";
+
+ if (agt.indexOf("opera 7") != -1 || agt.indexOf("opera/7") != -1)
+ { browserVer = "Opera7"; }
+ else if (agt.indexOf("opera 8") != -1 || agt.indexOf("opera/8") != -1)
+ { browserVer = "Opera8"; }
+ else if (agt.indexOf("opera 9") != -1 || agt.indexOf("opera/9") != -1)
+ { browserVer = "Opera9"; }
+ }
+
+else if (agt.indexOf("applewebkit") != -1)
+ {
+ browserType = "Safari";
+
+ if (agt.indexOf("version/3") != -1)
+ { browserVer = "Safari3"; }
+ else if (agt.indexOf("safari/4") != -1)
+ { browserVer = "Safari2"; }
+ }
+
+else if (agt.indexOf("khtml") != -1)
+ {
+ browserType = "Konqueror";
+ }
+
+else if (agt.indexOf("msie") != -1)
+ {
+ browserType = "IE";
+
+ if (agt.indexOf("msie 6") != -1)
+ { browserVer = "IE6"; }
+ else if (agt.indexOf("msie 7") != -1)
+ { browserVer = "IE7"; }
+ }
+
+else if (agt.indexOf("gecko") != -1)
+ {
+ browserType = "Firefox";
+
+ if (agt.indexOf("rv:1.7") != -1)
+ { browserVer = "Firefox1"; }
+ else if (agt.indexOf("rv:1.8)") != -1 || agt.indexOf("rv:1.8.0") != -1)
+ { browserVer = "Firefox15"; }
+ else if (agt.indexOf("rv:1.8.1") != -1)
+ { browserVer = "Firefox2"; }
+ }
+
+
+//
+// Support Functions
+// ____________________________________________________________________________
+
+
+function GetXPosition(item)
+ {
+ var position = 0;
+
+ if (item.offsetWidth != null)
+ {
+ while (item != document.body && item != null)
+ {
+ position += item.offsetLeft;
+ item = item.offsetParent;
+ };
+ };
+
+ return position;
+ };
+
+
+function GetYPosition(item)
+ {
+ var position = 0;
+
+ if (item.offsetWidth != null)
+ {
+ while (item != document.body && item != null)
+ {
+ position += item.offsetTop;
+ item = item.offsetParent;
+ };
+ };
+
+ return position;
+ };
+
+
+function MoveToPosition(item, x, y)
+ {
+ // Opera 5 chokes on the px extension, so it can use the Microsoft one instead.
+
+ if (item.style.left != null)
+ {
+ item.style.left = x + "px";
+ item.style.top = y + "px";
+ }
+ else if (item.style.pixelLeft != null)
+ {
+ item.style.pixelLeft = x;
+ item.style.pixelTop = y;
+ };
+ };
+
+
+//
+// Menu
+// ____________________________________________________________________________
+
+
+function ToggleMenu(id)
+ {
+ if (!window.document.getElementById)
+ { return; };
+
+ var display = window.document.getElementById(id).style.display;
+
+ if (display == "none")
+ { display = "block"; }
+ else
+ { display = "none"; }
+
+ window.document.getElementById(id).style.display = display;
+ }
+
+function HideAllBut(ids, max)
+ {
+ if (document.getElementById)
+ {
+ ids.sort( function(a,b) { return a - b; } );
+ var number = 1;
+
+ while (number < max)
+ {
+ if (ids.length > 0 && number == ids[0])
+ { ids.shift(); }
+ else
+ {
+ document.getElementById("MGroupContent" + number).style.display = "none";
+ };
+
+ number++;
+ };
+ };
+ }
+
+
+//
+// Tooltips
+// ____________________________________________________________________________
+
+
+var tooltipTimer = 0;
+
+function ShowTip(event, tooltipID, linkID)
+ {
+ if (tooltipTimer)
+ { clearTimeout(tooltipTimer); };
+
+ var docX = event.clientX + window.pageXOffset;
+ var docY = event.clientY + window.pageYOffset;
+
+ var showCommand = "ReallyShowTip('" + tooltipID + "', '" + linkID + "', " + docX + ", " + docY + ")";
+
+ tooltipTimer = setTimeout(showCommand, 1000);
+ }
+
+function ReallyShowTip(tooltipID, linkID, docX, docY)
+ {
+ tooltipTimer = 0;
+
+ var tooltip;
+ var link;
+
+ if (document.getElementById)
+ {
+ tooltip = document.getElementById(tooltipID);
+ link = document.getElementById(linkID);
+ }
+/* else if (document.all)
+ {
+ tooltip = eval("document.all['" + tooltipID + "']");
+ link = eval("document.all['" + linkID + "']");
+ }
+*/
+ if (tooltip)
+ {
+ var left = GetXPosition(link);
+ var top = GetYPosition(link);
+ top += link.offsetHeight;
+
+
+ // The fallback method is to use the mouse X and Y relative to the document. We use a separate if and test if its a number
+ // in case some browser snuck through the above if statement but didn't support everything.
+
+ if (!isFinite(top) || top == 0)
+ {
+ left = docX;
+ top = docY;
+ }
+
+ // Some spacing to get it out from under the cursor.
+
+ top += 10;
+
+ // Make sure the tooltip doesnt get smushed by being too close to the edge, or in some browsers, go off the edge of the
+ // page. We do it here because Konqueror does get offsetWidth right even if it doesnt get the positioning right.
+
+ if (tooltip.offsetWidth != null)
+ {
+ var width = tooltip.offsetWidth;
+ var docWidth = document.body.clientWidth;
+
+ if (left + width > docWidth)
+ { left = docWidth - width - 1; }
+
+ // If there's a horizontal scroll bar we could go past zero because it's using the page width, not the window width.
+ if (left < 0)
+ { left = 0; };
+ }
+
+ MoveToPosition(tooltip, left, top);
+ tooltip.style.visibility = "visible";
+ }
+ }
+
+function HideTip(tooltipID)
+ {
+ if (tooltipTimer)
+ {
+ clearTimeout(tooltipTimer);
+ tooltipTimer = 0;
+ }
+
+ var tooltip;
+
+ if (document.getElementById)
+ { tooltip = document.getElementById(tooltipID); }
+ else if (document.all)
+ { tooltip = eval("document.all['" + tooltipID + "']"); }
+
+ if (tooltip)
+ { tooltip.style.visibility = "hidden"; }
+ }
+
+
+//
+// Blockquote fix for IE
+// ____________________________________________________________________________
+
+
+function NDOnLoad()
+ {
+ if (browserVer == "IE6")
+ {
+ var scrollboxes = document.getElementsByTagName('blockquote');
+
+ if (scrollboxes.item(0))
+ {
+ NDDoResize();
+ window.onresize=NDOnResize;
+ };
+ };
+ };
+
+
+var resizeTimer = 0;
+
+function NDOnResize()
+ {
+ if (resizeTimer != 0)
+ { clearTimeout(resizeTimer); };
+
+ resizeTimer = setTimeout(NDDoResize, 250);
+ };
+
+
+function NDDoResize()
+ {
+ var scrollboxes = document.getElementsByTagName('blockquote');
+
+ var i;
+ var item;
+
+ i = 0;
+ while (item = scrollboxes.item(i))
+ {
+ item.style.width = 100;
+ i++;
+ };
+
+ i = 0;
+ while (item = scrollboxes.item(i))
+ {
+ item.style.width = item.parentNode.offsetWidth;
+ i++;
+ };
+
+ clearTimeout(resizeTimer);
+ resizeTimer = 0;
+ }
+
+
+
+/* ________________________________________________________________________________________________________
+
+ Class: SearchPanel
+ ________________________________________________________________________________________________________
+
+ A class handling everything associated with the search panel.
+
+ Parameters:
+
+ name - The name of the global variable that will be storing this instance. Is needed to be able to set timeouts.
+ mode - The mode the search is going to work in. Pass <NaturalDocs::Builder::Base->CommandLineOption()>, so the
+ value will be something like "HTML" or "FramedHTML".
+
+ ________________________________________________________________________________________________________
+*/
+
+
+function SearchPanel(name, mode, resultsPath)
+ {
+ if (!name || !mode || !resultsPath)
+ { alert("Incorrect parameters to SearchPanel."); };
+
+
+ // Group: Variables
+ // ________________________________________________________________________
+
+ /*
+ var: name
+ The name of the global variable that will be storing this instance of the class.
+ */
+ this.name = name;
+
+ /*
+ var: mode
+ The mode the search is going to work in, such as "HTML" or "FramedHTML".
+ */
+ this.mode = mode;
+
+ /*
+ var: resultsPath
+ The relative path from the current HTML page to the results page directory.
+ */
+ this.resultsPath = resultsPath;
+
+ /*
+ var: keyTimeout
+ The timeout used between a keystroke and when a search is performed.
+ */
+ this.keyTimeout = 0;
+
+ /*
+ var: keyTimeoutLength
+ The length of <keyTimeout> in thousandths of a second.
+ */
+ this.keyTimeoutLength = 500;
+
+ /*
+ var: lastSearchValue
+ The last search string executed, or an empty string if none.
+ */
+ this.lastSearchValue = "";
+
+ /*
+ var: lastResultsPage
+ The last results page. The value is only relevant if <lastSearchValue> is set.
+ */
+ this.lastResultsPage = "";
+
+ /*
+ var: deactivateTimeout
+
+ The timeout used between when a control is deactivated and when the entire panel is deactivated. Is necessary
+ because a control may be deactivated in favor of another control in the same panel, in which case it should stay
+ active.
+ */
+ this.deactivateTimout = 0;
+
+ /*
+ var: deactivateTimeoutLength
+ The length of <deactivateTimeout> in thousandths of a second.
+ */
+ this.deactivateTimeoutLength = 200;
+
+
+
+
+ // Group: DOM Elements
+ // ________________________________________________________________________
+
+
+ // Function: DOMSearchField
+ this.DOMSearchField = function()
+ { return document.getElementById("MSearchField"); };
+
+ // Function: DOMSearchType
+ this.DOMSearchType = function()
+ { return document.getElementById("MSearchType"); };
+
+ // Function: DOMPopupSearchResults
+ this.DOMPopupSearchResults = function()
+ { return document.getElementById("MSearchResults"); };
+
+ // Function: DOMPopupSearchResultsWindow
+ this.DOMPopupSearchResultsWindow = function()
+ { return document.getElementById("MSearchResultsWindow"); };
+
+ // Function: DOMSearchPanel
+ this.DOMSearchPanel = function()
+ { return document.getElementById("MSearchPanel"); };
+
+
+
+
+ // Group: Event Handlers
+ // ________________________________________________________________________
+
+
+ /*
+ Function: OnSearchFieldFocus
+ Called when focus is added or removed from the search field.
+ */
+ this.OnSearchFieldFocus = function(isActive)
+ {
+ this.Activate(isActive);
+ };
+
+
+ /*
+ Function: OnSearchFieldChange
+ Called when the content of the search field is changed.
+ */
+ this.OnSearchFieldChange = function()
+ {
+ if (this.keyTimeout)
+ {
+ clearTimeout(this.keyTimeout);
+ this.keyTimeout = 0;
+ };
+
+ var searchValue = this.DOMSearchField().value.replace(/ +/g, "");
+
+ if (searchValue != this.lastSearchValue)
+ {
+ if (searchValue != "")
+ {
+ this.keyTimeout = setTimeout(this.name + ".Search()", this.keyTimeoutLength);
+ }
+ else
+ {
+ if (this.mode == "HTML")
+ { this.DOMPopupSearchResultsWindow().style.display = "none"; };
+ this.lastSearchValue = "";
+ };
+ };
+ };
+
+
+ /*
+ Function: OnSearchTypeFocus
+ Called when focus is added or removed from the search type.
+ */
+ this.OnSearchTypeFocus = function(isActive)
+ {
+ this.Activate(isActive);
+ };
+
+
+ /*
+ Function: OnSearchTypeChange
+ Called when the search type is changed.
+ */
+ this.OnSearchTypeChange = function()
+ {
+ var searchValue = this.DOMSearchField().value.replace(/ +/g, "");
+
+ if (searchValue != "")
+ {
+ this.Search();
+ };
+ };
+
+
+
+ // Group: Action Functions
+ // ________________________________________________________________________
+
+
+ /*
+ Function: CloseResultsWindow
+ Closes the results window.
+ */
+ this.CloseResultsWindow = function()
+ {
+ this.DOMPopupSearchResultsWindow().style.display = "none";
+ this.Activate(false, true);
+ };
+
+
+ /*
+ Function: Search
+ Performs a search.
+ */
+ this.Search = function()
+ {
+ this.keyTimeout = 0;
+
+ var searchValue = this.DOMSearchField().value.replace(/^ +/, "");
+ var searchTopic = this.DOMSearchType().value;
+
+ var pageExtension = searchValue.substr(0,1);
+
+ if (pageExtension.match(/^[a-z]/i))
+ { pageExtension = pageExtension.toUpperCase(); }
+ else if (pageExtension.match(/^[0-9]/))
+ { pageExtension = 'Numbers'; }
+ else
+ { pageExtension = "Symbols"; };
+
+ var resultsPage;
+ var resultsPageWithSearch;
+ var hasResultsPage;
+
+ // indexSectionsWithContent is defined in searchdata.js
+ if (indexSectionsWithContent[searchTopic][pageExtension] == true)
+ {
+ resultsPage = this.resultsPath + '/' + searchTopic + pageExtension + '.html';
+ resultsPageWithSearch = resultsPage+'?'+escape(searchValue);
+ hasResultsPage = true;
+ }
+ else
+ {
+ resultsPage = this.resultsPath + '/NoResults.html';
+ resultsPageWithSearch = resultsPage;
+ hasResultsPage = false;
+ };
+
+ var resultsFrame;
+ if (this.mode == "HTML")
+ { resultsFrame = window.frames.MSearchResults; }
+ else if (this.mode == "FramedHTML")
+ { resultsFrame = window.top.frames['Content']; };
+
+
+ if (resultsPage != this.lastResultsPage ||
+
+ // Bug in IE. If everything becomes hidden in a run, none of them will be able to be reshown in the next for some
+ // reason. It counts the right number of results, and you can even read the display as "block" after setting it, but it
+ // just doesn't work in IE 6 or IE 7. So if we're on the right page but the previous search had no results, reload the
+ // page anyway to get around the bug.
+ (browserType == "IE" && hasResultsPage &&
+ (!resultsFrame.searchResults || resultsFrame.searchResults.lastMatchCount == 0)) )
+
+ {
+ resultsFrame.location.href = resultsPageWithSearch;
+ }
+
+ // So if the results page is right and there's no IE bug, reperform the search on the existing page. We have to check if there
+ // are results because NoResults.html doesn't have any JavaScript, and it would be useless to do anything on that page even
+ // if it did.
+ else if (hasResultsPage)
+ {
+ // We need to check if this exists in case the frame is present but didn't finish loading.
+ if (resultsFrame.searchResults)
+ { resultsFrame.searchResults.Search(searchValue); }
+
+ // Otherwise just reload instead of waiting.
+ else
+ { resultsFrame.location.href = resultsPageWithSearch; };
+ };
+
+
+ var domPopupSearchResultsWindow = this.DOMPopupSearchResultsWindow();
+
+ if (this.mode == "HTML" && domPopupSearchResultsWindow.style.display != "block")
+ {
+ var domSearchType = this.DOMSearchType();
+
+ var left = GetXPosition(domSearchType);
+ var top = GetYPosition(domSearchType) + domSearchType.offsetHeight;
+
+ MoveToPosition(domPopupSearchResultsWindow, left, top);
+ domPopupSearchResultsWindow.style.display = 'block';
+ };
+
+
+ this.lastSearchValue = searchValue;
+ this.lastResultsPage = resultsPage;
+ };
+
+
+
+ // Group: Activation Functions
+ // Functions that handle whether the entire panel is active or not.
+ // ________________________________________________________________________
+
+
+ /*
+ Function: Activate
+
+ Activates or deactivates the search panel, resetting things to their default values if necessary. You can call this on every
+ control's OnBlur() and it will handle not deactivating the entire panel when focus is just switching between them transparently.
+
+ Parameters:
+
+ isActive - Whether you're activating or deactivating the panel.
+ ignoreDeactivateDelay - Set if you're positive the action will deactivate the panel and thus want to skip the delay.
+ */
+ this.Activate = function(isActive, ignoreDeactivateDelay)
+ {
+ // We want to ignore isActive being false while the results window is open.
+ if (isActive || (this.mode == "HTML" && this.DOMPopupSearchResultsWindow().style.display == "block"))
+ {
+ if (this.inactivateTimeout)
+ {
+ clearTimeout(this.inactivateTimeout);
+ this.inactivateTimeout = 0;
+ };
+
+ this.DOMSearchPanel().className = 'MSearchPanelActive';
+
+ var searchField = this.DOMSearchField();
+
+ if (searchField.value == 'Search')
+ { searchField.value = ""; }
+ }
+ else if (!ignoreDeactivateDelay)
+ {
+ this.inactivateTimeout = setTimeout(this.name + ".InactivateAfterTimeout()", this.inactivateTimeoutLength);
+ }
+ else
+ {
+ this.InactivateAfterTimeout();
+ };
+ };
+
+
+ /*
+ Function: InactivateAfterTimeout
+
+ Called by <inactivateTimeout>, which is set by <Activate()>. Inactivation occurs on a timeout because a control may
+ receive OnBlur() when focus is really transferring to another control in the search panel. In this case we don't want to
+ actually deactivate the panel because not only would that cause a visible flicker but it could also reset the search value.
+ So by doing it on a timeout instead, there's a short period where the second control's OnFocus() can cancel the deactivation.
+ */
+ this.InactivateAfterTimeout = function()
+ {
+ this.inactivateTimeout = 0;
+
+ this.DOMSearchPanel().className = 'MSearchPanelInactive';
+ this.DOMSearchField().value = "Search";
+
+ this.lastSearchValue = "";
+ this.lastResultsPage = "";
+ };
+ };
+
+
+
+
+/* ________________________________________________________________________________________________________
+
+ Class: SearchResults
+ _________________________________________________________________________________________________________
+
+ The class that handles everything on the search results page.
+ _________________________________________________________________________________________________________
+*/
+
+
+function SearchResults(name, mode)
+ {
+ /*
+ var: mode
+ The mode the search is going to work in, such as "HTML" or "FramedHTML".
+ */
+ this.mode = mode;
+
+ /*
+ var: lastMatchCount
+ The number of matches from the last run of <Search()>.
+ */
+ this.lastMatchCount = 0;
+
+
+ /*
+ Function: Toggle
+ Toggles the visibility of the passed element ID.
+ */
+ this.Toggle = function(id)
+ {
+ if (this.mode == "FramedHTML")
+ { return; };
+
+ var parentElement = document.getElementById(id);
+
+ var element = parentElement.firstChild;
+
+ while (element && element != parentElement)
+ {
+ if (element.nodeName == 'DIV' && element.className == 'ISubIndex')
+ {
+ if (element.style.display == 'block')
+ { element.style.display = "none"; }
+ else
+ { element.style.display = 'block'; }
+ };
+
+ if (element.nodeName == 'DIV' && element.hasChildNodes())
+ { element = element.firstChild; }
+ else if (element.nextSibling)
+ { element = element.nextSibling; }
+ else
+ {
+ do
+ {
+ element = element.parentNode;
+ }
+ while (element && element != parentElement && !element.nextSibling);
+
+ if (element && element != parentElement)
+ { element = element.nextSibling; };
+ };
+ };
+ };
+
+
+ /*
+ Function: Search
+
+ Searches for the passed string. If there is no parameter, it takes it from the URL query.
+
+ Always returns true, since other documents may try to call it and that may or may not be possible.
+ */
+ this.Search = function(search)
+ {
+ if (!search)
+ {
+ search = window.location.search;
+ search = search.substring(1); // Remove the leading ?
+ search = unescape(search);
+ };
+
+ search = search.replace(/^ +/, "");
+ search = search.replace(/ +$/, "");
+ search = search.toLowerCase();
+
+ if (search.match(/[^a-z0-9]/)) // Just a little speedup so it doesn't have to go through the below unnecessarily.
+ {
+ search = search.replace(/\_/g, "_und");
+ search = search.replace(/\ +/gi, "_spc");
+ search = search.replace(/\~/g, "_til");
+ search = search.replace(/\!/g, "_exc");
+ search = search.replace(/\@/g, "_att");
+ search = search.replace(/\#/g, "_num");
+ search = search.replace(/\$/g, "_dol");
+ search = search.replace(/\%/g, "_pct");
+ search = search.replace(/\^/g, "_car");
+ search = search.replace(/\&/g, "_amp");
+ search = search.replace(/\*/g, "_ast");
+ search = search.replace(/\(/g, "_lpa");
+ search = search.replace(/\)/g, "_rpa");
+ search = search.replace(/\-/g, "_min");
+ search = search.replace(/\+/g, "_plu");
+ search = search.replace(/\=/g, "_equ");
+ search = search.replace(/\{/g, "_lbc");
+ search = search.replace(/\}/g, "_rbc");
+ search = search.replace(/\[/g, "_lbk");
+ search = search.replace(/\]/g, "_rbk");
+ search = search.replace(/\:/g, "_col");
+ search = search.replace(/\;/g, "_sco");
+ search = search.replace(/\"/g, "_quo");
+ search = search.replace(/\'/g, "_apo");
+ search = search.replace(/\</g, "_lan");
+ search = search.replace(/\>/g, "_ran");
+ search = search.replace(/\,/g, "_com");
+ search = search.replace(/\./g, "_per");
+ search = search.replace(/\?/g, "_que");
+ search = search.replace(/\//g, "_sla");
+ search = search.replace(/[^a-z0-9\_]i/gi, "_zzz");
+ };
+
+ var resultRows = document.getElementsByTagName("div");
+ var matches = 0;
+
+ var i = 0;
+ while (i < resultRows.length)
+ {
+ var row = resultRows.item(i);
+
+ if (row.className == "SRResult")
+ {
+ var rowMatchName = row.id.toLowerCase();
+ rowMatchName = rowMatchName.replace(/^sr\d*_/, '');
+
+ if (search.length <= rowMatchName.length && rowMatchName.substr(0, search.length) == search)
+ {
+ row.style.display = "block";
+ matches++;
+ }
+ else
+ { row.style.display = "none"; };
+ };
+
+ i++;
+ };
+
+ document.getElementById("Searching").style.display="none";
+
+ if (matches == 0)
+ { document.getElementById("NoMatches").style.display="block"; }
+ else
+ { document.getElementById("NoMatches").style.display="none"; }
+
+ this.lastMatchCount = matches;
+
+ return true;
+ };
+ };
+
diff --git a/sw/vendor/coremark/docs/html/javascript/searchdata.js b/sw/vendor/coremark/docs/html/javascript/searchdata.js
new file mode 100644
index 0000000..901318e
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/javascript/searchdata.js
@@ -0,0 +1,212 @@
+var indexSectionsWithContent = {
+ "General": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": true,
+ "D": true,
+ "E": false,
+ "F": true,
+ "G": true,
+ "H": false,
+ "I": true,
+ "J": false,
+ "K": false,
+ "L": false,
+ "M": true,
+ "N": false,
+ "O": false,
+ "P": false,
+ "Q": false,
+ "R": false,
+ "S": true,
+ "T": true,
+ "U": false,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ },
+ "Variables": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": true,
+ "D": true,
+ "E": false,
+ "F": false,
+ "G": false,
+ "H": false,
+ "I": false,
+ "J": false,
+ "K": false,
+ "L": true,
+ "M": false,
+ "N": false,
+ "O": true,
+ "P": true,
+ "Q": false,
+ "R": true,
+ "S": true,
+ "T": false,
+ "U": false,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ },
+ "Functions": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": true,
+ "D": false,
+ "E": false,
+ "F": false,
+ "G": true,
+ "H": false,
+ "I": true,
+ "J": false,
+ "K": false,
+ "L": false,
+ "M": true,
+ "N": false,
+ "O": false,
+ "P": true,
+ "Q": false,
+ "R": false,
+ "S": true,
+ "T": true,
+ "U": false,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ },
+ "Files": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": true,
+ "D": false,
+ "E": false,
+ "F": false,
+ "G": false,
+ "H": false,
+ "I": false,
+ "J": false,
+ "K": false,
+ "L": false,
+ "M": false,
+ "N": false,
+ "O": false,
+ "P": false,
+ "Q": false,
+ "R": true,
+ "S": false,
+ "T": false,
+ "U": false,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ },
+ "Configuration": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": true,
+ "D": false,
+ "E": false,
+ "F": false,
+ "G": false,
+ "H": true,
+ "I": false,
+ "J": false,
+ "K": false,
+ "L": false,
+ "M": true,
+ "N": false,
+ "O": false,
+ "P": false,
+ "Q": false,
+ "R": false,
+ "S": true,
+ "T": true,
+ "U": true,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ },
+ "Types": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": false,
+ "D": false,
+ "E": false,
+ "F": false,
+ "G": false,
+ "H": false,
+ "I": false,
+ "J": false,
+ "K": false,
+ "L": false,
+ "M": false,
+ "N": false,
+ "O": false,
+ "P": false,
+ "Q": false,
+ "R": false,
+ "S": true,
+ "T": false,
+ "U": false,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ },
+ "BuildTargets": {
+ "Symbols": false,
+ "Numbers": false,
+ "A": false,
+ "B": false,
+ "C": false,
+ "D": false,
+ "E": false,
+ "F": false,
+ "G": false,
+ "H": false,
+ "I": false,
+ "J": false,
+ "K": false,
+ "L": false,
+ "M": false,
+ "N": false,
+ "O": false,
+ "P": true,
+ "Q": false,
+ "R": false,
+ "S": false,
+ "T": false,
+ "U": false,
+ "V": false,
+ "W": false,
+ "X": false,
+ "Y": false,
+ "Z": false
+ }
+ }
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/BuildTargetsP.html b/sw/vendor/coremark/docs/html/search/BuildTargetsP.html
new file mode 100644
index 0000000..65e741d
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/BuildTargetsP.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_port_undpostbuild><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpostbuild')" class=ISymbol>port_postbuild</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postbuild" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postbuild" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpostload><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpostload')" class=ISymbol>port_postload</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postload" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postload" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpostrun><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpostrun')" class=ISymbol>port_postrun</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postrun" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postrun" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undprebuild><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undprebuild')" class=ISymbol>port_prebuild</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prebuild" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prebuild" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpreload><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpreload')" class=ISymbol>port_preload</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_preload" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_preload" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undprerun><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undprerun')" class=ISymbol>port_prerun</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prerun" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prerun" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationC.html b/sw/vendor/coremark/docs/html/search/ConfigurationC.html
new file mode 100644
index 0000000..84b49ca
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationC.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_CORE_undTICKS><div class=IEntry><a href="../files/linux/core_portme-h.html#CORE_TICKS" target=_parent class=ISymbol>CORE_TICKS</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationH.html b/sw/vendor/coremark/docs/html/search/ConfigurationH.html
new file mode 100644
index 0000000..3b0c392
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationH.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_HAS_undFLOAT><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_FLOAT" target=_parent class=ISymbol>HAS_FLOAT</a></div></div><div class=SRResult id=SR_HAS_undPRINTF><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_PRINTF" target=_parent class=ISymbol>HAS_PRINTF</a></div></div><div class=SRResult id=SR_HAS_undSTDIO><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_STDIO" target=_parent class=ISymbol>HAS_STDIO</a></div></div><div class=SRResult id=SR_HAS_undTIME_undH><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_TIME_H" target=_parent class=ISymbol>HAS_TIME_H</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationM.html b/sw/vendor/coremark/docs/html/search/ConfigurationM.html
new file mode 100644
index 0000000..022606f
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationM.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_MAIN_undHAS_undNOARGC><div class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NOARGC" target=_parent class=ISymbol>MAIN_HAS_NOARGC</a></div></div><div class=SRResult id=SR_MAIN_undHAS_undNORETURN><div class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NORETURN" target=_parent class=ISymbol>MAIN_HAS_NORETURN</a></div></div><div class=SRResult id=SR_MEM_undMETHOD><div class=IEntry><a href="../files/linux/core_portme-h.html#MEM_METHOD" target=_parent class=ISymbol>MEM_METHOD</a></div></div><div class=SRResult id=SR_MULTITHREAD><div class=IEntry><a href="../files/linux/core_portme-h.html#MULTITHREAD" target=_parent class=ISymbol>MULTITHREAD</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationS.html b/sw/vendor/coremark/docs/html/search/ConfigurationS.html
new file mode 100644
index 0000000..d26de19
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationS.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_SEED_undMETHOD><div class=IEntry><a href="../files/linux/core_portme-h.html#SEED_METHOD" target=_parent class=ISymbol>SEED_METHOD</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationT.html b/sw/vendor/coremark/docs/html/search/ConfigurationT.html
new file mode 100644
index 0000000..183daf1
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationT.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_TOTAL_undDATA_undSIZE><div class=IEntry><a href="../files/coremark-h.html#TOTAL_DATA_SIZE" target=_parent class=ISymbol>TOTAL_DATA_SIZE</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationU.html b/sw/vendor/coremark/docs/html/search/ConfigurationU.html
new file mode 100644
index 0000000..d9b46a5
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationU.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_USE_undCLOCK><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_CLOCK" target=_parent class=ISymbol>USE_CLOCK</a></div></div><div class=SRResult id=SR_USE_undFORK><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_FORK" target=_parent class=ISymbol>USE_FORK</a></div></div><div class=SRResult id=SR_USE_undPTHREAD><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_PTHREAD" target=_parent class=ISymbol>USE_PTHREAD</a></div></div><div class=SRResult id=SR_USE_undSOCKET><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_SOCKET" target=_parent class=ISymbol>USE_SOCKET</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationsH.html b/sw/vendor/coremark/docs/html/search/ConfigurationsH.html
new file mode 100644
index 0000000..ade2ab7
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationsH.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Generated by Natural Docs, version Development Release 01-12-2008 (1.35 base) -->
+<!-- http://www.naturaldocs.org -->
+
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_HAS_undFLOAT><div class=IEntry><a href="../files/coremark-h.html#HAS_FLOAT" target=_parent class=ISymbol>HAS_FLOAT</a></div></div><div class=SRResult id=SR_HAS_undSTDIO><div class=IEntry><a href="../files/coremark-h.html#HAS_STDIO" target=_parent class=ISymbol>HAS_STDIO</a></div></div><div class=SRResult id=SR_HAS_undTIME_undH><div class=IEntry><a href="../files/coremark-h.html#HAS_TIME_H" target=_parent class=ISymbol>HAS_TIME_H</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationsM.html b/sw/vendor/coremark/docs/html/search/ConfigurationsM.html
new file mode 100644
index 0000000..baa1892
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationsM.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Generated by Natural Docs, version Development Release 01-12-2008 (1.35 base) -->
+<!-- http://www.naturaldocs.org -->
+
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_MEM_undMETHOD><div class=IEntry><a href="../files/coremark-h.html#MEM_METHOD" target=_parent class=ISymbol>MEM_METHOD</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationsS.html b/sw/vendor/coremark/docs/html/search/ConfigurationsS.html
new file mode 100644
index 0000000..ceb8abf
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationsS.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Generated by Natural Docs, version Development Release 01-12-2008 (1.35 base) -->
+<!-- http://www.naturaldocs.org -->
+
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_SEED_undMETHOD><div class=IEntry><a href="../files/coremark-h.html#SEED_METHOD" target=_parent class=ISymbol>SEED_METHOD</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/ConfigurationsT.html b/sw/vendor/coremark/docs/html/search/ConfigurationsT.html
new file mode 100644
index 0000000..ef13810
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/ConfigurationsT.html
@@ -0,0 +1,20 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Generated by Natural Docs, version Development Release 01-12-2008 (1.35 base) -->
+<!-- http://www.naturaldocs.org -->
+
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_TOTAL_undDATA_undSIZE><div class=IEntry><a href="../files/coremark-h.html#TOTAL_DATA_SIZE" target=_parent class=ISymbol>TOTAL_DATA_SIZE</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FilesC.html b/sw/vendor/coremark/docs/html/search/FilesC.html
new file mode 100644
index 0000000..e2b01c4
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FilesC.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_core_undlist_undjoin_perc><div class=IEntry><a href="../files/core_list_join-c.html#core_list_join.c" target=_parent class=ISymbol>core_list_join.c</a></div></div><div class=SRResult id=SR_core_undmain_perc><div class=IEntry><a href="../files/core_main-c.html#core_main.c" target=_parent class=ISymbol>core_main.c</a></div></div><div class=SRResult id=SR_core_undmatrix_perc><div class=IEntry><a href="../files/core_matrix-c.html#core_matrix.c" target=_parent class=ISymbol>core_matrix.c</a></div></div><div class=SRResult id=SR_core_undportme_perc><div class=IEntry><a href="../files/linux/core_portme-c.html#core_portme.c" target=_parent class=ISymbol>core_portme.c</a></div></div><div class=SRResult id=SR_core_undportme_perh><div class=IEntry><a href="../files/linux/core_portme-h.html#core_portme.h" target=_parent class=ISymbol>core_portme.h</a></div></div><div class=SRResult id=SR_core_undportme_permak><div class=IEntry><a href="javascript:searchResults.Toggle('SR_core_undportme_permak')" class=ISymbol>core_portme.mak</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#core_portme.mak" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#core_portme.mak" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_core_undstate_perc><div class=IEntry><a href="../files/core_state-c.html#core_state.c" target=_parent class=ISymbol>core_state.c</a></div></div><div class=SRResult id=SR_core_undutil_perc><div class=IEntry><a href="../files/core_util-c.html#core_util.c" target=_parent class=ISymbol>core_util.c</a></div></div><div class=SRResult id=SR_CoreMark><div class=IEntry><a href="../files/readme-txt.html#CoreMark" target=_parent class=ISymbol>CoreMark</a></div></div><div class=SRResult id=SR_coremark_perh><div class=IEntry><a href="../files/coremark-h.html#coremark.h" target=_parent class=ISymbol>coremark.h</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FilesR.html b/sw/vendor/coremark/docs/html/search/FilesR.html
new file mode 100644
index 0000000..6202fb7
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FilesR.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Release_spcNotes><div class=IEntry><a href="../files/release_notes-txt.html#Release_Notes" target=_parent class=ISymbol>Release Notes</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsC.html b/sw/vendor/coremark/docs/html/search/FunctionsC.html
new file mode 100644
index 0000000..43993db
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsC.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_cmp_undcomplex><div class=IEntry><a href="../files/core_list_join-c.html#cmp_complex" target=_parent class=ISymbol>cmp_complex</a></div></div><div class=SRResult id=SR_cmp_undidx><div class=IEntry><a href="../files/core_list_join-c.html#cmp_idx" target=_parent class=ISymbol>cmp_idx</a></div></div><div class=SRResult id=SR_core_undbench_undmatrix><div class=IEntry><a href="../files/core_matrix-c.html#core_bench_matrix" target=_parent class=ISymbol>core_bench_matrix</a></div></div><div class=SRResult id=SR_core_undbench_undstate><div class=IEntry><a href="../files/core_state-c.html#core_bench_state" target=_parent class=ISymbol>core_bench_state</a></div></div><div class=SRResult id=SR_core_undinit_undstate><div class=IEntry><a href="../files/core_state-c.html#core_init_state" target=_parent class=ISymbol>core_init_state</a></div></div><div class=SRResult id=SR_core_undlist_undfind><div class=IEntry><a href="../files/core_list_join-c.html#core_list_find" target=_parent class=ISymbol>core_list_find</a></div></div><div class=SRResult id=SR_core_undlist_undinit><div class=IEntry><a href="../files/core_list_join-c.html#core_list_init" target=_parent class=ISymbol>core_list_init</a></div></div><div class=SRResult id=SR_core_undlist_undinsert><div class=IEntry><a href="../files/core_list_join-c.html#core_list_insert" target=_parent class=ISymbol>core_list_insert</a></div></div><div class=SRResult id=SR_core_undlist_undmergesort><div class=IEntry><a href="../files/core_list_join-c.html#core_list_mergesort" target=_parent class=ISymbol>core_list_mergesort</a></div></div><div class=SRResult id=SR_core_undlist_undremove><div class=IEntry><a href="../files/core_list_join-c.html#core_list_remove" target=_parent class=ISymbol>core_list_remove</a></div></div><div class=SRResult id=SR_core_undlist_undreverse><div class=IEntry><a href="../files/core_list_join-c.html#core_list_reverse" target=_parent class=ISymbol>core_list_reverse</a></div></div><div class=SRResult id=SR_core_undlist_undundo_undremove><div class=IEntry><a href="../files/core_list_join-c.html#core_list_undo_remove" target=_parent class=ISymbol>core_list_undo_remove</a></div></div><div class=SRResult id=SR_core_undstart_undparallel><div class=IEntry><a href="../files/linux/core_portme-c.html#core_start_parallel" target=_parent class=ISymbol>core_start_parallel</a></div></div><div class=SRResult id=SR_core_undstate_undtransition><div class=IEntry><a href="../files/core_state-c.html#core_state_transition" target=_parent class=ISymbol>core_state_transition</a></div></div><div class=SRResult id=SR_core_undstop_undparallel><div class=IEntry><a href="../files/linux/core_portme-c.html#core_stop_parallel" target=_parent class=ISymbol>core_stop_parallel</a></div></div><div class=SRResult id=SR_crc_ast><div class=IEntry><a href="../files/core_util-c.html#crc*" target=_parent class=ISymbol>crc*</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsG.html b/sw/vendor/coremark/docs/html/search/FunctionsG.html
new file mode 100644
index 0000000..217e854
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsG.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_get_undseed><div class=IEntry><a href="../files/core_util-c.html#get_seed" target=_parent class=ISymbol>get_seed</a></div></div><div class=SRResult id=SR_get_undtime><div class=IEntry><a href="../files/linux/core_portme-c.html#get_time" target=_parent class=ISymbol>get_time</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsI.html b/sw/vendor/coremark/docs/html/search/FunctionsI.html
new file mode 100644
index 0000000..f17354d
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsI.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_iterate><div class=IEntry><a href="../files/core_main-c.html#iterate" target=_parent class=ISymbol>iterate</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsM.html b/sw/vendor/coremark/docs/html/search/FunctionsM.html
new file mode 100644
index 0000000..345e2ba
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsM.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_main><div class=IEntry><a href="../files/core_main-c.html#main" target=_parent class=ISymbol>main</a></div></div><div class=SRResult id=SR_matrix_undadd_undconst><div class=IEntry><a href="../files/core_matrix-c.html#matrix_add_const" target=_parent class=ISymbol>matrix_add_const</a></div></div><div class=SRResult id=SR_matrix_undmul_undconst><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_const" target=_parent class=ISymbol>matrix_mul_const</a></div></div><div class=SRResult id=SR_matrix_undmul_undmatrix><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix" target=_parent class=ISymbol>matrix_mul_matrix</a></div></div><div class=SRResult id=SR_matrix_undmul_undmatrix_undbitextract><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix_bitextract" target=_parent class=ISymbol>matrix_mul_matrix_bitextract</a></div></div><div class=SRResult id=SR_matrix_undmul_undvect><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_vect" target=_parent class=ISymbol>matrix_mul_vect</a></div></div><div class=SRResult id=SR_matrix_undsum><div class=IEntry><a href="../files/core_matrix-c.html#matrix_sum" target=_parent class=ISymbol>matrix_sum</a></div></div><div class=SRResult id=SR_matrix_undtest><div class=IEntry><a href="../files/core_matrix-c.html#matrix_test" target=_parent class=ISymbol>matrix_test</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsP.html b/sw/vendor/coremark/docs/html/search/FunctionsP.html
new file mode 100644
index 0000000..c4b9d2d
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsP.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_portable_undfini><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_fini" target=_parent class=ISymbol>portable_fini</a></div></div><div class=SRResult id=SR_portable_undfree><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_free" target=_parent class=ISymbol>portable_free</a></div></div><div class=SRResult id=SR_portable_undinit><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_init" target=_parent class=ISymbol>portable_init</a></div></div><div class=SRResult id=SR_portable_undmalloc><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_malloc" target=_parent class=ISymbol>portable_malloc</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsS.html b/sw/vendor/coremark/docs/html/search/FunctionsS.html
new file mode 100644
index 0000000..33dfa5f
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsS.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_start_undtime><div class=IEntry><a href="../files/linux/core_portme-c.html#start_time" target=_parent class=ISymbol>start_time</a></div></div><div class=SRResult id=SR_stop_undtime><div class=IEntry><a href="../files/linux/core_portme-c.html#stop_time" target=_parent class=ISymbol>stop_time</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/FunctionsT.html b/sw/vendor/coremark/docs/html/search/FunctionsT.html
new file mode 100644
index 0000000..65ae37c
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/FunctionsT.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_time_undin_undsecs><div class=IEntry><a href="../files/linux/core_portme-c.html#time_in_secs" target=_parent class=ISymbol>time_in_secs</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralB.html b/sw/vendor/coremark/docs/html/search/GeneralB.html
new file mode 100644
index 0000000..66e27e4
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralB.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Build_spcTargets><div class=IEntry><a href="javascript:searchResults.Toggle('SR_Build_spcTargets')" class=ISymbol>Build Targets</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#Build_Targets" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#Build_Targets" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_Building_spcand_spcrunning><div class=IEntry><a href="../files/readme-txt.html#Building_and_running" target=_parent class=ISymbol>Building and running</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralC.html b/sw/vendor/coremark/docs/html/search/GeneralC.html
new file mode 100644
index 0000000..f1ac9d2
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralC.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_CC><div class=IEntry><a href="../files/linux/core_portme-mak.html#CC" target=_parent class=ISymbol>CC</a></div></div><div class=SRResult id=SR_CFLAGS><div class=IEntry><a href="javascript:searchResults.Toggle('SR_CFLAGS')" class=ISymbol>CFLAGS</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#CFLAGS" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#CFLAGS" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_cmp_undcomplex><div class=IEntry><a href="../files/core_list_join-c.html#cmp_complex" target=_parent class=ISymbol>cmp_complex</a></div></div><div class=SRResult id=SR_cmp_undidx><div class=IEntry><a href="../files/core_list_join-c.html#cmp_idx" target=_parent class=ISymbol>cmp_idx</a></div></div><div class=SRResult id=SR_Configuration><div class=IEntry><a href="javascript:searchResults.Toggle('SR_Configuration')" class=ISymbol>Configuration</a><div class=ISubIndex><a href="../files/coremark-h.html#Configuration" target=_parent class=IFile>coremark.h</a><a href="../files/linux/core_portme-h.html#Configuration" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.h</a></div></div></div><div class=SRResult id=SR_core_undbench_undmatrix><div class=IEntry><a href="../files/core_matrix-c.html#core_bench_matrix" target=_parent class=ISymbol>core_bench_matrix</a></div></div><div class=SRResult id=SR_core_undbench_undstate><div class=IEntry><a href="../files/core_state-c.html#core_bench_state" target=_parent class=ISymbol>core_bench_state</a></div></div><div class=SRResult id=SR_core_undinit_undstate><div class=IEntry><a href="../files/core_state-c.html#core_init_state" target=_parent class=ISymbol>core_init_state</a></div></div><div class=SRResult id=SR_core_undlist_undfind><div class=IEntry><a href="../files/core_list_join-c.html#core_list_find" target=_parent class=ISymbol>core_list_find</a></div></div><div class=SRResult id=SR_core_undlist_undinit><div class=IEntry><a href="../files/core_list_join-c.html#core_list_init" target=_parent class=ISymbol>core_list_init</a></div></div><div class=SRResult id=SR_core_undlist_undinsert><div class=IEntry><a href="../files/core_list_join-c.html#core_list_insert" target=_parent class=ISymbol>core_list_insert</a></div></div><div class=SRResult id=SR_core_undlist_undjoin_perc><div class=IEntry><a href="../files/core_list_join-c.html#core_list_join.c" target=_parent class=ISymbol>core_list_join.c</a></div></div><div class=SRResult id=SR_core_undlist_undmergesort><div class=IEntry><a href="../files/core_list_join-c.html#core_list_mergesort" target=_parent class=ISymbol>core_list_mergesort</a></div></div><div class=SRResult id=SR_core_undlist_undremove><div class=IEntry><a href="../files/core_list_join-c.html#core_list_remove" target=_parent class=ISymbol>core_list_remove</a></div></div><div class=SRResult id=SR_core_undlist_undreverse><div class=IEntry><a href="../files/core_list_join-c.html#core_list_reverse" target=_parent class=ISymbol>core_list_reverse</a></div></div><div class=SRResult id=SR_core_undlist_undundo_undremove><div class=IEntry><a href="../files/core_list_join-c.html#core_list_undo_remove" target=_parent class=ISymbol>core_list_undo_remove</a></div></div><div class=SRResult id=SR_core_undmain_perc><div class=IEntry><a href="../files/core_main-c.html#core_main.c" target=_parent class=ISymbol>core_main.c</a></div></div><div class=SRResult id=SR_core_undmatrix_perc><div class=IEntry><a href="../files/core_matrix-c.html#core_matrix.c" target=_parent class=ISymbol>core_matrix.c</a></div></div><div class=SRResult id=SR_core_undportme_perc><div class=IEntry><a href="../files/linux/core_portme-c.html#core_portme.c" target=_parent class=ISymbol>core_portme.c</a></div></div><div class=SRResult id=SR_core_undportme_perh><div class=IEntry><a href="../files/linux/core_portme-h.html#core_portme.h" target=_parent class=ISymbol>core_portme.h</a></div></div><div class=SRResult id=SR_core_undportme_permak><div class=IEntry><a href="javascript:searchResults.Toggle('SR_core_undportme_permak')" class=ISymbol>core_portme.mak</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#core_portme.mak" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#core_portme.mak" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_core_undstart_undparallel><div class=IEntry><a href="../files/linux/core_portme-c.html#core_start_parallel" target=_parent class=ISymbol>core_start_parallel</a></div></div><div class=SRResult id=SR_core_undstate_perc><div class=IEntry><a href="../files/core_state-c.html#core_state.c" target=_parent class=ISymbol>core_state.c</a></div></div><div class=SRResult id=SR_core_undstate_undtransition><div class=IEntry><a href="../files/core_state-c.html#core_state_transition" target=_parent class=ISymbol>core_state_transition</a></div></div><div class=SRResult id=SR_core_undstop_undparallel><div class=IEntry><a href="../files/linux/core_portme-c.html#core_stop_parallel" target=_parent class=ISymbol>core_stop_parallel</a></div></div><div class=SRResult id=SR_CORE_undTICKS><div class=IEntry><a href="../files/linux/core_portme-h.html#CORE_TICKS" target=_parent class=ISymbol>CORE_TICKS</a></div></div><div class=SRResult id=SR_core_undutil_perc><div class=IEntry><a href="../files/core_util-c.html#core_util.c" target=_parent class=ISymbol>core_util.c</a></div></div><div class=SRResult id=SR_CoreMark><div class=IEntry><a href="../files/readme-txt.html#CoreMark" target=_parent class=ISymbol>CoreMark</a></div></div><div class=SRResult id=SR_coremark_perh><div class=IEntry><a href="../files/coremark-h.html#coremark.h" target=_parent class=ISymbol>coremark.h</a></div></div><div class=SRResult id=SR_crc_ast><div class=IEntry><a href="../files/core_util-c.html#crc*" target=_parent class=ISymbol>crc*</a></div></div><div class=SRResult id=SR_Credits><div class=IEntry><a href="../files/readme-txt.html#Credits" target=_parent class=ISymbol>Credits</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralD.html b/sw/vendor/coremark/docs/html/search/GeneralD.html
new file mode 100644
index 0000000..b3c2100
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralD.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_default_undnum_undcontexts><div class=IEntry><a href="../files/linux/core_portme-h.html#default_num_contexts" target=_parent class=ISymbol>default_num_contexts</a></div></div><div class=SRResult id=SR_Description><div class=IEntry><a href="javascript:searchResults.Toggle('SR_Description')" class=ISymbol>Description</a><div class=ISubIndex><a href="../files/core_list_join-c.html#Description" target=_parent class=IFile>core_list_join.c</a><a href="../files/core_matrix-c.html#Description" target=_parent class=IFile>core_matrix.c</a><a href="../files/core_state-c.html#Description" target=_parent class=IFile>core_state.c</a><a href="../files/coremark-h.html#Description" target=_parent class=IFile>coremark.h</a><a href="../files/linux/core_portme-h.html#Description" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.h</a></div></div></div><div class=SRResult id=SR_Documentation><div class=IEntry><a href="../files/readme-txt.html#Documentation" target=_parent class=ISymbol>Documentation</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralF.html b/sw/vendor/coremark/docs/html/search/GeneralF.html
new file mode 100644
index 0000000..126a24c
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralF.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Functions><div class=IEntry><a href="javascript:searchResults.Toggle('SR_Functions')" class=ISymbol>Functions</a><div class=ISubIndex><a href="../files/core_list_join-c.html#Functions" target=_parent class=IFile>core_list_join.c</a><a href="../files/core_main-c.html#Functions" target=_parent class=IFile>core_main.c</a><a href="../files/core_matrix-c.html#Functions" target=_parent class=IFile>core_matrix.c</a><a href="../files/core_state-c.html#Functions" target=_parent class=IFile>core_state.c</a><a href="../files/core_util-c.html#Functions" target=_parent class=IFile>core_util.c</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralG.html b/sw/vendor/coremark/docs/html/search/GeneralG.html
new file mode 100644
index 0000000..217e854
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralG.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_get_undseed><div class=IEntry><a href="../files/core_util-c.html#get_seed" target=_parent class=ISymbol>get_seed</a></div></div><div class=SRResult id=SR_get_undtime><div class=IEntry><a href="../files/linux/core_portme-c.html#get_time" target=_parent class=ISymbol>get_time</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralH.html b/sw/vendor/coremark/docs/html/search/GeneralH.html
new file mode 100644
index 0000000..3b0c392
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralH.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_HAS_undFLOAT><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_FLOAT" target=_parent class=ISymbol>HAS_FLOAT</a></div></div><div class=SRResult id=SR_HAS_undPRINTF><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_PRINTF" target=_parent class=ISymbol>HAS_PRINTF</a></div></div><div class=SRResult id=SR_HAS_undSTDIO><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_STDIO" target=_parent class=ISymbol>HAS_STDIO</a></div></div><div class=SRResult id=SR_HAS_undTIME_undH><div class=IEntry><a href="../files/linux/core_portme-h.html#HAS_TIME_H" target=_parent class=ISymbol>HAS_TIME_H</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralI.html b/sw/vendor/coremark/docs/html/search/GeneralI.html
new file mode 100644
index 0000000..f17354d
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralI.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_iterate><div class=IEntry><a href="../files/core_main-c.html#iterate" target=_parent class=ISymbol>iterate</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralL.html b/sw/vendor/coremark/docs/html/search/GeneralL.html
new file mode 100644
index 0000000..22a700c
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralL.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Legal><div class=IEntry><a href="../files/readme-txt.html#Legal" target=_parent class=ISymbol>Legal</a></div></div><div class=SRResult id=SR_LFLAGS_undEND><div class=IEntry><a href="javascript:searchResults.Toggle('SR_LFLAGS_undEND')" class=ISymbol>LFLAGS_END</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#LFLAGS_END" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#LFLAGS_END" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_LOAD><div class=IEntry><a href="../files/linux/core_portme-mak.html#LOAD" target=_parent class=ISymbol>LOAD</a></div></div><div class=SRResult id=SR_Log_spcFile_spcFormat><div class=IEntry><a href="../files/readme-txt.html#Log_File_Format" target=_parent class=ISymbol>Log File Format</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralM.html b/sw/vendor/coremark/docs/html/search/GeneralM.html
new file mode 100644
index 0000000..57f55b2
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralM.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_main><div class=IEntry><a href="../files/core_main-c.html#main" target=_parent class=ISymbol>main</a></div></div><div class=SRResult id=SR_MAIN_undHAS_undNOARGC><div class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NOARGC" target=_parent class=ISymbol>MAIN_HAS_NOARGC</a></div></div><div class=SRResult id=SR_MAIN_undHAS_undNORETURN><div class=IEntry><a href="../files/linux/core_portme-h.html#MAIN_HAS_NORETURN" target=_parent class=ISymbol>MAIN_HAS_NORETURN</a></div></div><div class=SRResult id=SR_matrix_undadd_undconst><div class=IEntry><a href="../files/core_matrix-c.html#matrix_add_const" target=_parent class=ISymbol>matrix_add_const</a></div></div><div class=SRResult id=SR_matrix_undmul_undconst><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_const" target=_parent class=ISymbol>matrix_mul_const</a></div></div><div class=SRResult id=SR_matrix_undmul_undmatrix><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix" target=_parent class=ISymbol>matrix_mul_matrix</a></div></div><div class=SRResult id=SR_matrix_undmul_undmatrix_undbitextract><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_matrix_bitextract" target=_parent class=ISymbol>matrix_mul_matrix_bitextract</a></div></div><div class=SRResult id=SR_matrix_undmul_undvect><div class=IEntry><a href="../files/core_matrix-c.html#matrix_mul_vect" target=_parent class=ISymbol>matrix_mul_vect</a></div></div><div class=SRResult id=SR_matrix_undsum><div class=IEntry><a href="../files/core_matrix-c.html#matrix_sum" target=_parent class=ISymbol>matrix_sum</a></div></div><div class=SRResult id=SR_matrix_undtest><div class=IEntry><a href="../files/core_matrix-c.html#matrix_test" target=_parent class=ISymbol>matrix_test</a></div></div><div class=SRResult id=SR_MEM_undMETHOD><div class=IEntry><a href="../files/linux/core_portme-h.html#MEM_METHOD" target=_parent class=ISymbol>MEM_METHOD</a></div></div><div class=SRResult id=SR_MULTITHREAD><div class=IEntry><a href="../files/linux/core_portme-h.html#MULTITHREAD" target=_parent class=ISymbol>MULTITHREAD</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralO.html b/sw/vendor/coremark/docs/html/search/GeneralO.html
new file mode 100644
index 0000000..b14f180
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralO.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_OPATH><div class=IEntry><a href="javascript:searchResults.Toggle('SR_OPATH')" class=ISymbol>OPATH</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OPATH" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OPATH" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_OUTFLAG><div class=IEntry><a href="javascript:searchResults.Toggle('SR_OUTFLAG')" class=ISymbol>OUTFLAG</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OUTFLAG" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OUTFLAG" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralP.html b/sw/vendor/coremark/docs/html/search/GeneralP.html
new file mode 100644
index 0000000..063a6c1
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralP.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_PERL><div class=IEntry><a href="javascript:searchResults.Toggle('SR_PERL')" class=ISymbol>PERL</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PERL" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PERL" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_PORT_undOBJS><div class=IEntry><a href="javascript:searchResults.Toggle('SR_PORT_undOBJS')" class=ISymbol>PORT_OBJS</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PORT_OBJS" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PORT_OBJS" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpostbuild><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpostbuild')" class=ISymbol>port_postbuild</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postbuild" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postbuild" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpostload><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpostload')" class=ISymbol>port_postload</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postload" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postload" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpostrun><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpostrun')" class=ISymbol>port_postrun</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_postrun" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_postrun" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undprebuild><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undprebuild')" class=ISymbol>port_prebuild</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prebuild" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prebuild" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undpreload><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undpreload')" class=ISymbol>port_preload</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_preload" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_preload" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_port_undprerun><div class=IEntry><a href="javascript:searchResults.Toggle('SR_port_undprerun')" class=ISymbol>port_prerun</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#port_prerun" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#port_prerun" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_PORT_undSRCS><div class=IEntry><a href="../files/linux/core_portme-mak.html#PORT_SRCS" target=_parent class=ISymbol>PORT_SRCS</a></div></div><div class=SRResult id=SR_portable_undfini><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_fini" target=_parent class=ISymbol>portable_fini</a></div></div><div class=SRResult id=SR_portable_undfree><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_free" target=_parent class=ISymbol>portable_free</a></div></div><div class=SRResult id=SR_portable_undinit><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_init" target=_parent class=ISymbol>portable_init</a></div></div><div class=SRResult id=SR_portable_undmalloc><div class=IEntry><a href="../files/linux/core_portme-c.html#portable_malloc" target=_parent class=ISymbol>portable_malloc</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralR.html b/sw/vendor/coremark/docs/html/search/GeneralR.html
new file mode 100644
index 0000000..24f3395
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralR.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Release_spcNotes><div class=IEntry><a href="../files/release_notes-txt.html#Release_Notes" target=_parent class=ISymbol>Release Notes</a></div></div><div class=SRResult id=SR_Reporting_spcrules><div class=IEntry><a href="../files/readme-txt.html#Reporting_rules" target=_parent class=ISymbol>Reporting rules</a></div></div><div class=SRResult id=SR_RUN><div class=IEntry><a href="../files/linux/core_portme-mak.html#RUN" target=_parent class=ISymbol>RUN</a></div></div><div class=SRResult id=SR_Run_spcrules><div class=IEntry><a href="../files/readme-txt.html#Run_rules" target=_parent class=ISymbol>Run rules</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralS.html b/sw/vendor/coremark/docs/html/search/GeneralS.html
new file mode 100644
index 0000000..a18c407
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralS.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_secs_undret><div class=IEntry><a href="../files/coremark-h.html#secs_ret" target=_parent class=ISymbol>secs_ret</a></div></div><div class=SRResult id=SR_SEED_undMETHOD><div class=IEntry><a href="../files/linux/core_portme-h.html#SEED_METHOD" target=_parent class=ISymbol>SEED_METHOD</a></div></div><div class=SRResult id=SR_SEPARATE_undCOMPILE><div class=IEntry><a href="javascript:searchResults.Toggle('SR_SEPARATE_undCOMPILE')" class=ISymbol>SEPARATE_COMPILE</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#SEPARATE_COMPILE" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#SEPARATE_COMPILE" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_start_undtime><div class=IEntry><a href="../files/linux/core_portme-c.html#start_time" target=_parent class=ISymbol>start_time</a></div></div><div class=SRResult id=SR_stop_undtime><div class=IEntry><a href="../files/linux/core_portme-c.html#stop_time" target=_parent class=ISymbol>stop_time</a></div></div><div class=SRResult id=SR_Submitting_spcresults><div class=IEntry><a href="../files/readme-txt.html#Submitting_results" target=_parent class=ISymbol>Submitting results</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralT.html b/sw/vendor/coremark/docs/html/search/GeneralT.html
new file mode 100644
index 0000000..a2fde7e
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralT.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_time_undin_undsecs><div class=IEntry><a href="../files/linux/core_portme-c.html#time_in_secs" target=_parent class=ISymbol>time_in_secs</a></div></div><div class=SRResult id=SR_TIMER_undRES_undDIVIDER><div class=IEntry><a href="../files/linux/core_portme-c.html#TIMER_RES_DIVIDER" target=_parent class=ISymbol>TIMER_RES_DIVIDER</a></div></div><div class=SRResult id=SR_TOTAL_undDATA_undSIZE><div class=IEntry><a href="../files/coremark-h.html#TOTAL_DATA_SIZE" target=_parent class=ISymbol>TOTAL_DATA_SIZE</a></div></div><div class=SRResult id=SR_Types><div class=IEntry><a href="../files/coremark-h.html#Types" target=_parent class=ISymbol>Types</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralU.html b/sw/vendor/coremark/docs/html/search/GeneralU.html
new file mode 100644
index 0000000..d9b46a5
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralU.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_USE_undCLOCK><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_CLOCK" target=_parent class=ISymbol>USE_CLOCK</a></div></div><div class=SRResult id=SR_USE_undFORK><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_FORK" target=_parent class=ISymbol>USE_FORK</a></div></div><div class=SRResult id=SR_USE_undPTHREAD><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_PTHREAD" target=_parent class=ISymbol>USE_PTHREAD</a></div></div><div class=SRResult id=SR_USE_undSOCKET><div class=IEntry><a href="../files/linux/core_portme-h.html#USE_SOCKET" target=_parent class=ISymbol>USE_SOCKET</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralV.html b/sw/vendor/coremark/docs/html/search/GeneralV.html
new file mode 100644
index 0000000..9c53066
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralV.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Variables><div class=IEntry><a href="javascript:searchResults.Toggle('SR_Variables')" class=ISymbol>Variables</a><div class=ISubIndex><a href="../files/linux/core_portme-h.html#Variables" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.h</a><a href="../files/linux/core_portme-mak.html#Variables" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#Variables" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/GeneralW.html b/sw/vendor/coremark/docs/html/search/GeneralW.html
new file mode 100644
index 0000000..e22dcb0
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/GeneralW.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_Welcome><div class=IEntry><a href="../files/readme-txt.html#Welcome" target=_parent class=ISymbol>Welcome</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/NoResults.html b/sw/vendor/coremark/docs/html/search/NoResults.html
new file mode 100644
index 0000000..49e3859
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/NoResults.html
@@ -0,0 +1,13 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=NoMatches>No Matches</div></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/TypesS.html b/sw/vendor/coremark/docs/html/search/TypesS.html
new file mode 100644
index 0000000..3d87649
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/TypesS.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_secs_undret><div class=IEntry><a href="../files/coremark-h.html#secs_ret" target=_parent class=ISymbol>secs_ret</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesC.html b/sw/vendor/coremark/docs/html/search/VariablesC.html
new file mode 100644
index 0000000..d3bdfef
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesC.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_CC><div class=IEntry><a href="../files/linux/core_portme-mak.html#CC" target=_parent class=ISymbol>CC</a></div></div><div class=SRResult id=SR_CFLAGS><div class=IEntry><a href="javascript:searchResults.Toggle('SR_CFLAGS')" class=ISymbol>CFLAGS</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#CFLAGS" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#CFLAGS" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesD.html b/sw/vendor/coremark/docs/html/search/VariablesD.html
new file mode 100644
index 0000000..d4b961d
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesD.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_default_undnum_undcontexts><div class=IEntry><a href="../files/linux/core_portme-h.html#default_num_contexts" target=_parent class=ISymbol>default_num_contexts</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesL.html b/sw/vendor/coremark/docs/html/search/VariablesL.html
new file mode 100644
index 0000000..09e4b9a
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesL.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_LFLAGS_undEND><div class=IEntry><a href="javascript:searchResults.Toggle('SR_LFLAGS_undEND')" class=ISymbol>LFLAGS_END</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#LFLAGS_END" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#LFLAGS_END" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_LOAD><div class=IEntry><a href="../files/linux/core_portme-mak.html#LOAD" target=_parent class=ISymbol>LOAD</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesO.html b/sw/vendor/coremark/docs/html/search/VariablesO.html
new file mode 100644
index 0000000..b14f180
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesO.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_OPATH><div class=IEntry><a href="javascript:searchResults.Toggle('SR_OPATH')" class=ISymbol>OPATH</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OPATH" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OPATH" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_OUTFLAG><div class=IEntry><a href="javascript:searchResults.Toggle('SR_OUTFLAG')" class=ISymbol>OUTFLAG</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#OUTFLAG" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#OUTFLAG" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesP.html b/sw/vendor/coremark/docs/html/search/VariablesP.html
new file mode 100644
index 0000000..c687999
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesP.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_PERL><div class=IEntry><a href="javascript:searchResults.Toggle('SR_PERL')" class=ISymbol>PERL</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PERL" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PERL" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_PORT_undOBJS><div class=IEntry><a href="javascript:searchResults.Toggle('SR_PORT_undOBJS')" class=ISymbol>PORT_OBJS</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#PORT_OBJS" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#PORT_OBJS" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div><div class=SRResult id=SR_PORT_undSRCS><div class=IEntry><a href="../files/linux/core_portme-mak.html#PORT_SRCS" target=_parent class=ISymbol>PORT_SRCS</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesR.html b/sw/vendor/coremark/docs/html/search/VariablesR.html
new file mode 100644
index 0000000..9cd771d
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesR.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_RUN><div class=IEntry><a href="../files/linux/core_portme-mak.html#RUN" target=_parent class=ISymbol>RUN</a></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/search/VariablesS.html b/sw/vendor/coremark/docs/html/search/VariablesS.html
new file mode 100644
index 0000000..a1280a7
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/search/VariablesS.html
@@ -0,0 +1,18 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd">
+
+<html><head><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script></head><body class="PopupSearchResultsPage" onLoad="NDOnLoad()"><script language=JavaScript><!--
+if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
+
+<!-- Copyright 2009 EEMBC -->
+<!-- saved from url=(0026)http://www.naturaldocs.org -->
+
+
+
+
+<div id=Index><div class=SRStatus id=Loading>Loading...</div><table border=0 cellspacing=0 cellpadding=0><div class=SRResult id=SR_SEPARATE_undCOMPILE><div class=IEntry><a href="javascript:searchResults.Toggle('SR_SEPARATE_undCOMPILE')" class=ISymbol>SEPARATE_COMPILE</a><div class=ISubIndex><a href="../files/linux/core_portme-mak.html#SEPARATE_COMPILE" target=_parent class=IFile>linux/<span class=HB> </span>core_portme.mak</a><a href="../files/PIC32/core_portme-mak.html#SEPARATE_COMPILE" target=_parent class=IFile>PIC32/<span class=HB> </span>core_portme.mak</a></div></div></div></table><div class=SRStatus id=Searching>Searching...</div><div class=SRStatus id=NoMatches>No Matches</div><script type="text/javascript"><!--
+document.getElementById("Loading").style.display="none";
+document.getElementById("NoMatches").style.display="none";
+var searchResults = new SearchResults("searchResults", "HTML");
+searchResults.Search();
+--></script></div><script language=JavaScript><!--
+if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>
\ No newline at end of file
diff --git a/sw/vendor/coremark/docs/html/styles/1.css b/sw/vendor/coremark/docs/html/styles/1.css
new file mode 100644
index 0000000..d5a8bd6
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/styles/1.css
@@ -0,0 +1,767 @@
+/*
+ IMPORTANT: If you're editing this file in the output directory of one of
+ your projects, your changes will be overwritten the next time you run
+ Natural Docs. Instead, copy this file to your project directory, make your
+ changes, and you can use it with -s. Even better would be to make a CSS
+ file in your project directory with only your changes, which you can then
+ use with -s [original style] [your changes].
+
+ On the other hand, if you're editing this file in the Natural Docs styles
+ directory, the changes will automatically be applied to all your projects
+ that use this style the next time Natural Docs is run on them.
+
+ This file is part of Natural Docs, which is Copyright (C) 2003-2008 Greg Valure
+ Natural Docs is licensed under the GPL
+*/
+
+body {
+ font: 10pt Verdana, Arial, sans-serif;
+ color: #000000;
+ margin: 0; padding: 0;
+ }
+
+.ContentPage,
+.IndexPage,
+.FramedMenuPage {
+ background-color: #E8E8E8;
+ }
+.FramedContentPage,
+.FramedIndexPage,
+.FramedSearchResultsPage,
+.PopupSearchResultsPage {
+ background-color: #FFFFFF;
+ }
+
+
+a:link,
+a:visited { color: #900000; text-decoration: none }
+a:hover { color: #900000; text-decoration: underline }
+a:active { color: #FF0000; text-decoration: underline }
+
+td {
+ vertical-align: top }
+
+img { border: 0; }
+
+
+/*
+ Comment out this line to use web-style paragraphs (blank line between
+ paragraphs, no indent) instead of print-style paragraphs (no blank line,
+ indented.)
+*/
+p {
+ text-indent: 5ex; margin: 0 }
+
+
+/* Can't use something like display: none or it won't break. */
+.HB {
+ font-size: 1px;
+ visibility: hidden;
+ }
+
+/* Blockquotes are used as containers for things that may need to scroll. */
+blockquote {
+ padding: 0;
+ margin: 0;
+ overflow: auto;
+ }
+
+
+.Firefox1 blockquote {
+ padding-bottom: .5em;
+ }
+
+/* Turn off scrolling when printing. */
+@media print {
+ blockquote {
+ overflow: visible;
+ }
+ .IE blockquote {
+ width: auto;
+ }
+ }
+
+
+
+#Menu {
+ font-size: 9pt;
+ padding: 10px 0 0 0;
+ }
+.ContentPage #Menu,
+.IndexPage #Menu {
+ position: absolute;
+ top: 0;
+ left: 0;
+ width: 31ex;
+ overflow: hidden;
+ }
+.ContentPage .Firefox #Menu,
+.IndexPage .Firefox #Menu {
+ width: 27ex;
+ }
+
+
+ .MTitle {
+ font-size: 16pt; font-weight: bold; font-variant: small-caps;
+ text-align: center;
+ padding: 5px 10px 15px 10px;
+ border-bottom: 1px dotted #000000;
+ margin-bottom: 15px }
+
+ .MSubTitle {
+ font-size: 9pt; font-weight: normal; font-variant: normal;
+ margin-top: 1ex; margin-bottom: 5px }
+
+
+ .MEntry a:link,
+ .MEntry a:hover,
+ .MEntry a:visited { color: #606060; margin-right: 0 }
+ .MEntry a:active { color: #A00000; margin-right: 0 }
+
+
+ .MGroup {
+ font-variant: small-caps; font-weight: bold;
+ margin: 1em 0 1em 10px;
+ }
+
+ .MGroupContent {
+ font-variant: normal; font-weight: normal }
+
+ .MGroup a:link,
+ .MGroup a:hover,
+ .MGroup a:visited { color: #545454; margin-right: 10px }
+ .MGroup a:active { color: #A00000; margin-right: 10px }
+
+
+ .MFile,
+ .MText,
+ .MLink,
+ .MIndex {
+ padding: 1px 17px 2px 10px;
+ margin: .25em 0 .25em 0;
+ }
+
+ .MText {
+ font-size: 8pt; font-style: italic }
+
+ .MLink {
+ font-style: italic }
+
+ #MSelected {
+ color: #000000; background-color: #FFFFFF;
+ /* Replace padding with border. */
+ padding: 0 10px 0 10px;
+ border-width: 1px 2px 2px 0; border-style: solid; border-color: #000000;
+ margin-right: 5px;
+ }
+
+ /* Close off the left side when its in a group. */
+ .MGroup #MSelected {
+ padding-left: 9px; border-left-width: 1px }
+
+ /* A treat for Mozilla users. Blatantly non-standard. Will be replaced with CSS 3 attributes when finalized/supported. */
+ .Firefox #MSelected {
+ -moz-border-radius-topright: 10px;
+ -moz-border-radius-bottomright: 10px }
+ .Firefox .MGroup #MSelected {
+ -moz-border-radius-topleft: 10px;
+ -moz-border-radius-bottomleft: 10px }
+
+
+ #MSearchPanel {
+ padding: 0px 6px;
+ margin: .25em 0;
+ }
+
+
+ #MSearchField {
+ font: italic 9pt Verdana, sans-serif;
+ color: #606060;
+ background-color: #E8E8E8;
+ border: none;
+ padding: 2px 4px;
+ width: 100%;
+ }
+ /* Only Opera gets it right. */
+ .Firefox #MSearchField,
+ .IE #MSearchField,
+ .Safari #MSearchField {
+ width: 94%;
+ }
+ .Opera9 #MSearchField,
+ .Konqueror #MSearchField {
+ width: 97%;
+ }
+ .FramedMenuPage .Firefox #MSearchField,
+ .FramedMenuPage .Safari #MSearchField,
+ .FramedMenuPage .Konqueror #MSearchField {
+ width: 98%;
+ }
+
+ /* Firefox doesn't do this right in frames without #MSearchPanel added on.
+ It's presence doesn't hurt anything other browsers. */
+ #MSearchPanel.MSearchPanelInactive:hover #MSearchField {
+ background-color: #FFFFFF;
+ border: 1px solid #C0C0C0;
+ padding: 1px 3px;
+ }
+ .MSearchPanelActive #MSearchField {
+ background-color: #FFFFFF;
+ border: 1px solid #C0C0C0;
+ font-style: normal;
+ padding: 1px 3px;
+ }
+
+ #MSearchType {
+ visibility: hidden;
+ font: 8pt Verdana, sans-serif;
+ width: 98%;
+ padding: 0;
+ border: 1px solid #C0C0C0;
+ }
+ .MSearchPanelActive #MSearchType,
+ /* As mentioned above, Firefox doesn't do this right in frames without #MSearchPanel added on. */
+ #MSearchPanel.MSearchPanelInactive:hover #MSearchType,
+ #MSearchType:focus {
+ visibility: visible;
+ color: #606060;
+ }
+ #MSearchType option#MSearchEverything {
+ font-weight: bold;
+ }
+
+ .Opera8 .MSearchPanelInactive:hover,
+ .Opera8 .MSearchPanelActive {
+ margin-left: -1px;
+ }
+
+
+ iframe#MSearchResults {
+ width: 60ex;
+ height: 15em;
+ }
+ #MSearchResultsWindow {
+ display: none;
+ position: absolute;
+ left: 0; top: 0;
+ border: 1px solid #000000;
+ background-color: #E8E8E8;
+ }
+ #MSearchResultsWindowClose {
+ font-weight: bold;
+ font-size: 8pt;
+ display: block;
+ padding: 2px 5px;
+ }
+ #MSearchResultsWindowClose:link,
+ #MSearchResultsWindowClose:visited {
+ color: #000000;
+ text-decoration: none;
+ }
+ #MSearchResultsWindowClose:active,
+ #MSearchResultsWindowClose:hover {
+ color: #800000;
+ text-decoration: none;
+ background-color: #F4F4F4;
+ }
+
+
+
+
+#Content {
+ padding-bottom: 15px;
+ }
+
+.ContentPage #Content {
+ border-width: 0 0 1px 1px;
+ border-style: solid;
+ border-color: #000000;
+ background-color: #FFFFFF;
+ font-size: 9pt; /* To make 31ex match the menu's 31ex. */
+ margin-left: 31ex;
+ }
+.ContentPage .Firefox #Content {
+ margin-left: 27ex;
+ }
+
+
+
+ .CTopic {
+ font-size: 10pt;
+ margin-bottom: 3em;
+ }
+
+
+ .CTitle {
+ font-size: 12pt; font-weight: bold;
+ border-width: 0 0 1px 0; border-style: solid; border-color: #A0A0A0;
+ margin: 0 15px .5em 15px }
+
+ .CGroup .CTitle {
+ font-size: 16pt; font-variant: small-caps;
+ padding-left: 15px; padding-right: 15px;
+ border-width: 0 0 2px 0; border-color: #000000;
+ margin-left: 0; margin-right: 0 }
+
+ .CClass .CTitle,
+ .CInterface .CTitle,
+ .CDatabase .CTitle,
+ .CDatabaseTable .CTitle,
+ .CSection .CTitle {
+ font-size: 18pt;
+ color: #FFFFFF; background-color: #A0A0A0;
+ padding: 10px 15px 10px 15px;
+ border-width: 2px 0; border-color: #000000;
+ margin-left: 0; margin-right: 0 }
+
+ #MainTopic .CTitle {
+ font-size: 20pt;
+ color: #FFFFFF; background-color: #7070C0;
+ padding: 10px 15px 10px 15px;
+ border-width: 0 0 3px 0; border-color: #000000;
+ margin-left: 0; margin-right: 0 }
+
+ .CBody {
+ margin-left: 15px; margin-right: 15px }
+
+
+ .CToolTip {
+ position: absolute; visibility: hidden;
+ left: 0; top: 0;
+ background-color: #FFFFE0;
+ padding: 5px;
+ border-width: 1px 2px 2px 1px; border-style: solid; border-color: #000000;
+ font-size: 8pt;
+ }
+
+ .Opera .CToolTip {
+ max-width: 98%;
+ }
+
+ /* Scrollbars would be useless. */
+ .CToolTip blockquote {
+ overflow: hidden;
+ }
+ .IE6 .CToolTip blockquote {
+ overflow: visible;
+ }
+
+ .CHeading {
+ font-weight: bold; font-size: 10pt;
+ margin: 1.5em 0 .5em 0;
+ }
+
+ .CBody pre {
+ font: 10pt "Courier New", Courier, monospace;
+ margin: 1em 0;
+ }
+
+ .CBody ul {
+ /* I don't know why CBody's margin doesn't apply, but it's consistent across browsers so whatever.
+ Reapply it here as padding. */
+ padding-left: 15px; padding-right: 15px;
+ margin: .5em 5ex .5em 5ex;
+ }
+
+ .CDescriptionList {
+ margin: .5em 5ex 0 5ex }
+
+ .CDLEntry {
+ font: 10pt "Courier New", Courier, monospace; color: #808080;
+ padding-bottom: .25em;
+ white-space: nowrap }
+
+ .CDLDescription {
+ font-size: 10pt; /* For browsers that don't inherit correctly, like Opera 5. */
+ padding-bottom: .5em; padding-left: 5ex }
+
+
+ .CTopic img {
+ text-align: center;
+ display: block;
+ margin: 1em auto;
+ }
+ .CImageCaption {
+ font-variant: small-caps;
+ font-size: 8pt;
+ color: #808080;
+ text-align: center;
+ position: relative;
+ top: 1em;
+ }
+
+ .CImageLink {
+ color: #808080;
+ font-style: italic;
+ }
+ a.CImageLink:link,
+ a.CImageLink:visited,
+ a.CImageLink:hover { color: #808080 }
+
+
+
+
+
+.Prototype {
+ font: 10pt "Courier New", Courier, monospace;
+ padding: 5px 3ex;
+ border-width: 1px; border-style: solid;
+ margin: 0 5ex 1.5em 5ex;
+ }
+
+ .Prototype td {
+ font-size: 10pt;
+ }
+
+ .PDefaultValue,
+ .PDefaultValuePrefix,
+ .PTypePrefix {
+ color: #8F8F8F;
+ }
+ .PTypePrefix {
+ text-align: right;
+ }
+ .PAfterParameters {
+ vertical-align: bottom;
+ }
+
+ .IE .Prototype table {
+ padding: 0;
+ }
+
+ .CFunction .Prototype {
+ background-color: #F4F4F4; border-color: #D0D0D0 }
+ .CProperty .Prototype {
+ background-color: #F4F4FF; border-color: #C0C0E8 }
+ .CVariable .Prototype {
+ background-color: #FFFFF0; border-color: #E0E0A0 }
+
+ .CClass .Prototype {
+ border-width: 1px 2px 2px 1px; border-style: solid; border-color: #A0A0A0;
+ background-color: #F4F4F4;
+ }
+ .CInterface .Prototype {
+ border-width: 1px 2px 2px 1px; border-style: solid; border-color: #A0A0D0;
+ background-color: #F4F4FF;
+ }
+
+ .CDatabaseIndex .Prototype,
+ .CConstant .Prototype {
+ background-color: #D0D0D0; border-color: #000000 }
+ .CType .Prototype,
+ .CEnumeration .Prototype {
+ background-color: #FAF0F0; border-color: #E0B0B0;
+ }
+ .CDatabaseTrigger .Prototype,
+ .CEvent .Prototype,
+ .CDelegate .Prototype {
+ background-color: #F0FCF0; border-color: #B8E4B8 }
+
+ .CToolTip .Prototype {
+ margin: 0 0 .5em 0;
+ white-space: nowrap;
+ }
+
+
+
+
+
+.Summary {
+ margin: 1.5em 5ex 0 5ex }
+
+ .STitle {
+ font-size: 12pt; font-weight: bold;
+ margin-bottom: .5em }
+
+
+ .SBorder {
+ background-color: #FFFFF0;
+ padding: 15px;
+ border: 1px solid #C0C060 }
+
+ /* In a frame IE 6 will make them too long unless you set the width to 100%. Without frames it will be correct without a width
+ or slightly too long (but not enough to scroll) with a width. This arbitrary weirdness simply astounds me. IE 7 has the same
+ problem with frames, haven't tested it without. */
+ .FramedContentPage .IE .SBorder {
+ width: 100% }
+
+ /* A treat for Mozilla users. Blatantly non-standard. Will be replaced with CSS 3 attributes when finalized/supported. */
+ .Firefox .SBorder {
+ -moz-border-radius: 20px }
+
+
+ .STable {
+ font-size: 9pt; width: 100% }
+
+ .SEntry {
+ width: 30% }
+ .SDescription {
+ width: 70% }
+
+
+ .SMarked {
+ background-color: #F8F8D8 }
+
+ .SDescription { padding-left: 2ex }
+ .SIndent1 .SEntry { padding-left: 1.5ex } .SIndent1 .SDescription { padding-left: 3.5ex }
+ .SIndent2 .SEntry { padding-left: 3.0ex } .SIndent2 .SDescription { padding-left: 5.0ex }
+ .SIndent3 .SEntry { padding-left: 4.5ex } .SIndent3 .SDescription { padding-left: 6.5ex }
+ .SIndent4 .SEntry { padding-left: 6.0ex } .SIndent4 .SDescription { padding-left: 8.0ex }
+ .SIndent5 .SEntry { padding-left: 7.5ex } .SIndent5 .SDescription { padding-left: 9.5ex }
+
+ .SDescription a { color: #800000}
+ .SDescription a:active { color: #A00000 }
+
+ .SGroup td {
+ padding-top: .5em; padding-bottom: .25em }
+
+ .SGroup .SEntry {
+ font-weight: bold; font-variant: small-caps }
+
+ .SGroup .SEntry a { color: #800000 }
+ .SGroup .SEntry a:active { color: #F00000 }
+
+
+ .SMain td,
+ .SClass td,
+ .SDatabase td,
+ .SDatabaseTable td,
+ .SSection td {
+ font-size: 10pt;
+ padding-bottom: .25em }
+
+ .SClass td,
+ .SDatabase td,
+ .SDatabaseTable td,
+ .SSection td {
+ padding-top: 1em }
+
+ .SMain .SEntry,
+ .SClass .SEntry,
+ .SDatabase .SEntry,
+ .SDatabaseTable .SEntry,
+ .SSection .SEntry {
+ font-weight: bold;
+ }
+
+ .SMain .SEntry a,
+ .SClass .SEntry a,
+ .SDatabase .SEntry a,
+ .SDatabaseTable .SEntry a,
+ .SSection .SEntry a { color: #000000 }
+
+ .SMain .SEntry a:active,
+ .SClass .SEntry a:active,
+ .SDatabase .SEntry a:active,
+ .SDatabaseTable .SEntry a:active,
+ .SSection .SEntry a:active { color: #A00000 }
+
+
+
+
+
+.ClassHierarchy {
+ margin: 0 15px 1em 15px }
+
+ .CHEntry {
+ border-width: 1px 2px 2px 1px; border-style: solid; border-color: #A0A0A0;
+ margin-bottom: 3px;
+ padding: 2px 2ex;
+ font-size: 10pt;
+ background-color: #F4F4F4; color: #606060;
+ }
+
+ .Firefox .CHEntry {
+ -moz-border-radius: 4px;
+ }
+
+ .CHCurrent .CHEntry {
+ font-weight: bold;
+ border-color: #000000;
+ color: #000000;
+ }
+
+ .CHChildNote .CHEntry {
+ font-style: italic;
+ font-size: 8pt;
+ }
+
+ .CHIndent {
+ margin-left: 3ex;
+ }
+
+ .CHEntry a:link,
+ .CHEntry a:visited,
+ .CHEntry a:hover {
+ color: #606060;
+ }
+ .CHEntry a:active {
+ color: #800000;
+ }
+
+
+
+
+
+#Index {
+ background-color: #FFFFFF;
+ }
+
+/* As opposed to .PopupSearchResultsPage #Index */
+.IndexPage #Index,
+.FramedIndexPage #Index,
+.FramedSearchResultsPage #Index {
+ padding: 15px;
+ }
+
+.IndexPage #Index {
+ border-width: 0 0 1px 1px;
+ border-style: solid;
+ border-color: #000000;
+ font-size: 9pt; /* To make 27ex match the menu's 27ex. */
+ margin-left: 27ex;
+ }
+
+
+ .IPageTitle {
+ font-size: 20pt; font-weight: bold;
+ color: #FFFFFF; background-color: #7070C0;
+ padding: 10px 15px 10px 15px;
+ border-width: 0 0 3px 0; border-color: #000000; border-style: solid;
+ margin: -15px -15px 0 -15px }
+
+ .FramedSearchResultsPage .IPageTitle {
+ margin-bottom: 15px;
+ }
+
+ .INavigationBar {
+ font-size: 10pt;
+ text-align: center;
+ background-color: #FFFFF0;
+ padding: 5px;
+ border-bottom: solid 1px black;
+ margin: 0 -15px 15px -15px;
+ }
+
+ .INavigationBar a {
+ font-weight: bold }
+
+ .IHeading {
+ font-size: 16pt; font-weight: bold;
+ padding: 2.5em 0 .5em 0;
+ text-align: center;
+ width: 3.5ex;
+ }
+ #IFirstHeading {
+ padding-top: 0;
+ }
+
+ .IEntry {
+ font-size: 10pt;
+ padding-left: 1ex;
+ }
+ .PopupSearchResultsPage .IEntry {
+ font-size: 8pt;
+ padding: 1px 5px;
+ }
+ .PopupSearchResultsPage .Opera9 .IEntry,
+ .FramedSearchResultsPage .Opera9 .IEntry {
+ text-align: left;
+ }
+ .FramedSearchResultsPage .IEntry {
+ padding: 0;
+ }
+
+ .ISubIndex {
+ padding-left: 3ex; padding-bottom: .5em }
+ .PopupSearchResultsPage .ISubIndex {
+ display: none;
+ }
+
+ /* While it may cause some entries to look like links when they aren't, I found it's much easier to read the
+ index if everything's the same color. */
+ .ISymbol {
+ font-weight: bold; color: #900000 }
+
+ .IndexPage .ISymbolPrefix,
+ .FramedIndexPage .ISymbolPrefix {
+ font-size: 10pt;
+ text-align: right;
+ color: #C47C7C;
+ background-color: #F8F8F8;
+ border-right: 3px solid #E0E0E0;
+ border-left: 1px solid #E0E0E0;
+ padding: 0 1px 0 2px;
+ }
+ .PopupSearchResultsPage .ISymbolPrefix,
+ .FramedSearchResultsPage .ISymbolPrefix {
+ color: #900000;
+ }
+ .PopupSearchResultsPage .ISymbolPrefix {
+ font-size: 8pt;
+ }
+
+ .IndexPage #IFirstSymbolPrefix,
+ .FramedIndexPage #IFirstSymbolPrefix {
+ border-top: 1px solid #E0E0E0;
+ }
+ .IndexPage #ILastSymbolPrefix,
+ .FramedIndexPage #ILastSymbolPrefix {
+ border-bottom: 1px solid #E0E0E0;
+ }
+ .IndexPage #IOnlySymbolPrefix,
+ .FramedIndexPage #IOnlySymbolPrefix {
+ border-top: 1px solid #E0E0E0;
+ border-bottom: 1px solid #E0E0E0;
+ }
+
+ a.IParent,
+ a.IFile {
+ display: block;
+ }
+
+ .PopupSearchResultsPage .SRStatus {
+ padding: 2px 5px;
+ font-size: 8pt;
+ font-style: italic;
+ }
+ .FramedSearchResultsPage .SRStatus {
+ font-size: 10pt;
+ font-style: italic;
+ }
+
+ .SRResult {
+ display: none;
+ }
+
+
+
+#Footer {
+ font-size: 8pt;
+ color: #989898;
+ text-align: right;
+ }
+
+#Footer p {
+ text-indent: 0;
+ margin-bottom: .5em;
+ }
+
+.ContentPage #Footer,
+.IndexPage #Footer {
+ text-align: right;
+ margin: 2px;
+ }
+
+.FramedMenuPage #Footer {
+ text-align: center;
+ margin: 5em 10px 10px 10px;
+ padding-top: 1em;
+ border-top: 1px solid #C8C8C8;
+ }
+
+ #Footer a:link,
+ #Footer a:hover,
+ #Footer a:visited { color: #989898 }
+ #Footer a:active { color: #A00000 }
+
diff --git a/sw/vendor/coremark/docs/html/styles/2.css b/sw/vendor/coremark/docs/html/styles/2.css
new file mode 100644
index 0000000..69a1d1a
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/styles/2.css
@@ -0,0 +1,6 @@
+#Menu {
+ padding: 48px 0 0 0;
+ background: url(file:../../coremark_logo.jpg) no-repeat;
+ background-position: 30px 10px;
+ }
+
diff --git a/sw/vendor/coremark/docs/html/styles/main.css b/sw/vendor/coremark/docs/html/styles/main.css
new file mode 100644
index 0000000..a672a94
--- /dev/null
+++ b/sw/vendor/coremark/docs/html/styles/main.css
@@ -0,0 +1,2 @@
+@import URL("1.css");
+@import URL("2.css");
diff --git a/sw/vendor/coremark/linux/core_portme.c b/sw/vendor/coremark/linux/core_portme.c
new file mode 100755
index 0000000..6b63610
--- /dev/null
+++ b/sw/vendor/coremark/linux/core_portme.c
@@ -0,0 +1,338 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include "coremark.h"
+#if CALLGRIND_RUN
+#include <valgrind/callgrind.h>
+#endif
+
+#if (MEM_METHOD==MEM_MALLOC)
+#include <malloc.h>
+/* Function: portable_malloc
+ Provide malloc() functionality in a platform specific way.
+*/
+void *portable_malloc(size_t size) {
+ return malloc(size);
+}
+/* Function: portable_free
+ Provide free() functionality in a platform specific way.
+*/
+void portable_free(void *p) {
+ free(p);
+}
+#else
+void *portable_malloc(size_t size) {
+ return NULL;
+}
+void portable_free(void *p) {
+ p=NULL;
+}
+#endif
+
+#if (SEED_METHOD==SEED_VOLATILE)
+#if VALIDATION_RUN
+ volatile ee_s32 seed1_volatile=0x3415;
+ volatile ee_s32 seed2_volatile=0x3415;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PERFORMANCE_RUN
+ volatile ee_s32 seed1_volatile=0x0;
+ volatile ee_s32 seed2_volatile=0x0;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PROFILE_RUN
+ volatile ee_s32 seed1_volatile=0x8;
+ volatile ee_s32 seed2_volatile=0x8;
+ volatile ee_s32 seed3_volatile=0x8;
+#endif
+ volatile ee_s32 seed4_volatile=ITERATIONS;
+ volatile ee_s32 seed5_volatile=0;
+#endif
+/* Porting: Timing functions
+ How to capture time and convert to seconds must be ported to whatever is supported by the platform.
+ e.g. Read value from on board RTC, read value from cpu clock cycles performance counter etc.
+ Sample implementation for standard time.h and windows.h definitions included.
+*/
+/* Define: TIMER_RES_DIVIDER
+ Divider to trade off timer resolution and total time that can be measured.
+
+ Use lower values to increase resolution, but make sure that overflow does not occur.
+ If there are issues with the return value overflowing, increase this value.
+ */
+#if USE_CLOCK
+ #define NSECS_PER_SEC CLOCKS_PER_SEC
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE clock_t
+ #define GETMYTIME(_t) (*_t=clock())
+ #define MYTIMEDIFF(fin,ini) ((fin)-(ini))
+ #define TIMER_RES_DIVIDER 1
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#elif defined(_MSC_VER)
+ #define NSECS_PER_SEC 10000000
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE FILETIME
+ #define GETMYTIME(_t) GetSystemTimeAsFileTime(_t)
+ #define MYTIMEDIFF(fin,ini) (((*(__int64*)&fin)-(*(__int64*)&ini))/TIMER_RES_DIVIDER)
+ /* setting to millisces resolution by default with MSDEV */
+ #ifndef TIMER_RES_DIVIDER
+ #define TIMER_RES_DIVIDER 1000
+ #endif
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#elif HAS_TIME_H
+ #define NSECS_PER_SEC 1000000000
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE struct timespec
+ #define GETMYTIME(_t) clock_gettime(CLOCK_REALTIME,_t)
+ #define MYTIMEDIFF(fin,ini) ((fin.tv_sec-ini.tv_sec)*(NSECS_PER_SEC/TIMER_RES_DIVIDER)+(fin.tv_nsec-ini.tv_nsec)/TIMER_RES_DIVIDER)
+ /* setting to 1/1000 of a second resolution by default with linux */
+ #ifndef TIMER_RES_DIVIDER
+ #define TIMER_RES_DIVIDER 1000000
+ #endif
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#else
+ #define SAMPLE_TIME_IMPLEMENTATION 0
+#endif
+#define EE_TICKS_PER_SEC (NSECS_PER_SEC / TIMER_RES_DIVIDER)
+
+#if SAMPLE_TIME_IMPLEMENTATION
+/** Define Host specific (POSIX), or target specific global time variables. */
+static CORETIMETYPE start_time_val, stop_time_val;
+
+/* Function: start_time
+ This function will be called right before starting the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or zeroing some system parameters - e.g. setting the cpu clocks cycles to 0.
+*/
+void start_time(void) {
+ GETMYTIME(&start_time_val );
+#if CALLGRIND_RUN
+ CALLGRIND_START_INSTRUMENTATION
+#endif
+#if MICA
+ asm volatile("int3");/*1 */
+#endif
+}
+/* Function: stop_time
+ This function will be called right after ending the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or other system parameters - e.g. reading the current value of cpu cycles counter.
+*/
+void stop_time(void) {
+#if CALLGRIND_RUN
+ CALLGRIND_STOP_INSTRUMENTATION
+#endif
+#if MICA
+ asm volatile("int3");/*1 */
+#endif
+ GETMYTIME(&stop_time_val );
+}
+/* Function: get_time
+ Return an abstract "ticks" number that signifies time on the system.
+
+ Actual value returned may be cpu cycles, milliseconds or any other value,
+ as long as it can be converted to seconds by <time_in_secs>.
+ This methodology is taken to accomodate any hardware or simulated platform.
+ The sample implementation returns millisecs by default,
+ and the resolution is controlled by <TIMER_RES_DIVIDER>
+*/
+CORE_TICKS get_time(void) {
+ CORE_TICKS elapsed=(CORE_TICKS)(MYTIMEDIFF(stop_time_val, start_time_val));
+ return elapsed;
+}
+/* Function: time_in_secs
+ Convert the value returned by get_time to seconds.
+
+ The <secs_ret> type is used to accomodate systems with no support for floating point.
+ Default implementation implemented by the EE_TICKS_PER_SEC macro above.
+*/
+secs_ret time_in_secs(CORE_TICKS ticks) {
+ secs_ret retval=((secs_ret)ticks) / (secs_ret)EE_TICKS_PER_SEC;
+ return retval;
+}
+#else
+#error "Please implement timing functionality in core_portme.c"
+#endif /* SAMPLE_TIME_IMPLEMENTATION */
+
+ee_u32 default_num_contexts=MULTITHREAD;
+
+/* Function: portable_init
+ Target specific initialization code
+ Test for some common mistakes.
+*/
+void portable_init(core_portable *p, int *argc, char *argv[])
+{
+#if PRINT_ARGS
+ int i;
+ for (i=0; i<*argc; i++) {
+ ee_printf("Arg[%d]=%s\n",i,argv[i]);
+ }
+#endif
+ if (sizeof(ee_ptr_int) != sizeof(ee_u8 *)) {
+ ee_printf("ERROR! Please define ee_ptr_int to a type that holds a pointer!\n");
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR! Please define ee_u32 to a 32b unsigned type!\n");
+ }
+#if (MAIN_HAS_NOARGC && (SEED_METHOD==SEED_ARG))
+ ee_printf("ERROR! Main has no argc, but SEED_METHOD defined to SEED_ARG!\n");
+#endif
+
+#if (MULTITHREAD>1) && (SEED_METHOD==SEED_ARG)
+ {
+ int nargs=*argc,i;
+ if ((nargs>1) && (*argv[1]=='M')) {
+ default_num_contexts=parseval(argv[1]+1);
+ if (default_num_contexts>MULTITHREAD)
+ default_num_contexts=MULTITHREAD;
+ /* Shift args since first arg is directed to the portable part and not to coremark main */
+ --nargs;
+ for (i=1; i<nargs; i++)
+ argv[i]=argv[i+1];
+ *argc=nargs;
+ }
+ }
+#endif /* sample of potential platform specific init via command line, reset the number of contexts being used if first argument is M<n>*/
+ p->portable_id=1;
+}
+/* Function: portable_fini
+ Target specific final code
+*/
+void portable_fini(core_portable *p)
+{
+ p->portable_id=0;
+}
+
+#if (MULTITHREAD>1)
+
+/* Function: core_start_parallel
+ Start benchmarking in a parallel context.
+
+ Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets.
+ Other implementations using MCAPI or other standards can easily be devised.
+*/
+/* Function: core_stop_parallel
+ Stop a parallel context execution of coremark, and gather the results.
+
+ Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets.
+ Other implementations using MCAPI or other standards can easily be devised.
+*/
+#if USE_PTHREAD
+ee_u8 core_start_parallel(core_results *res) {
+ return (ee_u8)pthread_create(&(res->port.thread),NULL,iterate,(void *)res);
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ void *retval;
+ return (ee_u8)pthread_join(res->port.thread,&retval);
+}
+#elif USE_FORK
+static int key_id=0;
+ee_u8 core_start_parallel(core_results *res) {
+ key_t key=4321+key_id;
+ key_id++;
+ res->port.pid=fork();
+ res->port.shmid=shmget(key, 8, IPC_CREAT | 0666);
+ if (res->port.shmid<0) {
+ ee_printf("ERROR in shmget!\n");
+ }
+ if (res->port.pid==0) {
+ iterate(res);
+ res->port.shm=shmat(res->port.shmid, NULL, 0);
+ /* copy the validation values to the shared memory area and quit*/
+ if (res->port.shm == (char *) -1) {
+ ee_printf("ERROR in child shmat!\n");
+ } else {
+ memcpy(res->port.shm,&(res->crc),8);
+ shmdt(res->port.shm);
+ }
+ exit(0);
+ }
+ return 1;
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ int status;
+ pid_t wpid = waitpid(res->port.pid,&status,WUNTRACED);
+ if (wpid != res->port.pid) {
+ ee_printf("ERROR waiting for child.\n");
+ if (errno == ECHILD) ee_printf("errno=No such child %d\n",res->port.pid);
+ if (errno == EINTR) ee_printf("errno=Interrupted\n");
+ return 0;
+ }
+ /* after process is done, get the values from the shared memory area */
+ res->port.shm=shmat(res->port.shmid, NULL, 0);
+ if (res->port.shm == (char *) -1) {
+ ee_printf("ERROR in parent shmat!\n");
+ return 0;
+ }
+ memcpy(&(res->crc),res->port.shm,8);
+ shmdt(res->port.shm);
+ return 1;
+}
+#elif USE_SOCKET
+static int key_id=0;
+ee_u8 core_start_parallel(core_results *res) {
+ int bound, buffer_length=8;
+ res->port.sa.sin_family = AF_INET;
+ res->port.sa.sin_addr.s_addr = htonl(0x7F000001);
+ res->port.sa.sin_port = htons(7654+key_id);
+ key_id++;
+ res->port.pid=fork();
+ if (res->port.pid==0) { /* benchmark child */
+ iterate(res);
+ res->port.sock = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);
+ if (-1 == res->port.sock) /* if socket failed to initialize, exit */ {
+ ee_printf("Error Creating Socket");
+ } else {
+ int bytes_sent = sendto(res->port.sock, &(res->crc), buffer_length, 0,(struct sockaddr*)&(res->port.sa), sizeof (struct sockaddr_in));
+ if (bytes_sent < 0)
+ ee_printf("Error sending packet: %s\n", strerror(errno));
+ close(res->port.sock); /* close the socket */
+ }
+ exit(0);
+ }
+ /* parent process, open the socket */
+ res->port.sock = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);
+ bound = bind(res->port.sock,(struct sockaddr*)&(res->port.sa), sizeof(struct sockaddr));
+ if (bound < 0)
+ ee_printf("bind(): %s\n",strerror(errno));
+ return 1;
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ int status;
+ int fromlen=sizeof(struct sockaddr);
+ int recsize = recvfrom(res->port.sock, &(res->crc), 8, 0, (struct sockaddr*)&(res->port.sa), &fromlen);
+ if (recsize < 0) {
+ ee_printf("Error in receive: %s\n", strerror(errno));
+ return 0;
+ }
+ pid_t wpid = waitpid(res->port.pid,&status,WUNTRACED);
+ if (wpid != res->port.pid) {
+ ee_printf("ERROR waiting for child.\n");
+ if (errno == ECHILD) ee_printf("errno=No such child %d\n",res->port.pid);
+ if (errno == EINTR) ee_printf("errno=Interrupted\n");
+ return 0;
+ }
+ return 1;
+}
+#else /* no standard multicore implementation */
+#error "Please implement multicore functionality in core_portme.c to use multiple contexts."
+#endif /* multithread implementations */
+#endif
diff --git a/sw/vendor/coremark/linux/core_portme.h b/sw/vendor/coremark/linux/core_portme.h
new file mode 100755
index 0000000..2cf4659
--- /dev/null
+++ b/sw/vendor/coremark/linux/core_portme.h
@@ -0,0 +1,290 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#ifndef CORE_PORTME_H
+#define CORE_PORTME_H
+/************************/
+/* Data types and settings */
+/************************/
+/* Configuration: HAS_FLOAT
+ Define to 1 if the platform supports floating point.
+*/
+#ifndef HAS_FLOAT
+#define HAS_FLOAT 1
+#endif
+/* Configuration: HAS_TIME_H
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef HAS_TIME_H
+#define HAS_TIME_H 1
+#endif
+/* Configuration: USE_CLOCK
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef USE_CLOCK
+#define USE_CLOCK 0
+#endif
+/* Configuration: HAS_STDIO
+ Define to 1 if the platform has stdio.h.
+*/
+#ifndef HAS_STDIO
+#define HAS_STDIO 1
+#endif
+/* Configuration: HAS_PRINTF
+ Define to 1 if the platform has stdio.h and implements the printf function.
+*/
+#ifndef HAS_PRINTF
+#define HAS_PRINTF 1
+#endif
+
+/* Configuration: CORE_TICKS
+ Define type of return from the timing functions.
+ */
+#if defined(_MSC_VER)
+#include <windows.h>
+typedef size_t CORE_TICKS;
+#elif HAS_TIME_H
+#include <time.h>
+typedef clock_t CORE_TICKS;
+#else
+#error "Please define type of CORE_TICKS and implement start_time, end_time get_time and time_in_secs functions!"
+#endif
+
+/* Definitions: COMPILER_VERSION, COMPILER_FLAGS, MEM_LOCATION
+ Initialize these strings per platform
+*/
+#ifndef COMPILER_VERSION
+ #ifdef __GNUC__
+ #define COMPILER_VERSION "GCC"__VERSION__
+ #else
+ #define COMPILER_VERSION "Please put compiler version here (e.g. gcc 4.1)"
+ #endif
+#endif
+#ifndef COMPILER_FLAGS
+ #define COMPILER_FLAGS FLAGS_STR /* "Please put compiler flags here (e.g. -o3)" */
+#endif
+#ifndef MEM_LOCATION
+ #define MEM_LOCATION "Please put data memory location here\n\t\t\t(e.g. code in flash, data on heap etc)"
+ #define MEM_LOCATION_UNSPEC 1
+#endif
+
+/* Data Types:
+ To avoid compiler issues, define the data types that need ot be used for 8b, 16b and 32b in <core_portme.h>.
+
+ *Imprtant*:
+ ee_ptr_int needs to be the data type used to hold pointers, otherwise coremark may fail!!!
+*/
+typedef signed short ee_s16;
+typedef unsigned short ee_u16;
+typedef signed int ee_s32;
+typedef double ee_f32;
+typedef unsigned char ee_u8;
+typedef unsigned int ee_u32;
+typedef ee_u32 ee_ptr_int;
+typedef size_t ee_size_t;
+/* align_mem:
+ This macro is used to align an offset to point to a 32b value. It is used in the Matrix algorithm to initialize the input memory blocks.
+*/
+#define align_mem(x) (void *)(4 + (((ee_ptr_int)(x) - 1) & ~3))
+
+/* Configuration: SEED_METHOD
+ Defines method to get seed values that cannot be computed at compile time.
+
+ Valid values:
+ SEED_ARG - from command line.
+ SEED_FUNC - from a system function.
+ SEED_VOLATILE - from volatile variables.
+*/
+#ifndef SEED_METHOD
+#define SEED_METHOD SEED_ARG
+#endif
+
+/* Configuration: MEM_METHOD
+ Defines method to get a block of memry.
+
+ Valid values:
+ MEM_MALLOC - for platforms that implement malloc and have malloc.h.
+ MEM_STATIC - to use a static memory array.
+ MEM_STACK - to allocate the data block on the stack (NYI).
+*/
+#ifndef MEM_METHOD
+#define MEM_METHOD MEM_MALLOC
+#endif
+
+/* Configuration: MULTITHREAD
+ Define for parallel execution
+
+ Valid values:
+ 1 - only one context (default).
+ N>1 - will execute N copies in parallel.
+
+ Note:
+ If this flag is defined to more then 1, an implementation for launching parallel contexts must be defined.
+
+ Two sample implementations are provided. Use <USE_PTHREAD> or <USE_FORK> to enable them.
+
+ It is valid to have a different implementation of <core_start_parallel> and <core_end_parallel> in <core_portme.c>,
+ to fit a particular architecture.
+*/
+#ifndef MULTITHREAD
+#define MULTITHREAD 1
+#endif
+
+/* Configuration: USE_PTHREAD
+ Sample implementation for launching parallel contexts
+ This implementation uses pthread_thread_create and pthread_join.
+
+ Valid values:
+ 0 - Do not use pthreads API.
+ 1 - Use pthreads API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_PTHREAD
+#define USE_PTHREAD 0
+#endif
+
+/* Configuration: USE_FORK
+ Sample implementation for launching parallel contexts
+ This implementation uses fork, waitpid, shmget,shmat and shmdt.
+
+ Valid values:
+ 0 - Do not use fork API.
+ 1 - Use fork API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_FORK
+#define USE_FORK 0
+#endif
+
+/* Configuration: USE_SOCKET
+ Sample implementation for launching parallel contexts
+ This implementation uses fork, socket, sendto and recvfrom
+
+ Valid values:
+ 0 - Do not use fork and sockets API.
+ 1 - Use fork and sockets API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_SOCKET
+#define USE_SOCKET 0
+#endif
+
+/* Configuration: MAIN_HAS_NOARGC
+ Needed if platform does not support getting arguments to main.
+
+ Valid values:
+ 0 - argc/argv to main is supported
+ 1 - argc/argv to main is not supported
+*/
+#ifndef MAIN_HAS_NOARGC
+#define MAIN_HAS_NOARGC 0
+#endif
+
+/* Configuration: MAIN_HAS_NORETURN
+ Needed if platform does not support returning a value from main.
+
+ Valid values:
+ 0 - main returns an int, and return value will be 0.
+ 1 - platform does not support returning a value from main
+*/
+#ifndef MAIN_HAS_NORETURN
+#define MAIN_HAS_NORETURN 0
+#endif
+
+/* Variable: default_num_contexts
+ Number of contexts to spawn in multicore context.
+ Override this global value to change number of contexts used.
+
+ Note:
+ This value may not be set higher then the <MULTITHREAD> define.
+
+ To experiment, you can set the <MULTITHREAD> define to the highest value expected, and use argc/argv in the <portable_init> to set this value from the command line.
+*/
+extern ee_u32 default_num_contexts;
+
+#if (MULTITHREAD>1)
+#if USE_PTHREAD
+ #include <pthread.h>
+ #define PARALLEL_METHOD "PThreads"
+#elif USE_FORK
+ #include <unistd.h>
+ #include <errno.h>
+ #include <sys/wait.h>
+ #include <sys/shm.h>
+ #include <string.h> /* for memcpy */
+ #define PARALLEL_METHOD "Fork"
+#elif USE_SOCKET
+ #include <sys/types.h>
+ #include <sys/socket.h>
+ #include <netinet/in.h>
+ #include <arpa/inet.h>
+ #include <sys/wait.h>
+ #include <stdio.h>
+ #include <stdlib.h>
+ #include <string.h>
+ #include <unistd.h>
+ #include <errno.h>
+ #define PARALLEL_METHOD "Sockets"
+#else
+ #define PARALLEL_METHOD "Proprietary"
+ #error "Please implement multicore functionality in core_portme.c to use multiple contexts."
+#endif /* Method for multithreading */
+#endif /* MULTITHREAD > 1 */
+
+typedef struct CORE_PORTABLE_S {
+#if (MULTITHREAD>1)
+ #if USE_PTHREAD
+ pthread_t thread;
+ #elif USE_FORK
+ pid_t pid;
+ int shmid;
+ void *shm;
+ #elif USE_SOCKET
+ pid_t pid;
+ int sock;
+ struct sockaddr_in sa;
+ #endif /* Method for multithreading */
+#endif /* MULTITHREAD>1 */
+ ee_u8 portable_id;
+} core_portable;
+
+/* target specific init/fini */
+void portable_init(core_portable *p, int *argc, char *argv[]);
+void portable_fini(core_portable *p);
+
+#if (SEED_METHOD==SEED_VOLATILE)
+ #if (VALIDATION_RUN || PERFORMANCE_RUN || PROFILE_RUN)
+ #define RUN_TYPE_FLAG 1
+ #else
+ #if (TOTAL_DATA_SIZE==1200)
+ #define PROFILE_RUN 1
+ #else
+ #define PERFORMANCE_RUN 1
+ #endif
+ #endif
+#endif /* SEED_METHOD==SEED_VOLATILE */
+
+#endif /* CORE_PORTME_H */
diff --git a/sw/vendor/coremark/linux/core_portme.mak b/sw/vendor/coremark/linux/core_portme.mak
new file mode 100755
index 0000000..5cfabee
--- /dev/null
+++ b/sw/vendor/coremark/linux/core_portme.mak
@@ -0,0 +1,140 @@
+# Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+#
+# Licensed 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.
+#
+# Original Author: Shay Gal-on
+
+#File: core_portme.mak
+
+# Flag: OUTFLAG
+# Use this flag to define how to to get an executable (e.g -o)
+OUTFLAG= -o
+# Flag: CC
+# Use this flag to define compiler to use
+CC = gcc
+# Flag: CFLAGS
+# Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS="other flags"
+PORT_CFLAGS = -O2
+FLAGS_STR = "$(PORT_CFLAGS) $(XCFLAGS) $(XLFLAGS) $(LFLAGS_END)"
+CFLAGS = $(PORT_CFLAGS) -I$(PORT_DIR) -I. -DFLAGS_STR=\"$(FLAGS_STR)\"
+#Flag: LFLAGS_END
+# Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts).
+# Note: On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.
+LFLAGS_END += -lrt
+# Flag: PORT_SRCS
+# Port specific source files can be added here
+PORT_SRCS = $(PORT_DIR)/core_portme.c
+# Flag: LOAD
+# Define this flag if you need to load to a target, as in a cross compile environment.
+
+# Flag: RUN
+# Define this flag if running does not consist of simple invocation of the binary.
+# In a cross compile environment, you need to define this.
+
+#For flashing and using a tera term macro, you could use
+#LOAD = flash ADDR
+#RUN = ttpmacro coremark.ttl
+
+#For copying to target and executing via SSH connection, you could use
+#LOAD = scp $(OUTFILE) user@target:~
+#RUN = ssh user@target -c
+
+#For native compilation and execution
+LOAD = echo Loading done
+RUN =
+
+OEXT = .o
+EXE = .exe
+
+# Flag: SEPARATE_COMPILE
+# Define if you need to separate compilation from link stage.
+# In this case, you also need to define below how to create an object file, and how to link.
+ifdef SEPARATE_COMPILE
+
+LD = gcc
+OBJOUT = -o
+LFLAGS =
+OFLAG = -o
+COUT = -c
+# Flag: PORT_OBJS
+# Port specific object files can be added here
+PORT_OBJS = $(PORT_DIR)/core_portme$(OEXT)
+PORT_CLEAN = *$(OEXT)
+
+$(OPATH)%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+endif
+
+# Target: port_prebuild
+# Generate any files that are needed before actual build starts.
+# E.g. generate profile guidance files. Sample PGO generation for gcc enabled with PGO=1
+# - First, check if PGO was defined on the command line, if so, need to add -fprofile-use to compile line.
+# - Second, if PGO reference has not yet been generated, add a step to the prebuild that will build a profile-generate version and run it.
+# Note - Using REBUILD=1
+#
+# Use make PGO=1 to invoke this sample processing.
+
+ifdef PGO
+ ifeq (,$(findstring $(PGO),gen))
+ PGO_STAGE=build_pgo_gcc
+ CFLAGS+=-fprofile-use
+ endif
+ PORT_CLEAN+=*.gcda *.gcno gmon.out
+endif
+
+.PHONY: port_prebuild
+port_prebuild: $(PGO_STAGE)
+
+.PHONY: build_pgo_gcc
+build_pgo_gcc:
+ $(MAKE) PGO=gen XCFLAGS="$(XCFLAGS) -fprofile-generate -DTOTAL_DATA_SIZE=1200" ITERATIONS=10 gen_pgo_data REBUILD=1
+
+# Target: port_postbuild
+# Generate any files that are needed after actual build end.
+# E.g. change format to srec, bin, zip in order to be able to load into flash
+.PHONY: port_postbuild
+port_postbuild:
+
+# Target: port_postrun
+# Do platform specific after run stuff.
+# E.g. reset the board, backup the logfiles etc.
+.PHONY: port_postrun
+port_postrun:
+
+# Target: port_prerun
+# Do platform specific after run stuff.
+# E.g. reset the board, backup the logfiles etc.
+.PHONY: port_prerun
+port_prerun:
+
+# Target: port_postload
+# Do platform specific after load stuff.
+# E.g. reset the reset power to the flash eraser
+.PHONY: port_postload
+port_postload:
+
+# Target: port_preload
+# Do platform specific before load stuff.
+# E.g. reset the reset power to the flash eraser
+.PHONY: port_preload
+port_preload:
+
+# FLAG: OPATH
+# Path to the output folder. Default - current folder.
+OPATH = ./
+MKDIR = mkdir -p
+
+# FLAG: PERL
+# Define perl executable to calculate the geomean if running separate.
+PERL=/usr/bin/perl
diff --git a/sw/vendor/coremark/linux64/core_portme.c b/sw/vendor/coremark/linux64/core_portme.c
new file mode 100755
index 0000000..fe8d299
--- /dev/null
+++ b/sw/vendor/coremark/linux64/core_portme.c
@@ -0,0 +1,336 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include "coremark.h"
+#if CALLGRIND_RUN
+#include <valgrind/callgrind.h>
+#endif
+
+#if (MEM_METHOD==MEM_MALLOC)
+#include <malloc.h>
+/* Function: portable_malloc
+ Provide malloc() functionality in a platform specific way.
+*/
+void *portable_malloc(size_t size) {
+ return malloc(size);
+}
+/* Function: portable_free
+ Provide free() functionality in a platform specific way.
+*/
+void portable_free(void *p) {
+ free(p);
+}
+#else
+void *portable_malloc(size_t size) {
+ return NULL;
+}
+void portable_free(void *p) {
+ p=NULL;
+}
+#endif
+
+#if (SEED_METHOD==SEED_VOLATILE)
+#if VALIDATION_RUN
+ volatile ee_s32 seed1_volatile=0x3415;
+ volatile ee_s32 seed2_volatile=0x3415;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PERFORMANCE_RUN
+ volatile ee_s32 seed1_volatile=0x0;
+ volatile ee_s32 seed2_volatile=0x0;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PROFILE_RUN
+ volatile ee_s32 seed1_volatile=0x8;
+ volatile ee_s32 seed2_volatile=0x8;
+ volatile ee_s32 seed3_volatile=0x8;
+#endif
+ volatile ee_s32 seed4_volatile=ITERATIONS;
+ volatile ee_s32 seed5_volatile=0;
+#endif
+/* Porting: Timing functions
+ How to capture time and convert to seconds must be ported to whatever is supported by the platform.
+ e.g. Read value from on board RTC, read value from cpu clock cycles performance counter etc.
+ Sample implementation for standard time.h and windows.h definitions included.
+*/
+/* Define: TIMER_RES_DIVIDER
+ Divider to trade off timer resolution and total time that can be measured.
+
+ Use lower values to increase resolution, but make sure that overflow does not occur.
+ If there are issues with the return value overflowing, increase this value.
+ */
+#if USE_CLOCK
+ #define NSECS_PER_SEC CLOCKS_PER_SEC
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE clock_t
+ #define GETMYTIME(_t) (*_t=clock())
+ #define MYTIMEDIFF(fin,ini) ((fin)-(ini))
+ #define TIMER_RES_DIVIDER 1
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#elif defined(_MSC_VER)
+ #define NSECS_PER_SEC 10000000
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE FILETIME
+ #define GETMYTIME(_t) GetSystemTimeAsFileTime(_t)
+ #define MYTIMEDIFF(fin,ini) (((*(__int64*)&fin)-(*(__int64*)&ini))/TIMER_RES_DIVIDER)
+ /* setting to millisces resolution by default with MSDEV */
+ #ifndef TIMER_RES_DIVIDER
+ #define TIMER_RES_DIVIDER 1000
+ #endif
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#elif HAS_TIME_H
+ #define NSECS_PER_SEC 1000000000
+ #define EE_TIMER_TICKER_RATE 1000
+ #define CORETIMETYPE struct timespec
+ #define GETMYTIME(_t) clock_gettime(CLOCK_REALTIME,_t)
+ #define MYTIMEDIFF(fin,ini) ((fin.tv_sec-ini.tv_sec)*(NSECS_PER_SEC/TIMER_RES_DIVIDER)+(fin.tv_nsec-ini.tv_nsec)/TIMER_RES_DIVIDER)
+ /* setting to 1/1000 of a second resolution by default with linux */
+ #ifndef TIMER_RES_DIVIDER
+ #define TIMER_RES_DIVIDER 1000000
+ #endif
+ #define SAMPLE_TIME_IMPLEMENTATION 1
+#else
+ #define SAMPLE_TIME_IMPLEMENTATION 0
+#endif
+#define EE_TICKS_PER_SEC (NSECS_PER_SEC / TIMER_RES_DIVIDER)
+
+#if SAMPLE_TIME_IMPLEMENTATION
+/** Define Host specific (POSIX), or target specific global time variables. */
+static CORETIMETYPE start_time_val, stop_time_val;
+
+/* Function: start_time
+ This function will be called right before starting the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or zeroing some system parameters - e.g. setting the cpu clocks cycles to 0.
+*/
+void start_time(void) {
+ GETMYTIME(&start_time_val );
+#if CALLGRIND_RUN
+ CALLGRIND_START_INSTRUMENTATION
+#endif
+#if MICA
+ asm volatile("int3");/*1 */
+#endif
+}
+/* Function: stop_time
+ This function will be called right after ending the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or other system parameters - e.g. reading the current value of cpu cycles counter.
+*/
+void stop_time(void) {
+#if CALLGRIND_RUN
+ CALLGRIND_STOP_INSTRUMENTATION
+#endif
+#if MICA
+ asm volatile("int3");/*1 */
+#endif
+ GETMYTIME(&stop_time_val );
+}
+/* Function: get_time
+ Return an abstract "ticks" number that signifies time on the system.
+
+ Actual value returned may be cpu cycles, milliseconds or any other value,
+ as long as it can be converted to seconds by <time_in_secs>.
+ This methodology is taken to accomodate any hardware or simulated platform.
+ The sample implementation returns millisecs by default,
+ and the resolution is controlled by <TIMER_RES_DIVIDER>
+*/
+CORE_TICKS get_time(void) {
+ CORE_TICKS elapsed=(CORE_TICKS)(MYTIMEDIFF(stop_time_val, start_time_val));
+ return elapsed;
+}
+/* Function: time_in_secs
+ Convert the value returned by get_time to seconds.
+
+ The <secs_ret> type is used to accomodate systems with no support for floating point.
+ Default implementation implemented by the EE_TICKS_PER_SEC macro above.
+*/
+secs_ret time_in_secs(CORE_TICKS ticks) {
+ secs_ret retval=((secs_ret)ticks) / (secs_ret)EE_TICKS_PER_SEC;
+ return retval;
+}
+#else
+#error "Please implement timing functionality in core_portme.c"
+#endif /* SAMPLE_TIME_IMPLEMENTATION */
+
+ee_u32 default_num_contexts=MULTITHREAD;
+
+/* Function: portable_init
+ Target specific initialization code
+ Test for some common mistakes.
+*/
+void portable_init(core_portable *p, int *argc, char *argv[])
+{
+#if PRINT_ARGS
+ int i;
+ for (i=0; i<*argc; i++) {
+ ee_printf("Arg[%d]=%s\n",i,argv[i]);
+ }
+#endif
+ if (sizeof(ee_ptr_int) != sizeof(ee_u8 *)) {
+ ee_printf("ERROR! Please define ee_ptr_int to a type that holds a pointer!\n");
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR! Please define ee_u32 to a 32b unsigned type!\n");
+ }
+#if (MAIN_HAS_NOARGC && (SEED_METHOD==SEED_ARG))
+ ee_printf("ERROR! Main has no argc, but SEED_METHOD defined to SEED_ARG!\n");
+#endif
+
+#if (MULTITHREAD>1) && (SEED_METHOD==SEED_ARG)
+ int nargs=*argc,i;
+ if ((nargs>1) && (*argv[1]=='M')) {
+ default_num_contexts=parseval(argv[1]+1);
+ if (default_num_contexts>MULTITHREAD)
+ default_num_contexts=MULTITHREAD;
+ /* Shift args since first arg is directed to the portable part and not to coremark main */
+ --nargs;
+ for (i=1; i<nargs; i++)
+ argv[i]=argv[i+1];
+ *argc=nargs;
+ }
+#endif /* sample of potential platform specific init via command line, reset the number of contexts being used if first argument is M<n>*/
+ p->portable_id=1;
+}
+/* Function: portable_fini
+ Target specific final code
+*/
+void portable_fini(core_portable *p)
+{
+ p->portable_id=0;
+}
+
+#if (MULTITHREAD>1)
+
+/* Function: core_start_parallel
+ Start benchmarking in a parallel context.
+
+ Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets.
+ Other implementations using MCAPI or other standards can easily be devised.
+*/
+/* Function: core_stop_parallel
+ Stop a parallel context execution of coremark, and gather the results.
+
+ Three implementations are provided, one using pthreads, one using fork and shared mem, and one using fork and sockets.
+ Other implementations using MCAPI or other standards can easily be devised.
+*/
+#if USE_PTHREAD
+ee_u8 core_start_parallel(core_results *res) {
+ return (ee_u8)pthread_create(&(res->port.thread),NULL,iterate,(void *)res);
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ void *retval;
+ return (ee_u8)pthread_join(res->port.thread,&retval);
+}
+#elif USE_FORK
+static int key_id=0;
+ee_u8 core_start_parallel(core_results *res) {
+ key_t key=4321+key_id;
+ key_id++;
+ res->port.pid=fork();
+ res->port.shmid=shmget(key, 8, IPC_CREAT | 0666);
+ if (res->port.shmid<0) {
+ ee_printf("ERROR in shmget!\n");
+ }
+ if (res->port.pid==0) {
+ iterate(res);
+ res->port.shm=shmat(res->port.shmid, NULL, 0);
+ /* copy the validation values to the shared memory area and quit*/
+ if (res->port.shm == (char *) -1) {
+ ee_printf("ERROR in child shmat!\n");
+ } else {
+ memcpy(res->port.shm,&(res->crc),8);
+ shmdt(res->port.shm);
+ }
+ exit(0);
+ }
+ return 1;
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ int status;
+ pid_t wpid = waitpid(res->port.pid,&status,WUNTRACED);
+ if (wpid != res->port.pid) {
+ ee_printf("ERROR waiting for child.\n");
+ if (errno == ECHILD) ee_printf("errno=No such child %d\n",res->port.pid);
+ if (errno == EINTR) ee_printf("errno=Interrupted\n");
+ return 0;
+ }
+ /* after process is done, get the values from the shared memory area */
+ res->port.shm=shmat(res->port.shmid, NULL, 0);
+ if (res->port.shm == (char *) -1) {
+ ee_printf("ERROR in parent shmat!\n");
+ return 0;
+ }
+ memcpy(&(res->crc),res->port.shm,8);
+ shmdt(res->port.shm);
+ return 1;
+}
+#elif USE_SOCKET
+static int key_id=0;
+ee_u8 core_start_parallel(core_results *res) {
+ int bound, buffer_length=8;
+ res->port.sa.sin_family = AF_INET;
+ res->port.sa.sin_addr.s_addr = htonl(0x7F000001);
+ res->port.sa.sin_port = htons(7654+key_id);
+ key_id++;
+ res->port.pid=fork();
+ if (res->port.pid==0) { /* benchmark child */
+ iterate(res);
+ res->port.sock = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);
+ if (-1 == res->port.sock) /* if socket failed to initialize, exit */ {
+ ee_printf("Error Creating Socket");
+ } else {
+ int bytes_sent = sendto(res->port.sock, &(res->crc), buffer_length, 0,(struct sockaddr*)&(res->port.sa), sizeof (struct sockaddr_in));
+ if (bytes_sent < 0)
+ ee_printf("Error sending packet: %s\n", strerror(errno));
+ close(res->port.sock); /* close the socket */
+ }
+ exit(0);
+ }
+ /* parent process, open the socket */
+ res->port.sock = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);
+ bound = bind(res->port.sock,(struct sockaddr*)&(res->port.sa), sizeof(struct sockaddr));
+ if (bound < 0)
+ ee_printf("bind(): %s\n",strerror(errno));
+ return 1;
+}
+ee_u8 core_stop_parallel(core_results *res) {
+ int status;
+ int fromlen=sizeof(struct sockaddr);
+ int recsize = recvfrom(res->port.sock, &(res->crc), 8, 0, (struct sockaddr*)&(res->port.sa), &fromlen);
+ if (recsize < 0) {
+ ee_printf("Error in receive: %s\n", strerror(errno));
+ return 0;
+ }
+ pid_t wpid = waitpid(res->port.pid,&status,WUNTRACED);
+ if (wpid != res->port.pid) {
+ ee_printf("ERROR waiting for child.\n");
+ if (errno == ECHILD) ee_printf("errno=No such child %d\n",res->port.pid);
+ if (errno == EINTR) ee_printf("errno=Interrupted\n");
+ return 0;
+ }
+ return 1;
+}
+#else /* no standard multicore implementation */
+#error "Please implement multicore functionality in core_portme.c to use multiple contexts."
+#endif /* multithread implementations */
+#endif
diff --git a/sw/vendor/coremark/linux64/core_portme.h b/sw/vendor/coremark/linux64/core_portme.h
new file mode 100755
index 0000000..1228a67
--- /dev/null
+++ b/sw/vendor/coremark/linux64/core_portme.h
@@ -0,0 +1,291 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+/* Topic: Description
+ This file contains configuration constants required to execute on different platforms
+*/
+#ifndef CORE_PORTME_H
+#define CORE_PORTME_H
+/************************/
+/* Data types and settings */
+/************************/
+/* Configuration: HAS_FLOAT
+ Define to 1 if the platform supports floating point.
+*/
+#ifndef HAS_FLOAT
+#define HAS_FLOAT 1
+#endif
+/* Configuration: HAS_TIME_H
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef HAS_TIME_H
+#define HAS_TIME_H 1
+#endif
+/* Configuration: USE_CLOCK
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef USE_CLOCK
+#define USE_CLOCK 0
+#endif
+/* Configuration: HAS_STDIO
+ Define to 1 if the platform has stdio.h.
+*/
+#ifndef HAS_STDIO
+#define HAS_STDIO 1
+#endif
+/* Configuration: HAS_PRINTF
+ Define to 1 if the platform has stdio.h and implements the printf function.
+*/
+#ifndef HAS_PRINTF
+#define HAS_PRINTF 1
+#endif
+
+/* Configuration: CORE_TICKS
+ Define type of return from the timing functions.
+ */
+#if defined(_MSC_VER)
+#include <windows.h>
+typedef size_t CORE_TICKS;
+#elif HAS_TIME_H
+#include <time.h>
+typedef clock_t CORE_TICKS;
+#else
+#error "Please define type of CORE_TICKS and implement start_time, end_time get_time and time_in_secs functions!"
+#endif
+
+/* Definitions: COMPILER_VERSION, COMPILER_FLAGS, MEM_LOCATION
+ Initialize these strings per platform
+*/
+#ifndef COMPILER_VERSION
+ #ifdef __GNUC__
+ #define COMPILER_VERSION "GCC"__VERSION__
+ #else
+ #define COMPILER_VERSION "Please put compiler version here (e.g. gcc 4.1)"
+ #endif
+#endif
+#ifndef COMPILER_FLAGS
+ #define COMPILER_FLAGS FLAGS_STR /* "Please put compiler flags here (e.g. -o3)" */
+#endif
+#ifndef MEM_LOCATION
+ #define MEM_LOCATION "Please put data memory location here\n\t\t\t(e.g. code in flash, data on heap etc)"
+ #define MEM_LOCATION_UNSPEC 1
+#endif
+
+/* Data Types:
+ To avoid compiler issues, define the data types that need ot be used for 8b, 16b and 32b in <core_portme.h>.
+
+ *Imprtant*:
+ ee_ptr_int needs to be the data type used to hold pointers, otherwise coremark may fail!!!
+*/
+typedef signed short ee_s16;
+typedef unsigned short ee_u16;
+typedef signed int ee_s32;
+typedef double ee_f32;
+typedef unsigned char ee_u8;
+typedef unsigned int ee_u32;
+typedef unsigned long long ee_ptr_int;
+typedef size_t ee_size_t;
+/* align an offset to point to a 32b value */
+#define align_mem(x) (void *)(4 + (((ee_ptr_int)(x) - 1) & ~3))
+
+/* Configuration: SEED_METHOD
+ Defines method to get seed values that cannot be computed at compile time.
+
+ Valid values:
+ SEED_ARG - from command line.
+ SEED_FUNC - from a system function.
+ SEED_VOLATILE - from volatile variables.
+*/
+#ifndef SEED_METHOD
+#define SEED_METHOD SEED_ARG
+#endif
+
+/* Configuration: MEM_METHOD
+ Defines method to get a block of memry.
+
+ Valid values:
+ MEM_MALLOC - for platforms that implement malloc and have malloc.h.
+ MEM_STATIC - to use a static memory array.
+ MEM_STACK - to allocate the data block on the stack (NYI).
+*/
+#ifndef MEM_METHOD
+#define MEM_METHOD MEM_MALLOC
+#endif
+
+/* Configuration: MULTITHREAD
+ Define for parallel execution
+
+ Valid values:
+ 1 - only one context (default).
+ N>1 - will execute N copies in parallel.
+
+ Note:
+ If this flag is defined to more then 1, an implementation for launching parallel contexts must be defined.
+
+ Two sample implementations are provided. Use <USE_PTHREAD> or <USE_FORK> to enable them.
+
+ It is valid to have a different implementation of <core_start_parallel> and <core_end_parallel> in <core_portme.c>,
+ to fit a particular architecture.
+*/
+#ifndef MULTITHREAD
+#define MULTITHREAD 1
+#endif
+
+/* Configuration: USE_PTHREAD
+ Sample implementation for launching parallel contexts
+ This implementation uses pthread_thread_create and pthread_join.
+
+ Valid values:
+ 0 - Do not use pthreads API.
+ 1 - Use pthreads API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_PTHREAD
+#define USE_PTHREAD 0
+#endif
+
+/* Configuration: USE_FORK
+ Sample implementation for launching parallel contexts
+ This implementation uses fork, waitpid, shmget,shmat and shmdt.
+
+ Valid values:
+ 0 - Do not use fork API.
+ 1 - Use fork API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_FORK
+#define USE_FORK 0
+#endif
+
+/* Configuration: USE_SOCKET
+ Sample implementation for launching parallel contexts
+ This implementation uses fork, socket, sendto and recvfrom
+
+ Valid values:
+ 0 - Do not use fork and sockets API.
+ 1 - Use fork and sockets API
+
+ Note:
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef USE_SOCKET
+#define USE_SOCKET 0
+#endif
+
+/* Configuration: MAIN_HAS_NOARGC
+ Needed if platform does not support getting arguments to main.
+
+ Valid values:
+ 0 - argc/argv to main is supported
+ 1 - argc/argv to main is not supported
+*/
+#ifndef MAIN_HAS_NOARGC
+#define MAIN_HAS_NOARGC 0
+#endif
+
+/* Configuration: MAIN_HAS_NORETURN
+ Needed if platform does not support returning a value from main.
+
+ Valid values:
+ 0 - main returns an int, and return value will be 0.
+ 1 - platform does not support returning a value from main
+*/
+#ifndef MAIN_HAS_NORETURN
+#define MAIN_HAS_NORETURN 0
+#endif
+
+/* Variable: default_num_contexts
+ Number of contexts to spawn in multicore context.
+ Override this global value to change number of contexts used.
+
+ Note:
+ This value may not be set higher then the <MULTITHREAD> define.
+
+ To experiment, you can set the <MULTITHREAD> define to the highest value expected, and use argc/argv in the <portable_init> to set this value from the command line.
+*/
+extern ee_u32 default_num_contexts;
+
+#if (MULTITHREAD>1)
+#if USE_PTHREAD
+ #include <pthread.h>
+ #define PARALLEL_METHOD "PThreads"
+#elif USE_FORK
+ #include <unistd.h>
+ #include <errno.h>
+ #include <sys/wait.h>
+ #include <sys/shm.h>
+ #include <string.h> /* for memcpy */
+ #define PARALLEL_METHOD "Fork"
+#elif USE_SOCKET
+ #include <sys/types.h>
+ #include <sys/socket.h>
+ #include <netinet/in.h>
+ #include <arpa/inet.h>
+ #include <sys/wait.h>
+ #include <stdio.h>
+ #include <stdlib.h>
+ #include <string.h>
+ #include <unistd.h>
+ #include <errno.h>
+ #define PARALLEL_METHOD "Sockets"
+#else
+ #define PARALLEL_METHOD "Proprietary"
+ #error "Please implement multicore functionality in core_portme.c to use multiple contexts."
+#endif /* Method for multithreading */
+#endif /* MULTITHREAD > 1 */
+
+typedef struct CORE_PORTABLE_S {
+#if (MULTITHREAD>1)
+ #if USE_PTHREAD
+ pthread_t thread;
+ #elif USE_FORK
+ pid_t pid;
+ int shmid;
+ void *shm;
+ #elif USE_SOCKET
+ pid_t pid;
+ int sock;
+ struct sockaddr_in sa;
+ #endif /* Method for multithreading */
+#endif /* MULTITHREAD>1 */
+ ee_u8 portable_id;
+} core_portable;
+
+/* target specific init/fini */
+void portable_init(core_portable *p, int *argc, char *argv[]);
+void portable_fini(core_portable *p);
+
+#if (SEED_METHOD==SEED_VOLATILE)
+ #if (VALIDATION_RUN || PERFORMANCE_RUN || PROFILE_RUN)
+ #define RUN_TYPE_FLAG 1
+ #else
+ #if (TOTAL_DATA_SIZE==1200)
+ #define PROFILE_RUN 1
+ #else
+ #define PERFORMANCE_RUN 1
+ #endif
+ #endif
+#endif /* SEED_METHOD==SEED_VOLATILE */
+
+#endif /* CORE_PORTME_H */
diff --git a/sw/vendor/coremark/linux64/core_portme.mak b/sw/vendor/coremark/linux64/core_portme.mak
new file mode 100755
index 0000000..5cfabee
--- /dev/null
+++ b/sw/vendor/coremark/linux64/core_portme.mak
@@ -0,0 +1,140 @@
+# Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+#
+# Licensed 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.
+#
+# Original Author: Shay Gal-on
+
+#File: core_portme.mak
+
+# Flag: OUTFLAG
+# Use this flag to define how to to get an executable (e.g -o)
+OUTFLAG= -o
+# Flag: CC
+# Use this flag to define compiler to use
+CC = gcc
+# Flag: CFLAGS
+# Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS="other flags"
+PORT_CFLAGS = -O2
+FLAGS_STR = "$(PORT_CFLAGS) $(XCFLAGS) $(XLFLAGS) $(LFLAGS_END)"
+CFLAGS = $(PORT_CFLAGS) -I$(PORT_DIR) -I. -DFLAGS_STR=\"$(FLAGS_STR)\"
+#Flag: LFLAGS_END
+# Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts).
+# Note: On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.
+LFLAGS_END += -lrt
+# Flag: PORT_SRCS
+# Port specific source files can be added here
+PORT_SRCS = $(PORT_DIR)/core_portme.c
+# Flag: LOAD
+# Define this flag if you need to load to a target, as in a cross compile environment.
+
+# Flag: RUN
+# Define this flag if running does not consist of simple invocation of the binary.
+# In a cross compile environment, you need to define this.
+
+#For flashing and using a tera term macro, you could use
+#LOAD = flash ADDR
+#RUN = ttpmacro coremark.ttl
+
+#For copying to target and executing via SSH connection, you could use
+#LOAD = scp $(OUTFILE) user@target:~
+#RUN = ssh user@target -c
+
+#For native compilation and execution
+LOAD = echo Loading done
+RUN =
+
+OEXT = .o
+EXE = .exe
+
+# Flag: SEPARATE_COMPILE
+# Define if you need to separate compilation from link stage.
+# In this case, you also need to define below how to create an object file, and how to link.
+ifdef SEPARATE_COMPILE
+
+LD = gcc
+OBJOUT = -o
+LFLAGS =
+OFLAG = -o
+COUT = -c
+# Flag: PORT_OBJS
+# Port specific object files can be added here
+PORT_OBJS = $(PORT_DIR)/core_portme$(OEXT)
+PORT_CLEAN = *$(OEXT)
+
+$(OPATH)%$(OEXT) : %.c
+ $(CC) $(CFLAGS) $(XCFLAGS) $(COUT) $< $(OBJOUT) $@
+
+endif
+
+# Target: port_prebuild
+# Generate any files that are needed before actual build starts.
+# E.g. generate profile guidance files. Sample PGO generation for gcc enabled with PGO=1
+# - First, check if PGO was defined on the command line, if so, need to add -fprofile-use to compile line.
+# - Second, if PGO reference has not yet been generated, add a step to the prebuild that will build a profile-generate version and run it.
+# Note - Using REBUILD=1
+#
+# Use make PGO=1 to invoke this sample processing.
+
+ifdef PGO
+ ifeq (,$(findstring $(PGO),gen))
+ PGO_STAGE=build_pgo_gcc
+ CFLAGS+=-fprofile-use
+ endif
+ PORT_CLEAN+=*.gcda *.gcno gmon.out
+endif
+
+.PHONY: port_prebuild
+port_prebuild: $(PGO_STAGE)
+
+.PHONY: build_pgo_gcc
+build_pgo_gcc:
+ $(MAKE) PGO=gen XCFLAGS="$(XCFLAGS) -fprofile-generate -DTOTAL_DATA_SIZE=1200" ITERATIONS=10 gen_pgo_data REBUILD=1
+
+# Target: port_postbuild
+# Generate any files that are needed after actual build end.
+# E.g. change format to srec, bin, zip in order to be able to load into flash
+.PHONY: port_postbuild
+port_postbuild:
+
+# Target: port_postrun
+# Do platform specific after run stuff.
+# E.g. reset the board, backup the logfiles etc.
+.PHONY: port_postrun
+port_postrun:
+
+# Target: port_prerun
+# Do platform specific after run stuff.
+# E.g. reset the board, backup the logfiles etc.
+.PHONY: port_prerun
+port_prerun:
+
+# Target: port_postload
+# Do platform specific after load stuff.
+# E.g. reset the reset power to the flash eraser
+.PHONY: port_postload
+port_postload:
+
+# Target: port_preload
+# Do platform specific before load stuff.
+# E.g. reset the reset power to the flash eraser
+.PHONY: port_preload
+port_preload:
+
+# FLAG: OPATH
+# Path to the output folder. Default - current folder.
+OPATH = ./
+MKDIR = mkdir -p
+
+# FLAG: PERL
+# Define perl executable to calculate the geomean if running separate.
+PERL=/usr/bin/perl
diff --git a/sw/vendor/coremark/simple/core_portme.c b/sw/vendor/coremark/simple/core_portme.c
new file mode 100755
index 0000000..33c863d
--- /dev/null
+++ b/sw/vendor/coremark/simple/core_portme.c
@@ -0,0 +1,128 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+#include <stdio.h>
+#include <stdlib.h>
+#include "coremark.h"
+
+#if VALIDATION_RUN
+ volatile ee_s32 seed1_volatile=0x3415;
+ volatile ee_s32 seed2_volatile=0x3415;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PERFORMANCE_RUN
+ volatile ee_s32 seed1_volatile=0x0;
+ volatile ee_s32 seed2_volatile=0x0;
+ volatile ee_s32 seed3_volatile=0x66;
+#endif
+#if PROFILE_RUN
+ volatile ee_s32 seed1_volatile=0x8;
+ volatile ee_s32 seed2_volatile=0x8;
+ volatile ee_s32 seed3_volatile=0x8;
+#endif
+ volatile ee_s32 seed4_volatile=ITERATIONS;
+ volatile ee_s32 seed5_volatile=0;
+/* Porting : Timing functions
+ How to capture time and convert to seconds must be ported to whatever is supported by the platform.
+ e.g. Read value from on board RTC, read value from cpu clock cycles performance counter etc.
+ Sample implementation for standard time.h and windows.h definitions included.
+*/
+/* Define : TIMER_RES_DIVIDER
+ Divider to trade off timer resolution and total time that can be measured.
+
+ Use lower values to increase resolution, but make sure that overflow does not occur.
+ If there are issues with the return value overflowing, increase this value.
+ */
+#define NSECS_PER_SEC CLOCKS_PER_SEC
+#define CORETIMETYPE clock_t
+#define GETMYTIME(_t) (*_t=clock())
+#define MYTIMEDIFF(fin,ini) ((fin)-(ini))
+#define TIMER_RES_DIVIDER 1
+#define SAMPLE_TIME_IMPLEMENTATION 1
+#define EE_TICKS_PER_SEC (NSECS_PER_SEC / TIMER_RES_DIVIDER)
+
+/** Define Host specific (POSIX), or target specific global time variables. */
+static CORETIMETYPE start_time_val, stop_time_val;
+
+/* Function : start_time
+ This function will be called right before starting the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or zeroing some system parameters - e.g. setting the cpu clocks cycles to 0.
+*/
+void start_time(void) {
+ GETMYTIME(&start_time_val );
+}
+/* Function : stop_time
+ This function will be called right after ending the timed portion of the benchmark.
+
+ Implementation may be capturing a system timer (as implemented in the example code)
+ or other system parameters - e.g. reading the current value of cpu cycles counter.
+*/
+void stop_time(void) {
+ GETMYTIME(&stop_time_val );
+}
+/* Function : get_time
+ Return an abstract "ticks" number that signifies time on the system.
+
+ Actual value returned may be cpu cycles, milliseconds or any other value,
+ as long as it can be converted to seconds by <time_in_secs>.
+ This methodology is taken to accomodate any hardware or simulated platform.
+ The sample implementation returns millisecs by default,
+ and the resolution is controlled by <TIMER_RES_DIVIDER>
+*/
+CORE_TICKS get_time(void) {
+ CORE_TICKS elapsed=(CORE_TICKS)(MYTIMEDIFF(stop_time_val, start_time_val));
+ return elapsed;
+}
+/* Function : time_in_secs
+ Convert the value returned by get_time to seconds.
+
+ The <secs_ret> type is used to accomodate systems with no support for floating point.
+ Default implementation implemented by the EE_TICKS_PER_SEC macro above.
+*/
+secs_ret time_in_secs(CORE_TICKS ticks) {
+ secs_ret retval=((secs_ret)ticks) / (secs_ret)EE_TICKS_PER_SEC;
+ return retval;
+}
+
+ee_u32 default_num_contexts=1;
+
+/* Function : portable_init
+ Target specific initialization code
+ Test for some common mistakes.
+*/
+void portable_init(core_portable *p, int *argc, char *argv[])
+{
+ if (sizeof(ee_ptr_int) != sizeof(ee_u8 *)) {
+ ee_printf("ERROR! Please define ee_ptr_int to a type that holds a pointer!\n");
+ }
+ if (sizeof(ee_u32) != 4) {
+ ee_printf("ERROR! Please define ee_u32 to a 32b unsigned type!\n");
+ }
+ p->portable_id=1;
+}
+/* Function : portable_fini
+ Target specific final code
+*/
+void portable_fini(core_portable *p)
+{
+ p->portable_id=0;
+}
+
+
diff --git a/sw/vendor/coremark/simple/core_portme.h b/sw/vendor/coremark/simple/core_portme.h
new file mode 100755
index 0000000..a3607bf
--- /dev/null
+++ b/sw/vendor/coremark/simple/core_portme.h
@@ -0,0 +1,196 @@
+/*
+Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+
+Licensed 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.
+
+Original Author: Shay Gal-on
+*/
+
+/* Topic : Description
+ This file contains configuration constants required to execute on different platforms
+*/
+#ifndef CORE_PORTME_H
+#define CORE_PORTME_H
+/************************/
+/* Data types and settings */
+/************************/
+/* Configuration : HAS_FLOAT
+ Define to 1 if the platform supports floating point.
+*/
+#ifndef HAS_FLOAT
+#define HAS_FLOAT 1
+#endif
+/* Configuration : HAS_TIME_H
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef HAS_TIME_H
+#define HAS_TIME_H 1
+#endif
+/* Configuration : USE_CLOCK
+ Define to 1 if platform has the time.h header file,
+ and implementation of functions thereof.
+*/
+#ifndef USE_CLOCK
+#define USE_CLOCK 1
+#endif
+/* Configuration : HAS_STDIO
+ Define to 1 if the platform has stdio.h.
+*/
+#ifndef HAS_STDIO
+#define HAS_STDIO 1
+#endif
+/* Configuration : HAS_PRINTF
+ Define to 1 if the platform has stdio.h and implements the printf function.
+*/
+#ifndef HAS_PRINTF
+#define HAS_PRINTF 1
+#endif
+
+/* Configuration : CORE_TICKS
+ Define type of return from the timing functions.
+ */
+#include <time.h>
+typedef clock_t CORE_TICKS;
+
+/* Definitions : COMPILER_VERSION, COMPILER_FLAGS, MEM_LOCATION
+ Initialize these strings per platform
+*/
+#ifndef COMPILER_VERSION
+ #ifdef __GNUC__
+ #define COMPILER_VERSION "GCC"__VERSION__
+ #else
+ #define COMPILER_VERSION "Please put compiler version here (e.g. gcc 4.1)"
+ #endif
+#endif
+#ifndef COMPILER_FLAGS
+ #define COMPILER_FLAGS FLAGS_STR /* "Please put compiler flags here (e.g. -o3)" */
+#endif
+#ifndef MEM_LOCATION
+ #define MEM_LOCATION "STACK"
+#endif
+
+/* Data Types :
+ To avoid compiler issues, define the data types that need ot be used for 8b, 16b and 32b in <core_portme.h>.
+
+ *Imprtant* :
+ ee_ptr_int needs to be the data type used to hold pointers, otherwise coremark may fail!!!
+*/
+typedef signed short ee_s16;
+typedef unsigned short ee_u16;
+typedef signed int ee_s32;
+typedef double ee_f32;
+typedef unsigned char ee_u8;
+typedef unsigned int ee_u32;
+typedef ee_u32 ee_ptr_int;
+typedef size_t ee_size_t;
+/* align_mem :
+ This macro is used to align an offset to point to a 32b value. It is used in the Matrix algorithm to initialize the input memory blocks.
+*/
+#define align_mem(x) (void *)(4 + (((ee_ptr_int)(x) - 1) & ~3))
+
+/* Configuration : SEED_METHOD
+ Defines method to get seed values that cannot be computed at compile time.
+
+ Valid values :
+ SEED_ARG - from command line.
+ SEED_FUNC - from a system function.
+ SEED_VOLATILE - from volatile variables.
+*/
+#ifndef SEED_METHOD
+#define SEED_METHOD SEED_VOLATILE
+#endif
+
+/* Configuration : MEM_METHOD
+ Defines method to get a block of memry.
+
+ Valid values :
+ MEM_MALLOC - for platforms that implement malloc and have malloc.h.
+ MEM_STATIC - to use a static memory array.
+ MEM_STACK - to allocate the data block on the stack (NYI).
+*/
+#ifndef MEM_METHOD
+#define MEM_METHOD MEM_STACK
+#endif
+
+/* Configuration : MULTITHREAD
+ Define for parallel execution
+
+ Valid values :
+ 1 - only one context (default).
+ N>1 - will execute N copies in parallel.
+
+ Note :
+ If this flag is defined to more then 1, an implementation for launching parallel contexts must be defined.
+
+ Two sample implementations are provided. Use <USE_PTHREAD> or <USE_FORK> to enable them.
+
+ It is valid to have a different implementation of <core_start_parallel> and <core_end_parallel> in <core_portme.c>,
+ to fit a particular architecture.
+*/
+#ifndef MULTITHREAD
+#define MULTITHREAD 1
+#define USE_PTHREAD 0
+#define USE_FORK 0
+#define USE_SOCKET 0
+#endif
+
+/* Configuration : MAIN_HAS_NOARGC
+ Needed if platform does not support getting arguments to main.
+
+ Valid values :
+ 0 - argc/argv to main is supported
+ 1 - argc/argv to main is not supported
+
+ Note :
+ This flag only matters if MULTITHREAD has been defined to a value greater then 1.
+*/
+#ifndef MAIN_HAS_NOARGC
+#define MAIN_HAS_NOARGC 0
+#endif
+
+/* Configuration : MAIN_HAS_NORETURN
+ Needed if platform does not support returning a value from main.
+
+ Valid values :
+ 0 - main returns an int, and return value will be 0.
+ 1 - platform does not support returning a value from main
+*/
+#ifndef MAIN_HAS_NORETURN
+#define MAIN_HAS_NORETURN 0
+#endif
+
+/* Variable : default_num_contexts
+ Not used for this simple port, must cintain the value 1.
+*/
+extern ee_u32 default_num_contexts;
+
+typedef struct CORE_PORTABLE_S {
+ ee_u8 portable_id;
+} core_portable;
+
+/* target specific init/fini */
+void portable_init(core_portable *p, int *argc, char *argv[]);
+void portable_fini(core_portable *p);
+
+#if !defined(PROFILE_RUN) && !defined(PERFORMANCE_RUN) && !defined(VALIDATION_RUN)
+#if (TOTAL_DATA_SIZE==1200)
+#define PROFILE_RUN 1
+#elif (TOTAL_DATA_SIZE==2000)
+#define PERFORMANCE_RUN 1
+#else
+#define VALIDATION_RUN 1
+#endif
+#endif
+
+#endif /* CORE_PORTME_H */
diff --git a/sw/vendor/coremark/simple/core_portme.mak b/sw/vendor/coremark/simple/core_portme.mak
new file mode 100755
index 0000000..61c3db6
--- /dev/null
+++ b/sw/vendor/coremark/simple/core_portme.mak
@@ -0,0 +1,60 @@
+# Copyright 2018 Embedded Microprocessor Benchmark Consortium (EEMBC)
+#
+# Licensed 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.
+#
+# Original Author: Shay Gal-on
+
+#File : core_portme.mak
+
+# Flag : OUTFLAG
+# Use this flag to define how to to get an executable (e.g -o)
+OUTFLAG= -o
+# Flag : CC
+# Use this flag to define compiler to use
+CC = gcc
+# Flag : CFLAGS
+# Use this flag to define compiler options. Note, you can add compiler options from the command line using XCFLAGS="other flags"
+PORT_CFLAGS = -O2
+FLAGS_STR = "$(PORT_CFLAGS) $(XCFLAGS) $(XLFLAGS) $(LFLAGS_END)"
+CFLAGS = $(PORT_CFLAGS) -I$(PORT_DIR) -I. -DFLAGS_STR=\"$(FLAGS_STR)\"
+#Flag : LFLAGS_END
+# Define any libraries needed for linking or other flags that should come at the end of the link line (e.g. linker scripts).
+# Note : On certain platforms, the default clock_gettime implementation is supported but requires linking of librt.
+LFLAGS_END =
+# Flag : PORT_SRCS
+# Port specific source files can be added here
+PORT_SRCS = $(PORT_DIR)/core_portme.c
+# Flag : LOAD
+# For a simple port, we assume self hosted compile and run, no load needed.
+
+# Flag : RUN
+# For a simple port, we assume self hosted compile and run, simple invocation of the executable
+
+#For native compilation and execution
+LOAD = echo Loading done
+RUN =
+
+OEXT = .o
+EXE = .exe
+
+# Target : port_pre% and port_post%
+# For the purpose of this simple port, no pre or post steps needed.
+
+.PHONY : port_prebuild port_postbuild port_prerun port_postrun port_preload port_postload
+port_pre% port_post% :
+
+# FLAG : OPATH
+# Path to the output folder. Default - current folder.
+OPATH = ./
+MKDIR = mkdir -p
+
diff --git a/sw/vendor/cryptoc/Makefile b/sw/vendor/cryptoc/Makefile
new file mode 100644
index 0000000..6cac9f9
--- /dev/null
+++ b/sw/vendor/cryptoc/Makefile
@@ -0,0 +1,41 @@
+# Copyright lowRISC contributors.
+# Licensed under the Apache License, Version 2.0, see LICENSE for details.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Generate a baremetal application for the microcontroller
+
+LIB_NAME = cryptoc
+DIF_SRCS = sha256.c
+ARCH = rv32imc
+# ARCH = rv32im # to disable compressed instructions
+
+RV_TOOLS ?= /tools/riscv/bin/
+
+CC := ${RV_TOOLS}/riscv32-unknown-elf-gcc
+CFLAGS ?= -Wall -g -Os -march=$(ARCH) -mabi=ilp32 -static -mcmodel=medany \
+ -fvisibility=hidden -nostdlib -nostartfiles
+
+ifeq ($(SIM),1)
+ CFLAGS += -DSIMULATION
+endif
+
+AR := $(subst gcc,ar,$(wordlist 1,1,$(CC)))
+ARFLAGS ?= -cvr
+
+OBJS := ${DIF_SRCS:.c=.o}
+DEPS = $(OBJS:%.o=%.d)
+
+OUTFILES = lib$(LIB_NAME).a
+
+$(OUTFILES): $(OBJS)
+ $(AR) $(ARFLAGS) $@ $(OBJS)
+
+all: $(OUTFILES)
+
+%.o: %.c
+ $(CC) $(CFLAGS) -MMD -c $(INCS) -o $@ $<
+
+-include $(DEPS)
+
+clean:
+ $(RM) *.o *.d $(OUTFILES)
diff --git a/sw/vendor/cryptoc/hash-internal.h b/sw/vendor/cryptoc/hash-internal.h
new file mode 100644
index 0000000..528d8b0
--- /dev/null
+++ b/sw/vendor/cryptoc/hash-internal.h
@@ -0,0 +1,56 @@
+// Copyright 2016 Google Inc.
+//
+// Licensed 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.
+#ifndef SECURITY_UTIL_LITE_HASH_INTERNAL_H__
+#define SECURITY_UTIL_LITE_HASH_INTERNAL_H__
+
+#include <stddef.h>
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+struct HASH_CTX; // forward decl
+
+typedef struct HASH_VTAB {
+ void (*const init)(struct HASH_CTX*);
+ void (*const update)(struct HASH_CTX*, const void*, size_t);
+ const uint8_t* (*const final)(struct HASH_CTX*);
+ const uint8_t* (*const hash)(const void*, size_t, uint8_t*);
+ unsigned int size;
+} HASH_VTAB;
+
+typedef struct HASH_CTX {
+ const HASH_VTAB* f;
+ uint64_t count;
+#ifndef SHA512_SUPPORT
+ uint8_t buf[64];
+ uint32_t state[8]; // upto SHA2-256
+#else
+ uint8_t buf[128];
+ uint64_t state[8]; // upto SHA2-512
+#endif
+} HASH_CTX;
+
+#define HASH_init(ctx) (ctx)->f->init(ctx)
+#define HASH_update(ctx, data, len) (ctx)->f->update(ctx, data, len)
+#define HASH_final(ctx) (ctx)->f->final(ctx)
+#define HASH_hash(data, len, digest) (ctx)->f->hash(data, len, digest)
+#define HASH_size(ctx) (ctx)->f->size
+
+#ifdef __cplusplus
+}
+#endif // __cplusplus
+
+#endif // SECURITY_UTIL_LITE_HASH_INTERNAL_H__
diff --git a/sw/vendor/cryptoc/sha256.c b/sw/vendor/cryptoc/sha256.c
new file mode 100644
index 0000000..4741f6f
--- /dev/null
+++ b/sw/vendor/cryptoc/sha256.c
@@ -0,0 +1,156 @@
+// Copyright 2016 Google Inc.
+//
+// Licensed 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 "sha256.h"
+
+#include <stdint.h>
+#include <string.h>
+
+#define ror(value, bits) (((value) >> (bits)) | ((value) << (32 - (bits))))
+#define shr(value, bits) ((value) >> (bits))
+
+static const uint32_t K[64] = {
+ 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1,
+ 0x923f82a4, 0xab1c5ed5, 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3,
+ 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174, 0xe49b69c1, 0xefbe4786,
+ 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
+ 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147,
+ 0x06ca6351, 0x14292967, 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
+ 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85, 0xa2bfe8a1, 0xa81a664b,
+ 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
+ 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a,
+ 0x5b9cca4f, 0x682e6ff3, 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208,
+ 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2};
+
+static void SHA256_Transform(LITE_SHA256_CTX* ctx) {
+ uint32_t W[64];
+ uint32_t A, B, C, D, E, F, G, H;
+ uint8_t* p = ctx->buf;
+ int t;
+
+ for (t = 0; t < 16; ++t) {
+ uint32_t tmp = *p++ << 24;
+ tmp |= *p++ << 16;
+ tmp |= *p++ << 8;
+ tmp |= *p++;
+ W[t] = tmp;
+ }
+
+ for (; t < 64; t++) {
+ uint32_t s0 = ror(W[t - 15], 7) ^ ror(W[t - 15], 18) ^ shr(W[t - 15], 3);
+ uint32_t s1 = ror(W[t - 2], 17) ^ ror(W[t - 2], 19) ^ shr(W[t - 2], 10);
+ W[t] = W[t - 16] + s0 + W[t - 7] + s1;
+ }
+
+ A = ctx->state[0];
+ B = ctx->state[1];
+ C = ctx->state[2];
+ D = ctx->state[3];
+ E = ctx->state[4];
+ F = ctx->state[5];
+ G = ctx->state[6];
+ H = ctx->state[7];
+
+ for (t = 0; t < 64; t++) {
+ uint32_t s0 = ror(A, 2) ^ ror(A, 13) ^ ror(A, 22);
+ uint32_t maj = (A & B) ^ (A & C) ^ (B & C);
+ uint32_t t2 = s0 + maj;
+ uint32_t s1 = ror(E, 6) ^ ror(E, 11) ^ ror(E, 25);
+ uint32_t ch = (E & F) ^ ((~E) & G);
+ uint32_t t1 = H + s1 + ch + K[t] + W[t];
+
+ H = G;
+ G = F;
+ F = E;
+ E = D + t1;
+ D = C;
+ C = B;
+ B = A;
+ A = t1 + t2;
+ }
+
+ ctx->state[0] += A;
+ ctx->state[1] += B;
+ ctx->state[2] += C;
+ ctx->state[3] += D;
+ ctx->state[4] += E;
+ ctx->state[5] += F;
+ ctx->state[6] += G;
+ ctx->state[7] += H;
+}
+
+static const HASH_VTAB SHA256_VTAB = {SHA256_init, SHA256_update, SHA256_final,
+ SHA256_hash, SHA256_DIGEST_SIZE};
+
+void SHA256_init(LITE_SHA256_CTX* ctx) {
+ ctx->f = &SHA256_VTAB;
+ ctx->state[0] = 0x6a09e667;
+ ctx->state[1] = 0xbb67ae85;
+ ctx->state[2] = 0x3c6ef372;
+ ctx->state[3] = 0xa54ff53a;
+ ctx->state[4] = 0x510e527f;
+ ctx->state[5] = 0x9b05688c;
+ ctx->state[6] = 0x1f83d9ab;
+ ctx->state[7] = 0x5be0cd19;
+ ctx->count = 0;
+}
+
+void SHA256_update(LITE_SHA256_CTX* ctx, const void* data, size_t len) {
+ int i = (int)(ctx->count & 63);
+ const uint8_t* p = (const uint8_t*)data;
+
+ ctx->count += len;
+
+ while (len--) {
+ ctx->buf[i++] = *p++;
+ if (i == 64) {
+ SHA256_Transform(ctx);
+ i = 0;
+ }
+ }
+}
+
+const uint8_t* SHA256_final(LITE_SHA256_CTX* ctx) {
+ uint8_t* p = ctx->buf;
+ uint64_t cnt = ctx->count * 8;
+ int i;
+
+ SHA256_update(ctx, (uint8_t*)"\x80", 1);
+ while ((ctx->count & 63) != 56) {
+ SHA256_update(ctx, (uint8_t*)"\0", 1);
+ }
+ for (i = 0; i < 8; ++i) {
+ uint8_t tmp = (uint8_t)(cnt >> 56);
+ cnt <<= 8;
+ SHA256_update(ctx, &tmp, 1);
+ }
+
+ for (i = 0; i < 8; i++) {
+ uint32_t tmp = ctx->state[i];
+ *p++ = (uint8_t)(tmp >> 24);
+ *p++ = (uint8_t)(tmp >> 16);
+ *p++ = (uint8_t)(tmp >> 8);
+ *p++ = (uint8_t)(tmp >> 0);
+ }
+
+ return ctx->buf;
+}
+
+/* Convenience function */
+const uint8_t* SHA256_hash(const void* data, size_t len, uint8_t* digest) {
+ LITE_SHA256_CTX ctx;
+ SHA256_init(&ctx);
+ SHA256_update(&ctx, data, len);
+ memcpy(digest, SHA256_final(&ctx), SHA256_DIGEST_SIZE);
+ return digest;
+}
diff --git a/sw/vendor/cryptoc/sha256.h b/sw/vendor/cryptoc/sha256.h
new file mode 100644
index 0000000..311eb7b
--- /dev/null
+++ b/sw/vendor/cryptoc/sha256.h
@@ -0,0 +1,41 @@
+// Copyright 2016 Google Inc.
+//
+// Licensed 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.
+#ifndef SECURITY_UTIL_LITE_SHA256_H__
+#define SECURITY_UTIL_LITE_SHA256_H__
+
+#include <stddef.h>
+#include <stdint.h>
+
+#include "hash-internal.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
+typedef HASH_CTX LITE_SHA256_CTX;
+
+void SHA256_init(LITE_SHA256_CTX* ctx);
+void SHA256_update(LITE_SHA256_CTX* ctx, const void* data, size_t len);
+const uint8_t* SHA256_final(LITE_SHA256_CTX* ctx);
+
+// Convenience method. Returns digest address.
+const uint8_t* SHA256_hash(const void* data, size_t len, uint8_t* digest);
+
+#define SHA256_DIGEST_SIZE 32
+
+#ifdef __cplusplus
+}
+#endif // __cplusplus
+
+#endif // SECURITY_UTIL_LITE_SHA256_H__
