odroid_lcd 0.0.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6006d3b5b173420c1df81e8498d1a68b182c7eef
+  data.tar.gz: 1904a72869fe8cae59bcb2e94409b9f4e1e07170
+SHA512:
+  metadata.gz: 7aba291d2ff468fcc8330544c08f36e103dac6d948bbfd6e6202db21cee80fe1d561c67ce94b15e1f9405ee831f0902972802d8afde4b35a24cb2cb60d2dfc57
+  data.tar.gz: 650d24ba418a37ae228ef35198c4ee3cf1a1f3ab0f3196295567929212318a6ddf939a9dd6bd0e466b49fa3a5159b7a794dd901a5f32a88f0be97691e8340a90

data/bin/odroid-lcd

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require 'odroid_lcd'
+
+cli = OdroidLCD::CLI.new
+cli.run(ARGV)

data/ext/odroid_lcd/extconf.rb

@@ -0,0 +1,7 @@
+require 'mkmf'
+
+have_library('pthread')
+have_library('wiringPi')
+have_library('wiringPiDev')
+
+create_makefile('odroid_lcd/odroid_lcd_hw')

data/ext/odroid_lcd/odroid_lcd_hw.c

@@ -0,0 +1,139 @@
+//------------------------------------------------------------------------------------------------------------
+// An LCD display wiringPi wrapper for the Hardkernel Odroid C2.
+//
+// Based on: https://dn.odroid.com/source_peripherals/16x2lcdio/example-lcd.c
+//------------------------------------------------------------------------------------------------------------
+
+#include "ruby.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <stdint.h>
+
+#include <unistd.h>
+#include <string.h>
+#include <time.h>
+
+#include <wiringPi.h>
+#include <wiringPiI2C.h>
+#include <wiringSerial.h>
+#include <lcd.h>
+
+
+//------------------------------------------------------------------------------------------------------------
+//
+// WiringPi LCD defines
+//
+//------------------------------------------------------------------------------------------------------------
+#define LCD_ROW             2   // 16 Char
+#define LCD_COL             16  // 2 Line
+#define LCD_BUS             4   // Interface 4 Bit mode
+
+#define PORT_LCD_RS     7
+#define PORT_LCD_E      0
+#define PORT_LCD_D4     2
+#define PORT_LCD_D5     3
+#define PORT_LCD_D6     1
+#define PORT_LCD_D7     4
+ 
+
+//-----------------
+// Odroidlcd.new
+//
+// Initialize the LCD screen.
+//-----------------
+static VALUE odlcd_init(VALUE self) {
+  VALUE lcd_handle;
+
+  // Initialize the LCD, raises a RuntimeError if we fail.
+  wiringPiSetup();
+  lcd_handle = rb_funcall(self, rb_intern("system_init"), 0);
+
+  // We store the wiringPi lcdHandle in an instance variable.
+  rb_iv_set(self, "@lcd_handle", lcd_handle);
+
+  return self;
+}
+
+static VALUE odlcd_max_column(VALUE self) {
+  return INT2FIX(LCD_COL);
+}
+
+static VALUE odlcd_max_row(VALUE self) {
+  return INT2FIX(LCD_ROW);
+}
+
+//---------------
+// Clear the lcd screen.
+//---------------
+static VALUE odlcd_clear(VALUE self) {
+  lcdClear(FIX2INT(rb_iv_get(self, "@lcd_handle")));
+  return Qnil;
+}
+
+//------------------
+// Update a character on the LCD screen
+//
+// lcd = Odroidlcd.new
+// lcd.set_character(0, 0, "A")
+//
+// Note that row must be lower than LCD_ROW and column must be lower than LCD_COL.
+// Raises a RuntimeError if the row or column is too large.
+//------------------
+static VALUE odlcd_set_character(VALUE self, VALUE row, VALUE column, VALUE character) {
+  int lcdHandle;
+
+  if (FIX2INT(row) >= LCD_ROW) {
+    rb_raise(rb_eRuntimeError, "Invalid row \"%i\", should be less than %i", FIX2INT(row), LCD_ROW);
+  }
+
+  if (FIX2INT(column) >= LCD_COL) {
+    rb_raise(rb_eRuntimeError, "Invalid column \"%i\", should be less than %i", FIX2INT(column), LCD_COL);
+  }
+
+  lcdHandle = FIX2INT(rb_iv_get(self, "@lcd_handle"));
+
+  lcdPosition(lcdHandle, FIX2INT(column), FIX2INT(row));
+  rb_iv_set(self, "@lcd_handle", INT2FIX(lcdHandle));
+
+  lcdPutchar(lcdHandle, NUM2CHR(character));
+  return Qnil;
+}
+
+//------------------------------------------------------------------------------------------------------------
+//
+// system init
+//
+//------------------------------------------------------------------------------------------------------------
+static VALUE odlcd_system_init(VALUE self) {
+    int lcdHandle = 0;
+
+    // LCD Init
+    lcdHandle = lcdInit (LCD_ROW, LCD_COL, LCD_BUS,
+                         PORT_LCD_RS, PORT_LCD_E,
+                         PORT_LCD_D4, PORT_LCD_D5, PORT_LCD_D6, PORT_LCD_D7, 0, 0, 0, 0);
+
+    if(lcdHandle < 0)   {
+        rb_raise(rb_eRuntimeError, "%s : lcdInit failed!\n", __func__);
+    }
+    return INT2FIX(lcdHandle);
+}
+
+//------------------------------------------------------------------------------------------------------------
+
+void Init_odroid_lcd_hw() {
+  VALUE mOdroidLCD;
+  VALUE cOdroidLCD_HW;
+
+  mOdroidLCD = rb_define_module("OdroidLCD");
+  cOdroidLCD_HW = rb_define_class_under(mOdroidLCD, "HW", rb_cObject);
+  rb_define_method(cOdroidLCD_HW, "initialize", odlcd_init, 0);
+  rb_define_method(cOdroidLCD_HW, "clear", odlcd_clear, 0);
+  rb_define_method(cOdroidLCD_HW, "max_column", odlcd_max_column, 0);
+  rb_define_method(cOdroidLCD_HW, "max_row", odlcd_max_row, 0);
+  rb_define_method(cOdroidLCD_HW, "set_character", odlcd_set_character, 3);
+  rb_define_private_method(cOdroidLCD_HW, "system_init", odlcd_system_init, 0);
+}
+
+//------------------------------------------------------------------------------------------------------------
+//------------------------------------------------------------------------------------------------------------

