HilinkModem 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 591d5a10ea51be5ead9e916f452222457b1e3812
+  data.tar.gz: eae97b559f4a815e0940331bb0855be3a411a6da
+SHA512:
+  metadata.gz: b6b09913f32466f380f39420a653f2c9228ffb7cdcd281fa96d286f7331addb0008537345539d1f46b363d7dfb5323264e5d60592869ebde3b4e2be09fbe1e81
+  data.tar.gz: d98e9c4c83b461b575b13d6de6e0524a95292c4173f2ec77acf9bdfcb705961e022ade59f65241b53c871b7018538753c7731a04d44bfc7b8f8427d5c9419511

data/README.md

@@ -0,0 +1,55 @@
+# Hilink - ruby interface for Huawei Hilink web-frontend
+
+## Usage
+
+The code supposes that the modem is connected and has the IP
+192.168.1.1. Then you can do:
+
+````
+require 'hilink'
+puts Hilink::Monitoring::status.inspect
+````
+
+which will return a hash of all variables that the stick can return.
+
+Please also see the much more complete PhP-implementation on
+[BlackyPanther/Huawei-HiLink](https://github.com/BlackyPanther/Huawei-HiLink).
+
+If you have the newer version which connects to 192.168.8.1, this library
+won't work for you, sorry.
+
+## Commands
+
+Each command is a module inside of Hilink. There are different modules:
+
+- Monitoring - return different status of the modem
+- Network - change 2g / 3g network
+- SMS - send, receive and list
+- Dialup - (dis)connect from network
+- Modem - useful only when it is in modem-mode
+- USSD - *Doesn't work due to Huawei restriction*
+
+The Hilink-module itself has three methods:
+- `send_request( path, request = {} )` - generates a valid XML-request and return
+the result as a hash
+- `switch_to_modem` - sends the command so the key behaves as a modem
+- `switch_to_debug` - according to web-interface, no difference visible
+
+### Monitoring
+
+You can monitor different things:
+
+- `traffic_statistics` - per-connection and total usage
+- `traffic_reset` - set all to 0
+- `status` - shows whether connected or not
+- `check_notifications`
+
+### Network
+
+- `set_connection_type( mode = 'auto', band = '-1599903692' )` - mode
+can be 'auto', '2g' or '3g'
+- `current_plnm` - get actual connection
+
+### SMS
+
+- `list`

data/lib/hilinkmodem.rb

@@ -0,0 +1,172 @@
+require 'net/http'
+require 'active_support/core_ext'
+require 'active_support'
+require 'serialport'
+require 'helperclasses/hashaccessor'
+
+
+module HilinkModem
+  extend self
+  #using HelperClasses::HashAccessor
+
+  def send_request( path, request = {} )
+    url = "/api/#{path}"
+    http = Net::HTTP.new('192.168.1.1')
+
+    if request != {} 
+      req = Net::HTTP::Post.new(url)
+      req.body = request.to_xml(root: 'request', indent: 0, skip_types: true)
+      req.content_type = 'text/xml'
+    else
+      req = Net::HTTP::Get.new(url)
+    end
+    begin
+      response = http.request(req).body
+    rescue Errno::ENETUNREACH => e
+      return nil
+    end
+
+    begin
+      Hash.from_xml( response )['response']
+    rescue REXML::ParseException => e
+      nil
+    end
+  end
+
+  def switch_to_modem
+    send_request( 'device/mode', :mode => 0 )
+  end
+
+  def switch_to_debug
+    send_request( 'device/mode', :mode => 1 )
+  end
+  module Modem
+    extend self
+    
+    def send_modem( str )
+      sp = SerialPort.new('/dev/ttyUSB0',115200)
+      sp.write("#{str}\r\n")
+      sp.read_timeout = 100
+      sp.readlines
+    end
+
+    def switch_to_hilink
+      send_modem('AT^U2DIAG=119')
+    end
+
+    def save_modem
+      send_modem('AT^U2DIAG=0')
+    end
+  end
+  module Monitoring
+    extend self
+    
+    def send_request( path, request = {} )
+      Hilink::send_request( "monitoring/#{path}", request )
+    end
+
+    def traffic_statistics
+      send_request('traffic-statistics')
+    end
+
+    def traffic_reset
+      send_request('clear-traffic')
+    end
+
+    def status
+      send_request('status')
+    end
+
+    def check_notifications
+      send_request('check-notifications')
+    end
+  end
+  module Network
+    extend self
+    
+    def send_request( path, request = {} )
+      Hilink::send_request( "net/#{path}", request )
+    end
+
+    def current_plnm
+      send_request('current-plnm')
+    end
+
+    def set_connection_type( mode = 'auto', band: '-1599903692' )
+      nmode = case mode
+      when /2g/i 
+        1 
+      when /3g/i 
+        2 
+      else 
+        0 
+      end
+      send_request( 'network', {
+          :NetworkMode => nmode,
+          :NetworkBand => band } )
+    end
+  end
+  module SMS
+    extend self
+    
+    def send_request( path, request = {} )
+      Hilink::send_request( "sms/#{path}", request )
+    end
+
+    def list( box = 1, site: 1, pref_unread: 0, count: 20 )
+      ret = send_request( 'sms-list', {
+          :PageIndex => site,
+          :ReadCount => count,
+          :BoxType => box,
+          :SortType => 0,
+          :Ascending => 0,
+          :UnreadPreferred => pref_unread } )
+      if ret && ret['Messages']['Message'].class == Hash
+        ret['Messages']['Message'] = [ ret['Messages']['Message'] ]
+      end
+      ret
+    end
+
+    def delete( index )
+      send_request( 'delete-sms', { :Index => index } )
+    end
+
+    def send( number, message, index = -1 )
+      send_request( 'send-sms', {
+          :Index => index,
+          :Phones => [number].flatten,
+          :Sca => "",
+          :Content => message,
+          :Length => message.length,
+          :Reserved => 1,
+          :Date => Time.now.strftime('%Y-%m-%d %H:%M:%S') } )
+    end
+  end
+  module Dialup
+    extend self
+    
+    def send_request( path, request = {} )
+      Hilink::send_request( "dialup/#{path}", request )
+    end
+
+    def connect
+      send_request( 'dial', :Action => 1 )
+    end
+
+    def disconnect
+      send_request( 'dial', :Action => 0 )
+    end
+  end
+  module USSD
+    extend self 
+    
+    def send_request( path, request = {} )
+      Hilink::send_request( "ussd/#{path}", request )
+    end
+
+    def send( str )
+      return :error => "Sorry, doesn't work!"
+      send_request( 'send', :content => str, :codeType => 'CodeType')
+    end
+  end
+end

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification
+name: HilinkModem
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Linus Gasser
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-04-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.1'
+- !ruby/object:Gem::Dependency
+  name: serialport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: Using the web-interface of huawei hilink modems to do things
+email: ineiti@linusetviviane.ch
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/hilinkmodem.rb
+homepage: https://github.com/ineiti/HilinkModem
+licenses:
+- GPLv3
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Accessing Huawei HilinkModem modems
+test_files: []