Latest revision as of 14:58, 25 August 2023

Requirements

Install alpine-2.1.3 or newer (see these notes if you are unsure how to do it).

Decide which serial port to use and connect your modem to it.
In the example below, replace ttyS0 with ttySX where X matches your com port number.
(/dev/ttyS0 is the same as COM1, ttyS1=COM2, ttyS2=COM3, ttyS3=COM4, ...)

Install packages

Install required packages

apk add ppp

Load modules

Load the required modules and make sure they're automatically loaded at next reboot

modprobe ppp_generic echo "ppp_generic" >> /etc/modules-load.d/ppp.conf

Config files

/etc/ppp/peers/serialmodem

(The filename 'serialmodem' can be changed, but you will need to remember it when running pon/poff command)

debug
/dev/ttyS0
115200
modem
crtscts
asyncmap 0
defaultroute
lock
noauth
user '{login_id}'
connect '/usr/sbin/chat -v -f /etc/ppp/chat-serialmodem'

/etc/ppp/chat-serialmodem

(The filename 'chat-serialmodem' can be changed, but you will need modify the config file shown above to reflect your choice)

ABORT 'BUSY'
ABORT 'ERROR'
ABORT 'NO ANSWER'
ABORT 'NO CARRIER'
ABORT 'NO DIALTONE'
ABORT 'Invalid Login'
ABORT 'Login incorrect'
REPORT 'CONNECT'
TIMEOUT '60'
'' 'ATZ'
OK 'ATDT{phonenumber}'
CONNECT '\d\c'
Username: '{login_id}'
Password: '{your_password}'

/etc/ppp/pap-secrets

If your pppd log reports something like this:

daemon.debug pppd[5665]: rcvd [LCP ConfReq id=0xf6 <asyncmap 0xa0000> <auth pap> <magic 0xa239b2b1> <pcomp> <accomp>]

(Note the "<auth pap>" section)
you might need to use a pap-secrets file (or chap-secrets depending on what pppd reports in the logs).
Your file might look something like this:

# client     server  secret            IP addresses
{login_id}   *       {your_password}   *

If you are using 'pap-secrets' (or 'chap-secrets') you should most likely comment out the 'Username:' and 'Password:' lines in your '/etc/ppp/chat-serialmodem' config.

Note for above example configs

Note: Replace above words {login_id}, {your_password} and {phonenumber} with what you received from your ISP. The characters { and } should also be removed.

Note: You might need to replace the 'Username:' and 'Password:' parts to reflect the words your ISP is using to ask you to enter your credentials

Tip: You might need to replace "CONNECT '\d\c'" with "CONNECT 'CLIENT'" in your chat-serialmodem config

References:

Start/Stop

Start connection

pon serialmodem

Stop connection

poff serialmodem

If something goes wrong...

Check if process is running

pidof pppd

Logfile might give you a clue on what went wrong

egrep "pppd|chat" /var/log/messages

Check nic information

ifconfig ppp0

pppd has a statusinformation function that could come in handy

pppstats

@@ Line 1: / Line 1: @@
-{{Draft}}
 [[Category:Networking]]
@@ Line 5: / Line 4: @@
 Install alpine-2.1.3 or newer (see [[Installation|these]] notes if you are unsure how to do it).
-== Hardware ==
+Decide which serial port to use and connect your modem to it.<BR>
-Start by deciding which serial port to use and plug you modem there.<BR>
+In the example below, replace ttyS0 with ttyS'''X''' where '''X''' matches your com port number.<BR>
-In below examples replace ttyS0 with the ttyS? that applies for your needs.<BR>
+''(/dev/ttyS0 is the same as COM1, ttyS1=COM2, ttyS2=COM3, ttyS3=COM4, ...)''
-''(/dev/ttyS0 is same as COM1 - ttyS1=COM2, ttyS2=COM3, ttyS3=COM4, ...)''
 == Install packages ==
@@ Line 14: / Line 12: @@
 {{cmd|apk add ppp}}
