git.maemo.org Git - mtetherd/blob - README

   1 maemo-tethering 1.0
   2 -------------------
   3
   4 Description:
   5
   6 maemo-tethering allows you to use your N900 as an Internet router.
   7 Once a USB network or Bluetooth PAN connection is opened to the device,
   8 it will automatically configure networking and start a dnsmasq instance
   9 that serves DHCP requests and forwards DNS queries.
  10 This tool can also be used to automatically configure network interfaces
  11 for development.
  12
  13 Usage:
  14
  15 Bluetooth:
  16 1. Pair your host with the N900 and make sure the PAN (Bluetooth networking)
  17    service is recognized.
  18 2. Open a PAN connection to the N900.
  19 3. Routing should setup automatically and you can access the Internet
  20    right away.
  21
  22 USB:
  23 1. Connect host and N900 with a USB cable.
  24 2. Wait until the USB mode dialog pops up on the N900 and dismiss it.
  25 3. Open MAD Developer.
  26 4. Tap "Manage USB".
  27 5. Tap "Load g_ether".
  28 6. The USB mode is kept between cable disconnects, you only have to
  29    reload the g_ether module after a reboot or mode change.
  30 7. Start surfing on the host.
  31 3a.It is also possible to load the module from the Terminal:
  32 rmmod g_nokia
  33 rmmod g_file_storage
  34 modprobe g_ether
  35
  36 Notes:
  37
  38 IP addresses are currently hardcoded into the program. A later version
  39 will add support for a configuration file.
  40 The assigned addresses are the following:
  41 USB: N900: 192.168.253.254 DHCP: 192.168.253.1-192.168.253.253
  42 Bluetooth: N900: 192.168.254.254 DHCP: 192.168.254.1-192.168.254.253
  43
  44 If you connect while no GPRS/UMTS connection is active, forwarding will
  45 not be enabled. This is the case when the device is connected to a
  46 Wireless LAN, for example.
  47 You can still communicate with the device, but not surf the internet
  48 from your host. Just disconnect and reconnect again when the GPRS/UMTS
  49 connection is available.
  50
  51 Legal:
  52
  53 This program is free software: you can redistribute it and/or modify
  54 it under the terms of the GNU General Public License as published by
  55 the Free Software Foundation, either version 3 of the License, or
  56 (at your option) any later version.
  57
  58 This program is distributed in the hope that it will be useful,
  59 but WITHOUT ANY WARRANTY; without even the implied warranty of
  60 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  61 GNU General Public License for more details.
  62
  63 You should have received a copy of the GNU General Public License
  64 along with this program.  If not, see <http://www.gnu.org/licenses/>.