[README] Add github action badge
[platform/adaptation/npu/trix-engine.git] / README.md
1 ## NPU SystemService (NPU Engine)
2
3 [![Version](https://github.sec.samsung.net/nnsuite/n2s2/blob/master/AIP_NPU_SystemService/badges/version.svg)](/CHANGES)
4 [![Code Coverage](https://github.sec.samsung.net/nnsuite/n2s2/blob/master/AIP_NPU_SystemService/badges/codecoverage.svg)](http://nnsuiteci.mooo.com/NPU_SystemService/ci/gcov_html/index.html)
5 [![Unit Test](https://github.sec.samsung.net/nnsuite/n2s2/blob/master/AIP_NPU_SystemService/badges/unittest.svg)](http://nnsuiteci.mooo.com/NPU_SystemService/ci/unittest_result/)
6 [![SAM Score](https://github.sec.samsung.net/nnsuite/n2s2/blob/master/AIP_NPU_SystemService/badges/samscore.svg)](https://code.sec.samsung.net/architecturemanager/app/sam/NPU_SystemService/npu-engine/latest/overview)
7 [![Issues](https://github.sec.samsung.net/nnsuite/n2s2/blob/master/AIP_NPU_SystemService/badges/issues.svg)](https://github.sec.samsung.net/AIP/NPU_SystemService/issues)
8 [![Pull Requests](https://github.sec.samsung.net/nnsuite/n2s2/blob/master/AIP_NPU_SystemService/badges/pulls.svg)](https://github.sec.samsung.net/AIP/NPU_SystemService/pulls)
9 [![artifacts-ubuntu](https://github.sec.samsung.net/AIP/NPU_SystemService/workflows/artifacts-ubuntu/badge.svg)](https://github.sec.samsung.net/AIP/NPU_SystemService/actions?query=workflow%3Aartifacts-ubuntu)
10
11 ## Directory Structure
12 ```
13 NPU_SystemService/    Root directory
14 |-- src/
15 |   |-- core/         Source files for NPU Engine Core
16 |   |-- host/         Source files for User APIs
17 |-- include/
18 |   |-- common/       Definitions for Common Data
19 |   |-- host/         Definitions for User APIs
20 |-- tests/
21 |   |-- unittests     Source files for Unit Tests
22 |   |-- apptests      Source files for App Tests
23 |   `-- utils         Source files for Test Utils
24 |-- packaging/        Tizen Packaging Files (i.e., FastModel or FPGA)
25 |-- debian/           Debian Packaging Files (i.e., Ubuntu 18.04)
26 `-- docs/             Documentation using hotdoc
27 ```
28
29 ## Getting Started
30 - [AIP/NPU_DDK_DOCS](https://github.sec.samsung.net/pages/AIP/NPU_DDK_DOCS): Official documents generated by hotdoc
31
32 ## Related Projects
33 - [AIP/NPU_Linux-kernel](https://github.sec.samsung.net/AIP/NPU_Linux-kernel): Linux kernel image and drivers (on FastModel simulator)
34 - [AIP/NPU_bootstrap](https://github.sec.samsung.net/AIP/NPU_bootstrap): Bootstrap packages for FastModel simulator
35 - [AIP/NPU_SystemService_Testdata](https://github.sec.samsung.net/AIP/NPU_SystemService_Testdata): Testdata for verification (.tvn models compiled by [AIP/NPU_Compiler](https://github.sec.samsung.net/AIP/NPU_Compiler))
36 - [AIP/meta-trinity](https://github.sec.samsung.net/AIP/meta-trinity): Bitbake recipes for an FPGA board (ZCU102-ZYNQMP)
37 - [AIP/n2s2_docker](https://github.sec.samsung.net/AIP/n2s2_docker): Docker images for npu-engine users
38
39 ## Official Repository (to download npu-engine packages)
40 - SPIN OBS
41   - How to create your SPIN account: press [here](https://code.sec.samsung.net/confluence/display/NEWCOMM/SPIN+Request+Process)
42   - Tizen: http://10.113.136.32/download_trbs/snapshots/devel/tizen-6.0-ai/latest/repos/Tizen_Unified_standard
43   - Ubuntu (18.04): http://10.113.136.32/download_trbs/newlive/devel:/Tizen:/6.0:/AI:/UbuntuTools
44 - Artifactory
45   - Ubuntu (18.04): https://art.sec.samsung.net/artifactory/list/aip_debian
46
47 ## Additional Notes
48 - The FastModel simulator requires Ubuntu 18.04 as your Host OS.
49 - TRIV2 Models (.tvn) should be compatible with npubinfmt v3. Please refer to [npubinfmt.h](/include/common/npubinfmt.h)
50
51 ## Reference Links
52 - Software Stack: https://code.sec.samsung.net/confluence/display/ODLC/2020+Overall+Software+Stack
53 - CI Server: http://nnsuiteci.mooo.com/NPU_SystemService/ci/taos/
54 - Code Coverage: http://nnsuiteci.mooo.com/NPU_SystemService/ci/gcov_html/
55 - Doxygen manual: http://nnsuiteci.mooo.com/NPU_SystemService/latex/book.pdf