rabbit-slide-hasumikin-KeebKaigi2023 2022.05.10.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bdadd24317419639077b394662232dcceb19c221f1fce06fd4ddf52858fbdb53
+  data.tar.gz: d5adc18602df421aa8689fd94d9ccc57a4e916f9983e7ce4f826f3e36e5a9bf6
+SHA512:
+  metadata.gz: 810bdb5b35daffb725fd0c459b122180a48737685685516924cd9dd0b9db79f78f584cbfd15e1bee97f17f38e053574343e9906f1f0c1b544d0424c31a994655
+  data.tar.gz: 9dedf04a7566c7e0e0bdf1d310f59208d209799df79115ebffc7f5803657e7ccfe5b5ee3b9b850049df4323be4615dcd9d1c10372c110e4253345aa64d15ee3d

data/.rabbit

@@ -0,0 +1 @@
+PointingDeviceOnThePartnerHalf.rab

data/PointingDeviceOnThePartnerHalf.rab

@@ -0,0 +1,255 @@
+= Pointing Device
+
+: subtitle
+   On The Partner Half
+: author
+   hasumikin
+: date
+   Mar. 10, 2023
+: allotted-time
+   20m
+: theme
+   theme
+
+= Today's mood
+
+* Sharing how a keybosrd firmware creator thinks
+* We won't get a conclusion today
+* New ideas are welcome!
+
+
+= PRK Firmware - Outline
+
+* QMK inspired firmware
+* Written in PicoRuby
+* You don't need to build a firmware
+* Instead, just drag and drop a `keymap.rb`
+
+= PRK Firmware - Features
+
+* Split-type, Consumer key
+* Num/Caps/Scroll lock
+* Layer, Debounce, Composite key
+* Rotary encoder, Joystick
+* RGBLED, Sounder
+
+= PRK Firmware - Coming next
+
+* Track ball / Touchpad / Joystick as a ((*Mouse*))
+* You can configure a device based on I2C, SPI and ADC
+  * PicoRuby has implemented general peripheral classes
+
+= PRK Firmware - Track ball🖲️
+
+  # image
+  # src = images/keyball44.jpg
+  # relative-height = 98
+
+= PRK Firmware - I2C Track ball
+
+  # enscript ruby
+  require "i2c"
+  require "mouse"
+
+  i2c = I2C.new(unit: :RP2040_I2C0, frequency: 100_000,
+                sda_pin: 20, scl_pin: 21)
+  mouse = Mouse.new(driver: i2c)
+  mouse.task do |mouse, keyboard|
+    left, x, up, y, push = mouse.driver.read(0x0a, 5).bytes
+    x = -left if 0 < left
+    y = -up if 0 < up
+    # LEFT: 0b001, RIGHT: 0b010, MIDDLE: 0b100
+    button = (push == 128 ? 0b100 : 0)
+    if keyboard.layer == :default
+      USB.merge_mouse_report(button, x, y, 0, 0)
+    else
+      # Works as a scroll wheel when layer is changed
+      USB.merge_mouse_report(button, 0, 0, x, -y)
+    end
+  end
+  kbd.append mouse
+
+= An issue of split-type
+
+* Pointing device works on only "Anchor"
+  * Anchor: The half that connects to USB
+  * Partner: The opposite
+
+= An issue of split-type
+
+* Pointing device works on only "Anchor"
+  * Anchor: The half that connects to USB
+  * Partner: The opposite
+
+(('tag:center'))
+(('tag:x-large'))
+((*I know you want to place balls on both sides*))
+
+= UART - Communication protocol
+
+  # enscript sh
+  #  Simplex: One wire (TRS)
+     Anchor RX <---- TX Partner
+
+  #  Full duplex: Two wires (TRRS)
+     Anchor TX ----> RX Partner
+     Anchor RX <---- TX Partner
+
+  #  Half duplex: One wire (TRS)
+  Anchor RX/TX <===> TX/RX Partner
+
+= Bit-banging half duplex
+
+  * Manually manipulating GPIO to simulate a UART communication protocol
+  * Manually toggling the TX and RX to send and receive data on ((*one wire*))
+  * MCU may breaks if both sides become TX at the same time
+
+= PRK Fimeware - Bit-banging
+
+  # enscript sh
+  Anchor(TX) ---> Partner(RX)
+     Stop-bit     : 11111111
+     Start-bit    : 0
+     Data         : 87654321
+     Stop-bit     : 11
+     Extra-bit    : 0
+  ---------------------------------------------------------------
+   Demilitarized zone (both are RX)
+     DMZ          : 0000
+  ---------------------------------------------------------------
+   Anchor(RX) <--- Partner(TX)
+     Idle-bit     : 0000
+     Stop-bit     : 1
+     Start-bit    : 0
+     Data1,2,3    : 87654321 87654321 87654321
+     Stop-bit     : 1
+  ---------------------------------------------------------------
+  Anchor(TX) ---> Partner(RX)
+     Idling       : 0
+
+= PRK Fimeware - Bit-banging
+
+  * In a bit-bang cycle,
+    * Anhcor sends 8 bits then receives 24 bits
+    * Partner receives 8 bits then sends 24 bits
+
+= What can 8-bit represent?
+
+  # enscript sh
+  # One key switch
+    87654321
+    ^^^      row number (0 to 7)
+       ^^^^^ col number (0 to 31)
+
+  # Four rotary encoders
+    87654321
+    ^^  ^^
+      ^^  ^^ 2-bit each (-1,0,1)
+
+= What can 8-bit represent?
+
+  # enscript sh
+  # One coarsened axis data of an analog stick
+    87654321 (0 to 255. Originally 12 bits: 0 to 4095)
+
+  # One axis and one button of a pointing device
+    87654321
+     ^^^^^^^ Signed 7 bit (-64 to 63)
+    ^        Button push
+
+= How many bits are required?
+
+* A key switch: 8 bits
+* A rotary encoder: 2 bits
+* A joystick (X, Y): 16 bits (ideally 24 bits)
+* A pointing device (X, Y, 2 buttons): 16 bits
+  * If more buttons or multiple gestures: 17+ bits
+
+= What if a track ball on partner?
+
+* We'd need 40 bits (5 bytes) data width
+  * 24 bits (3 bytes) for three key switches
+  * 16 bits (2 bytes) for a track ball
+
+= 24 bits width would be short
+
+  # enscript sh
+  Anchor(TX) ---> Partner(RX)
+     Stop-bit     : 11111111
+     Start-bit    : 0
+     Data         : 87654321
+     Stop-bit     : 11
+     Extra-bit    : 0
+  ---------------------------------------------------------------
+   Demilitarized zone (both are RX)
+     DMZ          : 0000
+  ---------------------------------------------------------------
+   Anchor(RX) <--- Partner(TX)
+     Idle-bit     : 0000
+     Stop-bit     : 1
+     Start-bit    : 0
+     Data1,2,3    : 87654321 87654321 87654321
+     Stop-bit     : 1
+  ---------------------------------------------------------------
+  Anchor(TX) ---> Partner(RX)
+     Idling       : 0
+
+= Plan A: Expand the data width
+
+  # enscript sh
+  Anchor(TX) ---> Partner(RX)
+     Stop-bit     : 11111111
+     Start-bit    : 0
+     Data         : 87654321
+     Stop-bit     : 11
+     Extra-bit    : 0
+  ---------------------------------------------------------------
+   Demilitarized zone (both are RX)
+     DMZ          : 0000
+  ---------------------------------------------------------------
+   Anchor(RX) <--- Partner(TX)
+     Idle-bit     : 0000
+     Stop-bit     : 1
+     Start-bit    : 0
+     Data1,2,3,4,5: 87654321 87654321 87654321 87654321 87654321
+     Stop-bit     : 1                          👆👆👆👆 👆👆👆👆
+  ---------------------------------------------------------------
+  Anchor(TX) ---> Partner(RX)
+     Idling       : 0
+
+= Plan A: Expand the data width
+
+* Plan A: Easy to implement but,
+  * What if one needs 6 bytes?
+  * Joystick and rotary encoders and,......🔥
+
+= Plan B: Multiple comm threads
+
+* Divide threads into:
+  * Thread 1: 24 bits for three key switches
+  * Thread 2: 24 bits for user difined device
+  * Each input sustains for two thread cycles
+* Three or more threads?🤔
+
+= Plan B: Multiple comm threads
+
+* Plan A: Easy to implement but,
+  * What if one needs 6 bytes?
+  * Joystick and rotary encoders and,......🔥
+* Plan B: Harder to implement🐛
+* Both: Poorer performance?
+
+= Plan C: ??????????????????????
+
+(('tag:center'))
+(('tag:xx-large'))
+If you have an idea, reach out to\n(twitter | github).com/hasumikin
+
+= chapter
+
+(('tag:xx-large'))
+((*Thank you!!!!q*))
+== prop
+: hide-title
+   true
+

