Вы находитесь на странице: 1из 4

Handset Control

� #reboot - Reboots the device

� #switch2g - Switches the handset to 2G only mode (applicable to Moto


handsets).

� #switch3g - Switches the handset to 2G/3G mode (applicable to Moto


handsets).

� #switch4g - Switches the handset to 2G/3G/4G mode (applicable to Moto


handsets).

� #status - Returns a beacon status message to the sending handset via SMS

� #dataroamingsetting - Returns the current value of the data roaming


setting (1 is enabled, 0 disabled)

� #enabledataroamingsetting - Enables the data roaming setting on the


handset. Might need to issue a #reboot to make it stick.

[edit]Data Testing

� #datatest# - Performs a basic HTTP connection check by loading the file


at http://www.mycoveragechecker.com/mcc/beacon_test_file.txt and returning the
result. If successful the value of 1024 bytes should be returned.

� #hetest# - Performs a header enrichement check and returning the result


to the sender.

� #uploadtest - Performs a basic HTTP connection check by uploading the


file at http://www.mycoveragechecker.com/mcc/beacon_test_file.txt and returning the
result. If successful the value of 1024 bytes should be returned.

[edit]Application Management

� #restarthelper# - If the helper service is not running, this command will


attempt to restart it. If the service has been force stopped then it will not
restart until a user manually starts it. Beacon Helper 1.4 introduces a keep-alive
scheduler to do this automatically should the helper stop.

� #restartbeacon# - If the beacon application is not running, this command


will attempt to restart it. It will automatically attempt registration if an MSISDN
is available via HE or on the SIM. Beacon Helper 1.4 introduces a keep-alive
scheduler to do this automatically should the beacon stop.
� #installapk#[APK_URL] - This will cause the beacon to download and
install the apk at the specified link. Once installed a #startactivity# command
will need to be sent to actually start the app.

� #startactivity#[PACKAGE_NAME]/[ACTIVITY_NAME] - This will cause the


helper to attempt to start an app on the handset. The package name is the base
package name of the app and the activity name is the actual activity (relative to
the package name) to launch within the app. For example, to start the beacon the
command would be
#startactivity#com.metricell.mcc.beacon/.ui.registration.MCCRegistrationActivity

� #reinstall# - Completely uninstalls the current beacon and performs a re-


installation. Provided the phone is on mobile data the new beacon installation will
automatically register if it receives a number via HE or the SIM contains an
MSISDN.

[edit]Beacon Control
� #updatecheck - Instructs the helper to do an immediate update check to
download new version of the helper or beacon.

� #refreshsettings - Instructs the beacon to do an immediate settings


update check to receive new test scripts and server settings.

� #restarttest - Instructs the beacon to do an immediate script restart if


it is waiting, or after the currently executing test.

[edit]Logging
� #enablehelperlogging - Enables helper file logging (when the debugger is
not installed).

� #disablehelperlogging - Disables helper file logging (when the debugger


is not installed).

� #uploadhelperlogs - Uploads the logs collected for the beacon helper.

� #uploadlogs - If the logging is enabled on the beacon then this command


will concatenate, compress (using gzip) and upload the log files to our server.

� #uploadqueue - Uploads the raw queued points file from the beacon to our
server for manual import.

� #deletequeue - Deletes the queued points file from the beacon. WARNING:
make sure you have successfully uploaded the queued points file (using
#uploadqueue) before performing this action, it WILL delete all beacon data!
[edit]Wi-Fi Management (v1.6.0 and later)
� #wifistatus - Returns the status of the current Wi-Fi connection, if
connected.

� #wifienable - Enables Wi-Fi (will connect to any pre-configured networks


automatically)

� #wifidisable - Disables Wi-Fi

� #wifiscan - Temporarily enables Wi-Fi and performs a network scan, the


scan waits for a delay of 10 seconds before taking the scan results.

� #wifiscan#[TIMEOUT] - Temporarily enables Wi-Fi and performs a network


scan, the scan waits for a delay of [TIMEOUT] seconds before taking the scan
results.

� #wificonnect#[SSID],[PASSWORD],[SECURITY] - Attempts to connect to a


specified Wi-Fi access point. [SSID] should be the SSID of the network to connect
to (as listed with #wifiscan), this value is case-sensitive. [PASSWORD] is the
WPA/WEP password to use for the connection, if omitted the connection is made as an
open network. [SECURITY] specifies the type of Wi-Fi security for the connection,
values are wpa/wep/open, default is wpa if omitted.

[edit]Misc
� #sendsms#[NUMBER]#[MESSAGE] - Instructs the helper to send the specified
[MESSAGE] to the specified [NUMBER], the next SMS that the helper receives will
automatically be forwarded onto the sender. This allows credit check of an external
phone for example (#sendsms#150#ba)

� #uploadfile#[FILENAME] - Compresses (using gzip) and uploads the


specified from the phone filesystem to the debug receiver service on our servers.

#reinstallcallhelper

#enableusecallhelper

[edit]Other
Power Disconnection: When the helper is installed and the power is disconnected for
more than 1 hour (or 5 minutes for AutoMobile) the handset will automatically shut
down. When power is restored the handset will restart and continue as normal.

2G/3G/4G Changes: When a network mode change is requested the mode will be changed
immediately, after 3 minutes the service state is queried and if the handset is not
in service the network mode is reverted back to the default 2G & 3G mode. This
prevents switching to an unavailable network mode.

Debugging: To enable debug mode install the 'Metricell Debug Enabler' before
installing the helper. Once installed the helper will log debug messages to file on
the SD card. In debug mode the update ID 88888 is used for the helper and 99999 is
used for the beacon, this allows different versions to be tested without putting
them live.

#tcpdump-start
- Starts the tcpdump collection, if it is not already running

#tcpdump-stop
- Stops the tcpdump collection, if it already running

#tcpdump-flush
- Attempts to upload the queued PCAP files via FTP. All files uploaded remain on
the handset. When you are sure that all files are received successfully issue a
#tcpdump-purge to delete the files.

#tcpdump-purge
- Deletes any queued PCAP files. (Does NOT upload theme!)

#tcpdump-getsetting#[SETTING_NAME]
- Retrieves a setting from the application, available settings are:

tcpdump_ftp_server - FTP server host


tcpdump_ftp_user - FTP server username
tcpdump_ftp_password - FTP server password
tcpdump_maxage - Maximum age a PCAP file
can reach before it's purged (in ms, default is 48 hours)
tcpdump_cmdline - The tcpdump command
line (default command line is '-i any -G 1800 -s 128 ip')

#tcpdump-putsetting#[SETTING_NAME]=[VALUE]
- Sets a setting for the application, see setting name above. Value is string
value, e.g. to set new FTP host name:
#tcpdump-putsetting#tcpdump_ftp_server=my.ftp.host

#tcpdump-getcmdline
- Shortcut to #tcpdump-getsetting#tcpdump_cmdline

#tcpdump-setcmdline#[COMMAND_LINE]
- Shortcut to #tcpdump-putsetting#tcpdump_cmdline=[COMMAND_LINE]

#tcpdump-status
- Sends the current status of the tcpdump helper. Message includes running status,
queued pcap files, total data usage of pcap, and FTP login details

#tcpdump-testftp
- Attempts to open an FTP connection and make a temporary directory on the server
then close the connection. The progress is returned as SMS.

#startpackage#com.metricell.tcpdumpshell

#installapk#https://www.mycoveragechecker.com/mcc/megafon/dev/tcpdump_helper_v1.0.2
_161018.apk

Вам также может понравиться