Maemo Wiki Mirror - User contributions [en]

USB networking

2009-11-29T03:02:19Z

83.98.248.135: /* Host USB Network Configuration */ NetworkManager

This page describes how the maemo platform can be turned into a [[USB]] network device. The first part describes how to configure the Nokia tablet as a USB pluggable network device. The second part describes how to configure various platforms to use the Nokia tablet as a network device. This article is based loosely on the Maemo 3.x [http://maemo.org/development/documentation/how-tos/3-x/howto_usb_networking_bora.html configuring USB networking HOWTO].

You might want to use the tablet as a USB network device to log into your tablet remotely, or to transfer data from your tablet to another computer, in a situation where wifi or bluetooth are not an option. If you wish to connect your tablet to a Linux machine over TCP/IP, the [http://maemo.org/development/documentation/pc_connectivity/ PC connectivity] section in the Maemo SDK documentation also contains useful information.

'''WARNING'''
Currently there is a bug in the g_ether.ko driver of OS2008 (both 4.0.1 and 4.1) which prevents USB networking from working correctly with Windows machines (but not with Linux machines). See [https://bugs.maemo.org/show_bug.cgi?id=3243 bug #3243] for details. The bug was introduced somewhere between kernels 2.6.18 and 2.6.21, so Maemo versions based on 2.6.18 kernels (e.g. OS2007 and earlier) will work.

== Tablet USB network configuration ==

=== USB statusbar plugin ===

The [http://garage.maemo.org/projects/usb-otg-plugin/ usb-otg-plugin] applet '''<nowiki>[BAD LINK]</nowiki>''' lets you set up USB networking tablet-side, and switch between host and client mode. This is the easy way to do things and no other tablet-side configuration is required.

Alternatively you could try the usb networking applet found here:
http://repository.maemo.org/extras-devel/pool/diablo/free/m/maemo-control/

=== Behind the scenes ===

In normal circumstances, the USB Mass storage driver had control of the USB hardware. USBNet allows the g_ether network driver to take control of the USB interface.

After installing USB networking, set up a dummy access point by running the following:
gconftool-2 -s -t string /system/osso/connectivity/IAP/DUMMY/type DUMMY
gconftool-2 -s -t string /system/osso/connectivity/IAP/DUMMY/name 'Dummy network'"
gconftool-2 -s -t boolean /system/osso/connectivity/IAP/DUMMY/autoconnect true

You should see a "DEFAULT" connection appear in the connection manager.

'''WARNING'''
Currently there is a bug in Diablo that causes DUMMY connections not to show up in connection manager, a semi-official fix is outlined in [https://bugs.maemo.org/show_bug.cgi?id=3306#c23 bug #3306].

=== Starting and stopping USB network mode ===

To easily start & stop USB network mode, place the following script in /etc/init.d/usbnet on your tablet. To do this, you will need [[root access]] to the device.

While switching between modes by running the script, it is important to disconnect the USB cable.

<pre>
#! /bin/sh
#
# Startup script for USBnet (networking, instead of USB Mass Storage behaviour)
# Author: Michael Mlivoncic

PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin
NAME=usbnet
DESC="USB Networking for Nokia Internet Tablets"
INITFILE=/etc/init.d/$NAME

case "$1" in
start)
umount /media/mmc1
umount /media/mmc2
sleep 2
USBNET="`lsmod | grep g_ether`"
KERNEL_VERSION="`uname -r`"
if [ "$USBNET" = "" ]
then
echo "Entering Ethernet via USB mode (g_ether)..."
insmod /mnt/initfs/lib/modules/$KERNEL_VERSION/g_ether.ko
echo "Waiting, then bringing up the usb0 interface.."
sleep 1
/sbin/ifup usb0
else
echo "Already in Ethernet-via-USB mode..."
echo "Try ping 192.168.2.15"
fi
;;
stop)
echo "switching back to USB Mass Storage mode..."
echo "removing module g_ether"
/sbin/ifdown usb0
sleep 2
rmmod g_ether
;;
*)
printf "Usage: $INITFILE {start|stop}\n" >&2
exit 1
;;
esac

exit 0
</pre>
This script is quite basic, but can be run automatically at start-up, or manually using the command:
sudo /etc/init.d/usbnet [start|stop]
to activate or deactivate USB networking.

There is a default USB network interface configuration on Nokia N800 and 770 tablets. In the file /etc/network/interfaces, you should see a section which looks like this:
<pre>
auto usb0
iface usb0 inet static
address 192.168.2.15
netmask 255.255.255.0
gateway 192.168.2.14
</pre>

With this default configuration, the tablet interface will have the IP address 192.168.2.15, and the remote end will have the IP address 192.168.2.14.

== Host USB Network Configuration ==

=== Windows ===

====Requirements====

* For Windows 2000, you will need to download [ RNDIS drivers] from Microsoft.
* Download the file "Nokia770 USB Ethernet RNDIS.inf" from [http://homepage.hispeed.ch/mlivoncic/Nokia770%20USB%20Ethernet%20RNDIS.inf here] or [http://homepage.sunrise.ch/mysunrise/mlivoncic/Nokia770%20USB%20Ethernet%20RNDIS.inf here]. This allows to recognise that the RNDIS driver can be used with the Nokia device, and other Linux USB devices.
* If you are using an N800, skip all the steps below which apply to the N770; the bora distribution supplies a control panel applet called "maemo-statusbar-usbnet". Once installed, the control panel "Maemo-DM" will allow you to change the function of the USB port from "MMC emulation" to a RNDIS emulation of a USB ethernet interface. You will also need to set the WinXP side's IP address to be fixed at 192.168.2.14.

==== Preparing the Windows host ====

On Windows 2000, dowload & unpack RNDIS-USB-Kit_05.exe [http://www.microsoft.com/whdc/device/network/NDIS/rndis.mspx on the Microsoft web site]. You need to copy rndismpy.sys (30 KB) and usb8023y.sys (14 KB) from
RNDIS USB kit 2005\Drivers\x86fre\sys files
to a folder of your choice, e.g. c:\Drivers\Nokia770_RNDIS. Add "Nokia770 USB Ethernet RNDIS.inf" to the same folder; this will complete your driver set.

When you connect the Nokia to the PC, it will look for a suitable driver. As opposed to the USB mass device mode, Windows will not find a suitable driver by default. Windows supports so-called RNDIS devices, but it does not know that the N770 will act as such. Therefore, we need to instruct it to do so: In the driver dialog, provide the driver's location. Point it to the directory where you previously downloaded the "Nokia770 USB Ethernet RNDIS.inf" (or linux.inf) file. It will show you a driver called ''Linux USB Ethernet/RNDIS Gadget''. Install it.

A new network card with this name will become visible afterwards, which you can configure normally. Set the IP address to 192.168.2.14. Optionally activate ICS (Internet Connection Sharing) on your network adapter to share the outside world with your little Nokia.

=== Linux ===

==== Kernel Configuration ====
You should have the usbnet module available for your Linux kernel. On most distributions, this is the case by default. If this is not the case for your distribution, you will need to enable USB networking support in the kernel.
If you build your own kernel then you want 'CDC Ethernet support' in USB Network adaptors.

<pre>
#
# USB Network Adapters
#
...
CONFIG_USB_USBNET=m
...
CONFIG_USB_NET_CDCETHER=m
...
</pre>

==== NetworkManager based ====

A recent NetworkManager (at in least Fedora 12, probably Ubuntu too) supports Ethernet USB gadgets out-of-the-box. However the 'auto usb0' entry that it creates amongst your connection list is configured for DHCP and the N900 will not provide that, so it will time out.

The easiest/cleanest way to get it to work is probably to create a new connection using the same MAC address as 'auto usb0' has, and then providing a fixed IP address: 192.168.2.14/255.255.255.0 for example.

==== Fedora ====

Older Fedora versions also supports Ethernet USB gadgets out-of-the-box. To configure the USB networking:

* Connect the tablet with g_ether.ko loaded to your Linux PC
* Open System -> Administrate -> Network (or run system-config-network from command line).
* Press the "New" button to create a new network interface. Select "Ethernet" network card type.
* On the next screen, select the "Netchip Technology, Inc. Linux-USB Ethernet/RNDIS Gadget (usb0)".
* Choose "Static IP address" and enter the IP address 192.168.2.15 for your PC, if you are using the default usb0 configuration on your tablet. Don't fill the gateway field on the Fedora side.
* Fill other settings (DNS etc) if you want to, then press "Finish".

Now reconnect the tablet to PC and the interface should automatically configure.

==== Debian ====

Ensure that the usbnet module is available to your kernel (try ''modprobe usbnet'', then ''lsmod'' to check).

Add the following to /etc/network/interfaces:
<pre>
allow-hotplug usb0

mapping hotplug
script grep
map usb0

iface usb0 inet static
address 192.168.2.14
netmask 255.255.255.0
broadcast 192.168.2.255
up iptables -I INPUT 1 -s 192.168.2.15 -j ACCEPT
</pre>

After plugging in the tablet, you can bring up the network interface with the command ''ifup usb0''.

==== Configuring the host as a gateway ====
If your host has no firewalling rules, you can set the gateway rules by modifying /etc/interfaces file.

<pre>
iface usb0 inet static
address 192.168.2.14
netmask 255.255.255.0
up echo 1 > /proc/sys/net/ipv4/ip_forward
up iptables -P FORWARD ACCEPT
up iptables -A POSTROUTING -t nat -j MASQUERADE -s 192.168.2.0/24
down echo 0 > /proc/sys/net/ipv4/ip_forward
down iptables -t nat -F POSTROUTING
</pre>
Else add the necessary MASQUERADE rules to normal firewall rules.

If you get the following error:
<pre>
iptables v1.2.11: can't initialize iptables table `NAT': Table does not exist (do you need to insmod?)
Perhaps iptables or your kernel needs to be upgraded.
</pre>
You need verify that your kernel has the relevant iptables modules included, and hotplug or udev is set up properly on your computer.

==== Configuring the host as a bridge ====
Normally eth0 is on dhcp. This configuration allows my tablet to be on the same LAN as the rest of my boxes. You need the '''bridge''' module for 802.1d Ethernet Bridging installed.

iface br0 inet dhcp
hostname ash
pre-up echo "Adding ethernet bridge between LAN and PAN"
pre-up ifconfig eth0 0.0.0.0
pre-up brctl addbr br3
pre-up brctl setfd br3 0
pre-up brctl stp br3 off
pre-up brctl addif br3 eth0
pre-down echo "Removing ethernet bridge between LAN and PAN"
post-down brctl delif br3 eth0
post-down brctl delbr br3
post-down ifdown eth0
post-down ifup eth0

I do
ifup br0

And the tablet is then on the LAN.

==== Configuring the host firewall ====

If you have your Linux host configured with a strict firewall, you may need to modify your iptables to allow the tablet to access the internet over USB networking.

To allow access both to & from the tablet, the following iptables rules are required:

iptables -A OUTPUT -o usb0 -j ACCEPT
iptables -A INPUT -i usb0 -j ACCEPT

=== Testing the connection ===
To test the connection, you can either type ''ping 192.168.2.15'' on your PC or ''ping 192.168.2.14'' in an xterm on your tablet.

For troubleshooting, use ''ifconfig -a'' and ''route'' to verify on the Nokia and on a Linux or Unix PC, and ''ipconfig /all'' and ''route print'' on Windows.

=== Known issues ===
When unplugging and replugging the USB cable between the two devices, Windows will indicate a code 10-error indicating that the device could not start properly. The problem appears to be with the Nokia tablet, since after rebooting the device, networking works again. Remember to first initialize g_ether before plugging your tablet into the USB host.

This seems to be the case with Ubuntu too. Replugging causes following messages appear in the kernel log:

<pre>
[182104.412082] usb 3-1: new full speed USB device using uhci_hcd and address 29
[182104.824071] usb 3-1: device not accepting address 29, error -71
[182104.824100] hub 3-0:1.0: unable to enumerate USB device on port 1
</pre>

Rebooting the tablet seems to work.

=== Frequently asked questions ===
# So if we have already plugged in our 770 into XP, and it recognized it as a drive, do we need to remove the driver software that makes it appear as a USB drive, and replace it with the USBNet drivers?
#* No, windows registers the tablet in network mode as a different device.
#* However, as stated above: you have to insmod the kernel module on your tablet before you connect the cable!
# When I try to do the above, I get an error stating that the driver I am trying to choose doesn't have anything to do with my hardware.
#* Make sure you have activated USB networking on the Nokia side correctly.
# My tablet can now talk to my XP machine, but how do I get out to the rest of the network?
#:First, set up a dummy access point, as described above, so that you can configure the network settings in connection manager for your usbnet connection. This will allow you to configure proxy server access. Secondly, install a proxy on your local machine. Examples include [http://www.proxomitron.info/ proxomitron] or [http://www.handcraftedsoftware.org/ freeproxy].
# How do I set up DNS once I have connected the tablet and the host?
#* Install and configure pdnsd on your host computer, and add nameserver 192.168.2.14 to the file /etc/resolv.conf on your tablet.
#* or configure the host as a gateway, and use the same DNS servers as your host (without messing up /etc/resolv.conf and the dnsmasq server):
#::echo "nameserver xxx.xxx.xxx.xxx" >> /tmp/resolv.conf.ppp0
#::where xxx.xxx.xxx.xxx is the dns server of the host ( as found in /etc/resolv.conf on the host linux box )
#::echo again the second address if required.
#::Don't forget to choose "dummy" from the wireless connection manager on the tablet and do 'ifup usb0' on the Linux box.
#How do I keep my SD memory cards from being unmounted?
#* Before you plug in the usb cable; open two xterminals and cd one to /media/mmc1 and the other to /media/mmc2 and leave them there. By keeping a foot in the door the cards are kept available ... the usbnet will still succeed.

[[Category:Users]]
[[Category:Wiki page of the day]]
[[Category:Connectivity]]
[[Category:USB]]

[[Category:Power users]]

N900 USB networking

2009-11-29T02:19:31Z

83.98.248.135: /* Starting USB network mode */ typo

This page describes how to enable Networking on the [[N900]] via [[USB]]. The first part describes how to configure the Nokia N900 as a USB pluggable network device. The second part describes how to configure various platforms to use the Nokia N900 as a network device. This article is based on the Maemo 4.x [http://wiki.maemo.org/USB_networking wiki] for configuring USB networking.

You might want to use the N900 as a USB network device to log into your N900 remotely, or to transfer data from your N900 to another computer, in a situation where wifi or bluetooth are not an option. If you wish to connect your N900 to a Linux machine over TCP/IP, the [http://maemo.org/development/documentation/pc_connectivity/ PC connectivity] section in the Maemo SDK documentation also contains useful information.

== N900 USB network configuration ==
There is a default USB network interface configuration on Nokia N900. In the file /etc/network/interfaces, you should see a section which looks like this:
<pre>
auto usb0
iface usb0 inet static
address 192.168.2.15
netmask 255.255.255.0
gateway 192.168.2.14
</pre>

With this default configuration, the N900 USB interface will have the IP address 192.168.2.15, and the remote end will have the IP address 192.168.2.14.
By default, the USB network interface on the N900 is configured

=== Starting USB network mode ===
Plug one end of the USB cable on the host and the other end into the N900. The N900 will bring up the mode-selection dialog. Select 'PC Suite mode'.

[[Image:Mode-selection.png|center|alt=USB Mode-Selection dialog|USB Mode-Selection dialog]]

Open a root shell in 'X Terminal' on the N900 and activate the interface by executing the following:
<pre>
sudo gainroot
ifup usb0
</pre>

If all went well, no errors will be displayed. The command 'ifconfig usb0' will give the following output:
<pre>
Nokia-N900-42-11:~# ifconfig usb0
usb0 Link encap:Ethernet HWaddr F2:50:8F:04:1D:8B
inet addr:192.168.2.15 Bcast:192.168.2.255 Mask:255.255.255.0
UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1
RX packets:1021 errors:0 dropped:0 overruns:0 frame:0
TX packets:2003 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:86091 (84.0 KiB) TX bytes:2556598 (2.4 MiB)
</pre>

You should also be able to ping 192.168.2.15
<pre>
Nokia-N900-42-11:~# ping 192.168.2.15
PING 192.168.2.15 (192.168.2.15): 56 data bytes
64 bytes from 192.168.2.15: seq=0 ttl=64 time=0.367 ms
64 bytes from 192.168.2.15: seq=1 ttl=64 time=0.214 ms
^C
--- 192.168.2.15 ping statistics ---
2 packets transmitted, 2 packets received, 0% packet loss
round-trip min/avg/max = 0.214/0.290/0.367 ms
</pre>

=== Stopping USB network mode ===
This is optional. It is not necessary to stop the interface after unplugging the USB cable.

However, to stop the USB interface, unplug the USB cable and execute the following in 'X Terminal'
<pre>
sudo gainroot
ifdown usb0
</pre>

== Host USB Network Configuration ==
The Host configuration is detailed in the Maemo 4.x [http://wiki.maemo.org/USB_networking#Host_USB_Network_Configuration USB Networking wiki]. Please refer to it for details.

[[Category:Users]]
[[Category:Wiki page of the day]]
[[Category:Connectivity]]
[[Category:N900]]
[[Category:USB]]
[[Category:Power users]]

Sync

2009-11-29T02:08:17Z

83.98.248.135: /* HTTP support */ typo

This page will describe how to ''synchronize'' data on Maemo devices with other devices. Links to 'standard' behaviour would be nice and, of course, solutions to unsupported exchanges too.

=N900=

== ActiveSync ==

The easiest way to sync an N900 with both an Exchange server and Gmail is using ActiveSync (called Mail for Exchange or MfE by Nokia): You can more or less follow the instructions for [http://www.google.com/support/mobile/bin/answer.py?hl=en&answer=147951 S60 on Google Sync] with the N900. In the Settings dialog, open "Mail for Exchange", and follow the instructions on that webpage.

Update:
* MfE for Google Sync is not officially supported. It still works on some occasions but it is unreliable. See this [http://talk.maemo.org/showthread.php?t=35136 thread] for details.
* MfE supports Exchange 2007.

== SyncML ==

The N900 (preproduction) provides SyncML over Bluetooth and USB but not IP.

You can synchronize your contacts from

* Other devices (confirmed to work with N95). When Contacts or Calendar application is started for the first time it automatically suggests data import.

* PC Suite

=== HTTP support ===

[http://maemo.org/downloads/product/OS2008/syncevolution SyncEvolution] supports synchronization for arbitary HTTP based SyncML sources, but as the writing of this (2009-11-05) precompiled binaries for OS2009 Fremantle were not yet available.

=N8x0=

==GPE==
[http://gpe.linuxtogo.org/ GPE] is a suite of applications that was ported to Maemo. Search for GPE in the [http://downloads.maemo.org downloads section] for your version of Maemo. (You'll probably want GPE Calendar, GPE Contacts, gpesyncd to start with.)
These are standalone applications, there's no integration with the Maemo address book. You'll not find data from GPE in the Mail client or Chat.

==SyncML==
[http://maemo.org/downloads/product/OS2008/syncevolution SyncEvolution] provides support for SyncML via http. This means you can sync against services like [http://www.scheduleworld.com/ Scheduleworld] or [http://my.funambol.com/ MyFunambol] on the web (more services [http://syncevolution.org/documentation/compatibility listed here]), but you can not use it to sync directly via USB or bluetooth.

The advantage of SyncEvolution is that it syncs directly to the main system database on your device, which means: phone numbers are available from the internet call application, email addresses are visible in Modest etc. Unfortunately, the latest version 0.9 is not yet available for Maemo, so you have to be content with 0.8 which lacks a graphical user interface and Google integration.

When you use SyncEvolution, you'll want a more advanced contacts application to display information like postal address or birthday. This information is synced to your device but remains invisible in the Maemo Contacts-application. [http://www.pimlico-project.org/contacts.html Pimlico Contacts], though no longer maintained, is a working application to let you view and edit all fields. (Be warned: Pimlico contacts isn't properly hildonized and lacks a few icons. It really looks a mess, but it works.)

=770=

??

[[Category:Users]]
[[Category:Software]]

[[Category:Power users]]