data/README.rd

@@ -0,0 +1,24 @@
+= Pointing Device On The Partner Half
+
+Presentation slide for KeebKaigi 2023
+
+== For author
+
+=== Show
+
+  rake
+
+=== Publish
+
+  rake publish
+
+== For viewers
+
+=== Install
+
+  gem install rabbit-slide-hasumikin-KeebKaigi2023
+
+=== Show
+
+  rabbit rabbit-slide-hasumikin-KeebKaigi2023.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("rabbit-theme-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,24 @@
+---
+id: KeebKaigi2023
+base_name: PointingDeviceOnThePartnerHalf
+tags:
+  - PicoRuby
+  - PointingDevice
+  - Firmware
+presentation_date: '2023-05-10'
+presentation_start_time: 
+presentation_end_time: 
+version: 2022.05.10.0
+licenses: ["MIT License"]
+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/theme.rb

@@ -0,0 +1,177 @@
+# puts font_families.sort
+@xxx_large_font_size = screen_size(12 * Pango::SCALE)
+@xx_large_font_size = screen_size(9 * Pango::SCALE)
+@x_large_font_size = screen_size(8 * Pango::SCALE)
+@large_font_size = screen_size(7 * Pango::SCALE)
+@normal_font_size = screen_size(5 * Pango::SCALE)
+@small_font_size = screen_size(4.5 * Pango::SCALE)
+@x_small_font_size = screen_size(3.5 * Pango::SCALE)
+@xx_small_font_size = screen_size(3 * Pango::SCALE)
+
+@font_family = find_font_family('Saira')
+@monospace_font_family = 'Courier Prime'
+@title_font_family = find_font_family('Saira')
+
+# colors
+foreground = "#e9fd01"
+light_gray = "#444444"
+green = "#b5ff14"
+pink = "#fc0fc0"
+blue = "#00bfff"
+
+@default_headline_line_color = pink
+@default_headline_line_width = 2
+@default_headline_line_expand = true
+
+@default_emphasis_color = pink
+@default_emphasis_level2_color = "#ffffff"
+
+set_graffiti_color green
+set_graffiti_line_width 5
+
+@preformatted_fill_color = '#222222'
+# @preformatted_centering = true
+@space = screen_y(1)
+
+@image_slide_number_start_flag_color = pink
+@image_slide_number_goal_flag_color = blue
+
+#@slide_headline_hide = true
+
+@slide_background_image = 'images/assets/body_2.png'
+include_theme("slide-background-image")
+
+@title_slide_background_image = 'images/assets/cover_2.png'
+include_theme("title-slide-background-image")
+
+include_theme('default')
+
+match(Slide) do |slides|
+  slides.margin_left = 100
+  slides.margin_right = 100
+  slides.prop_set("foreground", foreground)
+end
+match(Slide, HeadLine) do |heads|
+  heads.margin_top = 0
+  heads.prop_set "foreground", blue
+#  heads.prop_set("weight", "normal")
+#  set_font_family(heads)
+end
+
+match TitleSlide do |slides|
+  slides.margin_left = 0
+  slides.prop_set("foreground", foreground)
+end
+match TitleSlide, Title do |title|
+  title.margin_top = 250
+  title.prop_set "size", @xxx_large_font_size
+  title.prop_set "font-family", @title_font_family
+  title.prop_set "weight", "bold"
+end
+match TitleSlide, Subtitle do |subtitle|
+  subtitle.margin_top = -100
+  subtitle.prop_set "size", @xxx_large_font_size
+  subtitle.prop_set "font-family", @title_font_family
+  subtitle.prop_set "weight", "bold"
+end
+match TitleSlide, Author do |author|
+  author.margin_top = -50
+  author.prop_set "size", @large_font_size
+  author.prop_set "foreground", pink
+end
+match TitleSlide, Date do |date|
+  date.margin_top = -20
+  date.prop_set "size", @x_small_font_size
+  date.prop_set "style", "normal"
+  date.prop_set "foreground", blue
+end
+match TitleSlide, Institution do |i|
+  i.prop_set "size", @x_small_font_size
+  i.prop_set "style", "normal"
+end
+
+#@slide_logo_image = 'images/mark_g.png'
+#include_theme('slide-logo')
+
+@item_image_1 = 'images/assets/bullet-point.png'
+@item_image_2 = 'images/assets/bullet-point.png'
+@item_image_3 = 'images/assets/bullet-point.png'
+
+include_theme("default-item-mark")
+
+add_image_path("rabbit-images")
+
+slide_body = [Slide, Body]
+item_list_item = [ItemList, ItemListItem]
+
+indent = 50
+
+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_1, 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_2, 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_3, 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_1, 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_2, name, indent: indent)
+end
+
+# table
+all_table = ["**", Table]
+match(*(all_table + [TableBody, TableRow, TableCell])) do |cells|
+  set_font_family(cells, @monospace_font_family)
+end
+match(*(all_table + [TableHead, TableRow, TableHeader])) do |headers|
+  set_font_family(headers, @monospace_font_family)
+end
+
+match("**", Emphasis, Emphasis) do |texts|
+  texts.prop_set("foreground", @default_emphasis_level2_color)
+  texts.prop_set("weight", "normal")
+end
+
+# Chapter
+match Slide do |slides|
+  slides.each do |slide|
+    if slide.match?(/sub_chapter/)
+      slide.horizontal_centering = true
+    elsif slide.match?(/chapter/)
+      set_font_family slide, @title_font_family
+      slide.horizontal_centering = true
+    elsif slide.match?(/cite/)
+      slide.prop_set "foreground", foreground
+      slide.horizontal_centering = true
+    end
+  end
+end
+
+match("**", PreformattedBlock) do |blocks|
+  blocks.prop_set("foreground", foreground)
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-hasumikin-KeebKaigi2023
+version: !ruby/object:Gem::Version
+  version: 2022.05.10.0
+platform: ruby
+authors:
+- HASUMI Hitoshi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2023-05-10 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: Presentation slide for KeebKaigi 2023
+email:
+- hasumikin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- PointingDeviceOnThePartnerHalf.rab
+- README.rd
+- Rakefile
+- config.yaml
+- images/assets/body_1.png
+- images/assets/body_2.png
+- images/assets/body_3.png
+- images/assets/bullet-point.png
+- images/assets/cover_1.png
+- images/assets/cover_2.png
+- images/assets/cover_3.png
+- images/keyball44.jpg
+- pdf/KeebKaigi2023-PointingDeviceOnThePartnerHalf.pdf
+- theme.rb
+homepage: https://slide.rabbit-shocker.org/authors/hasumikin/KeebKaigi2023/
+licenses:
+- MIT License
+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.4.12
+signing_key: 
+specification_version: 4
+summary: Pointing Device On The Partner Half
+test_files: []