Update README.md

Author: tectrolabs

README.md

@@ -13,6 +13,77 @@ This repository contains the MicroRNG Software Kit and utilities for using the M
 * `mcrng.cpp` - utility for downloading random bytes generated by MicroRNG device over SPI interface.
 * `sample.cpp` - sample C++ program that demonstrates how to use the API for communicating with the MicroRNG device over SPI interface.
 
+## Getting Started
+
+To build and run MicroRNG utilities you will need a sudo access permissions to your Linux instance and an Internet connection.
+
+### Dependencies
+
+The following dependencies are required to successfully build utilities: 
+
+* C++ compiler
+* git 
+* make
+
+C++ compiler can be installed on Ubuntu with the following command:
+```
+sudo apt-get install g++
+```
+
+Git development dependency can be installed on Ubuntu with the following command:
+```
+sudo apt-get install git
+```
+
+Make development dependency can be installed on Ubuntu with the following command:
+```
+sudo apt-get install make
+```
+
+### Installing
+
+* Download the project:
+```
+git clone https://github.com/tectrolabs/microrng.git
+```
+
+* Build utilities:
+```
+cd microrng/mcrng
+make 
+```
+* Install the necessary executables:
+```
+sudo make install
+```
+### Verify MicroRNG is working
+
+* Connect MicroRNG device to the target board through provided SPI interface.
+* Verify device connectivity with the following command (you may need to use specific device path):
+```
+sudo mcdiag /dev/spidev0.0
+```
+* You may get an output similar to the following:
+
+```
+~/microrng/mcrng$ sudo mcdiag /dev/spidev0.0 
+-------------------------------------------------------------------
+--- TectroLabs - mcdiag - MicroRNG diagnostics utility Ver 1.0  ---
+--- Use with RPI 3+ or other Linux-based single-board computers ---
+-------------------------------------------------------------------
+Opening device /dev/spidev0.0 ----------------------------- Success
+Identifying device /dev/spidev0.0 --------------  MicroRNG detected
+Identifying maximum SPI clock frequency --------------- 31000000 Hz
+New SPI clock frequency ------------------------------- 31000000 Hz
+Retrieving 32000 random bytes ----------------------------- Success
+Retrieving 32000 RAW random bytes ------------------------- Success
+Retrieving 32000 random bytes ----------------------------- Success
+Shutting down RNG ----------------------------------------- Success
+Starting RNG up ------------------------------------------- Success
+Computing SPI transfer speed ----------------------------  497 kbps
+Validating MicroRNG internal status  ---------------------- Healthy
+```
+
 ## Authors
 
 Andrian Belinski