rubyboy 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f71c49ce8d91b143c346ea5ac3534d531faa1d7ed7fc886243ed77e9e76e31b7
-  data.tar.gz: c9211303e89f8d775fb8c083a0eb3ab97e2299e41722b6c461bfac0cc9ea94ac
+  metadata.gz: f641e78dedf235a5ac8bab34c18fbd624150e5e6c9df92a710d2bc458fab3d62
+  data.tar.gz: 7ab941409fcbec7b0eff98241231e002c249f84be16a19c28216e33f91ac14d2
 SHA512:
-  metadata.gz: 76374e3846dc6a917a0dda34b71f6c667155cd5458bbb70ab0fba1ae16a8e5482153808e4de64aa8670d958a69ec52625e5f41673a04780d2b063b35c1564606
-  data.tar.gz: a3354719d960846738a7cb9252afa1a86fa0c3a2a0d3529013808386ab8a5aaa4a08ebc132cefed02353e20c4193f96804620031a79b6ca324c1e01ed5b8f12f
+  metadata.gz: f220a9aeff3fa642f334c0248c4f155cf648c53a4bb132801e86a8008039f50d3cb9d3519af07b47e44f5aa2032419ba370e8ddcbb41ffebcb7937e8ed397b92
+  data.tar.gz: 63065e706e48de9fc26dcd9f7bb75332876374769db0914c54843c3f60aa1dd53a950fe0f33755539331e8f02b5b71cc0d4cf0bdca31421911d23911454a8108

data/.rubocop.yml

@@ -17,9 +17,15 @@ Metrics/AbcSize:
 Metrics/BlockNesting:
   Enabled: false
 
+Metrics/BlockLength:
+  Enabled: false
+
 Metrics/CyclomaticComplexity:
   Enabled: false
 
+Metrics/ParameterLists:
+  Enabled: false
+
 Metrics/PerceivedComplexity:
   Enabled: false
 
@@ -38,6 +44,9 @@ Style/Documentation:
 Style/FormatString:
   Enabled: false
 
+Style/MultipleComparison:
+  Enabled: false
+
 Style/NumericLiterals:
   Enabled: false
 

data/CHANGELOG.md

@@ -1,5 +1,20 @@
 ## [Unreleased]
 
+## [1.3.0] - 2024-03-09
+
+- Add ffi to dependencies
+- Add SDL2 wrapper
+- Add audio
+- Optimize cpu
+- Cache R/W methods
+
+## [1.2.0] - 2024-01-09
+
+- Add logo
+- Bump raylib-bindings version to 0.6.0
+- Optimizing
+- Remove unnecessary classes
+
 ## [1.1.0] - 2023-12-28
 
 - Add bench option

data/README.md

@@ -1,4 +1,8 @@
-# Rubyboy
+<br>
+<p align="center">
+  <img src="/resource/logo/logo.svg" width="480px">
+</p>
+<br>
 
 A Game Boy emulator written in Ruby
 

data/exe/rubyboy

@@ -6,7 +6,8 @@ require 'bench'
 
 arg = ARGV[0]
 
-puts "yjit: #{RubyVM::YJIT.enabled?}"
+puts "Ruby: #{RUBY_VERSION}"
+puts "YJIT: #{RubyVM::YJIT.enabled?}"
 
 if arg == 'bench'
   Rubyboy::Bench.new.bench

data/lib/rubyboy/apu.rb