-== Modules ==
+== Load modules ==
-Load some needed modules and make sure they get automatically loaded at next reboot
+Load the required modules and make sure they're automatically loaded at next reboot
-{{cmd|modprobe ppp
+{{cmd|modprobe ppp_generic
-echo "ppp" >> /etc/modules}}
+echo "ppp_generic" >> /etc/modules-load.d/ppp.conf}}
-== Configure ==
+== Config files ==
-=== Create configfiles ===
+=== /etc/ppp/peers/serialmodem ===
-'''''/etc/ppp/peers/serialmodem'''''
+''(The filename 'serialmodem' can be changed, but you will need to remember it when running pon/poff command)''
 <pre>debug
 /dev/ttyS0
@@ Line 30: / Line 28: @@
 asyncmap 0
 defaultroute
-noipdefault
 lock
 noauth
+user '{login_id}'
 connect '/usr/sbin/chat -v -f /etc/ppp/chat-serialmodem'
 </pre>
-'''''/etc/ppp/chat-serialmodem'''''
+=== /etc/ppp/chat-serialmodem ===
+''(The filename 'chat-serialmodem' can be changed, but you will need modify the config file shown above to reflect your choice)''
 <pre>ABORT 'BUSY'
 ABORT 'ERROR'
@@ Line 48: / Line 47: @@
 '' 'ATZ'
 OK 'ATDT{phonenumber}'
-CONNECT ''
+CONNECT '\d\c'
-ogin: '{login_id}'
+Username: '{login_id}'
-sword: '{your_password}'
+Password: '{your_password}'
 </pre>
-{{Note|Replace above words '''{login_id}''', '''{your_password}''' and '''{phonenumber}''' with what you received from your ISP.}}
+=== /etc/ppp/pap-secrets ===
-See [http://www.yolinux.com/TUTORIALS/LinuxTutorialPPP.html this] link for more details.
+If your pppd log reports something like this:
+ daemon.debug pppd[5665]: rcvd [LCP ConfReq id=0xf6 <asyncmap 0xa0000> <auth pap> <magic 0xa239b2b1> <pcomp> <accomp>]
+''(Note the "<auth pap>" section)''<BR>
+you might need to use a pap-secrets file (or chap-secrets depending on what pppd reports in the logs).<BR>
+Your file might look something like this:
+<pre># client     server  secret            IP addresses
+{login_id}   *       {your_password}   *
+</pre>
+If you are using 'pap-secrets' (or 'chap-secrets') you should most likely comment out the 'Username:' and 'Password:' lines in your '/etc/ppp/chat-serialmodem' config.
+== Note for above example configs ==
+{{Note|Replace above words '''{login_id}''', '''{your_password}''' and '''{phonenumber}''' with what you received from your ISP. The characters '''{''' and '''}''' should also be removed.}}
+{{Note|You might need to replace the''' 'Username:' '''and''' 'Password:' '''parts to reflect the words your ISP is using to ask you to enter your credentials}}
+{{Tip|You might need to replace  "'''CONNECT '\d\c''''" with "'''CONNECT 'CLIENT''''" in your chat-serialmodem config}}
+References:
+* http://axion.physics.ubc.ca/ppp-linux.html
+* http://www.yolinux.com/TUTORIALS/LinuxTutorialPPP.html
+* https://tldp.org/HOWTO/PPP-HOWTO/options.html
 = Start/Stop=
@@ Line 65: / Line 81: @@
 Check if process is running
 {{cmd|pidof pppd}}
-Logfile would also give you information on what happened
+Logfile might give you a clue on what went wrong
-{{cmd|grep pppd /var/log/messages}}
+{{cmd|egrep "pppd{{!}}chat" /var/log/messages}}
 Check nic information
 {{cmd|ifconfig ppp0}}
-pppd seems to have some pppstats function
+pppd has a statusinformation function that could come in handy
 {{cmd|pppstats}}