MarkTomm at 16:31, 22 November 2013

2013-11-22T16:31:38Z

← Older revision		Revision as of 16:31, 22 November 2013
Line 62:		Line 62:

	== Advanced ==		== Advanced ==


			'''Prerequisites''':
			* Established terminal connection to the device.


			Additional information about 3G modem status can be viewed with the ''dynmotd'' command as well as in ''/tmp/log/modem.st'' file.

			Detailed log information about SMS events can be vieved in ''/tmp/log/messages'' .

			Sms counter file is located in ''/var/local/telem/sms/<phone_number>/sms_counter''

			Varius stamp files and next message content can be found in ''/tmp/sms/<phone_number>''


Line 72:		Line 85:


	[[Kasutaja:MarkTomm\|MarkTomm]] 22. november 2013, kell 18:16 (EET)		[[Kasutaja:MarkTomm\|MarkTomm]] 22. november 2013, kell 18:31 (EET)

MarkTomm: Uus lehekülg: '== Configuring GWS == '''Prerequisites''': *GWS version 6.0.5.'''1770''' or newer is required to configure the SMS protocol. === Adding a protocol === In GWS add a new port ...'

2013-11-22T16:16:08Z

Uus lehekülg: '== Configuring GWS == '''Prerequisites''': *GWS version 6.0.5.'''1770''' or newer is required to configure the SMS protocol. === Adding a protocol === In GWS add a new port ...'

New page

== Configuring GWS ==

'''Prerequisites''':
*GWS version 6.0.5.'''1770''' or newer is required to configure the SMS protocol.

=== Adding a protocol ===
In GWS add a new port and choose '''SMS''' from ''Protocol'' drop-down menu as illustrated below (Port7):
[[File: Sms_gws_port_add.png | 900px | thumb | center]]

Sms port column will now have an '''Add Phone''' cell in ''IP Address'' row (Port7).
Click on the '''Add Phone''' to access the configuration window as illustrated below:
[[File: Sms_gws_add_phone.jpg | 900px | thumb | center]]

* '''Phone''': Enter the phone number (International Country Calling Code is required) ''Default: None'' ''Type: String''
* '''Max number of daily SMS'es''': Maximum amount of SMS'es the entered number can receive¹ ''Default: 50'' ''Type: Integer''.
* '''Allow reboot command''': Allow rebooting the device via SMS using configured phone number ''Default: Unchecked'' ''Type: Check Box''.
* '''Allow commands (digital and analog)''': Allow sending control commands via SMS using configured phone number ''Default: Unchecked'' ''Type: Check Box''.

By default the SMS port is forbidden for all objects (in our case Port7 as illustated below):
[[File: Sms_gws_objects.jpg | 900px | thumb | center]]

== Interacting with the device via SMS protocol ==

'''Prerequisites''':
*A configured device in 3G network range that has a 3G modem that is turned on and has a valid SIM Card inserted (at the time of writing this text the only available option was GWM)

'''NB!''' Receiving a message may sometimes take a couple of minutes.

=== Available SMS messages ===
{| class="wikitable"
|-
! MESSAGE CONTENT
! DESCRIPTION
! NEGATIVE DEVICE RESPONSE
! POSITIVE DEVICE RESPONSE
! ADDITIONAL INFO
|-
|* '''IP''' || The device will respond with SIM Card Ip address. || - || ''<SIM Card Ip address>'' || -
|-
|* '''CSC''' || The device will reset the current SMS counter state to 0. || - || SMS counter reset || This command will be valid even if the daily SMS limit is reached
|-
|* '''REBOOT''' || The device will be rebooted || Insufficient privileges for reboot || successfully rebooted || This command requires "Allow reboot command" Check Box to be checked
|-
| * '''CTRL''' ''object_address'' ''value''² || The device will set the object at ''object_address'' to the requested ''value'' || *Control Failed: Not Allowed in GWS<br />*Control Failed: Invalid address value<br />*Control Error: Such address does not exist<br />*Wrong input value: ''value''|| Control Successful || This command requires "Allow commands (digital and analog)" Check Box to be checked
|}

'''NB!''' Messages in lowercase and mixed upper- and lowercase are also valid (f.ex ''Ip'' or ''reBoot'' or ''csc'')

=== Receiving SMS on certain events ===

SMS protocols can be separately configured to send messages to the configured phone number when certain object values change.
This can be done by removing the specific SMS protocol port number from ''Forbidden Ports'' column for the required object.
[[File: Sms_gws_objects.jpg | 900px | thumb | center]]

== Advanced ==

----
¹ Sending a message and receiving an answer is considered as one SMS (counter will be incremented once). Receiving a message in case of an event change (without previously sending) is considered as one SMS (counter will be incremented once).

² If controlling digital output "ON" and "OFF" can be used as value to switch digital output on and off respectively.

[[Kasutaja:MarkTomm|MarkTomm]] 22. november 2013, kell 18:16 (EET)

SMS Protocol Configuration - Revision history

MarkTomm at 16:31, 22 November 2013

MarkTomm: Uus lehekülg: '== Configuring GWS == '''Prerequisites''': *GWS version 6.0.5.'''1770''' or newer is required to configure the SMS protocol. === Adding a protocol === In GWS add a new port ...'