Editing SMSCON
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
Warning: This page is 58 kilobytes long; some browsers may have problems editing pages approaching or longer than 32kb. Please consider breaking the page into smaller sections.
The edit can be undone.
Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
- | + | '''Please Note: Update for 0.9.15++ is in progress for this page. In particular section "Usage" still needs updates...'''. -- [[User:yablacky|yablacky]] 08:49, 16 January 2012 (UTC) | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | Update for 0.9. | + | |
==Introduction== | ==Introduction== | ||
Line 20: | Line 15: | ||
'''WARNING:''' | '''WARNING:''' | ||
This application can send (multiple) SMS messages automatically (in the background). Be aware that SMS sending is '''not free''' and it's costs depends on the used telephone subscription with your Nokia device. Sending many SMS might be a minor problem for those having a SMS-flat-rate... | This application can send (multiple) SMS messages automatically (in the background). Be aware that SMS sending is '''not free''' and it's costs depends on the used telephone subscription with your Nokia device. Sending many SMS might be a minor problem for those having a SMS-flat-rate... | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
==Features== | ==Features== | ||
- | |||
- | |||
===General=== | ===General=== | ||
* Looking for commands in received SMS messages. | * Looking for commands in received SMS messages. | ||
- | * Asking a remote command server for commands | + | * Asking a remote command server for commands (available only if you setup and maintain such a server). |
* Sending notifications, responses and query results by SMS and/or by EMAIL. | * Sending notifications, responses and query results by SMS and/or by EMAIL. | ||
- | * Send help about all currently recognized SMS commands. | + | * Send help about all currently recognized SMS commands, e.g. if you've forgotten them. This way you need just to remember the code of one single command (the COM_CHECK command). |
* Supports use of multiple SIM cards. | * Supports use of multiple SIM cards. | ||
- | * Detect SIM card change. | + | * Detect SIM card change. It will send a notification containing the new SIM card's phone number, IMSI code & telecom operator name. This scenario happens if your phone's finder or thief replaces your SIM by his/hers own SIM card. |
- | + | ||
* Optionally turn the phone silent on receiving a known command. | * Optionally turn the phone silent on receiving a known command. | ||
* Stores personal settings encrypted. | * Stores personal settings encrypted. | ||
Line 51: | Line 34: | ||
* Track the phone's GPS location and location changes by let it automatically send repeated notifications in a selectable time interval. | * Track the phone's GPS location and location changes by let it automatically send repeated notifications in a selectable time interval. | ||
* Let front camera take pictures and send them via email notification. With a some luck you may see where your phone is or who is using it. | * Let front camera take pictures and send them via email notification. With a some luck you may see where your phone is or who is using it. | ||
- | |||
* Let the phone make a voice call to your controlling phone. Once the call is established you can listen where your phone is. | * Let the phone make a voice call to your controlling phone. Once the call is established you can listen where your phone is. | ||
* Play a pre- and user-defined sound file (only WAV supported). May be used instead of just let the phone ring and let it say a special message. | * Play a pre- and user-defined sound file (only WAV supported). May be used instead of just let the phone ring and let it say a special message. | ||
Line 75: | Line 57: | ||
* Autoloads at boot. This ensures that SMSCON is active (that means is listening for commands) even after device (re)boot. Autoload is enabled by default during installation of a SMSCON package. | * Autoloads at boot. This ensures that SMSCON is active (that means is listening for commands) even after device (re)boot. Autoload is enabled by default during installation of a SMSCON package. | ||
- | * Create and keep a log file on the device. The log file can be queried remotely by SMS command as well as locally via command line | + | * Create and keep a log file on the device. The log file can be queried remotely by SMS command as well as locally via command line. |
* Reboot the phone. Albeit this is possible it is not generally recommended if your SIM card has a PIN: If nobody enters the PIN correctly, the phone would boot but could not connect to GPRS network. | * Reboot the phone. Albeit this is possible it is not generally recommended if your SIM card has a PIN: If nobody enters the PIN correctly, the phone would boot but could not connect to GPRS network. | ||
* Shutdown the phone. Also just possible but not generally recommended. | * Shutdown the phone. Also just possible but not generally recommended. | ||
* Stop & restart SMSCON activity by SMS command. On trouble, this might be preferred operation instead of rebooting the phone. | * Stop & restart SMSCON activity by SMS command. On trouble, this might be preferred operation instead of rebooting the phone. | ||
- | * Send notifications if SMSCON crashes on activity. Should this ever happen, you're encouraged to forward them to the SMSCON developer team ( | + | * Send notifications if SMSCON crashes on activity. Should this ever happen, you're encouraged to forward them to the SMSCON developer team (make a bug report). |
==Installation== | ==Installation== | ||
Line 92: | Line 74: | ||
If you are willing to try unstable versions and help testing the application, consider to install packages from here: [http://maemo.org/packages/view/smscon/ SMSCON Releases] and there: [http://maemo.org/packages/view/smscon-editor/ SMSCON Editor Releases]. Be warned. | If you are willing to try unstable versions and help testing the application, consider to install packages from here: [http://maemo.org/packages/view/smscon/ SMSCON Releases] and there: [http://maemo.org/packages/view/smscon-editor/ SMSCON Editor Releases]. Be warned. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
===Installation details=== | ===Installation details=== | ||
Line 125: | Line 101: | ||
It is highly recommended to review all user settings and adjust them to your needs. Since this is a lot for the first time, there are a few important things for you to setup (no must but recommended): | It is highly recommended to review all user settings and adjust them to your needs. Since this is a lot for the first time, there are a few important things for you to setup (no must but recommended): | ||
* All the [[#Email_settings | Email settings]] to enable SMSCON to send EMAIL notifications. | * All the [[#Email_settings | Email settings]] to enable SMSCON to send EMAIL notifications. | ||
- | * Personalized [[#Prefix.2Fsuffix_for_all_SMS_command_strings | SMS command code prefix and/or suffix]] | + | * Personalized [[#Prefix.2Fsuffix_for_all_SMS_command_strings | SMS command code prefix and/or suffix]] |
* The so-called [[#SMS_command_source | master number]]. | * The so-called [[#SMS_command_source | master number]]. | ||
- | * Last not least, [[#Set_the_phone.27s_lock.2Funlock_code | Set the phones lock code]] | + | * Last not least, [[#Set_the_phone.27s_lock.2Funlock_code | Set the phones lock code]]<br>This is not a SMSCON setting but a N900 device setting. |
- | We recommend use of [[SMSCON Editor]] to review and change settings. Alternatively open Xterm and use | + | We recommend use of [[SMSCON Editor]] to review and change settings. Alternatively open Xterm and use the <code>smscon</code> command on unix command line. |
====Set the master number==== | ====Set the master number==== | ||
Line 168: | Line 144: | ||
With SMSCON the lock state can also be controlled remotely by SMS commands. | With SMSCON the lock state can also be controlled remotely by SMS commands. | ||
- | Fortunately (from users point of view) the N900 device locking function has a feature that prevents a user from accidentally lock out himself: Unless the lock code was explicitly set once in the Device Lock settings, the phone will not lock until the lock code was entered; this means you need the code to even lock the phone. | + | Fortunately (from users point of view) the N900 device locking function has a feature that prevents a user from accidentally lock out himself: Unless the lock code was explicitly set once in the Device Lock settings, the phone will not lock until the lock code was entered; this means you need the code to even lock the phone. Unfortunately (from SMSCON point of view) is is also true if locking was requested by a SMSCON command. |
- | Obviously locking via SMSCON command makes sense only if the the phone goes locked immediately without asking the current user for a code before. | + | Obviously locking via SMSCON command makes sense only if the the phone goes locked immediately without asking the current user for a code before. Because this can be canceled by the user and leaves the phone unlocked. |
- | In order to achieve this, '''each user of SMSCON is encouraged to at least once set an explicit device lock code on his/her phone'''. No matter if | + | In order to achieve this, '''each user of SMSCON is encouraged to at least once set an explicit device lock code on his/her phone'''. No matter if this explicit code is the same as the default code 12345 (which re-use is of course not recommended) and no matter if Autolock is enabled or not. |
===Phone number format=== | ===Phone number format=== | ||
All phone numbers should be entered with country prefix. Not only ensures this that SMS are send successfully regardless where your phone actually is located. It further is essential to make phone numbers comparable. | All phone numbers should be entered with country prefix. Not only ensures this that SMS are send successfully regardless where your phone actually is located. It further is essential to make phone numbers comparable. | ||
- | |||
- | |||
===After installation=== | ===After installation=== | ||
Line 216: | Line 190: | ||
===List of known sms commands=== | ===List of known sms commands=== | ||
- | + | * 'COM_CHECK': Command to ask for help. | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | * 'COM_CHECK': Command to ask for help | + | |
* 'COM_REBOOT': Command to reboot the phone. | * 'COM_REBOOT': Command to reboot the phone. | ||
* 'COM_POWEROFF': Command to shutdown the phone. | * 'COM_POWEROFF': Command to shutdown the phone. | ||
Line 228: | Line 197: | ||
* 'COM_REMOTEON': Command to start outgoing ssh connection. | * 'COM_REMOTEON': Command to start outgoing ssh connection. | ||
* 'COM_REMOTEOFF': Command to stop outgoing ssh connection. | * 'COM_REMOTEOFF': Command to stop outgoing ssh connection. | ||
- | * 'COM_CAMERA': Command to take | + | * 'COM_CAMERA': Command to take picture. |
* 'COM_CALL': Command to start an outgoing call. | * 'COM_CALL': Command to start an outgoing call. | ||
* 'COM_LOCK': Command to lock the phone. | * 'COM_LOCK': Command to lock the phone. | ||
- | * 'COM_UNLOCK': Command to unlock the phone. | + | * 'COM_UNLOCK': Command to unlock the phone (encrypted). |
* 'COM_TRACKON': Command to start GPS tracking. | * 'COM_TRACKON': Command to start GPS tracking. | ||
* 'COM_TRACKOFF': Command to stop GPS tracking. | * 'COM_TRACKOFF': Command to stop GPS tracking. | ||
- | * 'COM_CUSTOM': Command to run | + | * 'COM_CUSTOM': Command to run predefined user script. |
- | * 'COM_CUSTOMLOG': Command to ask for output | + | * 'COM_CUSTOMLOG': Command to ask for user script output. |
- | * 'COM_SHELL': | + | * 'COM_SHELL': Command to execute that shell command. Returns output as notification. |
- | * 'COM_ALARM': Command to play | + | * 'COM_ALARM': Command to play predefined alarm.wav. |
* 'COM_RESTART': Command to restart the daemon. | * 'COM_RESTART': Command to restart the daemon. | ||
- | * 'COM_LOG': Command to ask for application log | + | * 'COM_LOG': Command to ask for application log (encrypted). |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
===Prefix/suffix for all SMS command strings=== | ===Prefix/suffix for all SMS command strings=== | ||
Line 567: | Line 354: | ||
</pre> | </pre> | ||
- | These commands can be changed using [[SMSCON Editor]] | + | These commands can be changed using the [[SMSCON Editor]] and also at the command-line with the <code>smscon -set </code> command (see SMSCON command-line options). |
- | + | * When sending 'Check' to you phone it sends one or more SMS messages with all the available SMSCON commands. | |
+ | * Sending 'Reboot' it will reboot your phone. | ||
+ | * Sending 'Poweroff' is will shutdown your phone. | ||
+ | * Sending 'Location' is will send it's current position by SMS or EMAIL (or both). | ||
+ | * Sending 'Remoteon' it will enable the SSH connection to your (home-)server. 'Remoteoff' will kill the connection. | ||
+ | * Sending 'Camera' will send a frontcam picture by email. | ||
+ | * Sending 'Call' will call you. | ||
+ | * Sending 'Lock' will lock the device, so nobody can use your phone. 'Unlock' will remove the device lock. | ||
+ | * Sending 'Trackon' will continiously send SMS or email (or both) with location of the device & 'Trackoff' will disable this. | ||
+ | * Sending 'Script' will run a predefined by user shell script (<code>/opt/smscon/smscon_script</code>). | ||
+ | * Sending 'uptime' (an example shell command) will execute the shell command on your phone and returns the output. | ||
+ | * Sending 'Alarm' will play once a user selectable file (only WAV format and must be named <code>alarm.wav</code> in <code>/opt/smscon</code> directory) '''NEW IN 0.8.1''' | ||
+ | * Sending 'Restart' will kill the smscon_daemon and restart it. '''NEW IN 0.8.1''' | ||
- | * | + | USAGE EXAMPLE: |
- | + | * To trigger any of the commands the phone should receive an SMS having in the subject its defined name. E.g. to trigger the <code>'''COM_LOCATION'''</code> command the phone should receive: <code>'''Location'''</code>. | |
- | + | * The commands can use spaces in them and can be altered in a command only you know what it is and what it means. | |
- | + | * the alarm audio file (only WAV format and must be named <code>alarm.wav</code>) must be placed, if the option is used, in <code>/opt/smscon</code>. '''NEW IN 0.8.1''' | |
- | + | ||
- | + | ||
- | + | ||
- | * | + | |
- | + | ||
- | * | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | ===Remote command server | + | ===Remote command server=== |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | To trigger any of the commands by a remote file on your own server (when option ENABLECHECKHOST is enabled), the file only must contain one of the following values from 00, 01 to 17 or -1: | |
<pre> | <pre> | ||
Line 625: | Line 402: | ||
19 = COM_LOG | 19 = COM_LOG | ||
</pre> | </pre> | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | ''' | + | It is of course necessary that the file on your server can be read by your N900 via the http protocol (or the protocol you set). Otherwise it won't work. If it don't work, check the log for ''CHECKHOST'' errors. |
- | + | The default CHECKTIME is 15 minutes but can be changed via CHECKTIME setting. Note that after giving a command via remote command server, it can take up to CHECKTIME minutes to execute the command. | |
===Example config file=== | ===Example config file=== | ||
Line 655: | Line 411: | ||
Shown is an example config file as stored in <code>smscon_config</code>. This is presented for the gentle user only. Normal users never need to see nor edit this directly. Please use smscon command line or SMSCON Editor to edit settings. | Shown is an example config file as stored in <code>smscon_config</code>. This is presented for the gentle user only. Normal users never need to see nor edit this directly. Please use smscon command line or SMSCON Editor to edit settings. | ||
+ | ====Recent version==== | ||
<pre> | <pre> | ||
- | # smscon user settings (initially written by version 0.9. | + | # smscon user settings (initially written by version 0.9.13) |
# smscon configuration file written by: | # smscon configuration file written by: | ||
- | @APPVERSION = '0.9. | + | @APPVERSION = '0.9.13' |
# Send notification on battery discharge (yes|no): | # Send notification on battery discharge (yes|no): | ||
Line 668: | Line 425: | ||
# The URL to check (encoded): | # The URL to check (encoded): | ||
- | CHECKHOST = ' | + | CHECKHOST = 'yEBTfGI6EAJaWzmy73SqVEwUB6FcWazAIQzrVsS0qE1CuD0=' |
# Minutes between URL checks: | # Minutes between URL checks: | ||
Line 701: | Line 458: | ||
# Command to ask for application log (encrypted): | # Command to ask for application log (encrypted): | ||
- | COM_LOG = ' | + | COM_LOG = '+YjK8eIOzf+0n0uUJwSuUd3cKw==' |
# Command to ask for phone battery status: | # Command to ask for phone battery status: | ||
Line 731: | Line 488: | ||
# Command to unlock the phone (encrypted): | # Command to unlock the phone (encrypted): | ||
- | COM_UNLOCK = ' | + | COM_UNLOCK = '3YGdCMKu7rWGnlPSqCkSzz62uA==' |
- | + | ||
- | + | ||
- | + | ||
# Recipient of EMAIL notifications (regular owner of this phone, please contact him!): | # Recipient of EMAIL notifications (regular owner of this phone, please contact him!): | ||
Line 740: | Line 494: | ||
# Sender address of EMAIL notification (encrypted): | # Sender address of EMAIL notification (encrypted): | ||
- | EMAILFROM = ' | + | EMAILFROM = 'VsPk5cxygm5nGmucyzirv1skvPHrQadT5gqkM5/zM9bSywc=' |
# Enable checking URL for commands: | # Enable checking URL for commands: | ||
Line 748: | Line 502: | ||
ENABLERESEND = 'no' | ENABLERESEND = 'no' | ||
- | # Seconds between GPS coordinate acquisitions for COM_TRACKON and COM_LOCATION: | + | # Seconds between GPS coordinate acquisitions for COM_TRACKON and COM_LOCATION (10..120:10|20|30|60|120) |
- | GPSINTERVAL = | + | GPSINTERVAL = 60 |
- | + | ||
- | + | ||
- | + | ||
- | # Number of | + | # Number of GPS coordinate acquisitions for COM_LOCATIONs best of: |
- | GPSPOLLING = | + | GPSPOLLING = 3 |
# How to send GPS notifications (sms|email|both): | # How to send GPS notifications (sms|email|both): | ||
Line 773: | Line 524: | ||
# SMTP server hostname or IP (encrypted): | # SMTP server hostname or IP (encrypted): | ||
- | MAILSERVER = ' | + | MAILSERVER = 'dXXpTEa3MZ+05r/ALbHbKt/RePHrQadT5gqkM5/zM9bSywc=' |
# How to send notifications (sms|email|both|none): | # How to send notifications (sms|email|both|none): | ||
Line 779: | Line 530: | ||
# SMTP password for EMAILFROM (encrypted): | # SMTP password for EMAILFROM (encrypted): | ||
- | PASSWORD = ' | + | PASSWORD = 'WfxI7aL07RhrI83CRQMCC3Ocew==' |
# Local port number to be forwarded to [exit of tunnel itself] on the phone: | # Local port number to be forwarded to [exit of tunnel itself] on the phone: | ||
Line 785: | Line 536: | ||
# ssh server hostname or IP [to build tunnel] (encrypted): | # ssh server hostname or IP [to build tunnel] (encrypted): | ||
- | REMOTEHOST = ' | + | REMOTEHOST = 'iTxPVquDQU92cRF2bmlIRj/pGQ1T+fy7Qek0+9iEtxxVjHg=' |
# ssh server IP address [entry of tunnel itself] that will be forwarded to phone (*|localhost|IP): | # ssh server IP address [entry of tunnel itself] that will be forwarded to phone (*|localhost|IP): | ||
- | REMOTELISTENIP = ' | + | REMOTELISTENIP = 'JJ+/0x2Zo0/a9USQybIzKfa5Ww==' |
# ssh server port number [entry of tunnel itself] that will be forwarded to phone: | # ssh server port number [entry of tunnel itself] that will be forwarded to phone: | ||
- | REMOTELISTENPORT = ' | + | REMOTELISTENPORT = 'viXjs4DLHdkREGe/SdCvOiANqA==' |
# ssh server password [to build tunnel] (encrypted): | # ssh server password [to build tunnel] (encrypted): | ||
- | REMOTEPASSWORD = ' | + | REMOTEPASSWORD = 'ONm0UoDc3e3ireKwmSpwJBLylw==' |
# ssh server port number [to build tunnel]: | # ssh server port number [to build tunnel]: | ||
Line 800: | Line 551: | ||
# ssh server username [to build tunnel] (encrypted): | # ssh server username [to build tunnel] (encrypted): | ||
- | REMOTEUSER = ' | + | REMOTEUSER = 'I4eLEW9zhSuGD8bgA5b3K3aSNQ==' |
# Maximum number of message re-send tries (0=no limit): | # Maximum number of message re-send tries (0=no limit): | ||
Line 818: | Line 569: | ||
# Prefix that must be present before all COM_XXX commands [even COM_SHELL] (encrypted): | # Prefix that must be present before all COM_XXX commands [even COM_SHELL] (encrypted): | ||
- | SMS_COMPREFIX = ' | + | SMS_COMPREFIX = 'IJJTaoMyBiJLG3ArS7LeZXOs2w==' |
# Suffix that must be present behind all COM_XXX commands [even COM_SHELL] (encrypted): | # Suffix that must be present behind all COM_XXX commands [even COM_SHELL] (encrypted): | ||
- | SMS_COMSUFFIX = ' | + | SMS_COMSUFFIX = 'U9Vq6qDkHLB/px5Lnq4ZXgZeVQ==' |
# A SMS notification produces no more than this number of single SMS (0=no limit): | # A SMS notification produces no more than this number of single SMS (0=no limit): | ||
Line 827: | Line 578: | ||
# SMTP username for EMAILFROM (encrypted): | # SMTP username for EMAILFROM (encrypted): | ||
- | USER = ' | + | USER = 'x22rmwo4SeWn8OqA4Vx+84kf8g==' |
# SMS number of master controller (encrypted): | # SMS number of master controller (encrypted): | ||
- | MASTERNUMBER = ' | + | MASTERNUMBER = 'ZaZrsVQQgtT8cydYgqc3vYgIhg==' |
+ | </pre> | ||
+ | |||
+ | ====Older version==== | ||
+ | |||
+ | The config file of older version 0.8 may look like this: | ||
+ | |||
+ | <pre> | ||
+ | # smscon user settings (v0.8.1) | ||
+ | # (DO NOT edit the encrypted user settings below, use SMSCON-editor or SMSCON!) | ||
+ | |||
+ | # SMS number | ||
+ | SENDERNUMBER = '+1234567890' | ||
+ | |||
+ | # SMS commands | ||
+ | COM_CHECK = 'Check' | ||
+ | COM_REBOOT = 'Reboot' | ||
+ | COM_POWEROFF = 'Poweroff' | ||
+ | COM_POWER = 'Power' | ||
+ | COM_LOCATION = 'Location' | ||
+ | COM_REMOTEON = 'Remoteon' | ||
+ | COM_REMOTEOFF = 'Remoteoff' | ||
+ | COM_CAMERA = 'Camera' | ||
+ | COM_CALL = 'Call' | ||
+ | COM_LOCK = 'Lock' | ||
+ | COM_UNLOCK = 'Unlock' | ||
+ | COM_TRACKON = 'Trackon' | ||
+ | COM_TRACKOFF = 'Trackoff' | ||
+ | COM_CUSTOM = 'Script' | ||
+ | COM_SHELL = 'uptime >> /tmp/commandlog' | ||
+ | COM_ALARM = 'Alarm' /* NEW IN 0.8.1 */ | ||
+ | COM_RESTART = 'Restart' /* NEW IN 0.8.1 */ | ||
+ | |||
+ | # REMOTE command /* NEW IN 0.8.1 */ | ||
+ | # (check server file at remote host to trigger smscon: 'yes', 'no') | ||
+ | ENABLECHECKHOST = 'no' | ||
+ | # (check host) | ||
+ | CHECKHOST = 'www.bla.com/filetocheck' | ||
+ | # (check interval in minutes) | ||
+ | CHECKTIME = 15 | ||
+ | |||
+ | # Email settings | ||
+ | EMAILADDRESS = 'bla@bla.com' | ||
+ | # (encrypted setting) | ||
+ | USER = '<ENCRYPTED>' | ||
+ | # (encrypted setting) | ||
+ | PASSWORD = '<ENCRYPTED>' | ||
+ | EMAILFROM = 'bla@bla.com' | ||
+ | MAILSERVER = 'www.bla.com' | ||
+ | MAILPORT = 25 | ||
+ | |||
+ | # SSH settings | ||
+ | REMOTEHOST = 'www.bla.com' | ||
+ | REMOTEPORT = 22 | ||
+ | # (encrypted setting) | ||
+ | REMOTEUSER = '<ENCRYPTED>' | ||
+ | # (encrypted setting) | ||
+ | REMOTEPASSWORD = '<ENCRYPTED>' | ||
+ | |||
+ | # Reply message settings | ||
+ | # (method to send reply messages: 'sms' / 'email' / 'both' / 'none') | ||
+ | MESSAGESEND = 'sms' | ||
+ | # (enable resending of reply message after <RESENDTIME> minutes | ||
+ | # until successful sending; 'yes' / 'no') | ||
+ | ENABLERESEND = 'no' | ||
+ | # (resend waiting time in minutes) | ||
+ | RESENDTIME = 15 | ||
+ | |||
+ | # Send acknowledge SMS | ||
+ | # (send acknowledge SMS after receiving valid SMS command: 'yes' / 'no') | ||
+ | COMMANDREPLY = 'no' | ||
+ | |||
+ | # Detect keyboard use | ||
+ | # (send acknowledge SMS if keyboard is sliding: 'yes' / 'no') | ||
+ | KEYBOARDDETECT = 'no' | ||
+ | |||
+ | # Device lock | ||
+ | # (lock device after receiving valid SMS command: 'yes' / 'no') | ||
+ | AUTODEVICELOCK = 'yes' | ||
+ | |||
+ | # Auto battery status SMS report | ||
+ | # (sends SMS when SMSCON is set active with a SMS command & battery | ||
+ | # is depleting: 'yes' / 'no') | ||
+ | AUTOBATREPORT = 'no' | ||
+ | |||
+ | # Auto device unlock | ||
+ | # (unlocks device when new SIM is inserted; 'yes' / 'no') | ||
+ | SIMUNLOCK = 'no' | ||
+ | |||
+ | # Silence the phone | ||
+ | # (disable all phone sounds when SMSCON is set active with a SMS command: 'yes' / 'no') | ||
+ | SILENCEDEVICE = 'no' | ||
+ | # GPS settings | ||
+ | # (if no GPS coordinates after <GPSTIMEOUT> seconds then stop aquiring) | ||
+ | GPSTIMEOUT = 1800 | ||
+ | # (number of GPS coordinates to acquire and use the most accurate in "Location"-mode) | ||
+ | GPSPOLLING = 3 | ||
+ | # (time between sending GPS coordinate SMS in "Trackon"-mode: 10 / 20 / 30 / 60 / 120) | ||
+ | GPSINTERVAL = 60 | ||
+ | # (method to send GPS coordinates: 'email' / 'sms' / 'both') | ||
+ | GPSSEND = 'sms' | ||
</pre> | </pre> | ||
Line 866: | Line 717: | ||
===Remote SSH connection=== | ===Remote SSH connection=== | ||
- | + | When the (reverse-)SSH connection is made (default command 'Remoteon' / 'Remoteoff') you can from the server side (your own server) connect to your Nokia device with the following command: | |
- | + | ||
- | + | ||
<pre> | <pre> | ||
ssh -p 8080 localhost -l root | ssh -p 8080 localhost -l root | ||
</pre> | </pre> | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
==Files== | ==Files== | ||
Line 932: | Line 771: | ||
As said above, regular use of SMSCON does not require knowledge of files nor packages used. | As said above, regular use of SMSCON does not require knowledge of files nor packages used. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
== Versions == | == Versions == | ||
- | + | === 0.9.11-2 [http://maemo.org/packages/package_instance/view/fremantle_extras-devel_free_armel/smscon/0.9.11-2/ Development]'''=== | |
- | + | Availability: [[Extras-devel]] | |
- | + | ||
- | + | ||
- | + | ||
- | ''' | + | |
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
- | + | ||
'''Changelog''' | '''Changelog''' | ||
- | + | FIX: Fixed repeated resending of sms or email in almost zero-time intervals in case resend-time interval was configured to less than 1 minute. | |
- | + | ADD: Anonymized log files. Can be used to post logs in bug reports etc. Works like this: Logfile shown by command "smscon -log" is now anonymized by default (phone numbers, host names, IP-addresses) | |
IMPORTANT NOTE(1): Anonymizing takes place with ABSOLUTELY NO guarantee! | IMPORTANT NOTE(1): Anonymizing takes place with ABSOLUTELY NO guarantee! | ||
IMPORTANT NOTE(2): It is NOT A BUG if there is too much or "wrong" anonymizing. If new option "-pw password" was seen on command line before -log, then logfile is shown un-anonymized as before. And of course a super user has not limits anyway. | IMPORTANT NOTE(2): It is NOT A BUG if there is too much or "wrong" anonymizing. If new option "-pw password" was seen on command line before -log, then logfile is shown un-anonymized as before. And of course a super user has not limits anyway. | ||
- | + | CHANGE: Logfile is no longer readable by normal user. | |
- | + | FIX(MINOR): Fixed typos and added more comments. | |
=== 0.9.10-1=== | === 0.9.10-1=== | ||
'''Changelog''' | '''Changelog''' | ||
- | + | FIX: If called in user mode, prevent -export or -export! option to create/write files that user has no permissin to create or write. | |
- | + | FIX: Fix crash: TypeError: can only concatenate tuple (not "list") to tuple | |
=== 0.9.9-1=== | === 0.9.9-1=== | ||
'''Changelog''' | '''Changelog''' | ||
- | + | CHANGE: Deamon does no longer need to restart for switching between test mode and normal operation mode. | |
- | + | FIX: Daemon now reads test command requests from a named pipe and works them off sequentially (allows to quickly start several tests in a short time). | |
- | + | FIX: Fixed that COM_REMOTEOFF command did not work. | |
- | + | FIX: Fixed daemon crash ("need more than 3 values to unpack") | |
- | + | FIX (AGAIN): Force using busybox ps-command to ensure that process information like PID is at expected place. | |
=== 0.9.8-1=== | === 0.9.8-1=== | ||
'''Changelog''' | '''Changelog''' | ||
- | + | FIX: Fixed problems with daemon process ids on devices with extended "ps" command installed. This bug might prevent power users from using smscon. So this fix is reason for early release of new version. | |
- | + | FIX: Fixed interchanged message parameters in smscon -init! command output. | |
- | + | ADD: Added usage hints to initial smscon_script file (minor change). | |
+ | |||
===0.9.7-1=== | ===0.9.7-1=== | ||
'''Changelog''' | '''Changelog''' | ||
- | + | FIX: Send battery status notification if charge is below 10% AND discharging (not OR discharning). If devices can't tell change/discharge status; discharge is assumed. | |
- | + | FIX: Don't check for bootloader if in test mode. | |
- | + | FIX: Wrong error message that daemon did not start on devices with extended "ps" command installed. | |
+ | |||
===0.9.3-1=== | ===0.9.3-1=== | ||
Line 1,090: | Line 861: | ||
NEW: smscon now allows all options to start with the usual double dash as well. | NEW: smscon now allows all options to start with the usual double dash as well. | ||
+ | === 0.8.1-3 ([http://maemo.org/packages/view/smscon/ testing]) === | ||
+ | '''Changelog''' | ||
+ | * CHANGE/FIX: bug in ENABLECHECKHOST option; would execute wrong command & updated wiki because of some changes. See WIKI/Usage! | ||
+ | |||
+ | '''Issues''' | ||
+ | * Using Wrong 3G connection when fMMS is installed (MMS connection instead)(unconfirmed by Vanvan) | ||
+ | <del>* The "_" character does not get decoded correctly on reception and any command having this fails to execute. '''Recommended:''' until a fix is made avoid using this character in the commands. (confirmed)</del> -- fixed in 0.9.x [[User:yablacky|yablacky]] 08:46, 16 January 2012 (UTC) | ||
+ | |||
+ | === 0.8.1-2 === | ||
+ | |||
+ | '''Changelog''' | ||
+ | * MINOR FIX: removed debug line in smscon code. | ||
+ | |||
+ | '''Issues''' | ||
+ | * Using Wrong 3G connection when fMMS is installed (MMS connection instead)(unconfirmed by Vanvan) | ||
+ | |||
+ | === 0.8.1-1 === | ||
+ | |||
+ | '''Changelog''' | ||
+ | * FIX: shutdown & reboot routine (EnablePoweroff & EnableReboot) give internal error. | ||
+ | * NEW/CHANGE: expanded user setting MESSAGESEND ('sms', 'email', 'both' & 'none') | ||
+ | * CHANGE: Removed DISABLESMS user setting. This is superseded by MESSAGESEND user setting! | ||
+ | * CHANGE: with unauthorized SIM card change, SMS always will be send regardless of MESSAGESEND setting. | ||
+ | * NEW: added smscon command (RESTART); user can restart smscon_daemon by SMS command. | ||
+ | * NEW: added smscon command (COM_ALARM); phone will play user configurable sound file (only WAV format and must be named <code>alarm.wav</code> and placed in <code>/opt/smscon</code> directory) when command is received. | ||
+ | * NEW: smscon_daemon sends SMS/email message if smscon_daemon crashes. | ||
+ | * CHANGE: changed user setting ENABLERESEND ('yes', 'no'). Resending of messages will again be experimental feature!!! | ||
+ | * CHANGE: removed MAXRESEND user setting (didn't work properly). | ||
+ | * CHANGE: some log text changed/added. | ||
+ | * CHANGE: removed updatechecker during installation of smscon (failed to work previously). | ||
+ | * CHANGE: some changes in GPS message sending code. | ||
+ | * CHANGE: AUTODEVICELOCK message is only send if COMMANDREPLY is enabled. | ||
+ | * FIX: small bug in SMSsend(). | ||
+ | * FIX: bug in GPSINTERVAL handeling; GPSINTERVAL was always set at 60 sec. regardless of user setting. | ||
+ | * CHANGE: The log file location changed from <code>/tmp/smscon.log</code> to <code>/opt/smscon/smscon.log</code> (whereas location of <code>/tmp/smscon_boot.log</code> did not change). | ||
+ | |||
+ | '''Issues''' | ||
+ | * Using Wrong 3G connection when fMMS is installed (MMS connection instead)(unconfirmed by Vanvan) | ||
+ | |||
+ | ===0.7-2 ([http://maemo.org/packages/view/smscon/ current extras])=== | ||
+ | |||
+ | '''Changelog''' | ||
+ | * FIX: bug in RestoreNetwork(); restoring previous network could fail. | ||
+ | * FIX: bug in CheckArguments(); execution of shell script could fail. | ||
+ | |||
+ | '''Issues''' | ||
+ | |||
+ | * Using Wrong 3G connection when fMMS is installed (MMS connection instead)(unconfirmed by Vanvan) | ||
+ | |||
+ | === 0.7-1 === | ||
+ | |||
+ | '''Changelog''' | ||
+ | * '''NEW:''' multiple IMSI codes are allowed in smscon_code file; use new option "smscon -add imsi" to store current IMSI code in smscon_code file. | ||
+ | * '''NEW:''' added new user option (DISABLESMS); WARNING: disables ALL SMS sending in smscon program. | ||
+ | * '''NEW:''' added new smscon command (COM_SHELL); run directly shell commands. (no check & feedback from command!). | ||
+ | * '''NEW:''' added new user option (SIMUNLOCK); auto unlock phone after new SIM is inserted (to fool a possible thief of your phone). | ||
+ | * '''NEW:''' added new user option (SILENCEDEVICE); disable all phone sounds (email alert, IM alert, ringing alert & SMS alert) in current active profile, if smscon is activated. All volume levels are set to zero. | ||
+ | * '''NEW/CHANGE:''' new user option (AUTOBATREPORT); user can enable/disable sending automatically a SMS message when smscon is activated & device battery is depleting. | ||
+ | * CHANGE: when initializing a new smscon_config file all user settings wil be set default to 'no'. | ||
+ | * REFACTORING: some parts in both scripts. | ||
+ | * FIX: better number handeling in SMSrecieve() routine (thanks to maemo.org user!). | ||
+ | * FIX: small bug in GSMmodem() in smscon_daemon script. | ||
+ | * FIX: small text bug in smscon script. | ||
+ | * '''EXPERIMENTAL/CHANGE:''' when smscon fails to send SMS message (no cell reception) it will retry after 900 seconds. | ||
+ | * '''EXPERIMENTAL/FIX:''' change in getting the right GPRS connections; MMS & WAP will be discarded in available GPRS network list. | ||
+ | |||
+ | '''Known issues''' | ||
+ | * Bug in RestoreNetwork(); will be fixed in v0.7-2. (confirmed; thanks to Saturn) | ||
+ | * Bug in CheckArguments(); will be fixed in v0.7-2. (confirmed; thanks to Saturn) | ||
+ | * Please test & report on SMSCON thread on forum [http://talk.maemo.org/showthread.php?t=60729]. | ||
+ | |||
+ | |||
+ | === 0.5 & 0.4 branch === | ||
+ | |||
+ | * Don't use these anymore and update to 0.7 or 0.8 branch! | ||
- | == | + | ==Future release== |
- | + | * CHANGE: for encryption of user settings in <code>smscon_config</code> file, now secret code key is based on device serial number (no more predefined key in script); this enhances security. | |
==Future development ideas== | ==Future development ideas== | ||
Line 1,100: | Line 946: | ||
Feel free to add requests below. | Feel free to add requests below. | ||
- | * Add a provision for SMS reception without the UI being notified so that SMSCON control is silent. | + | * Add a provision for SMS reception without the UI being notified (so that SMSCON control is silent). INFO: Remote command server (CHECKHOST) already offers silent control. |
- | * | + | * saving all <code>smscon_config</code> user variables in gconf database. No need for <code>smscon_config</code> file anymore. (WONT IMPLEMENT) |
- | * | + | * add setting for user's country mobile number prefix. |
- | * | + | * add setting for alternative number (where alternative is a number sent a command and does not match the default) and option to choose where reply should be send, i.e. default number, alternative or both. Default number should not be replaced. INFO: Since 0.9.x there is a MASTERNUMBER concept. This is a default number that is never replaced |
- | * | + | * add setting to choose the default internet connection (WLAN, GPRS, or ANY). |
- | * | + | * when the "Camera" command is sent, the process should wait for keyboard action to capture a picture and send the mail. In that way, there will be more chances to get better face portrait of the "new" user. |
- | * | + | * Add the ability to run more than one custom command. |
- | * | + | * Application must be included in the ROM itself so that it cannot be removed. (CAN'T BE IMPLEMENTED) |
- | * | + | * Add a password so that no one else but the legitimate user can send an SMS to the phone and see where the phone is. (INFO: Use the prefix/suffix option in smscon editor application or set SMS_COMPREFIX/SMS_COMSUFFIX options via command-line) |
* Auto remove the received SMS from conversations. | * Auto remove the received SMS from conversations. | ||
* Disable PhoneSpeakerSwitch on receipt of 'call' command. | * Disable PhoneSpeakerSwitch on receipt of 'call' command. | ||
- | * | + | * EmailCON: check an specified email inbox, reading it with the program itself and not the built in default mail prog, at a given frequency, paying attention to commands written in the subject and/or body, accepting all the commands that are accepted via SMS. (WONT IMPLEMENT) |
- | * | + | * Improve handling of front camera to reduce the odds of crappy or plain blank black pictures being taken. (CAN'T BE IMPLEMENTED) |
- | * When in "stolen" mode, replace the front cam "recording" LED pattern with a on-lighting pattern for stealthiness. | + | * When in "stolen" mode, replace the front cam "recording" LED pattern with a on-lighting pattern for stealthiness. |
* Email, or post online somewhere you choose, any new photography taken with the main camera, geotagging whenever possible, preferably without showing any signs it's happening (if possible with an option to re-dimension the picture before sending). | * Email, or post online somewhere you choose, any new photography taken with the main camera, geotagging whenever possible, preferably without showing any signs it's happening (if possible with an option to re-dimension the picture before sending). | ||
- | * There should be an option to send email as text or as multipart html and text | + | * There should be an option to send email as text or as multipart html and text. |
- | + | ||
==Testers needed== | ==Testers needed== | ||
Line 1,123: | Line 968: | ||
Watch [http://maemo.org/packages/repository/list/fremantle_extras-testing_free_armel/ Packages in QA testing queue] if SMSCON and/or SMSCON Editor is present there. You're encouraged to test and tell your positive or negative feedback there (thumbs up or down). Thereby following the rules of [http://wiki.maemo.org/Extras-testing#Quality_Assurance_criteria Quality Assurance criteria]. | Watch [http://maemo.org/packages/repository/list/fremantle_extras-testing_free_armel/ Packages in QA testing queue] if SMSCON and/or SMSCON Editor is present there. You're encouraged to test and tell your positive or negative feedback there (thumbs up or down). Thereby following the rules of [http://wiki.maemo.org/Extras-testing#Quality_Assurance_criteria Quality Assurance criteria]. | ||
- | |||
- | |||
==License== | ==License== | ||
Line 1,137: | Line 980: | ||
GNU General Public License for more details. | GNU General Public License for more details. | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
- | |||
[[Category:Software]] | [[Category:Software]] | ||
[[Category:N900]] | [[Category:N900]] |
Learn more about Contributing to the wiki.