rubyduino 0.1.2 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e43dd1d4e9f5f4d9dbfda78f6954733999175a658f50b5d76186e6c51fc544
-  data.tar.gz: 62a7ba189c79f9741001a6724af58026c7870aaa9da5775dcf54c824afcf53d3
+  metadata.gz: 1ec4285a969c2afed1449f750c1674b63f1ba5cb5b454994cfdb9356173595cb
+  data.tar.gz: 8e1dba9b348672d0aa96f4eb7645242da1e111fa36595c1f601ab9a1fa45acdf
 SHA512:
-  metadata.gz: 9a83433f8069a0e13757f47666c6913307185d66f388eb014fa68bc54a9afd0117e4c7155bf2f8199ffa5a73c4e7de415096f8cdce2a0965f4679cd567cbf7a1
-  data.tar.gz: deb4d7cc643e4d93c172a525677fb7944fbc6fb2bab93fe2b48f7893ca2e0886153879fedd42ee7bf06605e4dc0ac5413cb16c767bd59a0ede37cde188dbf0c4
+  metadata.gz: 736ec9d0f9c5665ba2f88f647c36d0dcd1010a3e4d405d1a49a6032d1eaefaa60aecbd64a2d9e103796f9bf7443a8163370dc5951fdcd14bb589938452cc5ca7
+  data.tar.gz: 203d97b5aed491505f46e681d04aa4128dce2349ac93513d8cf307f1b8e96ddeaaa31478788c5f9aa919a028fe276cbab1b10a6c54466b69cf7ee17f2a1abc35

data/CHANGELOG.md

@@ -1,13 +1,19 @@
 ## [Unreleased]
 
-## [0.1.0] - 2026-05-08
+## [0.1.3] - 2026-05-08
 
-- Initial release
+- Add the built-in `ArduinoUNO` prelude with FFI-backed GPIO, analog read, and millisecond delay bindings
+- Replace the legacy `system("pin13:*")` sketch API with top-level helpers like `pin_mode`, `digital_write`, and `delay_ms`
+- Update the default hello example to use the new ArduinoUNO API
+
+## [0.1.2] - 2026-05-08
+
+- Update vendored Spinel revision
 
 ## [0.1.1] - 2026-05-08
 
 - Fix avrdude discovery for installed command
 
-## [0.1.2] - 2026-05-08
+## [0.1.0] - 2026-05-08
 
-- Update vendored Spinel revision
+- Initial release

data/README.md

@@ -1,6 +1,7 @@
 <div align="center">
 
-# Rubyduino
+# Rubyduino 
+[Experimental]
 
 <img width="250" height="250" alt="image copy" src="https://github.com/user-attachments/assets/156c7d41-ed42-43f3-a720-ed2e9c12b52c" />
 
