Sixfab_PPP_Installer/README.md

# Sixfab_PPP_Installer
Repository of Sixfab PPP Installer Tool 

Sixfab offers Shields/HATs for Raspberry Pi which provides cellular Internet connection anywhere with the availability of mobile network coverage. These shields are:

* [Raspberry Pi GSM/GPRS Shield](https://www.sixfab.com/product/gsmgprs-shield/)

* [Raspberry Pi 3G-4G/LTE Base Shield V2](https://www.sixfab.com/product/raspberry-pi-3g-4glte-base-shield-v2/)

* [Raspberry Pi Cellular IoT Application Shield](https://www.sixfab.com/product/raspberry-pi-cellular-iot-application-hat/)

* [Raspberry Pi Cellular IoT HAT ](https://sixfab.com/product/raspberry-pi-lte-m-nb-iot-egprs-cellular-hat/) 

* [Raspberry Pi Tracker HAT ](https://sixfab.com/product/raspberry-pi-gprs-gps-tracker-hat/)

Each of these shield can be connected to Internet via PPP(Point to Point Protocol). For this tutorial we have written an script to install and perform required steps.

Without further ado let us jump into the installation process:

Clone the repository

`git clone https://github.com/sixfab/Sixfab_PPP_Installer.git` 

Now change the permission of the downloaded script.

```
cd Sixfab_PPP_Installer/ppp_installer
chmod +x install.sh
```

Now install the script

`sudo ./install.sh`
  
It will ask several questions, just answer them accordingly to complete the installation process. The questions are:
`Please choose your Sixfab Shield/HAT`
 
You will be offered to choose among the mentioned four shields/HAT. Then it will fetch required scripts for you. 
`Do you have updated kernel`

It asks if your kernel is up-to-date. If no[n] it updates the kernel else it skips the update. Then it installs ppp. 

`What is your carrier APN?`

Here, it asks for your carrier's APN. For me it is hologram. 

`Does your carrier need username and password? [Y/n]`

Then it asks if your carrier needs username and password. 

`Enter username`
If yes then it will ask for user name.

`Enter password`
Then it will ask for password.

Once you type the username asks for password.

`What is your device communication PORT? (ttyS0/ttyUSB3/etc.`

In this step you will enter your PORT. e.g For 3G, 4G/LTE Base Shield it will be ttyUSB3. 

`Do you want to activate auto connect/reconnect service at R.Pi boot up?`

This option allows you to connect to Internet via your shield automatically when your Raspberry Pi Starts. If you want to connect to Internet automatically type Y else n. If you have selected n then you will need to run `sudo pon` to connect to internet and `sudo poff` to stop it. 

Enjoy your Internet connection.
-												Initial commit
											
										
										
											2018-10-15 14:56:16 +00:00
+								# Sixfab_PPP_Installer
 								Repository of Sixfab PPP Installer Tool
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												tracker description added

											
										
										
											2019-10-09 10:53:28 +00:00
+								Sixfab offers Shields/HATs for Raspberry Pi which provides cellular Internet connection anywhere with the availability of mobile network coverage. These shields are:
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												Update README.md
											
										
										
											2018-10-16 15:57:44 +00:00
+								* [Raspberry Pi GSM/GPRS Shield](https://www.sixfab.com/product/gsmgprs-shield/)
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												Update README.md
											
										
										
											2018-10-16 15:57:44 +00:00
+								* [Raspberry Pi 3G-4G/LTE Base Shield V2](https://www.sixfab.com/product/raspberry-pi-3g-4glte-base-shield-v2/)
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												Update README.md
											
										
										
											2018-10-16 15:57:44 +00:00
+								* [Raspberry Pi Cellular IoT Application Shield](https://www.sixfab.com/product/raspberry-pi-cellular-iot-application-hat/)
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												tracker description added

											
										
										
											2019-10-09 10:53:28 +00:00
+								* [Raspberry Pi Cellular IoT HAT ](https://sixfab.com/product/raspberry-pi-lte-m-nb-iot-egprs-cellular-hat/)
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												tracker description added

											
										
										
											2019-10-09 10:53:28 +00:00
+								* [Raspberry Pi Tracker HAT ](https://sixfab.com/product/raspberry-pi-gprs-gps-tracker-hat/)
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
 								Each of these shield can be connected to Internet via PPP(Point to Point Protocol). For this tutorial we have written an script to install and perform required steps.
 								Without further ado let us jump into the installation process:
 								Clone the repository
 								`git clone https://github.com/sixfab/Sixfab_PPP_Installer.git`
 								Now change the permission of the downloaded script.
 								```
 								cd Sixfab_PPP_Installer/ppp_installer
 								chmod +x install.sh
 								```
 								Now install the script
 								`sudo ./install.sh`
 								It will ask several questions, just answer them accordingly to complete the installation process. The questions are:
-												README modified

											
										
										
											2019-06-10 16:06:38 +00:00
+								`Please choose your Sixfab Shield/HAT`
 								You will be offered to choose among the mentioned four shields/HAT. Then it will fetch required scripts for you.
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
+								`Do you have updated kernel`
 								It asks if your kernel is up-to-date. If no[n] it updates the kernel else it skips the update. Then it installs ppp.
 								`What is your carrier APN?`
 								Here, it asks for your carrier's APN. For me it is hologram.
-												README modified

											
										
										
											2019-06-10 16:06:38 +00:00
+								`Does your carrier need username and password? [Y/n]`
 								Then it asks if your carrier needs username and password.
 								`Enter username`
 								If yes then it will ask for user name.
-												tracker description added

											
										
										
											2019-10-09 10:53:28 +00:00
+								`Enter password`
 								Then it will ask for password.
-												README modified

											
										
										
											2019-06-10 16:06:38 +00:00
 								Once you type the username asks for password.
-												tracker description added

											
										
										
											2019-10-09 10:53:28 +00:00
+								`What is your device communication PORT? (ttyS0/ttyUSB3/etc.`
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
-												tracker description added

											
										
										
											2019-10-09 10:53:28 +00:00
+								In this step you will enter your PORT. e.g For 3G, 4G/LTE Base Shield it will be ttyUSB3.
-												Update README.md
											
										
										
											2018-10-16 15:55:56 +00:00
 								`Do you want to activate auto connect/reconnect service at R.Pi boot up?`
 								This option allows you to connect to Internet via your shield automatically when your Raspberry Pi Starts. If you want to connect to Internet automatically type Y else n. If you have selected n then you will need to run `sudo pon` to connect to internet and `sudo poff` to stop it.
 								Enjoy your Internet connection.