rpremote 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 900c268660317e50ca480983f9993698adb35ab699a82d3e0539dfb583e03723
-  data.tar.gz: 5e506856f83d7a48f91481cb0ef377df70d4e6f348e922d3412d068c5012fa15
+  metadata.gz: 4eb2ee018d6af469de77f435dd2a7d7021ae6e017d078655d5a7ca06e0735ac7
+  data.tar.gz: 547f6b9d2c98deab27f1a67b9b37bd375a2c0bbfbb55e7f1a1faca156de67ada
 SHA512:
-  metadata.gz: 7fe7454fe617b0a31004b17ca7e38c681711e90d4bb7889a801092fad8089246e7a1a93d89ff48058a320d60488bd825400b0bfded5380bd8f77d5bde8bded45
-  data.tar.gz: cd79792554f9174f2c416794f5973a3e5090f9494ea54ce22ca96bd21cbb72ef1dda7188b78eb9d5939f3dc44b8fcbd003bac772d41e7b13c24436bc9315f034
+  metadata.gz: c732178d037299500ee01e6a9ba0dfbe3836372e543be0db1a2e156586043f153a8fdf45f47d435390996b9a840e399a3140c65e3159d16ca9302018308003a4
+  data.tar.gz: fcca0bbaf3d04fd352fcd9ec00dbf08217c77dd23f2228cdfb17940d094d0c815d4bef14320d24641abb30a8dd6cdd8ce32858146bb3866f6e45f03d3f1f0089

data/CHANGELOG.md

@@ -1,6 +1,18 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+Notable changes to the `rpremote` RubyGem will be documented in this file. Repository-level examples, local mrbgems, and support files are documented in the [repository changelog](../../CHANGELOG.md).
+
+## Unreleased
+
+## 0.5.0 - 2026-09-12
+
+- Make `deploy PATH` flash the existing UF2 by default, and add `deploy PATH --build` for the previous build-and-deploy workflow.
+- Keep the RP2350 PWM clock running during scheduler sleep after PWM initialization, preventing buzzer and other PWM output from pausing between scheduler ticks on PicoRuby 4.0.3.
+- Add `auto_require: false` to `Mrbgems` entries so a gem can remain embedded in firmware without being prepended to every `run`, `exec`, and `deploy` source.
+
+## 0.4.0 - 2026-08-31
+
+- Check R2P2 filesystem connectivity before non-recursive `fs cp` transfers, and report Shell synchronization timeouts as filesystem connection failures.
 
 ## 0.3.0 - 2026-08-28
 
@@ -15,13 +27,11 @@ All notable changes to this project will be documented in this file.
 - Read mrbgem `require_name` values from `Mrbgems.lock` and automatically prepend the corresponding `require` calls to `run`, `exec`, and `deploy`; allow `Mrbgems` entries to specify `require:` explicitly.
 - Change `flash` to accept an explicit UF2 only through `--firmware FILE`; positional UF2 arguments are no longer supported.
 - Improve RP2350 BOOTSEL flashing on macOS by accepting the expected `ENXIO` volume-detach race after a successful copy.
-- Add PicoRuby mrbgem examples for BMI270, HC-SR04 temperature, MAX30102, MPU6050, and WS2812 SPI, plus oximeter and Processing project examples.
 
 ## 0.2.0 - 2026-08-26
 
 - Make `run` and `exec` exit nonzero when compatible R2P2 firmware reports a Ruby exception, while preserving real-time program output.
 - Increase the default command timeout from 10 to 20 seconds.
-- Add a bilingual education example for practical PicoModem DFU application updates, startup confirmation, and A/B-slot rollback.
 
 ## 0.1.0 - 2026-08-24
 
@@ -31,7 +41,7 @@ All notable changes to this project will be documented in this file.
 - Add PicoModem DFU staging, status, compatible bytecode compilation, and A/B-slot rollback support for Ruby and `.mrb` applications.
 - Add binary-safe file transfer and remote filesystem commands, plus `run`, `exec`, `monitor`, `repl`, and reset with reconnect waiting.
 - Add macOS R2P2 serial-port detection for Raspberry Pi Pico 2 and Pico 2 W.
