da_funk 0.4.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1428a015e59da2c2ba1c5b7db367d3a675d8dc27
+  data.tar.gz: 9932163afefdab19e28393464f99aeebbc3a450b
+SHA512:
+  metadata.gz: 99b76fb9cf5da0fbdc7e1b9c40fd3e687ef5f650facf6b89b228f0680e3e949e9d5ff06e60e8fbe8be8c12de2898689ba66c4592ee3d10e0ef8d78d355ccf80c
+  data.tar.gz: 39ad52f41a43b49e6c6e053a9a0c1c691a4d4755d37414221678bc4be7533c4b75169fe325d90cc42e31eee2c8e9333c4a8ff680ea1e6bc831ada8a4edf5dc12

data/.gitignore

@@ -0,0 +1,11 @@
+.yardoc/*
+_yardoc/*
+doc/*
+rdoc/*
+.bundle
+coverage/*
+stats
+stats/*
+out/da_funk.mrb
+out/da_funk/*
+out/*

data/.yardopts

@@ -0,0 +1,12 @@
+--protected
+--no-private
+--readme README_GUIDE.md
+--title 'CloudWalk Ruby API Documentation'
+--charset utf-8
+'lib/device/**/*.rb'
+'lib/device.rb'
+'lib/iso8583/*.rb'
+'lib/iso8583.rb'
+'lib/file_db.rb'
+'guides/*'
+- guides/*

data/Gemfile

@@ -0,0 +1,7 @@
+source "https://rubygems.org"
+
+group :development do
+  gem 'yard'
+end
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,21 @@
+PATH
+  remote: .
+  specs:
+    da_funk (0.4.4)
+      bundler (~> 1.7)
+      rake (~> 10.4)
+      yard (~> 0.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (10.4.2)
+    yard (0.8.7.6)
+
+PLATFORMS
+  ruby
+  x86-mingw32
+
+DEPENDENCIES
+  da_funk!
+  yard

data/README.md

@@ -0,0 +1,108 @@
+# DaFunk
+
+Walk Framework API, responsible for managed compatibility between implemented devices, and treat deprecated syntax or behaviour.
+
+## Setup
+
+1. Install Ruby 1.9.3 (mruby compatible)
+
+2. Bundle `$ bundle install`
+	
+	
+## Docs (yard)
+
+1. Generate: `$ rake yard`
+2. Open: `open docs/index.html`
+
+## How to
+
+### Steps
+
+1. Add da_funk as submodule `$ git submodule add git@github.com:cloudwalkio/da_funk.git <path/to/lib/da_funk>`
+
+2. Develop start method in platform abstraction.
+
+	Start method is responsible for start the runtime in our platform. And should require the da_funk lib(common lib between platforms).
+
+		class PlatformInterface
+		  	def self.start(file = "./main.mrb")
+			    begin
+					require "./da_funk.mrb"
+					require "./platform.mrb"
+					require file
+
+					app = Device::Support.path_to_class file
+
+					loop do
+						app.call
+					end
+			    rescue => @exception
+					puts "#{@exception.class}: #{@exception.message}"
+					puts "#{@exception.backtrace[0..2].join("\n")}"
+    				IO.getc
+					return nil
+				end
+			end
+		end
+		
+3. Develop interface required by DaFunk on PlatformInterface, could be the same file you have start method.
+
+		class PlatformInterface
+			Network = ::Network # Implemented on C
+			IO      = ::IO # Implemeted on C
+
+			class Display
+				def self.clear
+					::IO.display_clear
+				end
+				
+				def self.print_line(buf, row, column)
+					# <class created on C or PlatformInterface>._print_line(buf, row, column)
+					PlatformInterface._print_line(buf, row, column)
+				end
+			end
+		end
+
+4. Configure Adapter
+
+		class Device # Class from DaFunk
+			self.adapter = PlatformAbstraction
+		end
+
+5. Compile da_funk into mrb file `$ rake`.
+6. Compile platform abstraction into mrb file `$ mrbc -o platform.mrb </path/to/mrblib/**/*/.rb`
+7. Application file `main.rb`(could be use to test).
+
+		class Main
+			def self.call
+				Device::Display.print "Test"
+			end
+		end
+
+	Call method should be implemented on applications.
+
+
+### Adapter pattern
+Adapter(platform abstraction) should be configured to access by DaFunk Library
+
+- [Wiki](http://en.wikipedia.org/wiki/Adapter_pattern)
+- Scheme Image (todo)
+
+
+### Platform Interface
+
+- Be careful with instance object variable, let't for DaFunk.
+- Prefer class methods to call as interface.
+- Any method defined on platform language, access by PlatformAbstraction, should defined with _<method name>. # Revise this point
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+![DaFunk](imgs/daft-punk-da-funk.jpg)

data/README_GUIDE.md

@@ -0,0 +1,52 @@
+## Ruby Walk Framework
+
+Ruby Walk Framework is a entire new VM for the Walk Platform, in Ruby, a modern and powerful language.
+
+
+## Ruby Compatiblity
+Support for Ruby 1.9.3 and ISO/IEC 30170:2012, where specifies the syntax and semantics of the computer programming language Ruby, and the requirements for conforming Ruby processors, strictly conforming Ruby programs.
+
+## Devices
+#### D200
+Alpha support, System, Network, IO, Sockets, Transction::Iso, Transaction::Download and Magnectic Card.
+
+#### Browser
+Alpha support, System, Network, IO, Sockets, Transction::Iso, Transaction::Download.
+
+#### Verifone
+Comming soon.
+
+#### Ingenico
+Comming soon.
+
+## DaFunk API
+
+Project responsible for managed compatibility between implemented devices, and treat deprecated syntax or behaviour.
+
+## Getting Started
+
+### D200 Environmet
+
+#### Install PC Loader
+
+Found in PAX resources, is needed to upload the BIN and main.rb
+
+#### Upload Binary
+
+Upload as App/Script, download [here](https://dl.dropboxusercontent.com/u/436039/walk/pax/robot_rock-0.4.2.bin).
+
+#### Upload main.rb
+
+Upload as Para Files, download [here](https://dl.dropboxusercontent.com/u/436039/walk/pax/main.rb)
+
+### Guides/Samples
+
+1. [Input and Output](file.sample_input_output.html)
+2. [Network](file.sample_network_gprs.html)
+3. [Sockets](file.sample_sockt.html)
+4. [Transaction](file.sample_transaction.html)
+5. [Download File](file.sample_transaction_download_file.html)
+6. [Applications](file.sample_transaction_download_application.html)
+7. [Read Magnect Card](file.sample_read_magnect_card.html)
+8. [ISO8583 Message](file.sample_message_iso8583.html)
+9. [Download and parse parameter file](file.sample_transaction_download_parameter_file.html)

data/RELEASE_NOTES.md

@@ -0,0 +1,23 @@
+# DaFunk
+
+### 0.4.4 - 2015-03-27 - Gemspec summary and description.
+- Fix gemspec summary and description.
+
+### 0.4.3 - 2015-03-27 - Refactoring Display interface
+- Support resource configuration in DaFunk RakeTask.
+- Refactoring IO/Display and UI methods.
+
+### 0.4.1 - 2015-03-10  - Small fixes and notifications
+- Implement Serf protocol by serfx port.
+- Support CloudWalk Notifications.
+- Support to execute unit and integration tests.
+- Fix check ssl = "1" to start handshake.
+- Fix verify handshake return to fail handshake.
+- Fix download by SSL, check received packet to increment downloaded size. It is posible to SSL interface return hald of asked size in the midle of process.
+- Support to mruby and mrbc binary configuration at rake task creation.
+- Implement Helper.rjust/ljust.
+- Implement CommandLinePlatform to perform integration tests.
+- Implement Zip class to abstract zip/unzip operations.
+- Implement Magnetic class to abstract magnetic card read.
+
+### 0.3.2 - 2014-12-24 - First stable Version

data/Rakefile

@@ -0,0 +1,69 @@
+#!/usr/bin/env rake
+
+require 'rake/testtask'
+require 'bundler/setup'
+
+Bundler.require(:default)
+DA_FUNK_ROOT = File.dirname(File.expand_path(__FILE__))
+
+FileUtils.cd DA_FUNK_ROOT
+
+FILES = FileList[
+  "lib/da_funk.rb",
+  "lib/da_funk/test.rb",
+  "lib/device.rb",
+  "lib/device/audio.rb",
+  "lib/device/crypto.rb",
+  "lib/device/display.rb",
+  "lib/device/helper.rb",
+  "lib/device/io.rb",
+  "lib/device/network.rb",
+  "lib/device/params_dat.rb",
+  "lib/device/printer.rb",
+  "lib/device/runtime.rb",
+  "lib/device/setting.rb",
+  "lib/device/support.rb",
+  "lib/device/system.rb",
+  "lib/device/transaction/download.rb",
+  "lib/device/transaction/emv.rb",
+  "lib/device/version.rb",
+  "lib/device/walk.rb",
+  "lib/file_db.rb",
+  "lib/iso8583/bitmap.rb",
+  "lib/iso8583/codec.rb",
+  "lib/iso8583/exception.rb",
+  "lib/iso8583/field.rb",
+  "lib/iso8583/fields.rb",
+  "lib/iso8583/message.rb",
+  "lib/iso8583/util.rb",
+  "lib/iso8583/version.rb",
+  "lib/version.rb",
+  "lib/device/transaction/iso.rb",
+  "lib/serfx.rb",
+  "lib/serfx/commands.rb",
+  "lib/serfx/connection.rb",
+  "lib/serfx/response.rb",
+  "lib/serfx/exceptions.rb",
+  "lib/device/notification_event.rb",
+  "lib/device/notification_callback.rb",
+  "lib/device/notification.rb",
+  "lib/device/application.rb",
+  "lib/zip.rb",
+  "lib/device/magnetic.rb",
+  "lib/ext/kernel.rb"
+]
+
+DaFunk::RakeTask.new do |t|
+  t.main_out  = "./out/da_funk.mrb"
+  t.libs = FILES
+end
+
+desc "Generate YARD Documentation"
+task :yard do
+  Bundler.require(:default, :development)
+  sh "yard"
+end
+
+task "test:all"         => :build
+task "test:unit"        => :build
+task "test:integration" => :build

data/da_funk.gemspec

@@ -0,0 +1,31 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+tasks = File.expand_path('../tasks', __FILE__)
+$LOAD_PATH.unshift(tasks) unless $LOAD_PATH.include?(tasks)
+
+require 'version.rb'
+
+Gem::Specification.new do |spec|
+  spec.name          = "da_funk"
+  spec.version       = Device::API_VERSION
+  spec.authors       = ["Thiago Scalone"]
+  spec.email         = ["thiago@cloudwalk.io"]
+  spec.summary       = "MRuby Embedded System Framework"
+  spec.description   = "DaFunk is a Embedded System Framework optimized for programmer happiness and sustainable productivity. It encourages beautiful code by favoring convention over configuration."
+  spec.homepage      = "http://github.com/cloudwalkio/da_funk"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.extensions = ["ext/da_funk/extconf.rb"]
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 1.9.3'
+
+  spec.add_dependency "rake", "~> 10.4"
+  spec.add_dependency "bundler", "~> 1.7"
+  spec.add_dependency "yard", "~> 0.8"
+end

data/ext/da_funk/Makefile

@@ -0,0 +1,5 @@
+all:
+	    true
+
+install:
+	    true

data/ext/da_funk/extconf.rb

@@ -0,0 +1,8 @@
+require 'rake'
+require 'mkmf'
+
+rakefile = File.join(File.dirname(File.expand_path(__FILE__)), "..", "..", "Rakefile")
+
+if sh "bundle exec rake -f #{rakefile}"
+  $makefile_created = true
+end

data/guides/sample_input_output.rb

@@ -0,0 +1,14 @@
+module Guide
+  # Input Output Test
+  def test_input_output
+    # Behaviour similar as c ruby
+    # Device::IO.puts same as Kerne.puts(string, row=nil, column=nil)
+    # puts is like a print + "\n"
+    Device::IO.puts "Display at row 0 column 0", 0, 0
+    puts "Pressed any key: ", 1
+    # Wait for some key
+    key = Device::IO.getc
+    # Print key pressed
+    print "key Pressed #{key}"
+  end
+end

data/guides/sample_message_iso8583.rb

@@ -0,0 +1,14 @@
+module Guide
+  def test_message_iso
+    message = Device::Transaction::Iso.new
+    message.mti = 1110
+
+    message[2] = 474747474747
+    message["Processing Code"] = "123456"
+    pan = message["Primary Account Number (PAN)"]
+
+    puts message.pan
+    puts message.to_b
+    puts message.to_s
+  end
+end

data/guides/sample_network_gprs.rb

@@ -0,0 +1,26 @@
+module Guide
+  # Sample Device::Network
+  # Attach on GPRS
+  def test_sample_network_attach
+    # Initialize hardware with configurations
+    Device::Network.init(:gprs, apn: 'claro.com.br', user: 'claro.com.br', pass: 'claro.com.br')
+    # Start Attaching process
+    Device::Network.connect
+
+    # Attaching process is unblocking, for this sample let's wait until return something
+    iRet = 1
+    while(iRet == 1)
+      iRet = Device::Network.connected?
+    end
+  end
+
+  def test_sample_network_ping
+    test_sample_network_attach
+    Device::Network.ping("cloudwalk.io", 8000)
+  end
+
+  def test_sample_network_disconnect
+    test_sample_network_attach
+    puts "Disconnect #{Device::Network.disconnect}"
+  end
+end

data/guides/sample_read_magnect_card.rb

@@ -0,0 +1,8 @@
+module Guide
+  def test_read_magnect_card
+    puts "Pass Card..."
+    card =  Device::IO.read_card(5000)
+    puts "Track1 #{card[:track1]} Track2:#{card[:track2]} Track3:#{card[:track2]}" 
+  end
+end
+

data/guides/sample_socket.rb

@@ -0,0 +1,29 @@
+module Guide
+  # Sample Socket
+  # Create socket, same syntax as default ruby standard library
+  def test_sample_socket
+    # Call test_sample_network to attach on GPRS
+    test_sample_network_attach
+
+    # Create TCPSocket
+    tcp = TCPSocket.new('cloudwalk.io', 80)
+    # print TCPSocket object
+    puts tcp.inspect
+
+    # Send and Recv some data
+    puts tcp.send('303132', 0)
+    puts "Recv #{tcp.recv(10)} "
+    puts "Closed? #{tcp.closed?}"
+    puts "Close #{tcp.close} "
+    puts "Closed? #{tcp.closed?}"
+  end
+
+  def test_sample_walk_socket
+    # Call test_sample_network to attach on GPRS
+    test_sample_network_attach
+
+    # Specific Walk Socket to transact in CloudWalk structure
+    Device::Network.walk_socket
+  end
+end
+

data/guides/sample_transaction.rb

@@ -0,0 +1,23 @@
+module Guide
+  def test_transaction_data
+    # Open CloudWalk socket
+    socket = test_sample_walk_socket
+
+    # Send any data for registered server in that app
+    socket.send("data\n")
+
+    # Receive some data from server 
+    puts "Recv Registered Server for this app: #{socket.recv(10).unpack("H*")}"
+
+    socket.close
+    Device::Network.disconnect
+  end
+
+  def test_transaction_iso8583
+    # peding test sample
+  end
+
+  def test_transaction_emv
+    # peding test sample
+  end
+end

data/guides/sample_transaction_download_application.rb

@@ -0,0 +1,9 @@
+module Guide
+  def test_sample_transaction_download_application
+    tcp = test_sample_walk_socket
+    if Device::Transaction::Download.request_file("show.rb", "show.mrb")
+      load "show.mrb"
+    end
+  end
+end
+

data/guides/sample_transaction_download_file.rb

@@ -0,0 +1,6 @@
+module Guide
+  def test_transaction_download_file
+    test_sample_network_attach
+    Device::Transaction::Download.request_file("remote_image_path.jpg", "local_image_path.jpg")
+  end
+end

data/guides/sample_transaction_download_parameter_file.rb

@@ -0,0 +1,18 @@
+module Guide
+  def test_transaction_download_parameter_file
+    tcp = test_sample_walk_socket
+    if Device::Transaction::Download.request_param_file
+      file = FileDb.open("params.dat")
+      puts file.keys
+      file.apps_list
+    end
+  end
+
+  def test_transaction_download_and_parse_parameter_file
+    apps = test_transaction_download_parameter_file
+    apps.split(";").each do |line|
+      app = line.split(",")
+      puts "Name: #{app[0]}, Ruby File: #{app[1]} Aparece no menu: #{app[2]} CRC: #{app[3]}"
+    end
+  end
+end