FALCOM MAMBOII, User Manual

Page: 118 / 271

C
ONFIGURATION
C
OMMAND
S
ET
- F
IRMWARE
R
EVISION
2.4.0_
BETA
- V
ERSION
1.0.0
3.2.6.3 “SMTP” command index
MAMBOII device is fully integrated with Internet standard SMTP protocol (email),
supporting following features:
Outgoing Mail Features
MAMBOII can be configured to send automatically email notification messages to
a user when a specific event or a change of state occurs on the device.
3.2.6.3.1 TCP.SMTP.Send,< email_address >,< protocols >,<” text ”> - Send an Email
to the connected remote server
Command syntax
TCP.SMTP.Send ,<”email_address” >,< protocols >,< ”usertext” >
TCP.SMTP.Send, < ”email_address” >,< protocols >,< ”usertext & (entry) ”>
Examples
$PFAL,TCP.SMTP.Send,”test@mailserver.com”,8,”MAMBOII sends its GSP positions”
Responses
E.g.
$prepare sending Email (length:105 Bytes)
Message description
This command enables sending of E-Mails via an Internet mail server, including GPS
position data and user text. The entered user text can be evaluated and used for
further application processes. The remote mail server to connect to is defined by
the
<mail_server_address> and <mail_server_port> from the
TCP.SMTP.CONNECT
parameter. Both entries must be set before this command is executed. If there is an
error during sending of E-Mail (message), the
TCP.SMTP.eFailed
event is raised and
this email message is deleted. If the E-Mail message is sent successfully, the
TCP.SMTP.eSent
event is raised. This command can be used to email you detailed
journey reports or other reports directly to your inbox.
The subject the MAMBOII device used to send E-Mail message is:
Subject syntax Message from <hardware name> (Name="<name>", IMEI=< IMEI >)
Subject example Message from MAMBOII (Name="my MAMBOII", IMEI=123456789012345)
Parameter Description
<”email_address”>
A string that contains the address that the message is sent to. Only one E-Mail
address is permitted per message. The E-Mail address must be wrapped in
quotation marks
(“ “)
.
<protocols>
It defines, in hexadecimal, the output NMEA messages to be sent to the
recipient of the E-Mail message. It has to be specified in the hex format without
leading the
“ 0x ”
. Supported protocols are listed in chapter 6.3 page 245
.
<”usertext“>
It specifies the text message, up to 200 characters, to be sent to the recipient of
the E-Mail message. It must be wrapped in quotation marks (“ “).
If it is required to attach also system information (
entry
) at certain times the
following syntax of the
<”text ” >
is also possible:
“text&(<entry
1
>)text&(<entry
2
>)text…&(<entry
n
>)“
Each dynamic entry is separated by ampersand “&” without spaces and enclosed in
parentheses “( )“.
For example:
$PFAL,TCP.SMTP.Sen
d,”test@mailserver.com“,8,
" on & ( Date) at & ( Time ) it is moving
at & ( Speed) m/s "
Dynamic entries are listed in chapter 6.2 page 243 .
This confidential document is a property of FALCOM and may not be copied or circulated without previous permission.
Page 118 of 271