-- Add bilingual repository, package, configuration, firmware, mrbgem, DFU, and electronic-craft example documentation.
+- Add bilingual package, configuration, firmware, mrbgem, and DFU documentation.
 - Add RBS signatures, automated tests, macOS CI, and release validation with isolated gem installation and CLI smoke testing.
 
 ### Limitations

data/README.ja.md

@@ -32,10 +32,11 @@ rpremote run main.rb
 
 `setup`はRaspberry Pi公式のリセット用`nuke_universal.uf2`も`firmware/`へダウンロードします。
 
-再利用するRubyコードを`lib/NAME`へ置くプロジェクトでは、`deploy`がファームウェアをビルドして書き込み、そのディレクトリをR2P2へコピーしてからエントリーファイルを実行します。
+再利用するRubyコードを`lib/NAME`へ置くプロジェクトでは、`deploy`が既存ファームウェアを書き込み、そのディレクトリをR2P2へコピーしてからエントリーファイルを一時実行します。`--build`を付けると、同じ処理の前にファームウェアをビルドします。
 
 ```sh
 rpremote deploy path/to/project
+rpremote deploy path/to/project --build
 ```
 
 既定では`firmware/picoruby-4.0.3/`にソースを準備し、`firmware/picoruby-4.0.3-pico2.uf2`を生成します。対象ボードを明示する必要がある場合は、`rpremote ports`でR2P2のCDC 0ポートを確認してください。
@@ -60,6 +61,8 @@ rpremote build
 
 `Mrbgems.lock`はGitHubのコミットとローカルgemの内容ハッシュを固定します。`build`は既存のlockを再利用し、`rpremote mrbgems update`だけが新しいコミットを解決します。
 
+ファームウェアへ組み込む一方で、すべての`run`、`exec`、`deploy`に先行ロードしないgemには`auto_require: false`を指定できます。アプリケーション側から必要なgemを明示的に`require`してください。
+
 ## 対象を選択する
 
 ```sh
@@ -78,7 +81,8 @@ rpremote flash --language picoruby --language-version 3.4.2 --board pico2 --moun
 | `rpremote build` | mrbgemを含むカスタムUF2をビルドします。 |
 | `rpremote build clean` | 中間ビルドファイルを削除します。 |
 | `rpremote bootsel` | 実行中のR2P2へBOOTSEL移行を要求し、USBボリュームの出現を待ちます。 |
-| `rpremote deploy PATH` | ファームウェアをビルドして書き込み、存在する場合は`PATH/lib/NAME`を`:/lib/NAME`へコピーしてから`PATH/main.rb`を実行します。ハードウェア出力は次のコマンドまで維持されます。 |
+| `rpremote deploy PATH` | 既存ファームウェアを書き込み、存在する場合は`PATH/lib/NAME`を`:/lib/NAME`へコピーしてから`PATH/main.rb`を一時実行します。ハードウェア出力は次のコマンドまで維持されます。 |
+| `rpremote deploy PATH --build` | ファームウェアをビルドして書き込んだ後、同じコピーと一時実行を行います。 |
 | `rpremote dfu app FILE` | PicoModem DFUでRubyまたは版を照合したバイトコードのアプリを更新します。 |
 | `rpremote dfu compile FILE` | DFU用にPicoRuby版と一致する`.mrb`を生成します。 |
 | `rpremote dfu status` | DFUのアクティブおよび起動候補スロットを表示します。 |
@@ -108,7 +112,7 @@ rpremote dfu app --help
 ## 操作モデル
 
 - `run`と`exec`はRubyコードを一時的に転送・実行して出力を表示し、一時リモートファイルを削除します。対応するR2P2ファームウェアがRuby例外を報告した場合は、非0で終了します。
-- `deploy PATH`はファームウェアをビルドし、BOOTSELへ移行して書き込んだ後、R2P2 Shellの起動完了を待ちます。存在する場合は`PATH/lib/NAME`を`:/lib/NAME`へコピーし、実行直前に読み込んだ`PATH/main.rb`を実行します。Shellジョブを保持するため、ハードウェア出力は次のコマンドまで維持されます。正常終了と出力バイト数を表示し、R2P2のRuby例外はコマンド失敗として扱います。ライブラリディレクトリがない場合、コピー処理はスキップします。PicoRuby 4系のファームウェアが必要です。
+- `deploy PATH`はBOOTSELへ移行して既存の選択済みファームウェアを書き込んだ後、R2P2 Shellの起動完了を待ちます。存在する場合は`PATH/lib/NAME`を`:/lib/NAME`へコピーし、実行直前に読み込んだ`PATH/main.rb`を一時実行します。`deploy PATH --build`は同じ処理の前にファームウェアをビルドします。Shellジョブを保持するため、ハードウェア出力は次のコマンドまで維持されます。正常終了と出力バイト数を表示し、R2P2のRuby例外はコマンド失敗として扱います。ライブラリディレクトリがない場合、コピー処理はスキップします。PicoRuby 4系のファームウェアが必要です。
 - `flash`はUF2をRP2350 BOOTSELボリュームへコピーし、永続的なR2P2ファームウェアを置き換えます。
 - `dfu app`はRubyソースまたは対応するバイトコードのアプリを非アクティブDFUスロットへ登録します。R2P2を再起動して試行し、正常に起動したアプリは`DFU.confirm`を呼び出します。
 - `dfu remove`はDFUのA/B両アプリスロットを完全に空にします。RAM上ですでに動作しているアプリは`rpremote reset`を実行するまで継続するため、起動アプリのログを混ぜずに`rpremote run`を使う場合は両方のコマンドを実行します。その他の`/home`ファイルとR2P2ファームウェアは削除しません。

data/README.md

@@ -32,10 +32,11 @@ rpremote run main.rb
 
 `setup` also downloads the official Raspberry Pi `nuke_universal.uf2` reset firmware into `firmware/`.
 
-For a project that stores reusable Ruby code in `lib/NAME`, `deploy` builds and flashes the firmware, copies that directory to R2P2, and then runs its entry file:
+For a project that stores reusable Ruby code in `lib/NAME`, `deploy` flashes the existing firmware, copies that directory to R2P2, and then temporarily runs its entry file. Add `--build` to build the firmware first:
 
 ```sh
 rpremote deploy path/to/project
+rpremote deploy path/to/project --build
 ```
 
 The defaults prepare `firmware/picoruby-4.0.3/` and create `firmware/picoruby-4.0.3-pico2.uf2`. Use `rpremote ports` to locate the R2P2 CDC 0 port when a board must be selected explicitly.
@@ -60,6 +61,8 @@ rpremote build
 
 `Mrbgems.lock` pins GitHub commits and hashes local gem contents. Existing locks are reused by `build`; `rpremote mrbgems update` deliberately resolves new commits.
 
+Set `auto_require: false` for a gem that should remain embedded in firmware without being loaded before every `run`, `exec`, or `deploy`. Require that gem explicitly from the application when needed.
+
 ## Select a target
 
 ```sh
@@ -78,7 +81,8 @@ Command-line options override `config/setting.json`. PicoRuby is implemented tod
 | `rpremote build` | Build a custom UF2 with project mrbgems. |
 | `rpremote build clean` | Remove intermediate build files. |
 | `rpremote bootsel` | Ask the running R2P2 firmware to enter BOOTSEL and wait for its USB volume. |
