Skip to content

Latest commit

 

History

History
76 lines (54 loc) · 2.47 KB

Networking-HOWTO.md

File metadata and controls

76 lines (54 loc) · 2.47 KB
Raw

Kanux networking HowTo

KanuxOS system is network ready from first boot, with ipv4 support. This document explains the various options you have to network the system to the outside world.

Kanux supports at least the following connectivity devices:

  • Ethernet
  • Kano Wireless wifi dongle
  • Android USB

Ethernet

Ethernet connectivity should always be ready functioning. Simply plug the network cable to a dhcp-ready network and Kanux will acquire a DHCP lease automatically.

USB devices

Kanux should also play nice with Android and iPhone USB tethering devices. Simply plug the usb cable, enable tethering, and Kanux will acquire a DHCP lease automatically.

Wireless

You can setup your wireless router, or you can also put your mobile device in "Wireless tethering" mode. Note that Kanux fully supports the wireless dongle provided. Other wifi dongles should work as well but have not been fully tested.

If you need to connect to other wireless networks, open the "Wifi" app icon in the Extras folder, or execute "sudo kano-wifi" from the command line.

Once you successfully connect to a wireless network, it will be remembered, so next time you boot Kanux it will automatically connect to the network if it is in range.

In case you need to fine tune more specific wireless secured networks, kano-wifi allows you to provide a custom wpa_supplicant configuration file, like this:

  • sudo kano-wifi /path/to/my/wpa_supplicant.conf

Make sure you provide an absolute path filename to avoid problems during automatic connect at boot time. As an example here's a small simple file to connect to a WPA2 network:

network={
  ssid="my-ap-essid"
  scan_ssid=1
  proto=WPA RSN
  key_mgmt=WPA-PSK
  pairwise=CCMP TKIP
  group=CCMP TKIP
  psk="psk-passphrase"
}

The wpa supplicant daemon log file is saved under /var/log/kano_wpa.log where you can find inner details on the association sequence.

IMPORTANT: Please note that plugging the wireless dongle while the RaspberryPI is functioning will almost certainly cause a hardware reset. This is a hardware limitation on the RaspberryPI device itself present as of the time of this writing.

IPv6 support

The kernel has built-in support for IPv6 networking but is disabled by default. To enable it, either "modprobe ipv6" or add "ipv6" in the file /etc/modules and restart the system:

More in-depth information regarding ipv6 can be found here: