qMp (Quick Mesh Project) - Packages

h1. Guifi oneclick

!guifi-logo.png!

{{toc}}

This new package helps *Guifi community network* users to configure their *qMp nodes* in one (or two) clicks with the Guifi.net site data.

h2. Get and install

You can install it with a prebuilt image with the package included.

Also you can install the standalone package in a standard qMp system.

h3. +From prebuilt image+

* Get the binary file from http://fw.qmp.cat/testing/ _*(not yet)*_.

** Download the image labeled with *qMp-Guifi*.

* Flash the image in your node.

h3. +From standalone package+

* Get the package file from _*(not yet)*_.

* Install it with the @opkg@ utility.

For example:

<pre>

opkg install qmp-guifi_1.0.2_ar71xx.ipk

</pre>

h2. Configure

h3. +LuCI+

Configure your node using LuCI web interface.

* Go to the new menú +@Guifi@+.

* Type (or paste) in the textfield the Guifi URL of the device you want to configure.

** URL is like http://guifi.net/guifi/device/##ID##/ _(where ##ID## is a 5-6 digit number)_ 

h4. Example

_TO DO SCREENSHOTS_

. 

h3. +CLI, qmpguifi+

Configure your node using the command line interface.

You have a new command +@qmpguifi@+.

The syntax is:

<pre>

qmpguifi oneclick [URL] <file>

</pre>

* [URL] is the URL of the device. Like: http://guifi.net/guifi/device/##ID##/ _(where ##ID## is a 5-6 digit number)_

* <file> _(optional)_ is the temporary file where the oneclick (unsolclic) config is saved. If it's not specified @/tmp/guifi_oneclick@ is used.

This commmand gets the config file, checks this file, prints their content and configure the node using the file's data.

Alternatively you can do this steps individually:

h4. get_url

<pre>

qmpguifi get_url [URL] [FILE]

</pre>

* [URL] is the URL of the device.

* [FILE] _(mandatory)_ is the temporary file where the oneclick config is saved. 

h4. check

<pre>

qmpguifi check [FILE]

</pre>

* [FILE] is the temporary file where the oneclick config has been previously saved.

h4. print

<pre>

qmpguifi print [FILE]

</pre>

* [FILE] is the temporary file where the oneclick config has been previously saved.

h4. configure

<pre>

qmpguifi configure [FILE]

</pre>

* [FILE] is the temporary file where the oneclick config has been previously saved.

h4. Example

<pre>

root@qMp6aa2:~# qmpguifi oneclick http://10.139.40.97/guifi/device/53684/

Getting oneclick config:

Done!

Checking oneclick config:

Done!

Showing variables:

 nodename='UPCc6lab104'

 devname='UPCc6lab104-TL'

 devmodel='TL-WDR3600'

 ipv4='10.1.24.33'

 netmask='255.255.255.224'

 zoneid='UPC'

Do you want to configure your node with this settings? [N,y]y

Configuring the node, please wait...

Configuration done!

root@UPCc6lab104-TL6aa2:~#

</pre>