-| `rpremote deploy PATH` | Build and flash firmware, copy `PATH/lib/NAME` to `:/lib/NAME` when present, then run `PATH/main.rb` while preserving its hardware output until the next command. |
+| `rpremote deploy PATH` | Flash existing firmware, copy `PATH/lib/NAME` to `:/lib/NAME` when present, then temporarily run `PATH/main.rb` while preserving its hardware output until the next command. |
+| `rpremote deploy PATH --build` | Build and flash firmware, then perform the same copy and temporary run workflow. |
 | `rpremote dfu app FILE` | Stage a Ruby or version-checked bytecode app through PicoModem DFU. |
 | `rpremote dfu compile FILE` | Compile `.rb` to matching PicoRuby bytecode for DFU. |
 | `rpremote dfu status` | Show the active and candidate DFU slots. |
@@ -109,7 +113,7 @@ UF2 files built with `rpremote build` from the [GitHub repository](https://githu
 ## Operation model
 
 - `run` and `exec` upload Ruby code temporarily, relay output, then remove the temporary remote file. A Ruby exception reported by compatible R2P2 firmware makes the command exit nonzero.
-- `deploy PATH` builds the selected firmware, enters BOOTSEL, flashes it, waits until the R2P2 Shell is ready, copies `PATH/lib/NAME` to `:/lib/NAME` when present, then runs the current contents of `PATH/main.rb`. Its Shell job is retained so hardware output remains active until the next command. It reports successful completion and the output byte count; an R2P2 Ruby exception remains a command failure. If the library directory is absent, the copy step is skipped. It requires PicoRuby 4.x firmware.
+- `deploy PATH` enters BOOTSEL, flashes the existing selected firmware, waits until the R2P2 Shell is ready, copies `PATH/lib/NAME` to `:/lib/NAME` when present, then temporarily runs the current contents of `PATH/main.rb`. `deploy PATH --build` builds that firmware before the same workflow. The Shell job is retained so hardware output remains active until the next command. It reports successful completion and the output byte count; an R2P2 Ruby exception remains a command failure. If the library directory is absent, the copy step is skipped. It requires PicoRuby 4.x firmware.
 - `flash` copies a UF2 to the RP2350 BOOTSEL volume and replaces persistent R2P2 firmware.
 - `dfu app` stages a Ruby source or matching bytecode app in the inactive DFU slot. Restart R2P2 to try it; a successful app must call `DFU.confirm`.
 - `dfu remove` permanently clears both DFU A/B application slots. The application already loaded in RAM continues until you run `rpremote reset`; use both commands before `rpremote run` when boot-app output would be unwanted. It does not remove other `/home` files or R2P2 firmware.

data/RELEASING.md

@@ -5,9 +5,10 @@ This checklist prepares and publishes one immutable gem version. Run every comma
 ## 1. Prepare the version
 
 1. Update `Rpremote::VERSION` in `lib/rpremote/version.rb`.
-2. Add the same version and release date to `CHANGELOG.md`.
-3. Commit all intended files and verify that `git status --short` is empty.
-4. Run the non-publishing release check:
+2. Replace `Unreleased` in the package `CHANGELOG.md` with the same version and release date, then add a new empty `Unreleased` section.
+3. If repository-level examples, local mrbgems, or support files changed, finalize the corresponding `Unreleased` section in `../../CHANGELOG.md` with the same release version and date, then add a new empty `Unreleased` section.
+4. Commit all intended files and verify that `git status --short` is empty.
+5. Run the non-publishing release check:
 
 ```sh
 bundle exec rake release:check
@@ -48,7 +49,7 @@ bundle exec rake release
 After the tag exists on GitHub, create a GitHub Release and attach the exact gem that passed validation. `--verify-tag` prevents GitHub CLI from silently creating a tag at another commit:
 
 ```sh
-gh release create v0.3.0 rpremote-0.3.0.gem --verify-tag --generate-notes
+gh release create v0.5.0 rpremote-0.5.0.gem --verify-tag --generate-notes
 ```
 
-Replace `0.3.0` in both places for later versions. Finally, install from RubyGems.org in a fresh environment and run `rpremote --version`.
+Replace `0.5.0` in both places for later versions. Finally, install from RubyGems.org in a fresh environment and run `rpremote --version`.

data/lib/rpremote/cli.rb

@@ -152,6 +152,8 @@ module Rpremote
       else
         raise ArgumentError, "unknown fs command: #{subcommand || "(none)"}"
       end
+    rescue Shell::TimeoutError => e
+      raise Shell::TimeoutError, "filesystem connection failed: #{e.message}"
     end
 
     def run_file(args)
@@ -255,6 +257,7 @@ module Rpremote
       raise ArgumentError, "exactly one cp path must be remote (prefix remote paths with :)" if source_remote == destination_remote
       return RecursiveCopy.new(output: stdout, serial: serial, device: device).call(source, destination, options) if recursive
 
+      ensure_filesystem_connection!(options)
       if source_remote
         data = with_modem(options) { |modem| modem.download(RemotePath.unwrap(source)) }
         File.binwrite(local_destination(destination, source), data)
@@ -293,6 +296,11 @@ module Rpremote
       raise Shell::CommandError, output.strip if failed
     end
 
+    def ensure_filesystem_connection!(options)
+      output = with_shell(options) { |shell| shell.execute("ls '/'") }
+      ensure_filesystem_success!("ls", output)
+    end
+
     def with_modem(options)
       port_path = device.main_port(options[:port])
       serial.open(port_path, baud: options[:baud]) do |port|

data/lib/rpremote/deploy_command.rb

@@ -11,7 +11,7 @@ module Rpremote
 
     class Error < Rpremote::Error; end
 
-    # The command intentionally keeps the six deployment stages visible in execution order.
+    # The command intentionally keeps the deployment stages visible in execution order.
     # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
     def self.run(args, defaults:, output: $stdout, error: $stderr, services: {})
       options = parse_options(args, defaults)
@@ -21,7 +21,6 @@ module Rpremote
       library, remote_library, source = project_files(project)
       Language.validate!(options[:language])
 
-      builder = services.fetch(:builder) { Builder.new }
       flasher = services.fetch(:flasher, Flasher)
       serial = services.fetch(:serial, Serial)
       device = services.fetch(:device, Device)
@@ -29,13 +28,16 @@ module Rpremote
       target_options = options.slice(:language, :language_version, :board, :cache_dir, :firmware)
       firmware_path = Target.new(**target_options).firmware_path(root: Dir.pwd)
 
-      output.puts("deploy build: #{firmware_path}")
-      builder.build(
-        **target_options,
-        mrbgems: options[:mrbgems],
-        output: output,
-        error: error
-      )
+      if options[:build]
+        builder = services.fetch(:builder) { Builder.new }
+        output.puts("deploy build: #{firmware_path}")
+        builder.build(
+          **target_options,
+          mrbgems: options[:mrbgems],
+          output: output,
+          error: error
+        )
+      end
 
       flash_service = flasher.new(timeout: options[:timeout])
       bootsel_mount = resolve_bootsel_mount(options, flash_service, output, services)
@@ -48,7 +50,7 @@ module Rpremote
         port: options[:port]
       )
 
-      connection_options = options.merge(port: result.port)
+      connection_options = options.except(:build).merge(port: result.port)
       output.puts("deploy connect: waiting for R2P2 Shell on #{result.port}")
       wait_for_shell(
         port: result.port, baud: options[:baud], timeout: options[:timeout], serial: serial,
@@ -160,13 +162,15 @@ module Rpremote
         mount: defaults[:mount],
         port: defaults[:port],
         baud: defaults.fetch(:baud, Serial::BAUD_RATE),
-        timeout: defaults.fetch(:timeout, Flasher::DEFAULT_TIMEOUT)
+        timeout: defaults.fetch(:timeout, Flasher::DEFAULT_TIMEOUT),
+        build: false
       }
     end
     private_class_method :default_options
 
     def self.option_parser(options)
       OptionParser.new do |parser|
+        parser.on("--build") { options[:build] = true }
         parser.on("--language LANGUAGE") { |value| options[:language] = value }
         parser.on("--language-version VERSION") { |value| options[:language_version] = value }
         parser.on("--board BOARD") { |value| options[:board] = value }

data/lib/rpremote/help.rb

@@ -10,7 +10,7 @@ module Rpremote
              "[--firmware FILE] [--cache DIR] [--mrbgems FILE|--no-mrbgems]",
       build_clean: "rpremote build clean",
       bootsel: "rpremote bootsel [--reset-flash-memory] [--mount DIR] [--port PORT] [--baud RATE] [--timeout SEC]",
-      deploy: "rpremote deploy PATH [--language LANGUAGE] [--language-version VERSION] [--board BOARD] " \
+      deploy: "rpremote deploy PATH [--build] [--language LANGUAGE] [--language-version VERSION] [--board BOARD] " \
               "[--firmware FILE] [--cache DIR] [--mrbgems FILE|--no-mrbgems] [--mount DIR] " \
               "[--port PORT] [--baud RATE] [--timeout SEC]",
       dfu_app: "rpremote dfu app FILE [--type ruby|rite] [--port PORT] [--baud RATE] [--timeout SEC]",
@@ -73,6 +73,7 @@ module Rpremote
 
       Options:
         --force           download the PicoRuby source again during setup
+        --build           build the selected firmware before deploy flashes it
         --language-version VERSION
                           use R2P2/PicoRuby 4.0.3 or 3.4.2 (default: 4.0.3)
         --cache DIR       use another project cache directory
@@ -152,7 +153,8 @@ module Rpremote
       <<~HELP
         Usage: #{COMMAND_USAGE.fetch(:deploy)}
 
-        Builds the selected custom UF2, enters BOOTSEL when needed, flashes the firmware, and waits for the R2P2 Shell to become ready.
+        Enters BOOTSEL when needed, flashes the existing selected UF2, and waits for the R2P2 Shell to become ready.
+        With --build, builds the selected custom UF2 before entering BOOTSEL and flashing it.
         If PATH/lib/NAME exists, it copies it to :/lib/NAME, where NAME is the final component of PATH. It then runs PATH/main.rb and preserves its Shell job, so hardware output remains active until the next command.
         The stages run in order and stop at the first failure. Flashing replaces persistent board firmware.
         deploy requires PicoRuby 4.x firmware (currently 4.0.3).

data/lib/rpremote/mrbgems.rb

@@ -14,7 +14,7 @@ module Rpremote
     COMMIT_PATTERN = /\A[0-9a-f]{40,64}\z/i
     VMS = %i[mruby mrubyc].freeze
 
-    Dependency = Data.define(:type, :source, :branch, :commit, :path, :require_name)
+    Dependency = Data.define(:type, :source, :branch, :commit, :path, :require_name, :auto_require)
     Overlay = Data.define(:path, :fingerprint)
 
     class Error < Rpremote::Error; end
@@ -72,7 +72,9 @@ module Rpremote
       lock_data = read_lock(required: false)
       return [] unless lock_data
 
-      lock_data.fetch("gems").filter_map { |gem| gem["require_name"] }.uniq
+      lock_data.fetch("gems").filter_map do |gem|
+        gem["require_name"] if gem.fetch("auto_require", true)
+      end.uniq
     end
 
     def prepend_requires(source)
@@ -122,14 +124,19 @@ module Rpremote
         commit = dependency.commit || previous_commit(previous, dependency) || resolver.call(
           dependency.source, dependency.branch
         )
-        { "type" => "github", "source" => dependency.source,
-          "branch" => dependency.branch, "commit" => validate_commit!(commit),
-          "require_name" => dependency.require_name }.compact
+        entry = { "type" => "github", "source" => dependency.source,
+                  "branch" => dependency.branch, "commit" => validate_commit!(commit),
+                  "require_name" => dependency.require_name }.compact
       else
-        { "type" => "path", "source" => dependency.source,
-          "sha256" => digest_directory(dependency.path),
-          "require_name" => dependency.require_name || local_require_name(dependency.path) }.compact
+        entry = { "type" => "path", "source" => dependency.source,
+                  "sha256" => digest_directory(dependency.path),
+                  "require_name" => dependency.require_name || local_require_name(dependency.path) }.compact
       end
+      unless dependency.auto_require
+        entry.delete("require_name")
+        entry["auto_require"] = false
+      end
+      entry
     end
 
     def previous_commit(lock_data, dependency)
@@ -200,18 +207,24 @@ module Rpremote
 
     def valid_github_lock?(entry)
       GITHUB_PATTERN.match?(entry["source"].to_s) && !entry["branch"].to_s.empty? &&
-        COMMIT_PATTERN.match?(entry["commit"].to_s) && valid_require_name?(entry["require_name"])
+        COMMIT_PATTERN.match?(entry["commit"].to_s) && valid_require_name?(entry["require_name"]) &&
+        valid_auto_require?(entry)
     end
 
     def valid_path_lock?(entry)
       entry["type"] == "path" && !entry["source"].to_s.empty? &&
-        /\A[0-9a-f]{64}\z/.match?(entry["sha256"].to_s) && valid_require_name?(entry["require_name"])
+        /\A[0-9a-f]{64}\z/.match?(entry["sha256"].to_s) && valid_require_name?(entry["require_name"]) &&
+        valid_auto_require?(entry)
     end
 
     def valid_require_name?(name)
       name.nil? || (name.is_a?(String) && !name.empty? && !name.match?(/[\x00-\x1f\x7f]/))
     end
 
+    def valid_auto_require?(entry)
+      !entry.key?("auto_require") || entry["auto_require"] == true || entry["auto_require"] == false
+    end
+
     def local_require_name(directory)
       source = File.read(File.join(directory, "mrbgem.rake"))
       match = source.match(/^\s*spec\.require_name\s*=\s*["']([^"']+)["']\s*$/)
@@ -226,6 +239,8 @@ module Rpremote
 
     def overlay_source(base_config, target, locked_entries)
       lines = [
+        "# frozen_string_literal: true",
+        "",
         "# Generated by rpremote. Do not edit.",
         "load #{File.expand_path(base_config).inspect}",
         "conf = MRuby.targets.fetch(#{target.inspect})"
@@ -272,17 +287,20 @@ module Rpremote
         @vm_name = value
       end
 
-      def gem(github: nil, path: nil, branch: "main", commit: nil, require: nil)
+      def gem(github: nil, path: nil, branch: "main", commit: nil, require: nil, auto_require: true)
         sources = [github, path].compact
         raise DefinitionError, "gem requires exactly one of github or path" unless sources.length == 1
         unless require.nil? || (require.is_a?(String) && !require.empty? && !require.match?(/[\x00-\x1f\x7f]/))
           raise DefinitionError, "invalid mrbgem require name: #{require.inspect}"
         end
 
+        valid_auto_require = [true, false].include?(auto_require)
+        raise DefinitionError, "mrbgem auto_require must be true or false: #{auto_require.inspect}" unless valid_auto_require
+
         dependency = if github
-                       github_dependency(github, branch, commit, require)
+                       github_dependency(github, branch, commit, require, auto_require)
                      else
-                       path_dependency(path, branch, commit, require)
+                       path_dependency(path, branch, commit, require, auto_require)
                      end
         key = [dependency.type, dependency.source]
         raise DefinitionError, "duplicate mrbgem: #{dependency.source}" if dependencies.any? do |item|
@@ -296,21 +314,23 @@ module Rpremote
 
       attr_reader :directory
 
-      def github_dependency(source, branch, commit, require_name)
+      def github_dependency(source, branch, commit, require_name, auto_require)
         raise DefinitionError, "invalid GitHub mrbgem: #{source.inspect}" unless GITHUB_PATTERN.match?(source.to_s)
         raise DefinitionError, "GitHub mrbgem branch must not be empty" if branch.to_s.empty?
         raise DefinitionError, "invalid Git commit: #{commit.inspect}" if commit && !COMMIT_PATTERN.match?(commit.to_s)
 
         Dependency.new(type: :github, source: source, branch: branch,
-                       commit: commit&.downcase, path: nil, require_name: require_name)
+                       commit: commit&.downcase, path: nil, require_name: require_name,
+                       auto_require: auto_require)
       end
 
-      def path_dependency(source, branch, commit, require_name)
+      def path_dependency(source, branch, commit, require_name, auto_require)
         raise DefinitionError, "local mrbgem path must not be empty" if source.to_s.empty?
         raise DefinitionError, "local mrbgem does not accept branch or commit" if branch != "main" || commit
 
         Dependency.new(type: :path, source: source, branch: nil, commit: nil,
-                       path: File.expand_path(source, directory), require_name: require_name)
+                       path: File.expand_path(source, directory), require_name: require_name,
+                       auto_require: auto_require)
       end
     end
   end

data/lib/rpremote/picoruby_source_patch.rb

@@ -4,6 +4,7 @@ module Rpremote
   class PicoRubySourcePatch
     JOB_PATH = "mrbgems/picoruby-shell/mrblib/job.rb"
     BOOTSEL_PATH = "mrbgems/picoruby-machine/include/machine.h"
+    PWM_PATH = "mrbgems/picoruby-pwm/ports/rp2040/pwm.c"
     PATCH_ALIASES = { "3.4.2" => "3.4.5" }.freeze
 
     class Error < Rpremote::Error; end
@@ -35,7 +36,8 @@ module Rpremote
     def patches(patch_version)
       definitions = {
         "ruby-exception-status" => JOB_PATH,
-        "bootsel" => BOOTSEL_PATH
+        "bootsel" => BOOTSEL_PATH,
+        "pwm-sleep-clock" => PWM_PATH
       }
       definitions.map do |name, prerequisite|
         [File.expand_path("../../patches/picoruby-#{patch_version}-#{name}.patch", __dir__), prerequisite]

data/lib/rpremote/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Rpremote
-  VERSION = "0.3.0"
+  VERSION = "0.5.0"
 end

data/patches/picoruby-4.0.3-pwm-sleep-clock.patch

@@ -0,0 +1,22 @@
+diff --git a/mrbgems/picoruby-pwm/ports/rp2040/pwm.c b/mrbgems/picoruby-pwm/ports/rp2040/pwm.c
+--- a/mrbgems/picoruby-pwm/ports/rp2040/pwm.c
++++ b/mrbgems/picoruby-pwm/ports/rp2040/pwm.c
+@@ -1,5 +1,6 @@
+ #include "pico/stdlib.h"
+ #include "hardware/pwm.h"
++#include "hardware/structs/clocks.h"
+ 
+ #include "../../include/pwm.h"
+ 
+@@ -9,6 +10,11 @@
+ void
+ PWM_init(uint32_t pin)
+ {
++  /* The scheduler enters WFI while sleep_ms waits. Keep autonomous PWM
++   * output clocked between scheduler ticks after a PWM pin is initialized. */
++  hw_set_bits(&clocks_hw->sleep_en0,
++              CLOCKS_SLEEP_EN0_CLK_SYS_PWM_BITS);
++
+   gpio_set_function(pin, GPIO_FUNC_PWM);
+   uint slice_num = pwm_gpio_to_slice_num(pin);
+   pwm_set_clkdiv(slice_num, CLK_DIV);

data/sig/rpremote.rbs

@@ -226,6 +226,8 @@ module Rpremote
       attr_reader branch: String?
       attr_reader commit: String?
       attr_reader path: String?
+      attr_reader require_name: String?
+      attr_reader auto_require: bool
     end
 
     class Overlay < Data

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rpremote
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - ogom
@@ -60,6 +60,7 @@ files:
 - patches/picoruby-3.4.5-bootsel.patch
 - patches/picoruby-3.4.5-ruby-exception-status.patch
 - patches/picoruby-4.0.3-bootsel.patch
+- patches/picoruby-4.0.3-pwm-sleep-clock.patch
 - patches/picoruby-4.0.3-ruby-exception-status.patch
 - sig/rpremote.rbs
 - tasks/firmware_build.rb