[README] Add quick start guide
authorgichan <gichan2.jang@samsung.com>
Wed, 29 Mar 2023 06:41:13 +0000 (15:41 +0900)
committerjaeyun-jung <39614140+jaeyun-jung@users.noreply.github.com>
Fri, 31 Mar 2023 02:34:06 +0000 (11:34 +0900)
Add quick start guide
 - install nnstreamer-edge via ppa
 - build and run unit tests

Signed-off-by: gichan <gichan2.jang@samsung.com>
README.md

index 44d1ccd27280580b308914a44bda16d02bbebff8..c9044e7c711a333275b54e609c0359f75c346a29 100644 (file)
--- a/README.md
+++ b/README.md
@@ -16,8 +16,43 @@ If your system can afford running nnstreamer (gstreamer), don't use nnstreamer-e
     - However, it may leave empty spaces that can be filled with "wrapper/plugin" for the portability. E.g., I may get too lazy to write communication layers; then, I'll leave it to the users to write down their own communication plugins.
     - This should not rely on Tizen, either. However, Tizen-RT might be considered as the primary target.
 - Communication Layers includes:
-    - Primary Targets: TCP, UDP, User Plugins.
+    - Primary Targets: TCP, User Plugins.
     - Secondary Targets: Flatbuffers
 
+# Quick start guide for NNStreamer-edge (Ubuntu 20.04 LTS or 22.04 LTS)
+ - Note: This simple guide explains how to use NNStreamer-edge on the Ubuntu, but NNStreamer-edge is also available on Tizen, Android and TizenRT.
+## Install via PPA
+### Download nnstreamer-edge
+```
+$ sudo add-apt-repository ppa:nnstreamer/ppa
+$ sudo apt-get install nnstreamer-edge
+# Download nnstreamer for sample application
+(optional) $ sudo apt-get install nnstreamer
+```
+### Run nnstreamer and nnstreamer-edge sample application
+ - See pub/sub example: [Link](https://nnstreamer.github.io/tutorial3_pubsub_mqtt.html)
+ - See query example: [Link](https://nnstreamer.github.io/tutorial4_query.html)
+
+## How to build (Ubuntu 20.04 LTS or 22.04 LTS)
+
+### Download prerequisite
+```
+$ sudo apt-get install cmake systemctl build-essential pkg-config mosquitto-dev libmosquitto-dev libgtest-dev libgmock-dev
+# Run MQTT broker
+$ sudo systemctl start mosquitto
+```
+
+### Build and Run test
+```
+# cd $NNST_EDGE_ROOT
+$ cmake -B build -DCMAKE_INSTALL_PREFIX=/usr -DENABLE_TEST=ON -DMQTT_SUPPORT=ON
+$ make -C build install
+
+# Run test
+$ cd /usr/bin
+$ ./unittest_nnstreamer-edge
+$ ./unittest_nnstreamer-edge-mqtt
+```
+
 ## License
 - Apache 2.0