GSOC Report #0: Documentation

{"date": "Tue 22 May 2012",

"category": "GSoC2012",
"tags": ["guifi.net", "gsoc2012"]}

-Note: I forgot to say in my last post that all coming posts about GSOC will be in English-
Well, the coding period started yesterday. Here is what I've been doing meanwhile during the documentation period:

Project name

First, I decided to change the project name from "CNML Explorer" to "Guifi.net Studio".

Why? CNML Explorer was the main idea of creating an application to visualize CNML files offline. Now the project is more generic and has more features apart from visualizing CNML files so I felt like the name wasn't accurate anymore. Guifi.net Studio aims to be a the Guifi.net desktop tool, for example, it will also interact with the Guifi.net web API and will contain more features to make life easier to the Guifi.net community ;)

I prefer this name, but let me know if you have an even better one! I'm still not 100% convinced about it so I'm open to new suggestions.

Rendering maps

There are several libraries to render Open Street Maps into GTK+. I had several candidates for this position and finally, the winner is called libchamplain!

Libchamplain is written in C but it takes advantage of GNOME's GObject Introspection to get the Python (and other languages) bindings for free! Cool tech :) (Generating Python bindings manually belongs to the past now).

I chose it because it's easy to install (it's included in the Debian/Ubuntu repostiories), it has the enough features that I need at the moment and the development looks active.

Actually there are some apps using libchamplain like emerillon (map viewer, screenshots), which is also a good sign.

Code example (Python snippet are available in the Git repository) and documentation are also available.

Other utilities found in the way are:

Due to some annoying bug in the Clutter version, I had to upgrade to Ubuntu 12.04. If you use Ubuntu and you want to test Guifi.net Studio you will probably have to upgrade too.

Community

I have chatted and got in contact with people from other wireless communities in Europe (FunkFeuer and Ninux this time) that are also interested in the interoperability subject. I got good impressions :-)

If you are interested in interoperability too, you should subscribe to the interop-dev mailing list. We will meet there.

I will possibly meet some of them at the Italian Hackmeeting 2012 (end of June) in L'Aquila.

Status of Hybrid Nodes

Hybrid nodes have become definitely more popular than old supernodes when you had to deal with miniPCI radios and routerboards.

This new prototype is easier to build and gives better performance. 

I didn't know exactly how they were technically configured, now I have understood :-)

Unsolclick configuration is not available for hybrid nodes at the moment. The work is done but the code isn't merged :(. I will also try to push it forward.

Here there is some documentation about hybrid nodes that helped me to understand them:

API

I have familiarized myself with the Guifi.net API. Isidro is also a student that is doing a project that interacts with the API from Android. He has done a great work too, testing it and reporting a lot of bugs and improvements.

Optic Fiber

Ramón Roca gave me access to the Alfresco platform, where there are a lot of interesting documents about Guifi.net!
I have seen how the optic fiber links are documented and I have some ideas to generate cute SVG graphs automatically from the data.
According to my calendar, I will work on it in July.

Development

I have started a new repository in Gitorious, where all the Guifi.net development takes place. At the moment there's only the code made during last summer as proof of concept.

You can get it by typing:

git clone git://gitorious.org/guifi-altres/guifinetstudio.git

There's also a new component at trac.guifi.net, so the bug tracking will happen there.

This week

I will be working in the user interface and unsolclick configuration for simple nodes. Albert Sarlé (who I met two weeks ago) has done a great work about it during his final project in the university. He made the configuration possible using templates (among other things).

Unfortunately my final exams are close and I won't be able to spend all the time I would like on it :(
Have a good week!

Flattr
this

Comments !