Article ID: 150323sab
Last Reviewed: December 1st 2016
The information in this article applies to:
- PmGateway version 3.0.1 and later when used to provide remote access to one of the Power Master Loggers
- NOTE: PmGateway was previously called PmRemoteAgent in older releases.
Target Audience.
This article is aimed at:
- All users of PmGateway who wish to remotely control a Power Master Logger
Summary.
PmGateway is an application that runs on a phone or tablet running the Android operating system. It provides timed remote download and control of a Power Master Logger. Remote control of PmGateway and the Logger is achieved by sending an SMS message to the phone or tablet which PmGateway receives, interprets and performs the command requested.
Before you start.
You will need all of the following:
1) An Android device to which you can send SMS messages.
2) A copy of PmGateway installed on the Android device.
3) A Power Master PM1000, PM2000, PM3000 or PM7000 with a Bluetooth interface.
4) A device from which to send SMS messages.
Command Format.
All commands have a common format and follow these conventions:
1) A command starts with the period / dot character “.”
2) A single command word immediately follows the period/dot character.
3) The parameters (if required) follow the command word and are space separated.
4) A final optional parameter determines where any response generated should be sent.
5) Commands are not case sensitive so .start .START and .stART are all considered the same.
Command quick reference.
| Command | Parameter 1 | Parameter 2 | Parameter 3 |
| .login | [phone number] | ||
| .logout | [phone number] | ||
| .response | |||
| .start | |||
| .stop | |||
| .restart | |||
| .status | |||
| .values | |||
| .registers | [location] | [count] |
Command descriptions.
.Login Command
For security and data integrity reasons PmGateway ignores messages received from a number/phone that is not authorised. The .login command adds a number to the list of authorised numbers. This command needs to be used once for each number/phone authorised to control PmGateway.
There are two ways to use this command to authorise a number.
1) When next to the device running PmGateway, ensure PmGateway is running in the foreground and send the .login command without any parameters from the device you wish to authorise. PmGateway presents a dialog on the screen requesting confirmation. Click Yes to add the number to the authorised number list.
2) When not near the device running PmGateway a number can be authorised, from a second previously authorised number, by sending the .login command followed by the number of the phone to be authorised.
Examples:
.login 012345678910 email Adds 012345678910 to the authorised numbers list and send response back over email.
.login Add this phones number to the authorised numbers list, local access to the device running PmGateway required to accept.
.Logout Command
Removes a number from the list of authorised numbers.
Examples
.logout 012345678910 Deletes 012345678910 from the list of authorised numbers (this can be sent from 012345678910 but would be the last command accepted from that number).
.Response Command
Sets the default response method, this is how PmGateway is to respond when a command is sent that does not have: <email>, <sms> or <none> appended.
Examples
.response email SMS commands received from now on will by default respond over email.
.response none no response will be returned from SMS commands.
.Start Command
Starts the Logger recording. If the Logger is already recording this has no effect.
Examples
.start email Start the Logger recording, sending the result over email
.start sms Start the Logger recording, sending the result back in an SMS
.Stop Command
Stops the Logger recording. If the Logger is not recording this has no effect. Examples
.stop email Stop the Logger recording, sending the result over email
.stop sms Stop the Logger recording, sending the result back in an SMS
.Restart Command
Stops and then starts the Logger recording. If the Logger is not recording this will start the Logger recording.
Examples
.restart email Stop the current recording and start the next session, sending the result over email
.restart sms Stop the current recording and start the next session, sending the result back in an SMS
.Status Command
Reads the Loggers status and returns the results.
Examples
.status email Get the Logger status, sending the result back in an email
.status sms Get the Logger status, sending the result back in an SMS
Example Response
PM1S0651
Status: Recording
Battery Volts: 5.979 V
Ambient Temp: 32.8 deg
Firmware: 1.025
Free Memory: 3.89 %
.Values Command
Reads the Loggers channel values and returns the results.
Examples .values email Get the channel values and send the results back over email
.values sms Get the channel values and send the results back over SMS
Example Response
Channels: 01=230.8 Vac 02= 8.1 Aac 03= 2.0% 04= 2.2 Aac 05= 0.00 Pfs 06= 1.00 Flg 07= 0.37 Pst 08= 0.33 Plt
09= 0.49 Vac
10=50.05 Hz
.Registers Command
reserved for development not for use by end users.