rabbit-slide-hasumikin-RubyConfPoland2019 2019.05.14

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: aabacc738ae6ef77dc1319002d5920b0713853e98bc7020f8618e90e4fc96cc8
+  data.tar.gz: 737e9ff3a69327f462c0d8c88830249172ef0605e4ac988d0c671ae6ce925bba
+SHA512:
+  metadata.gz: 122bfd7a79327479d2997b3a7795e280672fe541f009fd75f59137e17ec619ec53ac8fcd90bece8799055d7537bdb52be0e2748d8f8b024fde65fd0746aaad53
+  data.tar.gz: acdafb2d5fc2498e3b2755bb0723702c5e2faad56a22cbac2087e02e83ddef9e3bf457f0649d67ab9d0f58a243a99ab97544cb07893da542b1a820a547089f53

data/.rabbit

@@ -0,0 +1 @@
+mrubyc---The-smallest-Ruby-implementation-for-microcontrollers.rab

data/README.rd

@@ -0,0 +1,32 @@
+= mrubyc - The smallest Ruby implementation for microcontrollers
+
+The slide for [THE RUBY CONFERENCE OF CRACOW 2019](https://krk-rb.pl/) by [hasumkin](https://github.com/hasumikin)
+
+It will cover:
+
+- Introducing Ruby for microcontrollers and microcontrollers themselves
+- Things in common and difference between mruby and mruby/c
+- How mruby/c works
+- Development sorroundings
+- Some actual source code of firmware application
+
+== for author
+
+=== presentation
+
+  rake
+
+=== publishment
+
+  rake publish
+
+== for readers
+
+=== install
+
+  gem install rabbit-slide-hasumikin-RubyConfPoland2019
+
+=== browse
+
+  rabbit rabbit-slide-hasumikin-RubyConfPoland2019.gem
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # spec.files += Dir.glob("doc/**/*.*")
+  # spec.files -= Dir.glob("private/**/*.*")
+  # spec.add_runtime_dependency("YOUR THEME")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,22 @@
+---
+id: RubyConfPoland2019
+base_name: mrubyc---The-smallest-Ruby-implementation-for-microcontrollers
+tags:
+- mruby
+- mruby/c
+- IoT
+presentation_date: 2019/05/14
+version: 2019.05.14
+licenses: []
+slideshare_id: 
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+youtube_id: 
+author:
+  markup_language: :rd
+  name: HASUMI Hitoshi
+  email: hasumikin@gmail.com
+  rubygems_user: hasumikin
+  slideshare_user: 
+  speaker_deck_user: 

data/images/krkrb-main.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 739.03 574.87"><defs><style>.cls-1{fill:#182943;}.cls-2{fill:#afbdff;}.cls-3{fill:#c2cdff;}.cls-4{fill:#dde4ff;}.cls-5{fill:#8b9fff;}.cls-6{fill:#f34611;}.cls-7{fill:#c9260a;}.cls-8,.cls-9{fill:none;stroke-linecap:round;stroke-linejoin:round;stroke-width:2px;}.cls-8{stroke:#f34611;}.cls-9{stroke:#c9260a;}</style></defs><title>Asset 3</title><g id="Layer_2" data-name="Layer 2"><g id="Layer_1-2" data-name="Layer 1"><path class="cls-1" d="M553.41,239.39C529.24,97.89,346.38-5.49,259.59,36.18c-33,15.85-61.9,57.39-59.86,97.32,3.77,73.68,110.92,105,101.07,148-8.39,36.62-88.24,23.2-114.43,70.13C155.52,406.92,210.12,526.21,283,545.11,388.1,572.38,581.44,403.48,553.41,239.39Z"/><polygon class="cls-2" points="375.5 364.35 503.93 315.42 415.42 485.23 333.16 543.39 243.71 532.32 290.59 479.56 375.5 364.35"/><path class="cls-2" d="M739,288.92s-168.15-61.28-238.51-52.2S336,310.48,307.05,326.93s-105.26,54.64-105.26,54.64,21,27.49,55.37,13.38,66.06-28,86.48-24.07,51.63,17.33,104.68-17.28S739,288.92,739,288.92Z"/><path class="cls-2" d="M375.5,364.35S260.81,483.81,248,492s-99.57,1.7-112.91,3.4-27.51,7.66-31.2,13.62,127.66,18.72,145.25,13.62,56.73-37.45,56.73-37.45Z"/><path class="cls-2" d="M120.52,513.76c-16.67.55-36.48,1.19-34.18,10.09,10.4,8.47,51.8,16.17,49.17,15.47l96.5,4.07s78.73-14.47,96.6-34.33-22.7-23.83-22.7-23.83-46.86,32.61-56.17,33.66S137.19,513.22,120.52,513.76Z"/><path class="cls-3" d="M319,558.61s-56.45,16.26-86.81,16.26-120.28-26.38-120.28-32.34,20.71-16.21,37.45-16.21S239,541.39,239,541.39Z"/><path class="cls-4" d="M719.53,418.28S688.89,363,628.75,382.71,432.44,513.6,397.26,545.37s-162.77,7.14-170.5-6c0,0,9.11-17.12,34.05-16.22s63.81,3.72,83.1-.84,55.27-36.45,68.6-60.38S472.15,266.22,565.2,259.41,739,288.92,739,288.92Z"/><path class="cls-5" d="M185,117.74v21l-1.63,1.63L166.7,128.11a17.84,17.84,0,0,1-8.89-15.44V111.6c-2.12-1.85,4.57-6.88,8.24-4.77Z"/><path class="cls-3" d="M183.39,119.37v21l-18.32-10.65a17.84,17.84,0,0,1-8.89-15.44v-1.08a5.5,5.5,0,0,1,8.24-4.76Z"/><path class="cls-5" d="M185,160.93v21l-1.63,1.63L166.7,171.31a17.85,17.85,0,0,1-8.89-15.44v-1.08c-2.12-1.84,4.57-6.87,8.24-4.76Z"/><path class="cls-3" d="M183.39,162.56v21l-18.32-10.64a17.85,17.85,0,0,1-8.89-15.44v-1.08a5.5,5.5,0,0,1,8.24-4.77Z"/><path class="cls-5" d="M185,204.13v21l-1.63,1.63L166.7,214.51a17.85,17.85,0,0,1-8.89-15.44V198c-2.12-1.85,4.57-6.87,8.24-4.77Z"/><path class="cls-3" d="M183.39,205.76v21l-18.32-10.64a17.85,17.85,0,0,1-8.89-15.44v-1.08a5.5,5.5,0,0,1,8.24-4.77Z"/><path class="cls-5" d="M185,247.33v21L183.39,270,166.7,257.7a17.82,17.82,0,0,1-8.89-15.44v-1.07c-2.12-1.85,4.57-6.88,8.24-4.77Z"/><path class="cls-3" d="M183.39,249v21l-18.32-10.65a17.84,17.84,0,0,1-8.89-15.44v-1.08a5.5,5.5,0,0,1,8.24-4.76Z"/><path class="cls-5" d="M201.23,309.7l18.08,10.12,0,19c-3.26,8.87-6,9-10.8,6.23h0a14.58,14.58,0,0,1-7.28-12.63l-1.61-21.08Z"/><path class="cls-3" d="M199.59,311.34l18.08,10.1v19a7.2,7.2,0,0,1-10.79,6.24h0A14.59,14.59,0,0,1,199.59,334Z"/><path class="cls-5" d="M231.66,327.08l18.07,10.11v19c-3.27,8.88-6,9-10.8,6.23h0a14.56,14.56,0,0,1-7.28-12.63L230,328.7Z"/><path class="cls-3" d="M230,328.71l18.09,10.11v19A7.2,7.2,0,0,1,237.3,364h0A14.56,14.56,0,0,1,230,351.42Z"/><path class="cls-5" d="M264.48,345.54l18.08,10.12v19c-3.27,8.87-6,9-10.81,6.22h0a14.59,14.59,0,0,1-7.28-12.62l-1.61-21.08Z"/><path class="cls-3" d="M262.84,347.18l18.09,10.1v19a7.2,7.2,0,0,1-10.8,6.23h0a14.56,14.56,0,0,1-7.29-12.62Z"/><path class="cls-5" d="M294.91,362.91,313,373l0,19c-3.27,8.87-6,9-10.8,6.23h0a14.56,14.56,0,0,1-7.28-12.63l-1.61-21.08Z"/><path class="cls-3" d="M293.26,364.55l18.09,10.1v19a7.21,7.21,0,0,1-10.8,6.24h0a14.58,14.58,0,0,1-7.29-12.62Z"/><path class="cls-5" d="M190.15,287.84,185,74.57c8.64-7,12.46-12.83,18.37-9.47l128.53,73.12a21.81,21.81,0,0,1,11,18.94V372.21c0,6.79-10,13.34-13.77,17.12l-128-82.55A21.78,21.78,0,0,1,190.15,287.84Z"/><path class="cls-3" d="M179.89,297.56v-215a8.86,8.86,0,0,1,13.24-7.7l128.54,73.13a21.79,21.79,0,0,1,11,18.94V381.93a8.86,8.86,0,0,1-13.24,7.7L190.91,316.5A21.78,21.78,0,0,1,179.89,297.56Z"/><path class="cls-5" d="M195,279.53l-4.11-170.85c6.92-5.62,10-10.28,14.71-7.59l103,58.58a17.46,17.46,0,0,1,8.82,15.17V347.11c0,5.44-8,10.69-11,13.71L203.79,294.7A17.46,17.46,0,0,1,195,279.53Z"/><path class="cls-3" d="M186.75,287.31V115.05a7.09,7.09,0,0,1,10.6-6.17l103,58.58a17.43,17.43,0,0,1,8.82,15.17V354.9a7.09,7.09,0,0,1-10.6,6.16l-103-58.57A17.48,17.48,0,0,1,186.75,287.31Z"/><path class="cls-5" d="M206.66,74.84l-1.58-18.59c0-4.58,6.53-9,10.5-6.67h0a17.12,17.12,0,0,1,8.56,14.83V84.92l-1.57,1.58Z"/><path class="cls-3" d="M205.08,76.42V56.31A6,6,0,0,1,214,51.16h0A17.1,17.1,0,0,1,222.57,66V86.5Z"/><path class="cls-5" d="M238.44,93.61,236.87,75c0-4.58,6.53-9,10.5-6.67h0a17.12,17.12,0,0,1,8.56,14.83v20.51l-1.58,1.58Z"/><path class="cls-3" d="M236.87,95.19V75.08a5.94,5.94,0,0,1,8.92-5.15h0a17.09,17.09,0,0,1,8.56,14.82v20.52Z"/><path class="cls-5" d="M271,110.45l-1.58-18.59c0-4.58,6.54-9,10.5-6.67h0A17.12,17.12,0,0,1,288.5,100v20.52l-1.58,1.58Z"/><path class="cls-3" d="M269.43,112V91.92a6,6,0,0,1,8.93-5.15h0a17.09,17.09,0,0,1,8.56,14.82v20.52Z"/><path class="cls-5" d="M302.8,129.22l-1.58-18.59c0-4.58,6.53-9,10.5-6.67h0a17.11,17.11,0,0,1,8.56,14.82V139.3l-1.57,1.58Z"/><path class="cls-3" d="M301.22,130.79v-20.1a6,6,0,0,1,8.92-5.15h0a17.1,17.1,0,0,1,8.57,14.82v20.52Z"/><path class="cls-5" d="M339.14,192.19l-1.62,1.63,1.62,19.39,16,11.57c4.73,1.46,11.25-2.74,11.25-8.21h0a15.11,15.11,0,0,0-7.58-13.1Z"/><path class="cls-3" d="M337.52,193.82v21l16.56,9.52a7.11,7.11,0,0,0,10.65-6.16h0a15.11,15.11,0,0,0-7.58-13.1Z"/><path class="cls-5" d="M339.14,238.29l-1.62,1.63,1.62,19.39,16,11.57c4.73,1.46,11.25-2.74,11.25-8.21h0a15.12,15.12,0,0,0-7.58-13.1Z"/><path class="cls-3" d="M337.52,239.92v21l16.56,9.52a7.11,7.11,0,0,0,10.65-6.16h0a15.11,15.11,0,0,0-7.58-13.1Z"/><path class="cls-5" d="M339.14,284.39,337.52,286l1.62,19.39,16,11.57c4.73,1.46,11.25-2.74,11.25-8.2h0a15.13,15.13,0,0,0-7.58-13.11Z"/><path class="cls-3" d="M337.52,286v21l16.56,9.52a7.11,7.11,0,0,0,10.65-6.16h0a15.12,15.12,0,0,0-7.58-13.1Z"/><path class="cls-5" d="M339.14,330.49l-1.62,1.63,1.62,19.39,16,11.57c4.73,1.46,11.25-2.74,11.25-8.2h0a15.13,15.13,0,0,0-7.58-13.11Z"/><path class="cls-3" d="M337.52,332.12v21l16.56,9.52a7.11,7.11,0,0,0,10.65-6.15h0a15.13,15.13,0,0,0-7.58-13.11Z"/><path class="cls-6" d="M105.2,322.75,83.34,308.43h0a4.76,4.76,0,0,0-.49-.28l-.29-.14-.22-.1-.34-.12-.19-.06-.33-.08-.22-.05-.29,0-.27,0H79.9l-.34,0-.28,0-.27.05a5.09,5.09,0,0,0-.56.14h0l-31.54,10a5.75,5.75,0,0,0-3.62,3.36L33.6,345.34a5.77,5.77,0,0,0,2.41,7.1L78.7,377.81h0l.4.21.15.08h0a4.87,4.87,0,0,0,.53.21l.21.06c.12,0,.23.07.35.09l.22,0,.35.05.22,0,.35,0h.58l.19,0,.41-.06.15,0a5.36,5.36,0,0,0,.54-.14h0a5.55,5.55,0,0,0,.52-.2l.14-.06.37-.18.16-.1.32-.2.16-.12a3.15,3.15,0,0,0,.29-.22l.16-.14.26-.25.15-.16.24-.28.13-.17a5.72,5.72,0,0,0,.32-.48h0l.08-.15c.07-.14.15-.27.21-.4v0l20.39-45.28A5.75,5.75,0,0,0,105.2,322.75Z"/><path class="cls-7" d="M430.39,38.27l-9.47-24.36h0a4.9,4.9,0,0,0-.24-.52c0-.09-.1-.18-.15-.27l-.12-.21-.21-.3-.12-.16-.22-.26-.15-.17-.21-.2-.2-.19-.2-.15a2.43,2.43,0,0,0-.25-.2l-.19-.12-.29-.18-.25-.12-.25-.13a4.81,4.81,0,0,0-.53-.2h0L385.88.28A5.79,5.79,0,0,0,381,.92L359,15a5.76,5.76,0,0,0-2.16,7.18l20,45.45v0l.2.4s.05.11.08.16h0a4.9,4.9,0,0,0,.31.48l.13.17.23.28.16.17.25.24.16.15.28.22.17.12.32.2.16.1.36.19.14.06a5.55,5.55,0,0,0,.52.2h0a5.44,5.44,0,0,0,.54.15l.15,0,.4.06.19,0,.38,0h.56l.22,0,.35-.06.22,0a3.58,3.58,0,0,0,.35-.09l.21-.06.53-.2h0a.8.8,0,0,1,.16-.08c.13-.07.27-.13.39-.21h0l42.9-25A5.76,5.76,0,0,0,430.39,38.27Z"/><path class="cls-8" d="M343,449C156.55,435.26,109,407.64,105.26,382.64c-4.18-27.82,45.32-55.65,35.5-88-6.6-21.74-35.94-32-57.1-37"/><path class="cls-8" d="M31.87,409.74s53-32.13,72,19.67,229.31,35,229.31,35"/><path class="cls-8" d="M145.06,365.33s53.68-61.4,0-95.35"/><line class="cls-8" x1="124.48" y1="258.56" x2="103.85" y2="252.94"/><line class="cls-8" x1="320.28" y1="485.23" x2="248.04" y2="492.04"/><line class="cls-8" x1="230.03" y1="495.6" x2="196.51" y2="495.6"/><path class="cls-8" d="M20.24,416.21S4.77,424.93,1,437.55"/><path class="cls-8" d="M145.06,437.55s26.16,15.31,51.45,11.45"/><path class="cls-9" d="M402.3,240.9s-71.06-75.55-30.87-100,43.16-37.09,30.87-46.61"/><path class="cls-9" d="M383.91,182.25c-16.15-26,0-32.73,0-32.73"/><line class="cls-9" x1="389.3" y1="192.19" x2="398.22" y2="205.54"/><path class="cls-9" d="M376.73,87.2S391,88,389.3,100.31"/></g></g></svg>

data/mrubyc---The-smallest-Ruby-implementation-for-microcontrollers.rab

@@ -0,0 +1,866 @@
+= mruby/c\nThe smallest Ruby implementation for microcontrollers
+
+# : subtitle
+#    サブタイトル
+: author
+   HASUMI Hitoshi @hasumikin
+# : institution
+#    所属
+# : content-source
+#    イベント名
+: date
+   May 6, 2019 in Warszawa
+: date
+   May 14, 2019 in Kraków
+: allotted-time
+   47m
+: theme
+   theme
+
+= hide-title
+(('tag:center'))\n\n\n\n((*(('tag:xx-large:Cześć!'))*))
+== プロパティ
+: hide-title
+   true
+
+= about me
+  * HASUMI Hitoshi\n@hasumikin
+  * live in Matsue city,\na holy place of Ruby
+  * Sake 🍶\nSoba 🍜\nCoffee ☕
+  # image
+  # src = images/hasumi.jpg
+  # align = right
+  # relative-height = 80
+
+= about me
+  # image
+  # src = images/monstarlab.png
+  # relative_width = 120
+  # relative_margin_top = -1
+
+= about me
+  # image
+  # src = images/m2.png
+  # relative_width = 106
+  # relative_margin_top = -1
+
+= about me
+  # image
+  # src = images/松江城_Matsue.rb.jpg
+  # relative_width = 106
+  # relative_margin_top = -3
+== prop
+: hide-title
+   true
+
+= message from Matz
+  # # video
+  # # src = images/video.mp4
+
+= agenda
+* terminology
+* about my IoT project
+* mruby and mruby/c
+* how does mruby/c work
+* actual source code of my project
+* development environment
+
+= terminology
+
+= terminology
+* mruby/c
+  * tha language I will talk about today
+  * I say mrubyc as /c is hard to pronounce
+* microcontroller
+  * small computer contains CPU, memory and programmable I/O peripherals
+  * in this talk, microcontroller is distinguished from single board computer like Raspberry Pi
+
+= terminology
+* RTOS
+  * Real-time OS.  usually used for microcontroller
+* task
+  * almost equivalent to `Thread` in linux. we say `task` in microcontroller world
+
+= terminology
+* 旭日酒造(Aasahi-shuzo)
+  * shuzo means Sake brewery
+  * one of the best Japanese Sake brewery
+  * Asahi-beer(famous for SUPER DRY) has no concern with Asahi-shuzo
+  * Aasahi-shuzo and I make IoT system using mruby/c
+
+= why microcontroller?
+* I never use single board computer like Raspberry Pi for production environment.
+
+= why microcontroller?
+* it starts immediately right after plugged in
+  * end users, brewery workers in my case, can use it simply like home electical things
+* you can narrow security issue list
+  * many a malware aims at Linux or Windows platform as a target
+  * you don't need to consider unnecessary deamon
+  * you don't need to do `apt upgrade`
+
+= why microcontroller?
+* low energy
+  * rarely overheated
+  * many choices of power supply
+* mass production
+  * you can choose appropriate chipset(number of GPIOs, memory size, etc.) for your application
+  * cost advantage for parts supply and subcontractor manufacturing
+
+= which microcontroller?
+
+= which microcontroller?
+  # image
+  # src = images/psoc5lp_chip.jpg
+  # align = right
+  # relative-height = 60
+* CYPRESS PSoC5LP
+  * 32 bit Arm Cortex-M3 CPU
+  * Flash: 256KB
+  * SRAM: 64KB
+    * 64KB is the target size\nof mruby/c
+
+= which microcontroller?
+  # image
+  # src = images/esp32.jpg
+  # align = center
+  # relative-height = 50
+* Espressif ESP-WROOM-32 (ESP32)
+  * 32 bit dual core LX6 CPU
+  * Flash: 4MB
+  * SRAM: 520KB
+
+= about my IoT project
+
+= about my IoT project
+* IoT system for Asahi-shuzo
+* delivered to actual brew work in January 2018
+* devices post temperature of Sake materials in brewing, surrounding temperature and humidity to server
+* data is displayed on smartphone app
+
+= about my IoT project
+  # image
+  # src = images/kamos.jpg
+  # align = center
+  # relative-height = 95
+
+= about my IoT project
+  # image
+  # src = images/collage01.jpg
+  # align = center
+  # relative-height = 95
+
+= about my IoT project
+: what were difficult about mruby/c?
+* we can neither do step execution nor look into appropriate memory address of mruby/c's variables
+* so many troubles in IoT
+  * hard to find why the application doesn't work well
+* mruby/c was growing
+  * bugs, lack of features, docs and examples
+
+= about my IoT project
+: so, was mruby/c bad?
+
+= about my IoT project
+: so, was mruby/c bad? - NO
+* IoT at work makes you hurry
+  * you have to go back and forth between dark 10℃ storage cellar and humid 35℃ manufacturing room
+  * brewery workers run around
+  * you have to amend your firmware with your small laptop in 10 minutes
+  * you will thank Ruby's descriptiveness and agility
+
+= today's demo
+* CO(('sub:2')) concentration
+  * 400ppm : atmospheric
+  * 1000ppm : your programming speed decreases
+  * 1500ppm : tomatoes ((*🍅*)) may grow well
+  * > 2000ppm : sleepy, headache
+  * > 40000ppm : 💀
+
+= today's demo
+* my device keeps taking CO(('sub:2')) concentration
+* I will prove that it is due to CO(('sub:2')) if someone slept while I speaking
+
+= so many troubles in IoT
+
+= so many troubles in IoT
+* peripheral equipments (☆)
+* circuit and wiring design
+* printed circuit board = PCB
+* soldering (☆)
+* C, mruby and mruby/c (☆)
+* network
+☆...I will explain these topics today
+
+= peripheral equipments
+
+= peripheral equipments
+* it is very important to check the following before writing application code
+  * equipment like sensor or communication module works as its spec sheet
+  * whether the equipment is not broken (sometimes broken by soldering 😭)
+* unless you will regret
+  * so...
+
+= peripheral equipments
+  # image
+  # src = images/raspberrypi.jpg
+  # relative-height = 55
+
+* Raspberry Pi & CRuby are great for pre-prototyping
+  * use breadboard or make PCB for test like this photo
+
+= peripheral equipments
+ex) CRuby for serial communication test
+  # enscript ruby
+  # notice this is CRuby for RasPi
+  require 'rubyserial'
+  require 'timeout'
+  BAUDRATE = 9600 # match with your instrument
+  sp = Serial.new '/dev/serial0', BAUDRATE, 8
+  loop do
+    puts '[command]'
+    command = gets
+    sp.write command.sub("\n", "\r") # replace LF if needed
+    sleep 0.1
+    result = ''
+    begin
+      Timeout.timeout(10) do
+        loop do
+          line = sp.read(128)
+          break if line == '' && result != ''
+          result << line
+          sleep 0.1
+        puts '=> ' + result
+    rescue Timeout::Error
+      puts 'timeout!'
+
+= peripheral equipments
+ex) CRuby for serial communication test
+  # enscript bash
+  $ serial_communication_test.rb
+  [command]
+  AT              # command
+  => OK           # response
+  [command]
+  AT+CIMI         # command
+  => 123456789012 # response
+  [command]
+  AT+XXX          # command
+  => error        # response
+
+= soldering
+
+= soldering
+  # image
+  # src = images/unsoldered.jpg
+  # relative-width = 35
+
+* it may work even if you leave a pin unsoldered on surface mounting
+  * because the pin touches circuit's surface
+  * then, it will not work one day
+
+= soldering
+  # image
+  # src = images/unsoldered-2.png
+  # relative-width = 35
+
+* discovering this kind of bug is much more difficult than software bug
+* my teacher said\n"all the cause of failure, it is ((*impatience*))"
+
+= what is mruby?
+
+= what is mruby?
+  * github.com/mruby/mruby
+  * another implemantation of Ruby for embedded usage
+  * easily being called from C/C++
+  * ngx_mruby is a popular one
+  * good for command line tools as one-binary executable
+
+= what is mruby/c?
+
+= what is mruby/c?
+  * github.com/mrubyc/mrubyc
+  * yet another implementation of mruby
+  * `/c` symbolizes compact, concurrent and capability
+  * especially dedicated to one-chip microcontroller
+
+= mruby and mruby/c
+  # RT
+
+  mruby, mruby/c
+
+  v1.0.0 in Jan 2014, v1.0 in Jan 2017
+  for general embedded software, for one-chip microcontroller
+  RAM < 400KB, RAM < 40KB
+
+* sometimes mruby is still too big to run on microcontroller
+
+= ((*both*)) mruby and mruby/c
+  * bytecodes are compiled by `mrbc` and VM executes the bytecode
+  # image
+  # src = images/mruby_and_mrubyc.png
+  # align = center
+  # relative-height = 100
+
+= bytecode
+  * a kind of intermediate representation
+  * virtual machine dynamically interprets the bytecode and processes the program
+  # image
+  # src = images/bytecode.png
+  # align = center
+  # relative-width = 100
+
+= mruby on microcontroller
+  * RTOS (Real-Time OS) manages mruby VMs. RTOS has features like multi tasking
+  # image
+  # src = images/mruby_and_mrubyc-mruby.png
+  # align = center
+  # relative-height = 100
+
+= mruby/c on microcontroller
+  * mruby/c has its own mechanism to manage the runtime: ((*rrt0*))
+  # image
+  # src = images/mruby_and_mrubyc-mrubyc.png
+  # align = center
+  # relative-height = 100
+
+= mruby/c - virtual machine (VM)
+  * much smaller than mruby's one
+    * that's why mruby/c runs on smaller RAM
+  * accordingly, mruby/c has ((*less*)) functionality than mruby
+
+= how ((*less*))?
+
+= how ((*less*))? - for example
+  * mruby/c doesn't have module, hence there is no Kernel module
+  * then you must wonder how can you `#puts`?
+  * in mruby/c, `#puts` is implemented in Object class
+
+= how ((*less*))? - for example
+  * mruby/c doesn't have #send, #eval, nor #method_missing
+  * moreover, mruby/c neither have your favorite features like TracePoint nor RubyVM::AST 😞
+
+= how ((*less*))? - actually
+  * the full list of mruby/c's classes
+    * Array,   FalseClass,   Fixnum,   Float,   Hash,   Math,   Mutex,   NilClass,   Numeric,   Object,   Proc,   Range,   String,   Symbol,   TrueClass,   VM
+
+= despite the fact,
+  * no problem in practical use of microcontroller
+  * as far as IoT go, mruby/c is enough Ruby as I expect
+  * we can fully develop firmwares with features of mruby/c
+
+= how does mruby/c work
+
+= how does mruby/c work
+  # enscript bash
+  ~/sample_project
+  ├── main.c
+  ├── mrblib
+  │     ├── task_1.rb
+  │     └── task_2.rb
+  └── src
+         ├── task_1.c
+         └── task_2.c
+* task_*.c are compliled code from task_*.rb
+
+= how does mruby/c work
+  # enscript c
+  /* main.c */
+  #include "src/task_1.c"
+  #include "src/task_2.c"
+  // use 30KB RAM for VMs in this case
+  #define MEMORY_SIZE (1024*30)
+  static uint8_t memory_pool[MEMORY_SIZE];
+  int main(void) {
+    mrbc_init(memory_pool, MEMORY_SIZE);
+    mrbc_create_task(task_1, 0);
+    mrbc_create_task(task_2, 0);
+    mrbc_run(); // 2 tasks run concurrently!
+    return 0;
+    // we will not write `main loop` in main.c
+  }
+
+= how does mruby/c work
+* we can run easily multiple VMs with ((*concurrency*)) due to ((*rrt0*))
+* you might be disappointed to know you have to write C
+  * yes, we have to write ((*main.c*))
+  * don't worry, it's almost boilerplate code
+
+= how does mruby/c work
+  # enscript bash
+  ~/mrubyc $ tree src -P *.h
+  src
+  ├── alloc.h
+  ├── c_array.h
+  ...
+  ├── console.h
+  ├── errorcode.h
+  ├── global.h
+  ├── hal_posix
+  │     └── hal.h
+  ├── hal_psoc5lp
+  │     └── hal.h
+  ├── hal_esp32
+  │     └── hal.h
+  ├── load.h
+  ├── mrubyc.h
+  ├── opcode.h
+  ├── rrt0.h
+  ├── static.h
+  ├── symbol.h
+  ├── value.h
+  ├── vm.h
+  └── vm_config.h
+
+= how does mruby/c work
+  # enscript bash
+  ~/mrubyc $ tree src -P *.h
+  src
+  ├── alloc.h
+  ├── c_array.h
+  ...
+  ├── console.h
+  ├── errorcode.h
+  ├── global.h
+  ├── hal_posix
+  │     └── hal.h # hal for POSIX
+  ├── hal_psoc5lp
+  │     └── hal.h # hal for PSoC5LP
+  ├── hal_esp32
+  │     └── hal.h # hal for ESP32
+  ├── load.h
+  ├── mrubyc.h
+  ├── opcode.h
+  ├── rrt0.h
+  ├── static.h
+  ├── symbol.h
+  ├── value.h
+  ├── vm.h
+  └── vm_config.h
+
+= how does mruby/c work
+  # enscript bash
+  ~/mrubyc $ tree src -P *.h
+  src
+  ├── alloc.h
+  ├── c_array.h
+  ...
+  ├── console.h
+  ├── errorcode.h
+  ├── global.h
+  ├── hal_posix
+  │     └── hal.h
+  ├── hal_psoc5lp
+  │     └── hal.h
+  ├── hal_esp32
+  │     └── hal.h
+  ├── load.h
+  ├── mrubyc.h
+  ├── opcode.h
+  ├── rrt0.h     # runtime scheduler
+  ├── static.h
+  ├── symbol.h
+  ├── value.h
+  ├── vm.h
+  └── vm_config.h
+
+= how does mruby/c work
+  # enscript bash
+  ~/mrubyc $ tree src -P *.h
+  src
+  ├── alloc.h
+  ├── c_array.h
+  ...
+  ├── console.h
+  ├── errorcode.h
+  ├── global.h
+  ├── hal_posix
+  │     └── hal.h
+  ├── hal_psoc5lp
+  │     └── hal.h
+  ├── hal_esp32
+  │     └── hal.h
+  ├── load.h
+  ├── mrubyc.h
+  ├── opcode.h
+  ├── rrt0.h
+  ├── static.h
+  ├── symbol.h
+  ├── value.h # this gives you hints about variable
+  ├── vm.h
+  └── vm_config.h
+
+= how does mruby/c work
+  # enscript bash
+  ~/mrubyc $ tree src -P *.h
+  src
+  ├── alloc.h
+  ├── c_array.h
+  ...
+  ├── console.h
+  ├── errorcode.h
+  ├── global.h
+  ├── hal_posix
+  │     └── hal.h
+  ├── hal_psoc5lp
+  │     └── hal.h
+  ├── hal_esp32
+  │     └── hal.h
+  ├── load.h
+  ├── mrubyc.h
+  ├── opcode.h
+  ├── rrt0.h
+  ├── static.h
+  ├── symbol.h
+  ├── value.h
+  ├── vm.h
+  └── vm_config.h # edit this if needed
+
+= debugging
+
+= debugging
+* we can neither do step execution nor look into memory to see variables when we use mruby/c in general
+* we should prepare a way of debugging before writing app code
+* let's go with ((*old-fashioned 'print debug'*)).  it'll be almost enough
+
+= debugging
+  # enscript c
+  /* a part of main.c */
+  // create serial console with UART for debug print
+  static void c_debugprint(mrb_vm *vm, mrb_value *v, int argc){
+    int total, used, free, fragment;
+    mrbc_alloc_statistics(&total, &used, &free, &fragment);
+    console_printf(
+      "Memory total:%d, used:%d, free:%d, fragment:%d\n",
+      total, used, free, fragment);
+    unsigned char *key = GET_STRING_ARG(1);
+    unsigned char *value = GET_STRING_ARG(2);
+    console_printf("%s:%s\n", key, value);
+  }
+  int main(void) {
+    ...
+    mrbc_define_method(0, mrbc_class_object, "debugprint", c_debugprint);
+    ...
+  }
+
+= debugging
+  # enscript ruby
+  # mruby
+  pi = 3.14
+  debugprint('Pi', pi.to_s)
+
+  => # print in serial console like 'PuTTY' connecting USB
+     Memory total:30000, used:20000, free:10000, fragment:3
+     Pi:3.14
+
+= actual source code
+
+= actual source code
+(('tag:center'))\n\n\n\n
+github.com/hasumikin/co2-demo
+
+= actual source code
+  # enscript bash
+  ~/co2-demo
+  ├── main.c
+  └── mrblib
+         ├── loops
+         │     ├── master.rb
+         │     └── slave.rb
+         └── models
+                ├── co2.rb
+                ├── led.rb
+                └── thermistor.rb
+
+= actual source code
+  # enscript ruby
+  # loops/master.rb
+  $co2 = Co2.new     # Makes it global so that another task
+                     # can use it
+  led = Led.new(19)  # 19 is a pin number which LED connects
+  while true
+    co2 = $co2.concentrate
+    if co2 > 2000    # When CO2 reaches fatal level
+      5.times do     # Turning LED on and off
+        led.turn_on
+        sleep 0.1
+        led.turn_off
+        sleep 0.1
+      end
+    elsif co2 > 1500 # CO2 reaches warning level
+      led.turn_on    # Just keeps turn it on
+      sleep 1
+    else             # Safe level
+      led.turn_off   # Turns off
+      sleep 1
+    end
+  end
+
+= actual source code
+(('tag:center'))\n\n\n\n
+how does ((*Led#trun_on*)) work?
+
+= actual source code
+  # enscript ruby
+  # models/led.rb
+  class Led
+    def initialize(pin)
+      @pin = pin
+      gpio_init_output(@pin)
+      turn_off
+    end
+    def turn_on
+      gpio_set_level(@pin, 1)
+    end
+
+= actual source code
+  # enscript c
+  /* a part of main.c */
+  #include "models/led.c"
+  static void c_gpio_init_output(mrb_vm *vm, mrb_value *v,
+                                 int argc) {
+    int pin = GET_INT_ARG(1);
+    gpio_set_direction(pin, GPIO_MODE_OUTPUT);
+  }
+  static void c_gpio_set_level(mrb_vm *vm, mrb_value *v,
+                               int argc){
+    int pin = GET_INT_ARG(1);
+    int level = GET_INT_ARG(2);
+    gpio_set_level(pin, level);
+  }
+  int main(void){
+    ...
+    mrbc_define_method(0, mrbc_class_object, "gpio_init_output",
+                       c_gpio_init_output);
+    mrbc_define_method(0, mrbc_class_object, "gpio_set_level",
+                       c_gpio_set_level);
+    ...
+  }
+
+= actual source code
+  # enscript c
+  /* a part of main.c */
+  #include "models/co2.c"
+  static void c_get_co2(struct VM *vm, mrbc_value v[], int argc){
+    uint8_t command[] = { // Command to take CO2
+      0xFF, 0x01, 0x86, 0x00, 0x00, 0x00, 0x00, 0x00, 0x79
+    };
+    uart_write_bytes(uart_num, (const char*)command, 9);
+    // ↑Write then ↓Read data
+    uint8_t data[10];
+    int length = 0;
+    ESP_ERROR_CHECK(uart_get_buffered_data_len(uart_num, (size_t*)&length));
+    length = uart_read_bytes(uart_num, data, length, 10);
+    int i;
+    mrb_value array = mrbc_array_new( vm, 9 ); // mrubyc's variable
+    for( i = 0; i < 9; i++ ) {
+      mrb_value value = mrb_fixnum_value(data[i]);
+      mrbc_array_set( &array, i, &value ); // Adding a value to array
+    }
+    SET_RETURN(array); // Returning the array to mruby
+  }
+  int main(void){
+    ...
+    mrbc_define_method(0, mrbc_class_object, "get_co2", c_get_co2);
+    ...
+  }
+
+= actual source code
+  # enscript ruby
+  # models/co2.rb
+  class Co2
+    def concentrate
+      res = get_co2
+      # checks if the sensor works
+      if res[0] == 255 && res[1] == 134
+        res[2] * 256 + res[3]
+      else
+        0
+      end
+    end
+  end
+
+= actual source code
+* by the way,
+  * C function can return String instead of mruby/c Array
+  * `mrbc_array_new` will allocate larger memory than `mrbc_string_new`
+  * so, you can use String instead of Array if memory becomes short
+
+= actual source code
+  # enscript ruby
+  # loops/slave.rb
+  while true
+    co2 = $co2.concentrate
+    temperature = $thermistor.temperature
+    if co2 > 0
+      data = "co2=#{co2}&temperature=#{temperature}"
+      puts "DATASEND:#{data}"
+      sleep 300
+    else
+      sleep 3
+    end
+  end
+
+= development environment
+
+= development environment
+  * PSoC Creator for PSoC5LP
+  # image
+  # src = images/IDE.png
+  # align = center
+  # relative-width = 100
+
+= development environment
+  * the env depends on microcontroller
+    * IDE is your env if you use ((*PSoC5LP*))
+      * you can code mruby on any text editor
+      * IDE is almost mandatory to configure hardware
+    * terminal based work is the one if you use ((*ESP32*))
+
+= dev tools for mruby/c
+
+= dev tools for mruby/c
+  * mrubyc-utils
+  * mrubyc-test
+  * mrubyc-debugger
+
+= mrubyc-utils
+  * github.com/hasumikin/mrubyc-utils
+  * one-binary tool made with mruby
+  * helps to install boilerplate of application
+  * shows mruby/c's classes and methods
+
+= mrubyc-utils
+  your_project $ mrubyc-utils --help
+  Usage: mrubyc-utils COMMAND [ARGS]
+
+   install        Install mruby/c repo into your local and setup templates.
+                  Please run this command at the top directory
+                  of your firmware project.
+   update         Update mruby/c repo to the newest **master** branch.
+   checkout       Checkout specified tag or commit of mruby/c repo.
+    -t | --tag      [required] You can specify anything that
+                    `git checkout` will accept.
+   tag            Show all tags of mruby/c repogitory that you installed.
+   classes        Show all the classes that are defined in
+                  mruby/c's virtual machine.
+   methods        Show all the methods that are available
+                  in a class of mruby/c.
+    -c | --class    [required] You have to specify class name
+   compile        Compile your mruby source into C byte code.
+                  This command is for PSoC Creator project. Use make command instead
+                  if your project is dedicated to ESP32 or POSIX
+    -w | --watch    [optional] Monitoring loop runs and will
+                    compile mruby source every time you touched it.
+  
+  -v | --version  Show version.
+  -h | --help     Show usage. (this message)
+
+  Dependencies:
+   git
+   mrbc (mruby compiler)
+
+= mrubyc-utils
+  your_project $ mrubyc-utils classes
+  - Array
+  - FalseClass
+  - Fixnum
+  - Float
+  - Hash
+  - Math
+  - Mutex
+  - NilClass
+  - Numeric
+  - Object
+  - Proc
+  - Range
+  - String
+  - Symbol
+  - TrueClass
+  - VM
+
+= mrubyc-utils
+  your_project $ mrubyc-utils methods --class=array
+  Array
+  - +                    - inspect
+  - <<                   - join
+  - []                   - last
+  - []=                  - length
+  - at                   - max
+  - clear                - min
+  - collect              - minmax
+  - collect!             - new
+  - count                - pop
+  - delete_at            - push
+  - dup                  - shift
+  - each                 - size
+  - each_index           - to_s
+  - each_with_index      - unshift
+  - empty?                 < Object
+  - first                    - !
+  - index                    ...
+
+= mrubyc-test
+  * github.com/mrubyc/mrubyc-test
+  * unit testing framework
+  * RubyGem implemented with CRuby instead of mruby
+  * supports stub and mock
+  * official tool of mruby/c dev team
+
+= mrubyc-test
+  * gathers information of test cases by CRuby metaprogramming power
+  * generates stub and mock methods
+  * makes all-in-one script: ((*test.rb*))
+  # image
+  # src = images/how-mrubyc-test-works.png
+  # align = center
+  # relative-width = 100
+
+= mrubyc-debugger
+  * github.com/hasumikin/mrubyc-debugger
+  * RubyGem
+  * debugger for infinite loop
+
+= (anime gif DEMO)
+(('tag:center'))\n\n\n\n
+github.com/hasumikin/\nmrubyc-debugger
+
+= summary
+
+= summary
+  * mruby/c is the smallest implementation of Ruby
+
+= summary
+  * mruby/c is the smallest implementation of Ruby
+  * we can write firmwares for microcontrollers with mruby/c
+
+= summary
+  * mruby/c is the smallest implementation of Ruby
+  * we can write firmwares for microcontrollers with mruby/c
+  * it has a short history though, it's ready for production with the Rubyish ecosystem like testing tool
+
+= (DEMO)
+(('tag:center'))\n\n\n\n
+CO(('sub:2'))
+
+= (added after conference)
+  # image
+  # src = images/co2_demo.png
+  # align = center
+  # relative-height = 95
+
+= (added after conference)
+(('tag:center'))\n\n\n\n
+the ventilation facility\nof Browar Lubicz is pretty good 👍
+
+= conclusion
+
+= conclusion
+(('tag:center'))\n\n\n\n
+(('tag:x-large:You should refresh air'))
+
+= thank you!
+  # image
+  # src = images/juji-asahi.jpg
+  # align = center
+  # relative-height = 95

data/theme.rb

@@ -0,0 +1,99 @@
+# puts font_families.sort
+@xx_large_font_size = screen_size(10 * Pango::SCALE)
+@x_large_font_size = screen_size(7.5 * Pango::SCALE)
+@large_font_size = screen_size(6 * Pango::SCALE)
+@normal_font_size = screen_size(4.5 * Pango::SCALE)
+@small_font_size = screen_size(4 * Pango::SCALE)
+@x_small_font_size = screen_size(3.5 * Pango::SCALE)
+@xx_small_font_size = screen_size(2.8 * Pango::SCALE)
+
+@default_headline_line_color = '#888888'
+@font_family = find_font_family('Rockwell')
+@foreground = "#d9333f" # タイトルスライドの文字色
+#@background = "#000000"
+
+@table_frame_color = "#ffffff"
+@table_fill_color = "#0f0428"
+@table_body_frame_color = "#ffffff"
+@table_body_fill_color = "#3f3468"
+@table_head_frame_color = "#ffffff"
+@table_head_fill_color = "#rf0428"
+
+@monospace_font_family = 'Ricty Discord'
+@preformatted_fill_color = '#000000'
+# @preformatted_centering = true
+@space = screen_y(1)
+
+include_theme('default')
+
+match(Slide, HeadLine) do |heads|
+  heads.prop_set("size", @large_font_size)
+  heads.prop_set("weight", "normal")
+  set_font_family(heads)
+end
+
+match Slide do |slides|
+  slides.each do |slide|
+    # スライドの文字色
+    slide.prop_set("foreground", "#fef263")
+  end
+end
+
+#@title_background_color = "red"
+#include_theme("title-background-color")
+@title_slide_background_image = 'images/krkrb-main.png'
+include_theme("title-slide-background-image")
+
+#@slide_logo_image = 'images/NEW_ML_LOGO.png'
+#include_theme('slide-logo')
+
+@slide_background_image = 'images/slide-background.png'
+include_theme("slide-background-image")
+
+@item_image = 'images/mark32.png'
+
+include_theme("default-item-mark")
+
+add_image_path("rabbit-images")
+
+slide_body = [Slide, Body]
+item_list_item = [ItemList, ItemListItem]
+
+indent = 30
+
+match(*(slide_body + (item_list_item * 1))) do |items|
+  name = "item1"
+  items.delete_pre_draw_proc_by_name(name)
+  items.delete_post_draw_proc_by_name(name)
+  draw_image_mark(items, @item_image, name, indent: indent)
+end
+
+match(*(slide_body + (item_list_item * 2))) do |items|
+  name = "item2"
+  items.delete_pre_draw_proc_by_name(name)
+  items.delete_post_draw_proc_by_name(name)
+  draw_image_mark(items, @item_image, name, indent: indent)
+end
+
+match(*(slide_body + (item_list_item * 3))) do |items|
+  name = "item3"
+  items.delete_pre_draw_proc_by_name(name)
+  items.delete_post_draw_proc_by_name(name)
+  draw_image_mark(items, @item_image, name, indent: indent)
+end
+
+enum_list_item = [EnumList, EnumListItem]
+
+match(*(slide_body + enum_list_item + item_list_item)) do |items|
+  name = "enum-item1"
+  items.delete_pre_draw_proc_by_name(name)
+  items.delete_post_draw_proc_by_name(name)
+  draw_image_mark(items, @item_image, name, indent: indent)
+end
+
+match(*(slide_body + enum_list_item + (item_list_item * 2))) do |items|
+  name = "enum-item2"
+  items.delete_pre_draw_proc_by_name(name)
+  items.delete_post_draw_proc_by_name(name)
+  draw_image_mark(items, @item_image, name, indent: indent)
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-hasumikin-RubyConfPoland2019
+version: !ruby/object:Gem::Version
+  version: 2019.05.14
+platform: ruby
+authors:
+- HASUMI Hitoshi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-05-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+description: |-
+  The slide for [THE RUBY CONFERENCE OF CRACOW 2019](https://krk-rb.pl/) by [hasumkin](https://github.com/hasumikin)
+
+  It will cover:
+
+  - Introducing Ruby for microcontrollers and microcontrollers themselves
+  - Things in common and difference between mruby and mruby/c
+  - How mruby/c works
+  - Development sorroundings
+  - Some actual source code of firmware application
+email:
+- hasumikin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.rd
+- Rakefile
+- config.yaml
+- images/IDE.png
+- images/bytecode.png
+- images/co2_demo.png
+- images/collage01.jpg
+- images/esp32.jpg
+- images/hasumi.jpg
+- images/how-mrubyc-test-works.png
+- images/juji-asahi.jpg
+- images/kamos.jpg
+- images/krkrb-main.png
+- images/krkrb-main.svg
+- images/krkrb-main.svg.png
+- images/m1.png
+- images/m2.png
+- images/mark32.png
+- images/mark48.png
+- images/mark64.png
+- images/monstarlab.png
+- images/monstarlab_global.png
+- images/mruby_and_mrubyc-mruby.png
+- images/mruby_and_mrubyc-mrubyc.png
+- images/mruby_and_mrubyc.png
+- images/psoc5lp_chip.jpg
+- images/raspberrypi.jpg
+- images/slide-background.png
+- images/unsoldered-2.png
+- images/unsoldered.jpg
+- images/松江城_Matsue.rb.16x9.jpg
+- images/松江城_Matsue.rb.jpg
+- mrubyc---The-smallest-Ruby-implementation-for-microcontrollers.rab
+- pdf/RubyConfPoland2019-mrubyc---The-smallest-Ruby-implementation-for-microcontrollers.pdf
+- theme.rb
+homepage: http://slide.rabbit-shocker.org/authors/hasumikin/RubyConfPoland2019/
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: mrubyc - The smallest Ruby implementation for microcontrollers
+test_files: []