example: add hello_world example to mli module

add hello_world example to mli module

Signed-off-by: Siyuan Cheng <[email protected]>

Author: Siyuan Cheng

samples/modules/embarc_mli/hello_world/CMakeLists.txt

@@ -0,0 +1,15 @@
+# Copyright (c) 2022 Synopsys
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.13.1)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(hello_world)
+
+zephyr_compile_options("-Wno-ignored-qualifiers")
+
+zephyr_compile_definitions(
+  V2DSP_XY
+)
+
+target_sources(app PRIVATE src/main.c)

samples/modules/embarc_mli/hello_world/README.rst

@@ -0,0 +1,62 @@
+.. _embarc_mli_hello_world:
+
+Hello_world Example
+###################
+
+Quick Start
+--------------
+
+Example supports building with [Zephyr Software Development Kit (SDK)](https://docs.zephyrproject.org/latest/getting_started/installation_linux.html#zephyr-sdk) and running with MetaWare Debuger on [nSim simulator](https://www.synopsys.com/dw/ipdir.php?ds=sim_nSIM).
+
+Add embarc_mli module to Zephyr instruction
+-------------------------------------------
+
+1. Open command line and change working directory to './zephyrproject/zephyr'
+
+2. Download embarc_mli version 2.0
+
+        west update
+
+Build with Zephyr SDK toolchain
+-------------------------------
+
+    Build requirements:
+        - Zephyr SDK toolchain version 0.13.2 or higher
+        - gmake
+
+1. Open command line and change working directory to './zephyrproject/zephyr/samples/modules/embarc_mli/hello_world'
+
+2. Build example
+
+        west build -b nsim_em samples/modules/embarc_mli/hello_world
+
+Run example
+--------------
+
+1. Run example
+
+        west flash
+
+    Result shall be:
+
+.. code-block:: console
+
+        ...
+
+        in1:
+
+        1 2 3 4 5 6 7 8 
+
+        in2:
+
+        10 20 30 40 50 60 70 80 
+
+        mli_krn_eltwise_add_fx16 output:
+
+        11 22 33 44 55 66 77 88 
+
+        mli_krn_eltwise_sub_fx16 output:
+
+        -9 -18 -27 -36 -45 -54 -63 -72
+
+        ...

samples/modules/embarc_mli/hello_world/prj.conf

@@ -0,0 +1,3 @@
+# Copyright (c) 2022 Synopsys
+# SPDX-License-Identifier: Apache-2.0
+CONFIG_EMBARC_MLI=y

samples/modules/embarc_mli/hello_world/sample.yaml

@@ -0,0 +1,7 @@
+sample:
+  description: simple hello_world embarc_mli sample
+  name: hello_world
+tests:
+  sample.embarc_mli.hello_world:
+    platform_allow: nsim_em
+    tags: embarc_mli

samples/modules/embarc_mli/hello_world/src/main.c

@@ -0,0 +1,83 @@
+/*
+ * Copyright (c) 2022 Synopsys
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include "mli_api.h"
+#include <assert.h>
+#include <zephyr.h>
+#include <stdio.h>
+#include "mli_config.h"
+
+#if (PLATFORM == V2DSP_XY)
+#define DATA_ATTR __xy __attribute__((section(".Xdata")))
+
+#elif (PLATFORM == V2DSP_VECTOR)
+#define DATA_ATTR __vccm __attribute__((section(".vecmem_data")))
+
+#else
+#define DATA_ATTR
+
+#endif
+
+#define NUM_ELEMS 8
+
+int16_t DATA_ATTR data_in1[NUM_ELEMS] = { 1, 2, 3, 4, 5, 6, 7, 8 };
+int16_t DATA_ATTR data_in2[NUM_ELEMS] = { 10, 20, 30, 40, 50, 60, 70, 80 };
+int16_t DATA_ATTR data_out[NUM_ELEMS] = { 0, 0, 0, 0, 0, 0, 0, 0 };
+
+int main() {
+    mli_tensor in1 = { 0 };
+    in1.el_type = MLI_EL_FX_16;
+    in1.rank = 1;
+    in1.shape[0] = NUM_ELEMS;
+    in1.mem_stride[0] = 1;
+    in1.data.capacity = sizeof(data_in1);
+    in1.data.mem.pi16 = (int16_t *)data_in1;
+
+    mli_tensor in2 = { 0 };
+    in2.el_type = MLI_EL_FX_16;
+    in2.rank = 1;
+    in2.shape[0] = NUM_ELEMS;
+    in2.mem_stride[0] = 1;
+    in2.data.capacity = sizeof(data_in2);
+    in2.data.mem.pi16 = (int16_t *)data_in2;
+
+    mli_tensor out = { 0 };
+    out.el_type = MLI_EL_FX_16;
+    out.rank = 1;
+    out.shape[0] = NUM_ELEMS;
+    out.mem_stride[0] = 1;
+    out.data.capacity = sizeof(data_out);
+    out.data.mem.pi16 = (int16_t *)data_out;
+
+    printf("in1:\n");
+    for (int i = 0; i < NUM_ELEMS; i++) {
+        printf("%d ", in1.data.mem.pi16[i]);
+    }
+    printf("\nin2:\n");
+    for (int i = 0; i < NUM_ELEMS; i++) {
+        printf("%d ", in2.data.mem.pi16[i]);
+    }
+
+    mli_status status;
+    status = mli_krn_eltwise_add_fx16(&in1, &in2, &out);
+    assert(status == MLI_STATUS_OK);
+
+    printf("\nmli_krn_eltwise_add_fx16 output:\n");
+    for (int i = 0; i < NUM_ELEMS; i++) {
+        printf("%d ", out.data.mem.pi16[i]);
+    }
+
+    status = mli_krn_eltwise_sub_fx16(&in1, &in2, &out);
+    assert(status == MLI_STATUS_OK);
+
+    printf("\nmli_krn_eltwise_sub_fx16 output:\n");
+    for (int i = 0; i < NUM_ELEMS; i++) {
+        printf("%d ", out.data.mem.pi16[i]);
+    }
+    printf("\n");
+
+    return 0;
+}