rbbit 0.4.6

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 377a1d4c7fb6aeac90e9612e6567ee2ff51cd1a92cfa589857d2a65e8c46ef48
+  data.tar.gz: a723eb889d772a854436a5ba8980926baaab098181ec989fcfc22ffe8f0d61f8
+SHA512:
+  metadata.gz: 9654d0c5fc439ef5296b6078a80e0bd3a2bfa525c8c3857ec6a6f69651858cc39e5d8465c1066d29fd236cbc4337042822525dbdc0b1ecd74158b88dd4111e43
+  data.tar.gz: 19086d0ca0decc0bc7f1541f88beeb5def3421b1d1d9ea9aa5a98d0be1ae99ba2acc6083446f922aaeed27edaa641b0dd7774dc196b05464be48d436d54c4e74

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+/_doc/

data/Gemfile

@@ -0,0 +1,6 @@
+source "https://rubygems.org"
+
+git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }
+
+# Specify your gem's dependencies in rbbit.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 spoolkitamura
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+# rbbit (rb:-:bit)
+
+'rbbit' is a Class library and WebSocket server to use 'micro:bit'.
+
+## Requirements
+
+serialport ~> 1.3  
+em-websocket ~> 0.5  
+websocket-client-simple ~> 0.3  
+
+## Installation
+
+Install it yourself as:
+
+    $ gem install rbbit
+
+If you are using Windows, type following in addition to it:
+
+    $ gem uninstall eventmachine
+    $ gem   install eventmachine --platform ruby
+
+## Settings
+
+### [micro:bit]
+
+Connect the micro:bit to your PC with USB cable.  
+Then, save following file and drop to the micro:bit.  
+
+[microbit-rbbit_20201127_v1.5.hex](microbit/microbit-rbbit_20201127_v1.5.hex)    (for micro:bit v1.5)  
+[microbit-rbbit_20201127_v2.0.hex](microbit/microbit-rbbit_20201127_v2.0.hex)    (for micro:bit v2.0)  
+
+### [PC]
+
+To specify  the port name (MB_PORT),  
+find out the serial-port connected the micro:bit like as.  
+
+**Windows**
+
+    [windows] + [x] to open Device Manager
+
+Find a description like 'mbed Serial Port (`COM5`)'.  
+
+**macOS**
+
+    $ ls -l /dev/tty.*  
+
+Find a device like `/dev/tty.usbmodem14132`.  
+
+**Linux**
+
+    $ $ls -l /dev/serial/by-id/
+
+Find a device like `/dev/ttyACM1`.  
+
+
+## Usage
+
+### [as Class library]
+```ruby
+require 'rbbit'
+
+mb = Rbbit:Microbit.new("COM5")          # or "/dev/tty.usbmodem14132", "/dev/ttyACM1"
+mb.led_on
+mb.close(1000)
+```
+
+### [as WebSocket server]
+
+    $ rbbit COM5                             (Windows)
+    $ rbbit /dev/tty.usbmodem14132           (macOS)
+    $ rbbit /dev/ttyACM1                     (Linux)
+
+or
+
+    $ set MB_PORT=COM5                       (Windows)
+    $ export MB_PORT=/dev/tty.usbmodem14132  (macOS)
+    $ export MB_PORT=/dev/ttyACM1            (Linux)
+
+    $ rbbit
+
+
+## Documents
+
+https://spoolkitamura.github.io/rbbit/index.html
+
+## Samples
+
+https://spoolkitamura.github.io/rbbit/sample_web.html  
+https://spoolkitamura.github.io/rbbit/sample_console.html  
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "rbbit"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/exe/rbbit

