gluon/docs/releases/v2015.2.rst

Gluon 2015.2 (in development)
=============================

Added hardware support
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
ar71xx-generic
^^^^^^^^^^^^^^

* TP-Link

  - CPE 210/220/510/520 (v1.1)
  - TL-WR841N/ND (v10)
  - TL-WR901ND (v1)
  - TL-WR940N (v3)
  - TL-WR941N (v6)
  
* Ubiquity

  - Air Gateway

New features
~~~~~~~~~~~~
802.11s can now be used as an alternative to IBSS mode (ad-hoc). The statuspage has been reworked completely. French language support has been added. The numbers of clients connected are announced per band now (2.4/5GHz).

Bugfixes
~~~~~~~~
* Fix MTU/max fragmentation size to prevent issues with several ISPs like Kabel Deutschland
* Fix alfred: wait for a link-local address to prevent crashing

Site changes
~~~~~~~~~~~~
* ``site.conf``

  - New WLAN configuration

    ``wifi24`` and ``wifi5`` need to be updated to a new more flexible format.
    A configuration using the old format

    ::

      {
        channel = 1,
        htmode = 'HT20'
        ssid = 'entenhausen.freifunk.net',
        mesh_ssid = 'xe:xx:xx:xx:xx:xx',
        mesh_bssid = 'xe:xx:xx:xx:xx:xx',
        mesh_mcast_rate = 12000,
      }

    would look like this in the new format::

      {
        channel = 1,
        htmode = 'HT20',
        ap = {
          ssid = 'entenhausen.freifunk.net',
        },
        ibss = {
          ssid = 'xe:xx:xx:xx:xx:xx',
          bssid = 'xe:xx:xx:xx:xx:xx',
          mcast_rate = 12000,
        },
      }

    In addition to the old IBSS (Adhoc) based meshing, 802.11s-based meshing can be configured
    using the ``mesh`` section. Example::

      {
        channel = 1,
        htmode = 'HT20',
        ap = {
          ssid = 'entenhausen.freifunk.net',
        },
        mesh = {
          id = 'mesh.entenhausen.freifunk.net', -- can by any string, human-readable or random
          mcast_rate = 12000,
        },
      }

    While using ``ibss`` and ``mesh`` at the same time is possible, is causes high load in
    very active meshes, so it is advisable to avoid such configurations.

  - Bandwidth limitation defaults

    The old section ``simple_tc.mesh_vpn`` has been moved to ``fastd_mesh_vpn.bandwidth_limit`` and the ``ifname``
    field isn't used anymore. What looked like this
    before

    ::

      simple_tc = {
        mesh_vpn = {
          ifname = 'mesh-vpn',
          enabled = false,
          limit_ingress = 3000,
          limit_egress = 200,
        }
      }

    needs to be changed to

    ::

      fastd_mesh_vpn = {
        -- ...

        bandwidth_limit = {
          enabled = false,
          ingress = 3000,
          egress = 200,
        },
      }

  - opkg repository configuration

    The opkg configuration has been changed to be more flexible and allow specifying custom repositories.
    Example::

      opkg = {
        openwrt = 'http://opkg.services.ffeh/openwrt/%n/%v/%S/packages',
        extra = {
          modules = 'http://opkg.services.ffeh/modules/gluon-%GS-%GR/%S',
        },
      }

    The keys of the ``extra`` table (like ``modules`` in this example) can be chosen arbitrarily.

    Instead of explicitly specifying the whole URL, using patterns is recommended. The following
    patterns are understood:

    - ``%n`` is replaced by the OpenWrt version codename (e.g. "chaos_calmer")
    - ``%v`` is replaced by the OpenWrt version number (e.g. "15.05")
    - ``%S`` is replaced by the target architecture (e.g. "ar71xx/generic")
    - ``%GS`` is replaced by the Gluon site code (as specified in ``site.conf``)
    - ``%GV`` is replaced by the Gluon version
    - ``%GR`` is replaced by the Gluon release (as specified in ``site.mk``)


* ``i18n/``

  - The translations of ``gluon-config-mode:pubkey`` now have to show the fastd
    public key itself if desired, making the formatting of the key and whether it is shown at
    all configurable. To retain the old format, add ``<p>`` to the beginning of
    your translations and append::

    "</p>"
    "<div class=\"the-key\">"
    " # <%= hostname %>"
    " <br/>"
    "<%= pubkey %>"
    "</div>"

Internals
~~~~~~~~~


Known Issues
~~~~~~~~~~~~
* site.conf HT-mode option has been disabled in this release (defaults to HT20 - see https://github.com/freifunk-gluon/gluon/issues/487)