====== Getting Started ====== 
===== Connect =====

Connecting to Mango is pretty easy. There are several ways of doing this. My personal recommendation is: 
  * Serial: **picocom** for Linux and OSX, **putty** for Windows.
  * Ethernet: **ssh** for Linux and OSX, **putty** for Windows.

==== Serial ====

 Serial connectivity is available via pins connection. Pins on block J18 (1 - 3.3V, 2 - UART_TXD, 3 - UART_RXD, 4 - GND) designed for serial/console connection. Also, you need UART - USB adapter to connect a console to your computer. 

\\
=== putty (Windows) ===
Pretty straight forward. Run program, enter COM port number, select baudrate 115200 and click "connect".

\\
=== picocom (Linux, OSX) ===
  picocom -b 115200 /dev/ttyUSB0

  * Picocom [[http://linux.die.net/man/8/picocom|man]] 
  * To exit, press and hold CTRL, a, q.

\\
=== Telnet (Linux, OSX) ===

New OpenWrt versions (which are installed in our devices) don't have telnet service installed by default. 


==== Ethernet ====
=== putty (Windows) ===

Putty can be used for SSH, Telnet and Serial connectivity. It's a Swiss knife tool for Windows. Usage is as simple as in serial mode. Run, enter IP address, select protocol and connect.

\\
=== ssh (Linux, OSX) ===

SSH is enabled by default without password. Mango can be connected:

  ssh root@192.168.1.1

Where ''root'' is your default root user and 192.168.1.1 IP address.

==== Advanced ====

[[mango:gettingstarted:connect-advanced]]


===== Build firmware =====

This procedure must be performed on your computer. We use Debian and Ubuntu but many other distributions should work. It is also possible to build on OSX. Building on Windows platform is not recommended. 

\\
=== Install packages to your computer ===

In order to build OpenWrt, you will need few software packages on your computer. Some are mandatory, some optional.

  apt-get install git git-doc subversion build-essential flex wget gawk unzip man file python2.7 zlib1g-dev libssl-dev libncurses5-dev ocaml-nox

\\
=== Get latest sources ===
Get latest sources from 8devices OpenWrt branch.

  git clone --branch qsdk-11.3-ipq60xx-4.4 https://github.com/8devices/openwrt-8devices.git
  cd openwrt-8devices

\\
=== Build image ===
If you are building firmware for the first time run following commands to build manually:

  ./quick_start.sh 8dev_mango_stripped -c

This will update package feeds and build minimal image firmware image. 
If you want to customize your build look for more details in [[mango:gettingstarted:build-advanced|advanced]] section.


Note that building OpenWrt firmware takes some time. On moderate computer it might take 1 to 3 hours. CPU load during this process is usual close to 100%. Building environment takes up about 12GB of hard disk space.
You should see build log like this:

{{:mango:mango-build.png?nolink|}}

Image will be available in ''bin/ipq/'' folder. 

\\
=== Advanced ===
If you feel like something is missing or looking for some goodies, this section is for you.

  * [[mango:gettingstarted:build-advanced]]

\\
=== Useful links ===

  * [[http://wiki.openwrt.org/doc/howto/build?s|OpenWrt building (official web page)]]


===== Upload firmware =====
This section covers few methods how to upgrade firmware on Mango. Some methods require only USB-Serial connection, some only LAN, some LAN and Serial. Also you might need to install/setup other software to perform these tasks.

\\
=== Web interface / LUCI ===
This method is recommended for novices. Connect to Mango web interface, browse for firmware upgrade (System -> Backup / Flash Firmware), select file and press upgrade.

\\
=== sysupgrade ===
Login to Mango and download binary image to RAM. (Alter IP and path to match your binary image location)

  scp test@192.168.1.254:/home/test/openwrt-8devices/bin/ipq/openwrt-ipq-ipq60xx-8devices-mango-dvk-squashfs-sysupgrade.bin /tmp

\\
Perform upgrade procedure.

  sysupgrade /tmp/openwrt-ipq-ipq60xx-8devices-mango-dvk-squashfs-sysupgrade.bin


==== Advanced ====

[[mango:recover|Recover Firmware]]