@@ -0,0 +1,118 @@
+# frozen_string_literal: true
+
+require_relative 'audio'
+require_relative 'apu_channels/channel1'
+require_relative 'apu_channels/channel2'
+require_relative 'apu_channels/channel3'
+require_relative 'apu_channels/channel4'
+
+module Rubyboy
+  class Apu
+    def initialize
+      @audio = Audio.new
+      @nr50 = 0
+      @nr51 = 0
+      @cycles = 0
+      @sampling_cycles = 0
+      @fs = 0
+      @samples = Array.new(1024, 0.0)
+      @sample_idx = 0
+      @channel1 = ApuChannels::Channel1.new
+      @channel2 = ApuChannels::Channel2.new
+      @channel3 = ApuChannels::Channel3.new
+      @channel4 = ApuChannels::Channel4.new
+    end
+
+    def step(cycles)
+      @cycles += cycles
+      @sampling_cycles += cycles
+
+      @channel1.step(cycles)
+      @channel2.step(cycles)
+      @channel3.step(cycles)
+      @channel4.step(cycles)
+
+      if @cycles >= 0x1fff
+        @cycles -= 0x1fff
+
+        @channel1.step_fs(@fs)
+        @channel2.step_fs(@fs)
+        @channel3.step_fs(@fs)
+        @channel4.step_fs(@fs)
+
+        @fs = (@fs + 1) % 8
+      end
+
+      if @sampling_cycles >= 87
+        @sampling_cycles -= 87
+
+        left_sample = (
+          @nr51[7] * @channel4.dac_output +
+          @nr51[6] * @channel3.dac_output +
+          @nr51[5] * @channel2.dac_output +
+          @nr51[4] * @channel1.dac_output
+        ) / 4.0
+
+        right_sample = (
+          @nr51[3] * @channel4.dac_output +
+          @nr51[2] * @channel3.dac_output +
+          @nr51[1] * @channel2.dac_output +
+          @nr51[0] * @channel1.dac_output
+        ) / 4.0
+
+        raise "#{@nr51} #{@channel4.dac_output}, #{@channel3.dac_output}, #{@channel2.dac_output},#{@channel1.dac_output}" if left_sample.abs > 1.0 || right_sample.abs > 1.0
+
+        @samples[@sample_idx * 2] = (@nr50[4..6] / 7.0) * left_sample
+        @samples[@sample_idx * 2 + 1] = (@nr50[0..2] / 7.0) * right_sample
+        @sample_idx += 1
+      end
+
+      return if @sample_idx < 512
+
+      @sample_idx = 0
+      @audio.queue(@samples)
+    end
+
+    def read_byte(addr)
+      case addr
+      when 0xff10..0xff14 then @channel1.read_nr1x(addr - 0xff10)
+      when 0xff15..0xff19 then @channel2.read_nr2x(addr - 0xff15)
+      when 0xff1a..0xff1e then @channel3.read_nr3x(addr - 0xff1a)
+      when 0xff1f..0xff23 then @channel4.read_nr4x(addr - 0xff1f)
+      when 0xff24 then @nr50
+      when 0xff25 then @nr51
+      when 0xff26 then (@channel1.enabled ? 0x01 : 0x00) | (@channel2.enabled ? 0x02 : 0x00) | (@channel3.enabled ? 0x04 : 0x00) | (@channel4.enabled ? 0x08 : 0x00) | 0x70 | (@enabled ? 0x80 : 0x00)
+      when 0xff30..0xff3f then @channel3.wave_ram[(addr - 0xff30)]
+      else raise "Invalid APU read at #{addr.to_s(16)}"
+      end
+    end
+
+    def write_byte(addr, val)
+      return if !@enabled && ![0xff11, 0xff16, 0xff1b, 0xff20, 0xff26].include?(addr) && !(0xff30..0xff3f).include?(addr)
+
+      val &= 0x3f if !@enabled && [0xff11, 0xff16, 0xff1b, 0xff20].include?(addr)
+
+      case addr
+      when 0xff10..0xff14 then @channel1.write_nr1x(addr - 0xff10, val)
+      when 0xff15..0xff19 then @channel2.write_nr2x(addr - 0xff15, val)
+      when 0xff1a..0xff1e then @channel3.write_nr3x(addr - 0xff1a, val)
+      when 0xff1f..0xff23 then @channel4.write_nr4x(addr - 0xff1f, val)
+      when 0xff24 then @nr50 = val
+      when 0xff25 then @nr51 = val
+      when 0xff26
+        flg = val & 0x80 > 0
+        if !flg && @enabled
+          (0xff10..0xff25).each { |a| write_byte(a, 0) }
+        elsif flg && !@enabled
+          @fs = 0
+          @channel1.wave_duty_position = 0
+          @channel2.wave_duty_position = 0
+          @channel3.wave_duty_position = 0
+        end
+        @enabled = flg
+      when 0xff30..0xff3f then @channel3.wave_ram[(addr - 0xff30)] = val
+      else raise "Invalid APU write at #{addr.to_s(16)}"
+      end
+    end
+  end
+end