@@ -15,14 +16,13 @@ Under the hood it uses [Spinel](https://github.com/matz/spinel), a Ruby AOT comp
 <img width="500" height="281" alt="IMG_0197" src="https://github.com/user-attachments/assets/d2b1cc69-647a-4f63-b090-31b13a21e5a8" />
 
 ```ruby
-system("pin13:output")
+pin_mode(ArduinoUNO::LED_BUILTIN, ArduinoUNO::OUTPUT)
 
 loop do
-  duration = 0.1
-  system("pin13:high")
-  sleep duration
-  system("pin13:low")
-  sleep duration
+  digital_write(ArduinoUNO::LED_BUILTIN, ArduinoUNO::HIGH)
+  delay_ms(100)
+  digital_write(ArduinoUNO::LED_BUILTIN, ArduinoUNO::LOW)
+  delay_ms(100)
 end
 ```
 

data/bin/rubyduino

@@ -98,6 +98,7 @@ rubyduino_dir = File.join(root_dir, "lib/rubyduino")
 parse_bin = File.join(spinel_dir, "spinel_parse")
 codegen_rb = File.join(rubyduino_dir, "spinel_arduino_codegen.rb")
 entry_c = File.join(rubyduino_dir, "arduino_entry.c")
+arduino_uno_rb = File.join(rubyduino_dir, "arduino_uno.rb")
 
 mcu = "atmega328p"
 f_cpu = "16000000UL"
@@ -137,6 +138,7 @@ abort "rubyduino: #{source}: No such file" unless File.file?(source)
 abort "rubyduino: missing Spinel checkout at #{spinel_dir}" unless Dir.exist?(spinel_dir)
 abort "rubyduino: missing #{codegen_rb}" unless File.file?(codegen_rb)
 abort "rubyduino: missing #{entry_c}" unless File.file?(entry_c)
+abort "rubyduino: missing #{arduino_uno_rb}" unless File.file?(arduino_uno_rb)
 abort "rubyduino: avr-gcc not found" unless command?("avr-gcc")
 abort "rubyduino: avr-objcopy not found" unless command?("avr-objcopy")
 
@@ -164,9 +166,11 @@ avrdude = find_avrdude
 abort "rubyduino: avrdude not found" unless avrdude
 
 ast_tmp = File.join(Dir.tmpdir, "spinel_arduino_ast.#{$PROCESS_ID}.#{rand(1_000_000)}")
+source_tmp = File.join(Dir.tmpdir, "rubyduino_source.#{$PROCESS_ID}.#{rand(1_000_000)}.rb")
 begin
   warn "Spinel: #{source} -> #{c_file}"
-  run!(parse_bin, source, ast_tmp)
+  File.write(source_tmp, "#{File.read(arduino_uno_rb)}\n#{File.read(source)}")
+  run!(parse_bin, source_tmp, ast_tmp)
   run!(RbConfig.ruby, codegen_rb, ast_tmp, c_file)
 
   warn "AVR: #{c_file} -> #{hex_file}"
@@ -183,4 +187,5 @@ begin
   run!(avrdude, *conf_args, "-p#{mcu}", "-carduino", "-P#{port}", "-b#{baud}", "-D", "-Uflash:w:#{hex_file}:i")
 ensure
   FileUtils.rm_f(ast_tmp)
+  FileUtils.rm_f(source_tmp)
 end

data/examples/hello.rb

@@ -1,9 +1,8 @@
-system("pin13:output")
+pin_mode(ArduinoUNO::LED_BUILTIN, ArduinoUNO::OUTPUT)
 
 loop do
-  duration = 0.1
-  system("pin13:high")
-  sleep duration
-  system("pin13:low")
-  sleep duration
+  digital_write(ArduinoUNO::LED_BUILTIN, ArduinoUNO::HIGH)
+  delay_ms(100)
+  digital_write(ArduinoUNO::LED_BUILTIN, ArduinoUNO::LOW)
+  delay_ms(100)
 end

data/lib/rubyduino/arduino_uno.rb

@@ -0,0 +1,43 @@
+module ArduinoUNO
+  LOW = 0
+  HIGH = 1
+
+  INPUT = 0
+  OUTPUT = 1
+  INPUT_PULLUP = 2
+
+  A0 = 14
+  A1 = 15
+  A2 = 16
+  A3 = 17
+  A4 = 18
+  A5 = 19
+
+  LED_BUILTIN = 13
+
+  ffi_func :pin_mode, [:uint8, :uint8], :int
+  ffi_func :digital_write, [:uint8, :uint8], :int
+  ffi_func :digital_read, [:uint8], :int
+  ffi_func :analog_read, [:uint8], :int
+  ffi_func :delay_ms, [:uint32], :void
+end
+
+def pin_mode(pin, mode)
+  ArduinoUNO.pin_mode(pin, mode)
+end
+
+def digital_write(pin, value)
+  ArduinoUNO.digital_write(pin, value)
+end
+
+def digital_read(pin)
+  ArduinoUNO.digital_read(pin)
+end
+
+def analog_read(pin)
+  ArduinoUNO.analog_read(pin)
+end
+
+def delay_ms(ms)
+  ArduinoUNO.delay_ms(ms)
+end

data/lib/rubyduino/sp_runtime.h

@@ -3,6 +3,7 @@
 
 #include <stdint.h>
 #include <stdlib.h>
+#include <string.h>
 #include <avr/io.h>
 #include <util/delay.h>
 #include <util/delay_basic.h>
@@ -46,6 +47,7 @@ static void sp_gc_mark(void *ptr) {
 
 typedef struct {
   mrb_int *data;
+  mrb_int start;
   mrb_int len;
   mrb_int cap;
 } sp_IntArray;
@@ -69,6 +71,7 @@ static sp_Range sp_range_new(mrb_int first, mrb_int last) {
 
 static sp_IntArray *sp_IntArray_new(void) {
   sp_IntArray *array = (sp_IntArray *)malloc(sizeof(sp_IntArray));
+  array->start = 0;
   array->len = 0;
   array->cap = 4;
   array->data = (mrb_int *)malloc(sizeof(mrb_int) * array->cap);
@@ -80,7 +83,7 @@ static void sp_IntArray_push(sp_IntArray *array, mrb_int value) {
     array->cap *= 2;
     array->data = (mrb_int *)realloc(array->data, sizeof(mrb_int) * array->cap);
   }
-  array->data[array->len] = value;
+  array->data[array->start + array->len] = value;
   array->len++;
 }
 
@@ -89,7 +92,7 @@ static mrb_int sp_IntArray_length(sp_IntArray *array) {
 }
 
 static mrb_int sp_IntArray_get(sp_IntArray *array, mrb_int index) {
-  return array->data[index];
+  return array->data[array->start + index];
 }
 
 static sp_FloatArray *sp_FloatArray_new(void) {
@@ -117,30 +120,140 @@ static mrb_float sp_FloatArray_get(sp_FloatArray *array, mrb_int index) {
   return array->data[index];
 }
 
-static int sp_streq(const char *a, const char *b) {
-  while (*a && *b && *a == *b) {
-    a++;
-    b++;
+static int rd_uno_valid_pin(uint8_t pin) {
+  return pin <= 19;
+}
+
+static volatile uint8_t *rd_uno_ddr(uint8_t pin) {
+  if (pin <= 7) {
+    return &DDRD;
   }
-  return *a == *b;
+  if (pin <= 13) {
+    return &DDRB;
+  }
+  if (pin <= 19) {
+    return &DDRC;
+  }
+  return NULL;
 }
 
-static int sp_arduino_system(const char *cmd) {
-  if (sp_streq(cmd, "pin13:output")) {
-    DDRB |= _BV(DDB5);
+static volatile uint8_t *rd_uno_port(uint8_t pin) {
+  if (pin <= 7) {
+    return &PORTD;
+  }
+  if (pin <= 13) {
+    return &PORTB;
+  }
+  if (pin <= 19) {
+    return &PORTC;
+  }
+  return NULL;
+}
+
+static volatile uint8_t *rd_uno_pin_reg(uint8_t pin) {
+  if (pin <= 7) {
+    return &PIND;
+  }
+  if (pin <= 13) {
+    return &PINB;
+  }
+  if (pin <= 19) {
+    return &PINC;
+  }
+  return NULL;
+}
+
+static uint8_t rd_uno_bit(uint8_t pin) {
+  if (pin <= 7) {
+    return pin;
+  }
+  if (pin <= 13) {
+    return pin - 8;
+  }
+  return pin - 14;
+}
+
+int pin_mode(uint8_t pin, uint8_t mode) {
+  volatile uint8_t *ddr = rd_uno_ddr(pin);
+  volatile uint8_t *port = rd_uno_port(pin);
+  uint8_t mask;
+
+  if (!ddr || !port) {
+    return 1;
+  }
+
+  mask = (uint8_t)(1 << rd_uno_bit(pin));
+
+  if (mode == 1) {
+    *ddr |= mask;
     return 0;
   }
-  if (sp_streq(cmd, "pin13:high")) {
-    PORTB |= _BV(PORTB5);
+
+  if (mode == 0) {
+    *ddr &= (uint8_t)~mask;
+    *port &= (uint8_t)~mask;
     return 0;
   }
-  if (sp_streq(cmd, "pin13:low")) {
-    PORTB &= (uint8_t)~_BV(PORTB5);
+
+  if (mode == 2) {
+    *ddr &= (uint8_t)~mask;
+    *port |= mask;
     return 0;
   }
+
   return 1;
 }
 
+int digital_write(uint8_t pin, uint8_t value) {
+  volatile uint8_t *port = rd_uno_port(pin);
+  uint8_t mask;
+
+  if (!port) {
+    return 1;
+  }
+
+  mask = (uint8_t)(1 << rd_uno_bit(pin));
+
+  if (value) {
+    *port |= mask;
+  } else {
+    *port &= (uint8_t)~mask;
+  }
+
+  return 0;
+}
+
+int digital_read(uint8_t pin) {
+  volatile uint8_t *reg = rd_uno_pin_reg(pin);
+
+  if (!reg) {
+    return -1;
+  }
+
+  return ((*reg & (uint8_t)(1 << rd_uno_bit(pin))) != 0) ? 1 : 0;
+}
+
+int analog_read(uint8_t pin) {
+  uint8_t channel = pin;
+
+  if (pin >= 14 && pin <= 19) {
+    channel = pin - 14;
+  }
+
+  if (channel > 5 || !rd_uno_valid_pin(pin)) {
+    return -1;
+  }
+
+  ADMUX = (uint8_t)((1 << REFS0) | channel);
+  ADCSRA = (uint8_t)((1 << ADEN) | (1 << ADPS2) | (1 << ADPS1) | (1 << ADPS0));
+  ADCSRA |= (uint8_t)(1 << ADSC);
+
+  while (ADCSRA & (uint8_t)(1 << ADSC)) {
+  }
+
+  return ADC;
+}
+
 static void sp_arduino_delay_ms(unsigned long ms) {
   while (ms > 0) {
     _delay_loop_2((uint16_t)(F_CPU / 4000UL));
@@ -148,12 +261,10 @@ static void sp_arduino_delay_ms(unsigned long ms) {
   }
 }
 
-static void sp_arduino_sleep_seconds(double seconds) {
-  sp_arduino_delay_ms((unsigned long)(seconds * 1000.0 + 0.5));
+void delay_ms(uint32_t ms) {
+  sp_arduino_delay_ms(ms);
 }
 
-#define system(cmd) sp_arduino_system(cmd)
-#define sleep(seconds) sp_arduino_delay_ms((unsigned long)((seconds) * 1000.0 + 0.5))
 #define fflush(stream) ((void)0)
 
 #endif

data/lib/rubyduino/spinel_arduino_codegen.rb

@@ -26,9 +26,6 @@ load_spinel_compiler
 module SpinelArduinoCodegen
   def compile_no_recv_call_expr(nid, mname)
     case mname
-    when "sleep"
-      compile_arduino_sleep(nid)
-      "0"
     when "rand"
       arduino_rand = compile_arduino_rand(nid)
       return arduino_rand if arduino_rand
@@ -41,21 +38,6 @@ module SpinelArduinoCodegen
 
   private
 
-  def compile_arduino_sleep(nid)
-    args_id = @nd_arguments[nid]
-    return if args_id < 0
-
-    arg_ids = get_args(args_id)
-    return if arg_ids.empty?
-
-    arg = arg_ids.first
-    if numeric_literal_node?(arg)
-      emit_arduino_delay_literal(numeric_literal_value(arg))
-    else
-      emit("  sp_arduino_sleep_seconds(" + compile_expr(arg) + ");")
-    end
-  end
-
   def compile_arduino_rand(nid)
     args_id = @nd_arguments[nid]
     return nil if args_id < 0
@@ -79,32 +61,9 @@ module SpinelArduinoCodegen
     "((mrb_int)(#{first} + (rand() % #{span})))"
   end
 
-  def emit_arduino_delay_literal(seconds)
-    ms = (seconds * 1000.0).round
-    parts = []
-    while ms >= 250
-      parts << "_delay_ms(250.0)"
-      ms -= 250
-    end
-    parts << "_delay_ms(#{ms}.0)" if ms > 0
-    emit("  " + parts.join("; ") + ";") unless parts.empty?
-  end
-
   def integer_literal_node?(nid)
     nid && nid >= 0 && @nd_type[nid] == "IntegerNode"
   end
-
-  def numeric_literal_node?(nid)
-    nid && nid >= 0 && %w[IntegerNode FloatNode].include?(@nd_type[nid])
-  end
-
-  def numeric_literal_value(nid)
-    if @nd_type[nid] == "IntegerNode"
-      @nd_value[nid].to_f
-    else
-      @nd_content[nid].to_f
-    end
-  end
 end
 
 Compiler.prepend(SpinelArduinoCodegen)

data/lib/rubyduino/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rubyduino
-  VERSION = "0.1.2"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rubyduino
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.3
 platform: ruby
 authors:
 - Joseph Schito
@@ -27,6 +27,7 @@ files:
 - examples/hello.rb
 - lib/rubyduino.rb
 - lib/rubyduino/arduino_entry.c
+- lib/rubyduino/arduino_uno.rb
 - lib/rubyduino/sp_runtime.h
 - lib/rubyduino/spinel.rb
 - lib/rubyduino/spinel_arduino_codegen.rb