@@ -0,0 +1,184 @@
+#!/usr/bin/env ruby
+
+require "rbbit"
+require 'optparse'
+require 'readline'
+
+#
+# Diagnosis
+#
+
+def diagnosis(mb)
+  STDOUT.sync = true
+  while input = Readline.readline("micro:bit> ", true)
+    inputs = input.split(' ')
+    case inputs[0]
+      when '?'
+        puts
+        puts "interactive commands"
+        puts "\n [LED]"
+        puts "   on   x y  ... turn on  the LED at (x, y) or whole  if omitt x, y"
+        puts "   off  x y  ... turn off the LED at (x, y) or whole  if omitt x, y"
+        puts "   turn x y  ... toggle   the LED at (x, y) or center if omitt x, y"
+        puts "   puts str  ... show string specified or 'Ruby!' if ommit str"
+        puts "   1         ... show LED's pattern 1"
+        puts "   2         ... show LED's pattern 2"
+        puts "   3         ... show LED's pattern 3"
+        puts "\n [Sound]"
+        puts "   play      ... play sound"
+        puts "\n [Sensor]"
+        puts "   scan      ... print values of 'x', 'y', 'z', 'pitch', 'roll', 'light', 'temp' for 10 seconds"
+        puts "\n [Button]"
+        puts "   button    ... print status of button-A and button-B for 10 seconds"
+        puts "\n [etc]"
+        puts "   port      ... print port"
+        puts "   reset     ... reset micro:bit"
+        puts "   exit      ... exit this script"
+        puts
+      when 'exit'
+        mb.close
+        break
+      when 'reset'
+        mb.reset
+      when 'port'
+        puts mb.port
+      when 'on'
+        x = y = nil
+        if inputs.length >= 3
+          x = inputs[1].to_i
+          y = inputs[2].to_i
+        end
+        mb.led_on(x, y)
+      when 'off'
+        x = y = nil
+        if inputs.length >= 3
+          x = inputs[1].to_i
+          y = inputs[2].to_i
+        end
+        mb.led_off(x, y)
+      when 'turn'
+        x = y = 2
+        if inputs.length >= 3
+          x = inputs[1].to_i
+          y = inputs[2].to_i
+        end
+        mb.led_turn(x, y)
+      when 'puts'
+        str = 'Ruby!'
+        if inputs.length >= 2
+          str = inputs[1]
+        end
+        mb.led_puts(str)
+      when '1'
+        mb.led_show(
+          [[1, 1, 1, 1, 1],
+           [0, 0, 0, 0, 0],
+           [1, 1, 1, 1, 1],
+           [0, 0, 0, 0, 0],
+           [1, 1, 1, 1, 1]]
+        )
+      when '2'
+        mb.led_show(
+          [[1, 1, 1, 1, 1],
+           [1, 1, 1, 1, 0],
+           [1, 1, 1, 0, 0],
+           [1, 1, 0, 0, 0],
+           [1, 0, 0, 0, 0]]
+        )
+      when '3'
+        mb.led_show(
+          [[1, 0, 1, 0, 1],
+           [0, 0, 1, 0, 1],
+           [1, 1, 1, 0, 1],
+           [0, 0, 0, 0, 1],
+           [1, 1, 1, 1, 1]]
+        )
+      when 'play'
+        mb.sound_volume = 48
+        mb.sound_tempo = 180
+        mb.sound_play(:C4, 1)     # do
+        mb.sound_play(:D4, 1)     # re
+        mb.sound_play(:E4, 1)     # mi
+        mb.sound_play(:F4, 1)     # fa
+        mb.sound_play(:G4, 1)     # so
+        mb.sound_play(:A4, 1)     # la
+        mb.sound_play(:B4, 1)     # si
+        mb.sound_play(:C5, 1)     # do
+        mb.sound_rest(2)
+        mb.sound_play(:C5, 0.5)   # do
+        mb.sound_play(:B4, 0.5)   # si
+        mb.sound_play(:A4, 0.5)   # la
+        mb.sound_play(:G4, 0.5)   # so
+        mb.sound_play(:F4, 0.5)   # fa
+        mb.sound_play(:E4, 0.5)   # mi
+        mb.sound_play(:D4, 0.5)   # re
+        mb.sound_play(:C4, 0.5)   # do
+        mb.sound_rest(2)
+      when 'scan'
+        20.times do
+          puts "x=%6d    y=%6d    z=%6d    pitch=%3d    roll=%3d    light=%3d    temp=%3d\n" % [mb.x, mb.y, mb.z, mb.p, mb.r, mb.l, mb.t]
+          Kernel.sleep 0.5
+        end
+      when 'button'
+        mb.on_press_a   { puts "[A] press!"   }
+        mb.on_press_b   { puts "[B] press!"   }
+        mb.on_release_a { puts "[A] release!" }
+        mb.on_release_b { puts "[B] release!" }
+        puts "Please press button"
+        500.times do
+          puts "[A] down"    if mb.button_down?(:a)
+          puts "[B] down"    if mb.button_down?(:b)
+            Kernel.sleep 0.02
+        end
+        mb.on_press_a   {}
+        mb.on_press_b   {}
+        mb.on_release_a {}
+        mb.on_release_b {}
+      else
+        puts 'Invalid'
+    end
+  end
+end
+
+
+
+# parse options
+usage = "Usage : #{$0} [-r] [-s ws_port] MB_PORT"
+options = {}
+begin
+  o = OptionParser.new do |o|
+    o.version = Rbbit::VERSION
+    o.banner = usage
+    o.summary_width = 16
+    o.summarize
+    o.on("-r",         "reset")
+    o.on("-s ws_port", "specify WebSocket server port (default: #{Rbbit::WS_PORT})")
+    o.parse!(ARGV, into: options)
+  end
+rescue => e
+  p e
+  exit
+end
+
+unless options.has_key?(:s)
+  options[:s] = :default
+else
+  options[:s] = options[:s].to_i
+end
+
+# parse arguments
+port = ARGV[0]
+unless port || ENV['MB_PORT'] 
+  puts usage
+else
+  mb = Rbbit::Microbit.new(port, options[:s])
+  if options[:r]
+    mb.reset
+    mb.close(1000)
+  else
+    print "conneted to #{mb.port}.  "
+    puts (options[:i] ? "('?' for help)" : "")
+    diagnosis(mb)
+  end
+end
+

data/lib/rbbit/version.rb

@@ -0,0 +1,3 @@
+module Rbbit
+  VERSION = "0.4.6"
+end