data/lib/odroid_lcd/cli.rb

@@ -0,0 +1,22 @@
+module OdroidLCD
+  class CLI
+
+    def initialize
+      @lcd = OdroidLCD::LCD.new
+    end
+
+    def run(argv)
+      string = argv[0]
+
+      rows = argv[0].lines
+      if rows.length > 1
+        @lcd.set_string(row: 0, string: rows[0].chomp)
+        @lcd.set_string(row: 1, string: rows[1].chomp)
+      else
+        @lcd.set_string(row: 0, string: rows[0].chomp)
+      end
+
+    end
+
+  end
+end

data/lib/odroid_lcd/hw.rb

@@ -0,0 +1,7 @@
+
+require 'odroid_lcd/odroid_lcd_hw'
+module OdroidLCD
+  class HW
+
+  end
+end

data/lib/odroid_lcd/lcd.rb

@@ -0,0 +1,31 @@
+
+module OdroidLCD
+  class LCD
+
+    attr_reader :max_column
+    attr_reader :max_row
+
+    def initialize(mocks: {})
+      @hw = mocks[:odroidlcd_hw] || OdroidLCD::HW.new
+      @max_column = @hw.max_column
+      @max_row = @hw.max_row
+      freeze()
+    end
+
+    def clear
+      @hw.clear
+    end
+
+    def set_character(row:, column:, character:)
+      @hw.set_character(row, column, character)
+    end
+
+    def set_string(row: 0, string:)
+      column = 0
+      string[0, @max_column].ljust(@max_column - 1).chars do |chr|
+        set_character(row: row, column: column, character: chr)
+        column += 1
+      end
+    end
+  end
+end

data/lib/odroid_lcd.rb

@@ -0,0 +1,8 @@
+
+require 'odroid_lcd/hw'
+require "odroid_lcd/lcd"
+require "odroid_lcd/cli"
+
+module OdroidLCD
+end
+

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: odroid_lcd
+version: !ruby/object:Gem::Version
+  version: 0.0.4
+platform: ruby
+authors:
+- Phil Helliwell
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-09-12 00:00:00.000000000 Z
+dependencies: []
+description: 'Allows writing strings to the LCD screen accessory, see: https://wiki.odroid.com/accessory/display/16x2_lcd_io_shield/c/start'
+email: phil.helliwell@gmail.com
+executables:
+- odroid-lcd
+extensions:
+- ext/odroid_lcd/extconf.rb
+extra_rdoc_files: []
+files:
+- bin/odroid-lcd
+- ext/odroid_lcd/extconf.rb
+- ext/odroid_lcd/odroid_lcd_hw.c
+- lib/odroid_lcd.rb
+- lib/odroid_lcd/cli.rb
+- lib/odroid_lcd/hw.rb
+- lib/odroid_lcd/lcd.rb
+homepage: http://github.com/kill9zombie/odroid_lcd
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - "~>"
+    - !ruby/object:Gem::Version
+      version: '2.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- 'WiringPi patched by Hardkernel, see: https://wiki.odroid.com/accessory/display/16x2_lcd_io_shield/c/start'
+rubyforge_project: 
+rubygems_version: 2.6.13
+signing_key: 
+specification_version: 4
+summary: LCD screen utils for the Hardkernel Odroid C2
+test_files: []