data/lib/rubyboy/apu_channels/channel1.rb

@@ -0,0 +1,154 @@
+# frozen_string_literal: true
+
+module Rubyboy
+  module ApuChannels
+    class Channel1
+      attr_accessor :enabled, :wave_duty_position
+
+      WAVE_DUTY = [
+        [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0], # 12.5%
+        [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 1.0], # 25%
+        [0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0], # 50%
+        [0.0, 0.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0]  # 75%
+      ].freeze
+
+      def initialize
+        @cycles = 0
+        @frequency = 0
+        @frequency_timer = 0
+        @wave_duty_position = 0
+
+        @enabled = false
+        @dac_enabled = false
+        @length_enabled = false
+        @is_upwards = false
+        @is_decrementing = false
+        @sweep_enabled = false
+        @sweep_period = 0
+        @sweep_shift = 0
+        @period = 0
+        @period_timer = 0
+        @current_volume = 0
+        @initial_volume = 0
+        @shadow_frequency = 0
+        @sweep_timer = 0
+        @length_timer = 0
+        @wave_duty_pattern = 0
+      end
+
+      def step(cycles)
+        @cycles += cycles
+
+        return if @cycles < @frequency_timer
+
+        @cycles -= @frequency_timer
+        @frequency_timer = (2048 - @frequency) * 4
+        @wave_duty_position = (@wave_duty_position + 1) % 8
+      end
+
+      def step_fs(fs)
+        length if fs & 0x01 == 0
+        envelope if fs == 7
+        sweep if fs == 2 || fs == 6
+      end
+
+      def length
+        return unless @length_enabled && @length_timer > 0
+
+        @length_timer -= 1
+        @enabled &= @length_timer > 0
+      end
+
+      def envelope
+        return if @period == 0
+
+        @period_timer -= 1 if @period_timer > 0
+
+        return if @period_timer != 0
+
+        @period_timer = @period
+
+        if @current_volume < 15 && @is_upwards
+          @current_volume += 1
+        elsif @current_volume > 0 && !@is_upwards
+          @current_volume -= 1
+        end
+      end
+
+      def sweep
+        @sweep_timer -= 1 if @sweep_timer > 0
+
+        return if @sweep_timer != 0
+
+        @sweep_timer = @sweep_period
+
+        return unless @sweep_enabled
+
+        @frequency = calculate_frequency
+        @shadow_frequency = @frequency
+      end
+
+      def calculate_frequency
+        if @is_decrementing
+          if @shadow_frequency >= (@shadow_frequency >> @sweep_shift)
+            @shadow_frequency - (@shadow_frequency >> @sweep_shift)
+          else
+            0
+          end
+        else
+          [0x3ff, @shadow_frequency + (@shadow_frequency >> @sweep_shift)].min
+        end
+      end
+
+      def dac_output
+        return 0.0 unless @dac_enabled && @enabled
+
+        ret = WAVE_DUTY[@wave_duty_pattern][@wave_duty_position] * @current_volume
+        (ret / 7.5) - 1.0
+      end
+
+      def read_nr1x(x)
+        case x
+        when 0 then (@sweep_period << 4) | @sweep_shift | (@is_decrementing ? 0x08 : 0x00) | 0x80
+        when 1 then (@wave_duty_pattern << 6) | 0x3f
+        when 2 then (@initial_volume << 4) | (@is_upwards ? 0x08 : 0x00) | @period
+        when 3 then 0xff
+        when 4 then (@length_enabled ? 0x40 : 0x00) | 0xbf
+        else 0xff
+        end
+      end
+
+      def write_nr1x(x, val)
+        case x
+        when 0
+          @sweep_period = (val >> 4) & 0x07
+          @is_decrementing = (val & 0x08) > 0
+          @sweep_shift = val & 0x07
+        when 1
+          @wave_duty_pattern = (val >> 6) & 0x03
+          @length_timer = 64 - (val & 0x3f)
+        when 2
+          @is_upwards = (val & 0x08) > 0
+          @initial_volume = (val >> 4)
+          @period = val & 0x07
+          @dac_enabled = val & 0xf8 > 0
+          @enabled &= @dac_enabled
+        when 3
+          @frequency = (@frequency & 0x700) | val
+        when 4
+          @frequency = (@frequency & 0xff) | ((val & 0x07) << 8)
+          @length_enabled = (val & 0x40) > 0
+          @length_timer = 64 if @length_timer == 0
+          return unless (val & 0x80) > 0 && @dac_enabled
+
+          @enabled = true
+          @period_timer = @period
+          @current_volume = @initial_volume
+          @shadow_frequency = @frequency
+          @sweep_timer = @sweep_period
+          @sweep_enabled = @sweep_period > 0 || @sweep_shift > 0
+        end
+      end
+    end
+  end
+end

