From 581153cd08af20b1951678663d095529fa39a75f Mon Sep 17 00:00:00 2001
From: Moritz Kempe <moritzkemp@mailbox.orge>
Date: Fri, 16 Aug 2024 12:15:10 +0200
Subject: [PATCH 1/3] added apply hylafax configuration section

---
 README.md | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 7f629a1..448ca1d 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,10 @@ Linux Fax Stack using Hylafax and t38modem.
 
 ***THIS GUIDE IS WIP***
 
-This guide was created using information from the opalvoid wiki (http://wiki.opalvoip.org/index.php?n=Main.HomePage)
+This guide was created using information from the opalvoid wiki (http://wiki.opalvoip.org/index.php?n=Main.HomePage).
+Please do not follow this guide blindly.
+Some used Opal versions are marked as being infected with malware by SourceForge.
+**We are strongly discouraging, that you are using these versions.**
 
 ## Software stack
 
@@ -38,7 +41,7 @@ apt-get install build-essential git wget pkg-config libssl-dev libsrtp2-dev libs
 Versions:
 - libpt (2.18.6) https://sourceforge.net/projects/opalvoip/files/v3.18 Cygni/Stable 6/
 - opal (3.18.6) https://sourceforge.net/projects/opalvoip/files/v3.18 Cygni/Stable 6/
-- t38mdem (4.6.2) https://github.com/hehol/t38modem/releases/tag/4.6.2
+- t38modem (4.6.2) https://github.com/hehol/t38modem/releases/tag/4.6.2
 
 #### ptlib
 ```bash
@@ -165,7 +168,7 @@ sudo cp ./t38modem /usr/local/bin
 ## Configuring t38modem
 ### Init script
 
-- To automatically start t38modem, you need to create Systemd services, as well as start and stop scripts
+- To automatically start t38modem, you need to create Systemd services
 - script is adapted from https://web.archive.org/web/20111231021042/https://www.foriamroot.org/hylafax-6-0-debian-or-ubuntu-t38modem-1-0-asterisk-1-6/
 
 First we'll create the configuration directory under `/etc` using `sudo mkdir -p /etc/t38modem/bin/`.
@@ -211,9 +214,9 @@ sudo chmod +x /etc/t38modem/bin/run
 
 ### Create the configuration file
 Create a file using the following contents at `/etc/t38modem/config/XX`.
+Replace `XX` with the modem number.
 
 ```bash
-# /etc/t38modem/config
 T38MODEM_PTTY_ID="XX" # /dev/ttyT38-XX
 T38MODEM_SIP_USERNAME="USERNAME"
 T38MODEM_SIP_PASSWORD="PASSWORD"
@@ -327,6 +330,14 @@ CountryCode:	1
 AreaCode:		999
 ```
 
+## Apply configuration
+If HylaFax doesn't receive or send faxes, you can try restarting it.
+This can be done using
+```bash
+sudo /etc/init.d/hylafax stop
+sudo /etc/init.d/hylafax start
+```
+
 ## FaxDispatch
 
 - https://legacy.hylafax.org/content/Advanced_Permissions_with_6.0

From adafdafde4d2cc49546ed75bd6fde5e96825de54 Mon Sep 17 00:00:00 2001
From: Moritz Kempe <moritzkemp@mailbox.orge>
Date: Mon, 26 Aug 2024 10:25:09 +0200
Subject: [PATCH 2/3] corrected mistake

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 448ca1d..20f4c4d 100644
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@ Some used Opal versions are marked as being infected with malware by SourceForge
 (legacy) library for doing a little bit of everything.
 
 ### Opal
-Voice codec used by e.g. mumble.
+Voice codec
 
 ### t38modem
 Emulates a serial modem from SIP connection
@@ -53,7 +53,7 @@ make install
 #### opal
 ```bash
 ./configure
-make -j5
+make
 make runtest
 make install
 ```

From 8f7a28b6956992a4ad98470f7f1099d52d98843d Mon Sep 17 00:00:00 2001
From: Moritz Kempe <git@moritzkempe.de>
Date: Sun, 10 Nov 2024 23:59:05 +0100
Subject: [PATCH 3/3] added hylafax warning

---
 README.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.md b/README.md
index 20f4c4d..28ded80 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,8 @@ Unfortunately this software stack uses a lot of legacy software. Because of this
 For Debian 12, we´ll only install dependencies which are hard requirements.
 For this guide we'll use ptlib 2.18.6 and opal 3.18.6.
 
+WARNING: Hylafax will get stuck during the modem probing process.
+
 #### Installing Requirements
 First we'll need some packages
 ```bash
@@ -245,6 +247,7 @@ sudo chmod 700 -R /etc/t38modem/config/
     - -> `RING`
     - Answer the call: `ata` -> `CONNECT`
     - You should now hear your modem "talking" to you
+    - ATH means hang up
 - Pitfalls:
   - If you are already connected to your SIP server it may not give proper response codes. My provider returns `500 Internal Server Error`
   - Test the command before running the init script!