sim_card 0.0.2

data/lib/sim_card/received_sms_message.rb

@@ -0,0 +1,50 @@
+class SimCard
+  class ReceivedSmsMessage
+    
+    # parse raw output from SIM card and return list of ReceivedSmsMessage instances.
+    # see SimCardTest for examples of raw SIM output.
+    def self.to_messages raw_sim_output
+      messages = []
+      raw_input2 = raw_sim_output[14..-1] # remove initial AT+CMGL="ALL"\n
+      raw_input3 = (raw_input2 || '').split('+CMGL: ')[1..-1]
+      
+      (raw_input3 || []).each do |raw_message|
+        header, *text_lines = raw_message.split("\n")
+        
+        # +CMGL: 2,"REC READ","+421918987987","","13/08/20,19:00:44+08"
+        message_id, _, sender_number, _, date, time = header.gsub("\"", '').split(',')
+        
+        timestamp = DateTime.strptime (date + ' ' + time), '%y/%m/%d %H:%M:%S'
+        message_text = text_lines.join "\n"
+        
+        sms_message = ReceivedSmsMessage.new message_id, sender_number, timestamp, message_text
+        messages << sms_message
+      end
+      
+      return messages.reverse
+    end
+    
+    attr_reader :message_id, :sender_number, :timestamp, :text
+    
+    # * message_id : ID of the sms message as provided by the SIM card
+    # * sender_number : who sent the message
+    # * timestamp : time of message arrival
+    # * text : message text
+    def initialize message_id, sender_number, timestamp, text
+      @message_id = message_id
+      @sender_number = sender_number
+      @timestamp = timestamp
+      @text = text
+    end
+    
+    def to_s
+      <<STRING
+message id: #{@message_id}
+sender: #{@sender_number}
+timestamp: #{@timestamp}
+#{@text}
+STRING
+    end
+    
+  end
+end

data/lib/sim_card/sim.rb

@@ -0,0 +1,68 @@
+class SimCard
+  
+# code below is based on:
+# http://www.dzone.com/snippets/send-and-receive-sms-text
+
+  class Sim
+  
+    # connect to SIM card. user_options may contain:
+    # * port : device where the gsm modem is connected, default is '/dev/ttyUSB0'
+    # * speed : connection speed in bauds, default is 9600
+    # * pin : pin to your sim card, default is '0000'
+    # * sms_center_no : SMS center of you provider. required only if you want to send SMS messages
+    def initialize(user_options = {})
+      default_options = {:port => '/dev/ttyUSB0', :speed => 9600, :pin => '0000'}
+      options = default_options.merge user_options
+      
+      @port = SerialPort.new(options[:port], options[:speed])
+      cmd("AT")
+      cmd("AT+CPIN=\"#{options[:pin]}\"")
+      # Set to text mode
+      cmd("AT+CMGF=1")
+      # Set SMSC number
+      cmd("AT+CSCA=\"#{options[:sms_center_no]}\"") if options[:sms_center_no]
+    end
+  
+    # correctly disconnect from SIM card
+    def close
+      @port.close
+    end
+
+    def send_sms number, message_text
+      cmd("AT+CMGS=\"#{number}\"")
+      cmd("#{message_text[0..140]}#{26.chr}\r\r")
+      sleep 3
+      wait
+      cmd("AT")
+    end
+  
+    # list SMS messages in SIM memory
+    def sms_messages
+      raw_sim_output = cmd("AT+CMGL=\"ALL\"")
+      ReceivedSmsMessage.to_messages raw_sim_output
+    end
+    
+    # remove SMS message from SIM card memory
+    # * sms_message: instance of SimCard::SmsMessage to be deleted
+    def delete_sms_message sms_message
+      cmd("AT+CMGD=#{sms_message.message_id}")
+    end
+  
+    private
+    def cmd(cmd)
+      # puts "SIM CMD IN:#{cmd}"
+      @port.write(cmd + "\r")
+      wait
+    end
+    
+    def wait
+      buffer = ''
+      while IO.select([@port], [], [], 0.25)
+        chr = @port.getc.chr;
+        buffer += chr
+      end
+      # puts "SIM OUT:#{buffer}"
+      buffer
+    end
+  end
+end

data/lib/sim_card.rb

@@ -0,0 +1,7 @@
+# see README
+class SimCard
+end
+
+require 'date'
+require 'sim_card/received_sms_message'
+require 'sim_card/sim'

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: sim_card
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Peter Vojtek
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-21 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/sim_card.rb
+- lib/sim_card/sim.rb
+- lib/sim_card/received_sms_message.rb
+homepage: 
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Access and control cellphone SIM card functionality via AT commands
+test_files: []