simpleble 0.0.1

data/lib/simpleble/characteristic.rb

@@ -0,0 +1,36 @@
+module SimpleBLE
+  class Characteristic
+    # Instance methods (implemented in C extension)
+    def uuid
+      # Returns the characteristic UUID
+    end
+
+    def capabilities
+      # Returns array of capability strings (read, write, notify, indicate, etc.)
+    end
+
+    def descriptors
+      # Returns array of descriptors for this characteristic
+    end
+
+    def can_read?
+      capabilities.include?('read')
+    end
+
+    def can_write?
+      capabilities.include?('write')
+    end
+
+    def can_write_without_response?
+      capabilities.include?('write-without-response')
+    end
+
+    def can_notify?
+      capabilities.include?('notify')
+    end
+
+    def can_indicate?
+      capabilities.include?('indicate')
+    end
+  end
+end

data/lib/simpleble/descriptor.rb

@@ -0,0 +1,8 @@
+module SimpleBLE
+  class Descriptor
+    # Instance methods (implemented in C extension)
+    def uuid
+      # Returns the descriptor UUID
+    end
+  end
+end

data/lib/simpleble/exceptions.rb

@@ -0,0 +1,25 @@
+module SimpleBLE
+  # Base exception for all SimpleBLE errors
+  class Error < StandardError; end
+
+  # Raised when a feature is not supported on the current platform
+  class NotSupportedError < Error; end
+
+  # Raised when Bluetooth is not available or disabled
+  class BluetoothNotAvailableError < Error; end
+
+  # Raised when attempting operations on disconnected peripherals
+  class NotConnectedError < Error; end
+
+  # Raised when connection to peripheral fails
+  class ConnectionError < Error; end
+
+  # Raised when scan operations fail
+  class ScanError < Error; end
+
+  # Raised when characteristic/service operations fail
+  class CharacteristicError < Error; end
+
+  # Raised when timeout occurs during operations
+  class TimeoutError < Error; end
+end

data/lib/simpleble/peripheral.rb

@@ -0,0 +1,64 @@
+module SimpleBLE
+  class Peripheral
+    # All core methods are implemented in the C extension.
+    # This Ruby file provides additional helper methods.
+    
+    # Returns the peripheral name (identifier with fallback to address)
+    def name
+      id = identifier
+      (id.nil? || id.empty?) ? address : id
+    end
+    
+    # Returns a summary string for the peripheral
+    def to_s
+      "#{name} (#{address})"
+    end
+    
+    # Convenience method for write operations - uses write_request by default
+    def write_characteristic(service_uuid, char_uuid, data)
+      write_characteristic_request(service_uuid, char_uuid, data)
+    end
+    
+    # Helper to get service by UUID
+    def service(uuid)
+      services.find { |s| s['uuid'] == uuid }
+    end
+    
+    # Helper to get characteristic by service and characteristic UUID
+    def characteristic(service_uuid, char_uuid)
+      svc = service(service_uuid)
+      return nil unless svc
+      svc['characteristics'].find { |c| c['uuid'] == char_uuid }
+    end
+    
+    # Helper to check if peripheral has data (not empty identifiers)
+    def has_data?
+      !identifier.nil? && !identifier.empty? && !address.nil? && !address.empty?
+    end
+    
+    # Format RSSI with units
+    def rssi_s
+      "#{rssi} dBm"
+    end
+    
+    # Format TX power with units
+    def tx_power_s
+      "#{tx_power} dBm"
+    end
+    
+    # Format MTU with units
+    def mtu_s
+      "#{mtu} bytes"
+    end
+    
+    # Human readable address type
+    def address_type_s
+      case address_type
+      when 0 then "Public"
+      when 1 then "Random" 
+      when 2 then "Unspecified"
+      else "Unknown (#{address_type})"
+      end
+    end
+  end
+end

data/lib/simpleble/service.rb

@@ -0,0 +1,16 @@
+module SimpleBLE
+  class Service
+    # Instance methods (implemented in C extension)
+    def uuid
+      # Returns the service UUID
+    end
+
+    def data
+      # Returns the service data
+    end
+
+    def characteristics
+      # Returns array of characteristics for this service
+    end
+  end
+end

data/lib/simpleble/version.rb

@@ -0,0 +1,3 @@
+module SimpleBLE
+  VERSION = '0.0.1'
+end

data/lib/simpleble.rb

@@ -0,0 +1,40 @@
+require_relative 'simpleble/version'
+require_relative 'simpleble/exceptions'
+
+# Load the native extension
+require_relative 'simpleble/simpleble'
+
+# Load Ruby wrapper classes
+require_relative 'simpleble/adapter'
+require_relative 'simpleble/peripheral'
+require_relative 'simpleble/service'
+require_relative 'simpleble/characteristic'
+require_relative 'simpleble/descriptor'
+
+# Ensure SimpleBLE is available at top level
+unless defined?(::SimpleBLE)
+  raise LoadError, "SimpleBLE C extension did not load properly"
+end
+
+# Module-level convenience methods
+module SimpleBLE
+  # Get all available Bluetooth adapters
+  def self.adapters
+    Adapter.get_adapters
+  end
+
+  # Check if Bluetooth is enabled
+  def self.bluetooth_enabled?
+    Adapter.bluetooth_enabled?
+  end
+
+  # Quick scan for peripherals using first available adapter
+  def self.scan(timeout_ms = 5000)
+    adapters = self.adapters
+    raise BluetoothNotAvailableError, "No Bluetooth adapters found" if adapters.empty?
+
+    adapter = adapters.first
+    adapter.scan_for(timeout_ms)
+    adapter.scan_results
+  end
+end