data/lib/rubyboy/apu_channels/channel2.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+module Rubyboy
+  module ApuChannels
+    class Channel2
+      attr_accessor :enabled, :wave_duty_position
+
+      WAVE_DUTY = [
+        [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0], # 12.5%
+        [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 1.0], # 25%
+        [0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0], # 50%
+        [0.0, 0.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0]  # 75%
+      ].freeze
+
+      def initialize
+        @cycles = 0
+        @frequency = 0
+        @frequency_timer = 0
+        @wave_duty_position = 0
+
+        @enabled = false
+        @dac_enabled = false
+        @length_enabled = false
+        @is_upwards = false
+        @is_decrementing = false
+        @period = 0
+        @period_timer = 0
+        @current_volume = 0
+        @initial_volume = 0
+        @shadow_frequency = 0
+        @length_timer = 0
+        @wave_duty_pattern = 0
+      end
+
+      def step(cycles)
+        @cycles += cycles
+
+        return if @cycles < @frequency_timer
+
+        @cycles -= @frequency_timer
+        @frequency_timer = (2048 - @frequency) * 4
+        @wave_duty_position = (@wave_duty_position + 1) % 8
+      end
+
+      def step_fs(fs)
+        length if fs & 0x01 == 0
+        envelope if fs == 7
+      end
+
+      def length
+        return unless @length_enabled && @length_timer > 0
+
+        @length_timer -= 1
+        @enabled &= @length_timer > 0
+      end
+
+      def envelope
+        return if @period == 0
+
+        @period_timer -= 1 if @period_timer > 0
+
+        return if @period_timer != 0
+
+        @period_timer = @period
+
+        if @current_volume < 15 && @is_upwards
+          @current_volume += 1
+        elsif @current_volume > 0 && !@is_upwards
+          @current_volume -= 1
+        end
+      end
+
+      def dac_output
+        return 0.0 unless @dac_enabled && @enabled
+
+        ret = WAVE_DUTY[@wave_duty_pattern][@wave_duty_position] * @current_volume
+        (ret / 7.5) - 1.0
+      end
+
+      def read_nr2x(x)
+        case x
+        when 1 then (@wave_duty_pattern << 6) | 0x3f
+        when 2 then (@initial_volume << 4) | (@is_upwards ? 0x08 : 0x00) | @period
+        when 3 then 0xff
+        when 4 then (@length_enabled ? 0x40 : 0x00) | 0xbf
+        else 0xff
+        end
+      end
+
+      def write_nr2x(x, val)
+        case x
+        when 1
+          @wave_duty_pattern = (val >> 6) & 0x03
+          @length_timer = 64 - (val & 0x3f)
+        when 2
+          @is_upwards = (val & 0x08) > 0
+          @initial_volume = (val >> 4)
+          @period = val & 0x07
+          @dac_enabled = val & 0xf8 > 0
+          @enabled &= @dac_enabled
+        when 3
+          @frequency = (@frequency & 0x700) | val
+        when 4
+          @frequency = (@frequency & 0xff) | ((val & 0x07) << 8)
+          @length_enabled = (val & 0x40) > 0
+          @length_timer = 64 if @length_timer == 0
+          return unless (val & 0x80) > 0 && @dac_enabled
+
+          @enabled = true
+          @period_timer = @period
+          @current_volume = @initial_volume
+        end
+      end
+    end
+  end
+end

