GSM Commander Package Readme:
=============================

Package Version: 4.17C


Changes since V4.17:

* Fixed bug causing temperature related statements to trigger continuously when lockout timer is zero.

* Added use of variables

* Enhanced airtime checking algorithm to support long airtime response from network


Changes since V4.16:

* Enhanced housekeeping routine checking if GSM module is still powered.  

* Changed GSM Network registration checking to reconnect quicker, without influencing the rest of the GSM Commander's functionality

* Fixed problem with received voicecalls where these statements did not trigger reliably.



Changes since V4.15B:

* Fixed bug that caused "AT+CREG?" to appear in text messages sent by the GSM Commander

Changegs since Package V4.15:

* Added ability to detect if GSM Commander has been deregistered from GSM network, and then restarts GSM module (thereby re-registering on the network)

* Fixed a bug that inhibited correct working of all 32 inputs and 32 outputs


Changes since Package V4.14:

Many updates including short number compatability


Changes since Package V4.12:

* New Software (V4.13)
* New Firmware (V4.13)



FIRMWARE
========
Version: 4.14B

changes since 4.14:
* fixed a bug with long SMS somtimes crashing the GSM Commander

changes since 4.12:
* power status message now includes battery voltage whether or not the power is ON.
* Fixed a bug that only shows itself when more than 2 or 3 expansion units are used - the upper 16 IO did not work correctly.

changes since 4.11C:
* fixed a major bug that resulted in outputs not behaving correctly under certain specific conditions
* Added a feature to "IF input goes active/inactive/toggle" to prevent the statement from triggering again for a preset period.

changes since 4.11B:
* Bug with trigger delays added to IF Startup
* Removed debug messages from serial port output

changes since 4.11:

* Disabled statements had a tendency to become enabled spontaneuosly!

Changes since V4.10:

* Fixed a serious bug that was introduced in V4.10 where if a garbage SMS is sent, the first trigger string is always assumed to be contained in the message


Changes since V4.09:

* Fixed status message to reply with correct signal strength and correct serial number
* Changed formatting of status message
* Fixed message sorting - if you have two trigger strings, with the one contained inside the other,
  then sending the larger of the two strings will no longer trigger both statements
* Changed formatting of startup message


Changes since V4.08:

* Fixed "midnight" time constraint bug. (time constraints that included midnight did not work)
* Will now automatically check airtime every 2 minutes, instead of only every 5 events.
* Return date&time as part of status message
* Will only set current time in response to a "SETTIME" message
* Will reply to "settime" message as confirmation - also giving the time..
* Some changes to Expansion output code - more robust - get rid of false input readings..



Changes since V4.07:

* Added "SEND USD" option - you can now request the GSM Commander to send an "unstructured supplementary data" request
  to the network, as is used by the networks to load airtime vouchers.  You send an SMS (from the admin number) of the form:
  SENDUSD:<data> with <data> being the text to send.  For airtime vouchers, this will typically be something like *121*<voucherno>#

* Fix problems with startup in V4.07 (Some GSM Comamnders would not boot after upgrading to V4.07)
* Fixed 1 problem with the Status display (IO map was not correct)
* Added "Trigger Delay" - you can now specify a delay in-between the time a statement triggers, and the time it executes the corresponding action.
* Added "IF GSM Signal > X" and "IF GSM Signal < X"
* GSM operations will now be halted if signal falls too low (GSMC sometimes became unstable under very low signal conditions before)
* IF GSM module is faulty, GSM Commander will still perform other functions (and only halt all GSM operations)

Changes since V4.06:

* Added options to allow Renaming of outputs and inputs
* Increase scope of "IF logic expression" to include more inputs and outputs
* Use of statement names during setup of "THEN enable/disable group of statements"
* Addition of "THEN toggle output X"
* Addition of THEN Activate Output for 'B' MINUTES
* Addition of THEN Activate Output for 'B' MINUTES, wait for 'C' MINUTES, Activate for 'B' MINUTES
* Addition of support extra temperature probe


Changes since V4.05:

* Added IF option  "IF Statement X has not triggered in Y minutes/Hours"
* Added IF option  "IF Date/Time = X" -to make something happen at a specific time on a specific range of dates or on specified days of the week
* Added IF option  "IF Temperature Equals X"
* Added IF option  "IF Startup" -to make something happen when the GSM Commander boots up
  - If the user selects "THEN Send message over serial port" as the action, this will replace the default startup message)
* Added THEN option  "THEN send string over serial port" (with date&time options too)
* Added THEN option  "THEN set multiple outputs according to pattern"
* Added THEN option  "THEN enable/disable group of statements"
* Added substantial serial capabilities, and also fully documented the serial port in the newest advanced manual.
* Expanded Time constraints to include day-of-week.  (Statement X only allowed to trigger on specified days of week at specified times)
* Expanded functionality for "THEN place voicecall" - you can now select the number of calls the GSM Commander should make, the number of seconds
  the phone should ring, and the interval between calls.
