########################################
IFC6309 Wiki
########################################

Getting Started
===============

**Hardware Required:**

.. image:: extra/hardware-requirements-1.jpg
      :align: center

.. image:: extra/hardware-requirement-2.jpg
      :align: center

**Software Required:**

1) android-tools-fastboot

To install the software run the following command:

.. code-block:: shell

    sudo apt-get install android-tools-fastboot

Flashing the image
-------------------

**Step 1: Untar the Linux Image**

.. code-block:: shell
   :linenos:

     $ tar -xvzf IFC6309-shunya-desktop-image-0.1.zip
     $ cd IFC6309-shunya-xxx-image-0.1

.. note:: Replace xxx with console or desktop according to the image you have downloaded

**Step 2: Connecting Cables**

Connect USB Type C cable to the host and board(next to the Debug UART).

Press the volume button and connect the 12V@2A Power Adapter. Keep the volume button pressed for few seconds even after inserting the power button.

Confirm if the cables are connected correctly using dmesg command. You should get a serial number of the device.
			
**Sample dmesg Log:**

.. code-block:: shell
   :linenos:
   :emphasize-lines: 6

	[ 8454.847947] usb 2-2: new high-speed USB device number 18 using xhci_hcd
	[ 8455.003058] usb 2-2: New USB device found, idVendor=18d1, idProduct=d00d
	[ 8455.003063] usb 2-2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
	[ 8455.003066] usb 2-2: Product: Android
	[ 8455.003069] usb 2-2: Manufacturer: Google
	[ 8455.003072] usb 2-2: SerialNumber: a88f3c50


**Step 3: Install binaries on the IFC6309 board. This may take about 2-3 minutes**

	$ ./flash-minimum-binaries.sh

**Step 4:Boot your newly installed Linux OS**
 
**Connect HDMI cable**

Reboot the board by removing the power supply and connecting it back or using the command below:

.. code-block:: shell

    sudo fastboot reboot 

**Remove USB Type C cable (important)** 

.. warning:: Plug the HDMI cable before powering up. HDMI hot plug may not work.

.. note:: Congratulations! You are now booting your newly installed Shunya OS directly from UFS on IFC-6309!

Login details
-------------

For user shunya the login details are:

.. code-block:: shell

    Username: shunya
    Password: shunya

For the root user the login details are:

.. code-block:: shell

    Username: root
    Password: toor


Networking
===========

**Network Devices available:**

- Ethernet
- Wifi
- Bluetooth

Using a Camera on IFC6309
============================

Using GStreamer
---------------

**To record a video in the avi format use the following command**

.. code-block:: shell

    gst-launch-1.0 v4l2src device=/dev/video3 ! avimux ! filesink location=filename.avi -e

**To record a video in the mkv format use the following command**

.. code-block:: shell

    gst-launch-1.0 -e v4l2src device=/dev/video3 ! videoconvert ! matroskamux ! filesink location=filename.mkv 

.. note:: Device number might change so be careful.

Using FFMPEG
-------------

To install ffmpeg use the following command:

.. code-block:: shell

   sudo apt install ffmpeg

**To check the index of the USB use v4l-utils.You can install it and get the index using the commands below:**

.. code-block:: shell

   sudo apt install v4l-utils
   v4l2-ctl --list-devices

**To record a video using ffmpeg the following command can be used:**

.. code-block:: shell

   ffmpeg -i /dev/video3 filename.avi

**OR**

.. code-block:: shell

    ffmpeg -f v4l2 -video_size 640x480 -i /dev/video3 -c:v libx264 filename.mp4

Sound on IFC6309
==================

Sound recording and playback is tested using a USB Mic and a Speaker connected to USB Sound Adapter. 

.. note:: Device and card numbers might change so be careful.

Sound Recording
---------------

To list the recording devices you can use this command:

.. code-block:: shell

   arecord -l

To record a wav file you can use the following command:

.. code-block:: shell

   arecord -vv -Dplughw:1,0 -f dat filename.wav


Sound Playback
--------------

To list the playback devices use this command:

.. code-block:: shell

   aplay -l

To playback a wav file you can use the following command:

.. code-block:: shell

   aplay -vv --device=hw:1,0 filename.wav

OpenCV on IFC6309
===================

Install **OpenCV-3.3**
----------------------

.. code-block:: shell

   sudo opkg install python3-opencv

Test **OpenCV-3.3**
-------------------

.. code-block:: shell
   :linenos:

    sudo apt install git
    git clone https://github.com/shunyaos/object-recognition-dnn.git
    git checkout ifc6309
    cd object-recognition-dnn
    python3 detect.py

Test Outcome 
-------------

.. image:: extra/ifc6309-test-opencv.png
      :align: center

Release info
============

**Shunya O/s Version: 0.1-Beta**

**Kernel Version: 4.4.23**

**Bootloader: LK**

**Bootloader Version: dragonboard410c-LA_BR_1_2_7-03810-8x16_0-linaro2**

**Desktop Environment: XFCE**