Difference between revisions of "Application:FreeTether"

From WebOS Internals
Jump to navigation Jump to search
m
m
 
(40 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
<div style='position: relative;'>
 
{{application
 
{{application
 
|name=freeTether
 
|name=freeTether
 
|type=webOS
 
|type=webOS
−
|version=Version: 0.99.13
+
|version=Version: 1.2.0
 
|tag=Networking
 
|tag=Networking
−
|screenshot=freeTether_0.99.12_main.png
+
|screenshot=Freetether_main.png
−
|description=}}
+
|description=<div style='position: absolute; bottom: 0; right: 0; padding-right: 28px; padding-bottom: 16px'>{{FreeTetherDonation}}</div>}}
 +
</div>
  
  
Line 11: Line 13:
 
[[image:Icon_FreeTether.png|frameless|left]]
 
[[image:Icon_FreeTether.png|frameless|left]]
 
freeTether is an open source tethering application for webOS that turns your device into an access point/gateway that allows you to share your device's cellular data connection with other devices via WiFi, Bluetooth or USB.
 
freeTether is an open source tethering application for webOS that turns your device into an access point/gateway that allows you to share your device's cellular data connection with other devices via WiFi, Bluetooth or USB.
−
 
+
<br /><br /><br />
  
 
== Installation ==
 
== Installation ==
  
 
The following information will help with installing freeTether on your device.
 
The following information will help with installing freeTether on your device.
−
<br /><br />
 
−
{| style="color:black; background-color:#FFDEDE; border:1px solid #cc3333;" VAlign="middle" cellpadding="20" cellspacing="0" Width="100%"
 
−
|
 
−
==== <span style="color:#cc3333">Notice/Warning</span> ====
 
−
<br/ >
 
−
'''freeTether currently is in a beta/testing phase and as such its use falls under the WebOS-Internals Testing Feed Rules.'''
 
−
<br />
 
−
'''Please take a few mintues to read over, understand and agree to the [http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds WebOS-Internals Testing Feed Rules] before continuing.'''
 
−
|}
 
  
  
Line 33: Line 26:
 
===== Remove Other Tethering Solutions =====
 
===== Remove Other Tethering Solutions =====
 
It is highly recommended to remove all previous versions of freeTether and freeTetherD, as well as, Mobile Hotspot. Other tethering solutions may conflict with freeTether as well.
 
It is highly recommended to remove all previous versions of freeTether and freeTetherD, as well as, Mobile Hotspot. Other tethering solutions may conflict with freeTether as well.
−
 
−
===== Testing Feeds =====
 
−
freeTether is found in the WebOS-Internals Testing Feeds. The WebOS-Internals Testing Feeds need to be added to your Preware configuration. Please carefully follow the steps listed on the [http://www.webos-internals.org/wiki/Testing_Feeds#Configuring_the_WebOS_Internals_Testing_Feeds WebOS-Internals Testing Feed] page before continuing.
 
 
</blockquote>
 
</blockquote>
  
Line 43: Line 33:
  
 
<blockquote>
 
<blockquote>
−
===== [http://www.webos-internals.org/wiki/Application:Preware Preware] =====
+
===== [[Preware]] =====
  
 
# Open Preware
 
# Open Preware
Line 62: Line 52:
 
==== Updating ====
 
==== Updating ====
  
−
freeTether is being heavily developed and will have many updates during the beta/testing phase. Check Preware often for the latest updates to freeTether.
+
freeTether updates can be found and installed via Preware
  
  
−
== Troubleshooting/FAQ ==
+
== System/Device Compatibility ==
−
<blockquote>
 
−
'''Q: What version of webOS is freeTether available for?'''
 
−
<br />
 
−
A: freeTether is only available for webOS 1.4.5 and later.
 
−
<br />
 
−
<br />
 
−
'''Q: I think I've found a bug. What should I do?'''
 
−
<br />
 
−
A: freeTether is currently a beta/test release, so don't get all worked up if you encounter a bug. Please review the bug/features listed [http://redmine.webos-internals.org/projects/freetether/issues here] before submitting your own. You should also consider removing all other tethering solutions and then try again; as one of the other tethering solutions may be causing the issue with freeTether.
 
−
<br />
 
−
<br />
 
−
'''Q: I don't see freeTether listed in Preware. What am I doing wrong?'''
 
−
<br />
 
−
A: Make sure you have both testing feeds configured. You need the "ALL" feed and your device specific feed. See the [http://www.webos-internals.org/wiki/Testing_Feeds WebOS-Internals Testing Feed] wiki page for more information.
 
−
<br />
 
−
<br />
 
−
'''Q: Where can I find the testing feeds?'''
 
−
<br />
 
−
A: The Webos-Internals Testing Feed information can be found [http://www.webos-internals.org/wiki/Testing_Feeds#Configuring_the_WebOS_Internals_Testing_Feeds here].
 
−
</blockquote>
 
−
 
 
−
 
 
−
== Usage ==
 
−
The following information will help to understand and use freeTether.
 
−
 
 
−
 
 
−
===== Overview =====
 
−
Each tethered interface has a section describing how to enable/disable the interface for tethering and how to configure any preferences for that interface, as well as, a section on configuring the TCP/IP options that the tethered interfaces will use.
 
−
 
 
−
 
 
−
===== <span style="color:#8a0002">Systems Compatibility</span> =====
 
 
Here is a list of some systems and their current status/compatibility with freeTether.
 
Here is a list of some systems and their current status/compatibility with freeTether.
 
<br /><br />
 
<br /><br />
Line 115: Line 74:
 
| Good
 
| Good
 
|-
 
|-
−
!scope="row"| OSX 10.6
+
!scope="row"| MacOSX <=10.5
 +
| ?
 +
| ?
 +
| ?
 +
| ?
 +
|-
 +
!scope="row"| MacOSX 10.6
 
| Good
 
| Good
 
| Broken
 
| Broken
 +
| Good
 +
| Good
 +
|-
 +
!scope="row"| Windows 7 (x86)
 +
| ?
 +
| Good
 +
| Good
 +
| Good
 +
|-
 +
!scope="row"| Windows 7 (x64)
 +
| Can work
 +
| Good
 
| Good
 
| Good
 
| Good
 
| Good
Line 143: Line 120:
 
<br />
 
<br />
  
 +
== Usage ==
 +
The following information will help to understand and use freeTether.
 +
 +
 +
===== Overview =====
 +
 +
There are a number of different preferences and options that can be configured for freeTether. Each of the sections below contain information for configuring and using those preferences and options.
 +
<br /><br />
 +
From within freeTether, you can learn more about the particular preferences and options by pressing the help button ''(blue question mark)'' found throughout the preferences and options areas. Pressing the help button will toggle the preferences or option fields blue. Tapping on a preference or option while the help is enabled will give you a description of that particular preference or option. Tap the help button again to exit the help.
 +
 +
 +
===== <span style="color:#8a0002">General Preferences</span> =====
  
−
===== <span style="color:#8a0002">WIFI Tethering</span> =====
 
−
The following steps will assist you in configuring and using freeTether for WIFI tethering.
 
 
<blockquote>
 
<blockquote>
−
<span style="color:#3399ff">'''Configure WIFI Preferences:'''</span>
+
<span style="color:#3399ff">'''Accessing General Preferences:'''</span>
 +
<blockquote>
 +
# Tap or Swipe down the app menu and select General Prefs.
 +
</blockquote>
 +
 
 +
 
 +
<span style="color:#3399ff">'''Configuring General Preferences:'''</span>
 +
<blockquote>
 +
'''Auto WiFi Tether:''' ''[Enabled | Disabled]''
 +
<br />
 +
This setting automatically enables WiFi tethering when freeTether starts.
 +
<br /><br />
 +
'''Auto BT Tether:''' ''[Enabled | Disabled]''
 +
<br />
 +
This setting automatically enables Bluetooth tethering when freeTether starts.
 +
<br /><br />
 +
'''Auto USB Tether:''' ''[Enabled | Disabled]''
 
<br />
 
<br />
−
The WIFI Preferences can be accessed two ways.
+
This setting automatically enables USB tethering when freeTether starts.
 +
</blockquote>
 +
</blockquote>
 +
 
 +
 
 +
===== <span style="color:#8a0002">TCP/IP Preferences</span> =====
 +
 
 +
<blockquote>
 +
<span style="color:#3399ff">'''Accessing TCP/IP Preferences:'''</span>
 +
<blockquote>
 +
The TCP/IP preferences can be accessed two ways:
 
<br />
 
<br />
−
# Tap the WIFI row listed in the Tethered Interfaces list.
+
# Tap or Swipe down the app menu and select TCP/IP Prefs.
−
# Tap or Swipe down the app menu and select WIFI Prefs.
+
# Tap the DHCP Server section shown below the Tethered Interfaces list.
 
</blockquote>
 
</blockquote>
  
 +
 +
<span style="color:#3399ff">'''Configuring TCP/IP Preferences:'''</span>
 +
<br /><br />
 +
''(Note: If invalid settings are configured for the TCP/IP Preferences, the text in the preferences and the DHCP Server section shown below the Tethered Interfaces list will turn a crimson red color to indicate that invalid settings were used. In addition the on/off toggles for the three tethering modes will be disabled. You will have to correct the TCP/IP Preferences before you can enable the interfaces.)''
 +
<br />
 
<blockquote>
 
<blockquote>
−
'''Network:'''
+
'''Gateway:''' ''[Default: 192.168.100.1]''
 
<br />
 
<br />
−
This setting determines the name (SSID) of the WIFI hotspot network. Tap the Network row to change the SSID. ''(See Figure 1)''
+
This setting determines the router or default gateway IP address.
 
<br /><br />
 
<br /><br />
−
'''Security:''' ''[Open | WPA2 Personal]''
+
'''Subnet:''' ''[Default: 255.255.255.0]''
 
<br />
 
<br />
−
This setting determines the type of security to be used for the WIFI hotspot network. Tap the Security row to change between the Open and WPA2 Personal. ''(See Figure 2)''
+
This setting determines the subnet address for the network which the default gateway is on.
−
<br /><br /><br />
+
<br /><br />
 +
'''DHCP Start:''' ''[Default: 192.168.100.50]''
 +
<br />
 +
This setting determines the start of the DHCP lease pool.  
 +
<br /><br />
 +
'''Max Leases:''' ''[Default: 15]''
 +
<br />
 +
This setting determines the maximum number of DHCP leases that will be given out at a given time.
 +
<br /><br />
 +
'''Lease Time:''' ''[Default: 7200]''
 +
<br />
 +
This setting determines ''(in seconds)'' how long a DHCP lease will last before expiring.
 +
</blockquote>
 +
</blockquote>
 +
 
 +
 
  
−
<center>'''''[The following settings are only available if WPA2 Personal is selected for the type of security.]'''''</center>
+
===== <span style="color:#8a0002">WiFi Tetheing</span> =====
  
 +
<blockquote>
 +
<span style="color:#3399ff">'''Accessing WiFi Preferences:'''</span>
 +
<blockquote>
 +
The WiFi preferences can be accessed two ways:
 
<br />
 
<br />
 +
# Tap or Swipe down the app menu and select WiFi Prefs.
 +
# Tap the WiFi section in the Tethered Interfaces list.
 +
</blockquote>
 +
 +
 +
<span style="color:#3399ff">'''Configuring WiFi Tethering:'''</span>
 
<blockquote>
 
<blockquote>
 +
'''Network:''' ''[Default: freeTether]''
 +
<br />
 +
This setting determines the ESSID of the WiFi access point.
 +
<br /><br />
 +
'''Security:''' ''[Open | WPA Personal] [Default: Open]''
 +
<br />
 +
This setting determines the encryption used by the WiFi access point.
 +
<br /><br />
 +
''(Note: The following settings are only displayed if the Security setting is changed from Open to WPA Personal)''
 +
<br />
 
'''Passphrase:'''
 
'''Passphrase:'''
 
<br />
 
<br />
−
This setting determines the passphrase used. Tap the Passphrase row to toggle between showing or hiding of the passphrase.
+
This setting determines the secret passphrase which is required when connection to an encrypted WiFi access point. Tapping the passphrase field will toggle between hiding and showing the passphrase in clear text.
 
<br /><br />
 
<br /><br />
−
To configure your own passphrase, tap the Set Passphase button. A passphrase can be created two different ways. ''(See Figure 3)''
+
To configure your own or to generate a random passphrase, tap the Set Passphase button. A passphrase can be created two ways:
 
<blockquote>
 
<blockquote>
−
# Tap the text field ''(above the Generate Random button)'' and enter your passphrase. ''(The passphrase needs to have a minimum of eight (8) characters.)'' Then tap the Set Passphrase button.
+
# Tap the text field ''(above the Generate Random button)'' and enter your own passphrase. ''(minimum of eight (8) characters.)'' Then tap the Set Passphrase button.
 
# Tap the Generate Random button to have freeTether generate a passphrase for you. Then tap the Set Passphrase button.
 
# Tap the Generate Random button to have freeTether generate a passphrase for you. Then tap the Set Passphrase button.
 
</blockquote>
 
</blockquote>
 
</blockquote>
 
</blockquote>
−
<br />
 
  
−
<span style="color:#3399ff">'''Enable/Disable Wifi Tethering:'''</span>
 
−
<br />
 
−
Toggle the On/Off switch to enable or disable the freeTether WiFi tethering.
 
−
</blockquote>
 
−
<br />
 
  
 +
<span style="color:#3399ff">'''Enabling WiFi Tethering:'''</span>
 
<blockquote>
 
<blockquote>
−
<gallery widths=80px heights=80px perrow=7 caption="Tethered WiFi Preferences">
+
Tap the On|Off toggle on the WiFi section in the Tethered Interfaces list.
−
file:freetether_wifiprefs1.png|''Figure 1''
 
−
file:freetether_wifiprefs2.png|''Figure 2''
 
−
file:freetether_wifiprefs3.png|''Figure 3''
 
−
</gallery>
 
 
</blockquote>
 
</blockquote>
−
<br />
+
</blockquote>
 +
 
  
 +
===== <span style="color:#8a0002">Bluetooth Tetheing</span> =====
  
−
===== <span style="color:#8a0002">Bluetooth Tethering</span> =====
 
−
The following steps will assist you in configuring and using freeTether for Bluetooth tethering.
 
 
<blockquote>
 
<blockquote>
−
<span style="color:#3399ff">'''Configure Bluetooth Preferences:'''</span>
+
<span style="color:#3399ff">'''Accessing Bluetooth Preferences:'''</span>
 +
<br /><br />
 +
The Bluetooth preferences can be accessed two ways:
 
<br />
 
<br />
−
The Bluetooth Preferences can be accessed two ways.
+
# Tap or Swipe down the app menu and select Bluetooth Prefs.
 +
# Tap the Bluetooth section in the Tethered Interfaces list.
 
<br />
 
<br />
−
# Tap the Bluetooth row listed in the Tethered Interfaces list.
 
−
# Tap or Swipe down the app menu and select Bluetooth Prefs.
 
−
</blockquote>
 
  
 +
 +
<span style="color:#3399ff">'''Configuring Bluetooth Tethering:'''</span>
 
<blockquote>
 
<blockquote>
−
'''PAN Profile:''' ''[Enabled | Disabled]''
+
'''PAN Profile:''' ''[Enabled | Disabled] [Default: Enabled]''
 
<br />
 
<br />
−
This setting attempts to enable Bluetooth PAN support for those carriers that may disable Bluetooth PAN support. ''(See Figure 1)''
+
This setting determines if the personal area network (PAN) bluetooth profile is enabled or disabled. This option is not 100% functional yet. Use at your own risk.
 
</blockquote>
 
</blockquote>
−
<br />
 
  
 +
 +
<span style="color:#3399ff">'''Enabling Bluetooth Tethering:'''</span>
 
<blockquote>
 
<blockquote>
−
<span style="color:#3399ff">'''Enable/Disable Bluetooth Tethering:'''</span>
+
Tap the On|Off toggle on the Bluetooth section in the Tethered Interfaces list.
−
<br />
+
</blockquote>
−
Toggle the On/Off switch to enable or disable the freeTether Bluetooth tethering.
 
 
</blockquote>
 
</blockquote>
−
<br />
+
 
 +
 
 +
===== <span style="color:#8a0002">USB Tethering</span> =====
  
 
<blockquote>
 
<blockquote>
−
<gallery widths=80px heights=80px perrow=7 caption="Tethered Bluetooth Preferences">
+
<span style="color:#3399ff">'''Accessing USB Preferences:'''</span>
−
file:freetether_btprefs.png|''Figure 1''
+
<blockquote>
−
</gallery>
+
There are no Bluetooth preferences at this time.
 
</blockquote>
 
</blockquote>
−
<br />
 
−
 
  
−
===== <span style="color:#8a0002">USB Tethering</span> =====
 
−
The following steps will assist you in using freeTether for USB tethering. Configuring clients for USB tethering is somewhat outside the scope of this wiki, however, there is a WebOS-Internals wiki page on setting up USBNet, found [http://www.webos-internals.org/wiki/USBnet_Setup here].
 
  
 +
<span style="color:#3399ff">'''Configuring USB Tethering:'''</span>
 
<blockquote>
 
<blockquote>
−
<span style="color:#3399ff">'''Enable/Disable USB Tethering:'''</span>
+
Configuring computers to connect to freeTether using USB tethering is outside the scope of this wiki, however, there is a WebOS-Internals wiki page that contains a section (Computer Setup) with instructions on configuring your computer's operating system with specific drivers so that it will be able to work with freeTether's USB tethering, found [http://www.webos-internals.org/wiki/USBnet_Setup#Computer_Setup here].
−
<br />
 
−
Toggle the On/Off switch to enable or disable the freeTether USB tethering.
 
 
</blockquote>
 
</blockquote>
−
<br />
 
  
−
===== <span style="color:#8a0002">TCP/IP Preferences</span> =====
+
 
−
The following steps will assist you in configuring the TCP/IP Preferences for freeTether.
+
<span style="color:#3399ff">'''Enabling USB Tethering:'''</span>
 
<blockquote>
 
<blockquote>
−
<span style="color:#3399ff">'''Configure TCP/IP Preferences:'''</span>
+
Tap the On|Off toggle on the USB section in the Tethered Interfaces list.
−
<br />
+
</blockquote>
−
The TCP/IP Preferences can be accessed two ways.
 
−
<br />
 
−
# Tap the DHCP Server section listed below the Tethered Interfaces list.
 
−
# Tap or Swipe down the app menu and select TCP/IP Prefs.
 
 
</blockquote>
 
</blockquote>
  
 +
== Troubleshooting/FAQ ==
 
<blockquote>
 
<blockquote>
 +
'''Q: What version of webOS is freeTether available for?'''
 
<br />
 
<br />
−
For a view of the TCP/IP Prefs... ''(See Figure 1)''
+
A: freeTether is only available for webOS 1.4.5 and later.
 
<br /><br />
 
<br /><br />
−
'''Gateway:'''
+
 
 +
'''Q: I think I've found a bug. What should I do?'''
 
<br />
 
<br />
−
This setting determines the gateway address that is used by the tethered clients as their connection point to your device.
+
A: Please review the bug/features listed [http://redmine.webos-internals.org/projects/freetether/issues here] before submitting your own. You should also consider removing all other tethering solutions and then try again; as one of the other tethering solutions may be causing the issue with freeTether.
 
<br /><br />
 
<br /><br />
−
'''Subnet:'''
+
 
−
<br />
+
'''Q: I am unable to change the preferences for the tethered interface?'''
−
This setting determines the subnet address that is used by the tethered clients.
 
−
<br /><br />
 
−
'''DHCP Start:'''
 
−
<br />
 
−
This setting determines the starting address used when allocating IP address to the tethered clients.
 
−
<br /><br />
 
−
'''Max Leases:'''
 
−
<br />
 
−
This setting determines the maximum number of addresses available for allocation to the tethered clients.
 
−
<br /><br />
 
−
'''Lease Time:'''
 
 
<br />
 
<br />
−
This setting determines the length of time the tethered client's address allocation is valid. ''(Time is in seconds.)''
+
A: You can not change the tethered interfaces settings when the interface is on. Turn the interface off, change your settings, then turn the interface back on.
−
<br /><br />
 
−
</blockquote>
 
−
<br />
 
−
 
 
−
<blockquote>
 
−
<gallery widths=80px heights=80px perrow=7 caption="TCP/IP Preferences">
 
−
file:freetether_tcpipprefs.png|''Figure 1''
 
−
</gallery>
 
 
</blockquote>
 
</blockquote>
−
<br />
 
  
  
 
== Resources ==
 
== Resources ==
 +
 +
===== Support Development =====
 +
::{{FreeTetherDonation}}
  
 
===== Official Forum =====
 
===== Official Forum =====
−
<blockquote>
+
::* [http://forums.precentral.net/webos-internals/279353-freetether-1-0-x.html Official PreCentral Forum Thread]
−
* [http://forums.precentral.net/webos-internals/272151-freetether-0-99-x.html Official PreCentral Forum Thread]
 
−
</blockquote>
 
  
−
===== Donation to Developers =====
+
===== Official Bug/Feature Request Site =====
−
<blockquote>
+
::*[http://redmine.webos-internals.org/projects/freetether/issues Official Bug/Feature Request Site]
−
* Please see the official PreCentral Forum thread opening post for the donation link.
 
−
</blockquote>
 
  
  
 
== Status ==
 
== Status ==
−
freeTether currently is in a beta/testing phase and is being heavily developed.
 
  
  
 
===== Changelog =====
 
===== Changelog =====
 
<blockquote>
 
<blockquote>
−
:'''0.99.13 - Current Release''' - (''Released Jan. 14th, 2011'')
+
:'''1.2.0 - Current Release''' - (''Released Oct. 17th, 2011'')
 +
:* Backs up and hides Mobile Hotspot on install
 +
:* Makes freeTether's service persistent instead of dynamic
 +
:* Pre3 screen size fix
 +
:* Remove BT and USB interfaces from bridge when disabled
 +
:* Restore previous states when app is closed without disabling first
 +
<br />
 +
:'''1.1.3'''
 +
:* Add advanced usb prefs back, only visible if secret passphrase is typed
 +
<br />
 +
:'''1.1.2'''
 +
:* Makes sure custom TCP prefs are used on startup
 +
<br />
 +
:'''1.1.1'''
 +
:* Added options to auto-tether interfaces on app startup
 +
<br />
 +
:'''1.1.0'''
 +
:* Set the "default" gateway/router IP to 192.168.100.1
 +
:* Add help overlay to all options
 +
:* Set font color TCP settings to crimson if invalid
 +
:* Disable main toggles if there are invalid TCP settings
 +
:* Turn "DHCP Server" text crimson if there are invalid TCP settings
 +
<br />
 +
:'''1.0.0'''
 +
:* Moved out of testing feeds into public feeds. Initial public release.
 +
<br />
 +
:'''0.99.15'''
 +
:* Fixed TCP/IP settings not saving
 +
<br />
 +
:'''0.99.14'''
 +
:* Fixed cookie bug not saving preferences
 +
<br />
 +
:'''0.99.13'''
 
:* Disable settings while interface active
 
:* Disable settings while interface active
 
:* Add TCP/IP Preferences
 
:* Add TCP/IP Preferences

Latest revision as of 21:31, 20 October 2011

Freetether main.png


Overview

Icon FreeTether.png

freeTether is an open source tethering application for webOS that turns your device into an access point/gateway that allows you to share your device's cellular data connection with other devices via WiFi, Bluetooth or USB.


Installation

The following information will help with installing freeTether on your device.


Preparing Your Device

The following steps should be taken to prepare your device for the installation of freeTether.

Remove Other Tethering Solutions

It is highly recommended to remove all previous versions of freeTether and freeTetherD, as well as, Mobile Hotspot. Other tethering solutions may conflict with freeTether as well.


Method

The following method is the recommend way to install freeTether. By installing with Preware, you'll be certain to have access to the latest versions of freeTether.

Preware
  1. Open Preware
  2. Start typing “freetether” (no quotes), then press the enter/return key.
  3. Tap freeTether from the list
  4. Tap the Install button

Or

  1. Open Preware
  2. Tap Available Packages
  3. Tap Application > System Utilities
  4. Tap freeTether from the list
  5. Tap the Install button


Updating

freeTether updates can be found and installed via Preware


System/Device Compatibility

Here is a list of some systems and their current status/compatibility with freeTether.

Bluetooth USB WIFI (Open) WIFI (WPA)
Linux Good Good Good Good
MacOSX <=10.5 ? ? ? ?
MacOSX 10.6 Good Broken Good Good
Windows 7 (x86) ? Good Good Good
Windows 7 (x64) Can work Good Good Good
PS3 N/A N/A Good Good
Wii N/A N/A Good Needs Work
iPad N/A N/A Good Good


Usage

The following information will help to understand and use freeTether.


Overview

There are a number of different preferences and options that can be configured for freeTether. Each of the sections below contain information for configuring and using those preferences and options.

From within freeTether, you can learn more about the particular preferences and options by pressing the help button (blue question mark) found throughout the preferences and options areas. Pressing the help button will toggle the preferences or option fields blue. Tapping on a preference or option while the help is enabled will give you a description of that particular preference or option. Tap the help button again to exit the help.


General Preferences

Accessing General Preferences:

  1. Tap or Swipe down the app menu and select General Prefs.


Configuring General Preferences:

Auto WiFi Tether: [Enabled | Disabled]
This setting automatically enables WiFi tethering when freeTether starts.

Auto BT Tether: [Enabled | Disabled]
This setting automatically enables Bluetooth tethering when freeTether starts.

Auto USB Tether: [Enabled | Disabled]
This setting automatically enables USB tethering when freeTether starts.


TCP/IP Preferences

Accessing TCP/IP Preferences:

The TCP/IP preferences can be accessed two ways:

  1. Tap or Swipe down the app menu and select TCP/IP Prefs.
  2. Tap the DHCP Server section shown below the Tethered Interfaces list.


Configuring TCP/IP Preferences:

(Note: If invalid settings are configured for the TCP/IP Preferences, the text in the preferences and the DHCP Server section shown below the Tethered Interfaces list will turn a crimson red color to indicate that invalid settings were used. In addition the on/off toggles for the three tethering modes will be disabled. You will have to correct the TCP/IP Preferences before you can enable the interfaces.)

Gateway: [Default: 192.168.100.1]
This setting determines the router or default gateway IP address.

Subnet: [Default: 255.255.255.0]
This setting determines the subnet address for the network which the default gateway is on.

DHCP Start: [Default: 192.168.100.50]
This setting determines the start of the DHCP lease pool.

Max Leases: [Default: 15]
This setting determines the maximum number of DHCP leases that will be given out at a given time.

Lease Time: [Default: 7200]
This setting determines (in seconds) how long a DHCP lease will last before expiring.


WiFi Tetheing

Accessing WiFi Preferences:

The WiFi preferences can be accessed two ways:

  1. Tap or Swipe down the app menu and select WiFi Prefs.
  2. Tap the WiFi section in the Tethered Interfaces list.


Configuring WiFi Tethering:

Network: [Default: freeTether]
This setting determines the ESSID of the WiFi access point.

Security: [Open | WPA Personal] [Default: Open]
This setting determines the encryption used by the WiFi access point.

(Note: The following settings are only displayed if the Security setting is changed from Open to WPA Personal)
Passphrase:
This setting determines the secret passphrase which is required when connection to an encrypted WiFi access point. Tapping the passphrase field will toggle between hiding and showing the passphrase in clear text.

To configure your own or to generate a random passphrase, tap the Set Passphase button. A passphrase can be created two ways:

  1. Tap the text field (above the Generate Random button) and enter your own passphrase. (minimum of eight (8) characters.) Then tap the Set Passphrase button.
  2. Tap the Generate Random button to have freeTether generate a passphrase for you. Then tap the Set Passphrase button.


Enabling WiFi Tethering:

Tap the On|Off toggle on the WiFi section in the Tethered Interfaces list.


Bluetooth Tetheing

Accessing Bluetooth Preferences:

The Bluetooth preferences can be accessed two ways:

  1. Tap or Swipe down the app menu and select Bluetooth Prefs.
  2. Tap the Bluetooth section in the Tethered Interfaces list.



Configuring Bluetooth Tethering:

PAN Profile: [Enabled | Disabled] [Default: Enabled]
This setting determines if the personal area network (PAN) bluetooth profile is enabled or disabled. This option is not 100% functional yet. Use at your own risk.


Enabling Bluetooth Tethering:

Tap the On|Off toggle on the Bluetooth section in the Tethered Interfaces list.


USB Tethering

Accessing USB Preferences:

There are no Bluetooth preferences at this time.


Configuring USB Tethering:

Configuring computers to connect to freeTether using USB tethering is outside the scope of this wiki, however, there is a WebOS-Internals wiki page that contains a section (Computer Setup) with instructions on configuring your computer's operating system with specific drivers so that it will be able to work with freeTether's USB tethering, found here.


Enabling USB Tethering:

Tap the On|Off toggle on the USB section in the Tethered Interfaces list.

Troubleshooting/FAQ

Q: What version of webOS is freeTether available for?
A: freeTether is only available for webOS 1.4.5 and later.

Q: I think I've found a bug. What should I do?
A: Please review the bug/features listed here before submitting your own. You should also consider removing all other tethering solutions and then try again; as one of the other tethering solutions may be causing the issue with freeTether.

Q: I am unable to change the preferences for the tethered interface?
A: You can not change the tethered interfaces settings when the interface is on. Turn the interface off, change your settings, then turn the interface back on.


Resources

Support Development
Btn donateCC LG.gif
Official Forum
Official Bug/Feature Request Site


Status

Changelog
1.2.0 - Current Release - (Released Oct. 17th, 2011)
  • Backs up and hides Mobile Hotspot on install
  • Makes freeTether's service persistent instead of dynamic
  • Pre3 screen size fix
  • Remove BT and USB interfaces from bridge when disabled
  • Restore previous states when app is closed without disabling first


1.1.3
  • Add advanced usb prefs back, only visible if secret passphrase is typed


1.1.2
  • Makes sure custom TCP prefs are used on startup


1.1.1
  • Added options to auto-tether interfaces on app startup


1.1.0
  • Set the "default" gateway/router IP to 192.168.100.1
  • Add help overlay to all options
  • Set font color TCP settings to crimson if invalid
  • Disable main toggles if there are invalid TCP settings
  • Turn "DHCP Server" text crimson if there are invalid TCP settings


1.0.0
  • Moved out of testing feeds into public feeds. Initial public release.


0.99.15
  • Fixed TCP/IP settings not saving


0.99.14
  • Fixed cookie bug not saving preferences


0.99.13
  • Disable settings while interface active
  • Add TCP/IP Preferences


0.99.12
  • Default to Open for wifi tethering
  • Styling tweaks
  • Show passphrase hint
  • Menu options for each interface


0.99.11
  • Add client info scene
  • End freeTether service on app close


0.99.10
  • Default to WPA for wifi tethering
  • Provide default passphrase
  • Enforce min passphrase length
  • Random passphrase generator


0.99.9
  • Service fixes for race conditions and client list reporting
  • Save and restore interface state
  • Fix spinner states and multi-interface toggling
  • Fix client list to correctly update hostnames


0.99.7
  • Bluetooth PAN profile


0.99.6
  • USB, Bluetooth and WiFi support
  • webOS 1.4.5 and 2.x.x support
  • Improved UI
Known Issues

Please see the issues list here for more information on the known issues.

Retrieved from "http://wiki.webos-internals.org/index.php?title=Application:FreeTether&oldid=19627"