Application:FreeTether

2011-03-13T03:13:28Z

The justin:

{{application
|name=freeTether
|type=webOS
|version=Version: 0.99.13
|tag=Networking
|screenshot=freeTether_0.99.12_main.png
|description=}}

== Overview ==
[[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.

== Installation ==

The following information will help with installing freeTether on your device.
 
{| style="color:black; background-color:#FFDEDE; border:1px solid #cc3333;" VAlign="middle" cellpadding="20" cellspacing="0" Width="100%"
|
==== Notice/Warning ====
 
'''freeTether currently is in a beta/testing phase and as such its use falls under the WebOS-Internals Testing Feed Rules.'''
 
'''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.'''
|}

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

<blockquote>
===== 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.

===== 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>

==== 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.

<blockquote>
===== [http://www.webos-internals.org/wiki/Application:Preware Preware] =====

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

'''Or'''

# Open Preware
# Tap Available Packages
# Tap Application > System Utilities
# Tap freeTether from the list
# Tap the Install button
</blockquote>

==== 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.

== Troubleshooting/FAQ ==
<blockquote>
'''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: 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.
 
 
'''Q: I don't see freeTether listed in Preware. What am I doing wrong?'''
 
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.
 
 
'''Q: Where can I find the testing feeds?'''
 
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>

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

<blockquote>
{| border="1" cellspacing="0" cellpadding="5"
|-
!scope="col"|
!scope="col"| Bluetooth
!scope="col"| USB
!scope="col"| WIFI (Open)
!scope="col"| WIFI (WPA)
|-
!scope="row"| Linux
| Good
| Good
| Good
| Good
|-
!scope="row"| MacOSX <=10.5
| ?
| ?
| ?
| ?
|-
!scope="row"| MacOSX 10.6
| Good
| Broken
| Good
| Good
|-
!scope="row"| Windows 7 (x86)
| ?
| Good
| Good
| Good
|-
!scope="row"| Windows 7 (x64)
| Can work
| Good
| Good
| Good
|-
!scope="row"| PS3
| N/A
| N/A
| Good
| Good
|-
!scope="row"| Wii
| N/A
| N/A
| Good
| Needs Work
|-
!scope="row"| iPad
| N/A
| N/A
| Good
| Good
|-
|}
</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.

===== WIFI Tethering =====
The following steps will assist you in configuring and using freeTether for WIFI tethering.
<blockquote>
'''Configure WIFI Preferences:'''
 
The WIFI Preferences can be accessed two ways.
 
# Tap the WIFI row listed in the Tethered Interfaces list.
# Tap or Swipe down the app menu and select WIFI Prefs.
</blockquote>

<blockquote>
'''Network:'''
 
This setting determines the name (SSID) of the WIFI hotspot network. Tap the Network row to change the SSID. ''(See Figure 1)''
 
'''Security:''' ''[Open | WPA2 Personal]''
 
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)''
 

<center>'''''[The following settings are only available if WPA2 Personal is selected for the type of security.]'''''</center>

 
<blockquote>
'''Passphrase:'''
 
This setting determines the passphrase used. Tap the Passphrase row to toggle between showing or hiding of the passphrase.
 
To configure your own passphrase, tap the Set Passphase button. A passphrase can be created two different ways. ''(See Figure 3)''
<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 Generate Random button to have freeTether generate a passphrase for you. Then tap the Set Passphrase button.
</blockquote>
</blockquote>
 

'''Enable/Disable Wifi Tethering:'''
 
Toggle the On/Off switch to enable or disable the freeTether WiFi tethering.
</blockquote>
 

<blockquote>
<gallery widths=80px heights=80px perrow=7 caption="Tethered WiFi Preferences">
file:freetether_wifiprefs1.png|''Figure 1''
file:freetether_wifiprefs2.png|''Figure 2''
file:freetether_wifiprefs3.png|''Figure 3''
</gallery>
</blockquote>
 

===== Bluetooth Tethering =====
The following steps will assist you in configuring and using freeTether for Bluetooth tethering.
<blockquote>
'''Configure Bluetooth Preferences:'''
 
The Bluetooth Preferences can be accessed two ways.
 
# Tap the Bluetooth row listed in the Tethered Interfaces list.
# Tap or Swipe down the app menu and select Bluetooth Prefs.
</blockquote>

<blockquote>
'''PAN Profile:''' ''[Enabled | Disabled]''
 
This setting attempts to enable Bluetooth PAN support for those carriers that may disable Bluetooth PAN support. ''(See Figure 1)''
</blockquote>
 

<blockquote>
'''Enable/Disable Bluetooth Tethering:'''
 
Toggle the On/Off switch to enable or disable the freeTether Bluetooth tethering.
</blockquote>
 

<blockquote>
<gallery widths=80px heights=80px perrow=7 caption="Tethered Bluetooth Preferences">
file:freetether_btprefs.png|''Figure 1''
</gallery>
</blockquote>
 

===== USB Tethering =====
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].

<blockquote>
'''Enable/Disable USB Tethering:'''
 
Toggle the On/Off switch to enable or disable the freeTether USB tethering.
</blockquote>
 

===== TCP/IP Preferences =====
The following steps will assist you in configuring the TCP/IP Preferences for freeTether.
<blockquote>
'''Configure TCP/IP Preferences:'''
 
The TCP/IP Preferences can be accessed two ways.
 
# 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>
 
For a view of the TCP/IP Prefs... ''(See Figure 1)''
 
'''Gateway:'''
 
This setting determines the gateway address that is used by the tethered clients as their connection point to your device.
 
'''Subnet:'''
 
This setting determines the subnet address that is used by the tethered clients.
 
'''DHCP Start:'''
 
This setting determines the starting address used when allocating IP address to the tethered clients.
 
'''Max Leases:'''
 
This setting determines the maximum number of addresses available for allocation to the tethered clients.
 
'''Lease Time:'''
 
This setting determines the length of time the tethered client's address allocation is valid. ''(Time is in seconds.)''
 
</blockquote>
 

<blockquote>
<gallery widths=80px heights=80px perrow=7 caption="TCP/IP Preferences">
file:freetether_tcpipprefs.png|''Figure 1''
</gallery>
</blockquote>
 

== Resources ==

===== Donation to Developers =====
::* Please see the official PreCentral Forum thread opening post for the donation link.

===== Official Forum =====
::* [http://forums.precentral.net/webos-internals/272151-freetether-0-99-x.html Official PreCentral Forum Thread]

===== Official Bug/Feature Request Site =====
::*[http://redmine.webos-internals.org/projects/freetether/issues Official Bug/Feature Request Site]

== Status ==
freeTether currently is in a beta/testing phase and is being heavily developed.

===== Changelog =====
<blockquote>
:'''0.99.13 - Current Release''' - (''Released Jan. 14th, 2011'')
:* 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
</blockquote>

===== Known Issues =====
<blockquote>
Please see the issues list [http://redmine.webos-internals.org/projects/freetether/issues here] for more information on the known issues.
</blockquote>

WebOS Internals - User contributions [en]

Application:FreeTether