View source for Howto enable the SMS Mail Gateway (SMGW)

== Check if your card is ready for SMGW ==
The requirements for running SMGW are the following:

 * bero*fix card/box with installed GSM-module
 * AppFS version newer than 2.2rc4

Make sure the GSM-related settings are right (PIN) and
that your card registers with the network.


== Download SMGW ==
The current version of SMGW can be downloaded here:
[http://www.beronet.com/downloads/berofix/apps/smgw/SMGW-current.tar.gz SMGW current]


== Install SMGW ==
To install SMGW on your bero*fix you need to open the bero*fix Management UI and log in.


Open the Firmware-Update page and choose the file downloaded above. Then click<br />
'Upload file' to upload SMGW to your bero*fix:<br />
[[Image:Smgw inst01.png|800px]]


After the archive has been uploaded, you will be asked to install it onto your bero*fix:<br />
[[Image:Smgw inst02.png|800px]]


When the installation is done, a log will be presented to you:<br />
[[Image:Smgw inst03.png|800px]]


== Configure SMGW ==
If SMGW is the first app to be installed on your bero*fix, you will note the menu entry 'Apps' appearing in the menu.<br />
Point to it and open the sub-entry 'SMGW':<br />
[[Image:Smgw inst04.png|800px]]


The configuration interface for SMGW allows you to configure the POP3 and SMTP-servers used.<br />
Fill out the forms for both and press the button 'Test Settings' to check if the entries made are correct:<br />
[[Image:Smgw inst05.png|800px]]


If the test completed without errors, you will see two green 'OK's below the configuration forms.
<br />You may now press 'Save Settings':<br />
[[Image:Smgw inst06.png|800px]]


SMGW should now check the mail-account configured in 'POP3 Configuration' for new mail and the<br />
incoming SMS-spool for new SMS every minute. Press the link 'reload' and see the contents of<br />
the logfiles generated. Note that entries in 'Error Logfile' do not need to be real errors,<br />
as messages concerning incorrect formatted mail are also logged in this logfile.


== Mail-Format needed to be processed successfully by SMGW ==

 Subject: smsto:<phonenumber>;port:<port_to_be_used>

 Content-Type: text/plain; charset=UTF-8

 Content-Transfer-Encoding: [base64|7bit|8bit|binary|quoted-printable]

The end of a SMS is determined by the end of the mails body or the word 'SMSEND' in a new line.