data/lib/rubyboy/apu_channels/channel3.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+module Rubyboy
+  module ApuChannels
+    class Channel3
+      attr_accessor :enabled, :wave_duty_position, :wave_ram
+
+      WAVE_DUTY = [
+        [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0], # 12.5%
+        [0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 1.0], # 25%
+        [0.0, 0.0, 0.0, 0.0, 1.0, 1.0, 1.0, 1.0], # 50%
+        [0.0, 0.0, 1.0, 1.0, 1.0, 1.0, 1.0, 1.0]  # 75%
+      ].freeze
+
+      def initialize
+        @cycles = 0
+        @frequency = 0
+        @frequency_timer = 0
+        @wave_duty_position = 0
+
+        @enabled = false
+        @dac_enabled = false
+        @length_enabled = false
+        @is_upwards = false
+        @is_decrementing = false
+        @sweep_enabled = false
+        @sweep_period = 0
+        @sweep_shift = 0
+        @period = 0
+        @period_timer = 0
+        @current_volume = 0
+        @initial_volume = 0
+        @shadow_frequency = 0
+        @sweep_timer = 0
+        @length_timer = 0
+        @wave_duty_pattern = 0
+
+        @output_level = 0
+        @volume_shift = 0
+        @wave_ram = Array.new(16, 0)
+      end
+
+      def step(cycles)
+        @cycles += cycles
+
+        return if @cycles < @frequency_timer
+
+        @cycles -= @frequency_timer
+        @frequency_timer = (2048 - @frequency) * 2
+        @wave_duty_position = (@wave_duty_position + 1) % 32
+      end
+
+      def step_fs(fs)
+        length if fs & 0x01 == 0
+      end
+
+      def length
+        return unless @length_enabled && @length_timer > 0
+
+        @length_timer -= 1
+        @enabled &= @length_timer > 0
+      end
+
+      def calculate_frequency
+        if @is_decrementing
+          if @shadow_frequency >= (@shadow_frequency >> @sweep_shift)
+            @shadow_frequency - (@shadow_frequency >> @sweep_shift)
+          else
+            0
+          end
+        else
+          [0x3ff, @shadow_frequency + (@shadow_frequency >> @sweep_shift)].min
+        end
+      end
+
+      def dac_output
+        return 0.0 unless @dac_enabled && @enabled
+
+        ret = ((0xf & (
+          @wave_ram[@wave_duty_position >> 1] >> ((@wave_duty_position & 0x01) << 2)
+        ))) >> @volume_shift
+
+        (ret / 7.5) - 1.0
+      end
+
+      def read_nr3x(x)
+        case x
+        when 0 then ((@dac_enabled ? 0x80 : 0x00) | 0x7f)
+        when 1 then 0xff
+        when 2 then (@output_level << 5) | 0x9f
+        when 3 then 0xff
+        when 4 then (@length_enabled ? 0x40 : 0x00) | 0xbf
+        else 0xff
+        end
+      end
+
+      def write_nr3x(x, val)
+        case x
+        when 0
+          @dac_enabled = val & 0x80 > 0
+          @enabled &= @dac_enabled
+        when 1
+          @length_timer = 256 - val
+        when 2
+          @output_level = (val >> 5) & 0x03
+        when 3
+          @frequency = (@frequency & 0x700) | val
+        when 4
+          @frequency = (@frequency & 0xff) | ((val & 0x07) << 8)
+          @length_enabled = val & 0x40 > 0
+          @length_timer = 256 if @length_timer == 0
+          @enabled = true if (val & 0x80) > 0 && @dac_enabled
+        end
+      end
+    end
+  end
+end