* Added support for 8-bit expansion units
Changes since V4.04:

* TIME CONSTRAINTS ADDED
  You can now add a time constraint to any behaviour statement, so that it will only
  trigger during certain times of the day.  NOTE that the unit receives the current time of
  day automatically when any SMS is received.  Upon power up, the unit will send an SMS to
  the first number in the list (Admin number), requesting a reply (any reply - even blank),
  which will automatically pass along the current time to the GSM Commander.  Typically,
  one will use a batery backup when using time constrained behaviour statements.
* Added "Send Power status message" Action option
* Added "Send Airtime message" Action option
* Changed "send Input Status" to "send Input/Output Status"


Changes since V4.03:
* Added outputs to logic test trigger conditions
* Added NAND and NOR options to logic test trigger conditions
* Added "Send Global input status Message" Action option
* Airtime is checked at startup (previously, airtime was only checked later, AFTER 5 events have occurred)


Changes since V4.02:
* Added "send analog status message" functionality
* Added "send input status message" functionality
* Added a feature to detect if a setup file was created by a non-compatible software version
* GSMC Will now only send "could not determine Airtime" messages once every 4 hours
* Corrected the serial number reported in "could not determine Airtime" messages



Changes since V4.00:
* Added "IF Power Restored" statement
* expanded the range of the timing variable, so that one can choose upto 24 hours as the interval
  between triggers while a trigger condition is met (as with power failure)


Changes since V3.05:
* all SMS commander can now be sent in reply to an originating number.
* added "send temperature message"

Changes since V3.04:
* There were still some problems with the startup procedure.  These are tested to be fixed now.
  Revamped the startup procedure to give detailed error reporting via the Software.

Changes since V3.03:
* GSM Commander not always booting properly - only with some SIMcards.  This should be fixed now.
* Added functionality - STATUS LED will remain lit while the unit is booting.

Changes since V3.02:
* "Send please call me" was not working properly - Fixed in this version
* Battery monitoring was not working properly - Fixed in this version
* "if input is inactive for longer than X" was not working properly - Fixed in this version
* "reply to.." was not working properly - Fixed in this version

Changes since V3.01:
* The "send Status message" action item was not working properly.

Changes since V3.00:
* Fixed some stability issues.

Changes since V1.05:

* Added support for multiple number formats
* Added support for battery connection in V6
* Added airtime checking code

SETUP SOFTWARE
==============

Version: 4.12

Changes since Version: 4.11
* Changes to support new features in firmware

Changes since Version: 4.10
* Fixed a bug with "THEN send temperature message" - it was corrupting the accompanying "IF" statement under certain conditions.

Changes since Version: 4.08

* AT LAST: We have added the ability to choose to select the com number manually instead of waiting for the scanning process, which sometimes takes ages.
* hiding of help menus now saved to ini file


Version: 4.08

Changes since Version: 4.07
Minor changes to  status display.

Changes since Version: 4.06
* Changes to support new features in firmware
* last used COMport now saved in .ini file - will stat looking at this port, then move to others if it doesn't find the gsm commander
* Software now autodetects at different baudrates - required because the GSMC HW may now be configured to other baudrates.
* Added ability to give names to statements, inputs and outputs.
* Addition of "Status" tab, allowing you to see what is going on insde the connected GSM Commander.

Changes since Version: 4.05
* Changes to support new features in firmware

Changes since Version: 4.04
* Changes to support new features in firmware

Changes since Version: 4.03
* Changes to support new features in firmware
* Changes to "read setup from unit" code - this was not working on all PCs, should be fixed now

Changes since Version: 4.02
* Added a "clear all statements" button on the "behaviour statements" tab.
* Changes to support updates in firmware
* Some general GUI changes.


Changes since Version: 4.01
* Will only work with the correct version of hardware (will now through error message for incompatible hardware)
* Will not unneccesarily disconnect the port (will not re-scan through all COMports every time)

Changes since V4.00:
* Changes to support the updates in firmware..

Changes since V3.05:
* Changes to support the updates in firmware..

Changes since V3.03:
* Revamped startup error detection to show detailed error messages.

Changes since V3.02:
* Software was generating faulty setup data for battery monitoring - fixed in this version
* Added several usability features (error reporting etc)

Changes since V3.01:
* added some clever code to detect bad simcard.

Changes since V3.00:
* some bugfixes

MINILOADER SOFTWARE
===================


Version: 4.0

Changes since 3.5:
* Software now autodetects at different baudrates - required because the GSMC HW may now be configured to other baudrates.


Changes since 3.4:
* Now able to update from V3.X or from V4.X

Changes since 3.3:
* Added functionality to make firmware update much easier


MANUALS
=======
Basic Manual   V2.04
Advanced Manual V2.04   <- this is a MUST read for the newest features..

=============================================================================================
The Firmware running on the GSM Commander is proprietary to Polygon Technologies CC.
You are NOT allowed to reverse-engineer, copy or change the Firmware or Software in any way.
=============================================================================================