1. fun mruby develoment with Eclipse
2013/04/19
Team yamanekko
Masayoshi Takahashi
Yurie Yamane
使用Eclipse快樂的mruby開發

2. 自我介紹
●
山根ゆりえ(Yurie Yamane)
●
高橋征義(Masayoshi Takahashi)
self introduction

3. RubyConf 2012
our talks

4. RubyConf Taiwan 2012
our talks

5. 自我介紹
Team Yamanekko

6. ebook publisher

9. 今天的主題
Today's Topic

10. mruby
http://mrb.h2so5.net/

11. 輕量型Ruby
Minimal Ruby

12. 嵌入式Ruby
eMededdable Ruby

13. 用途
“Embedded?”

14. 用途
● 嵌入其他應用軟件
● 嵌入式系統
into application
for embedded systems

15. 用途
● 嵌入其他應用軟件
● 嵌入式系統
for embedded systems

16. FM3 (Fujitsu, Cortex M3)
http://www.kumikomi.net/interface/contents/fm3.php
target boards we've tried

17. GR-SAKURA (Renesas, RX63N)
http://japan.renesas.com/products/promotion/gr/index.jsp
target boards we've tried

18. RubyConf 2012
our talks

19. RubyConf Taiwan 2012
our talks

20. 大江戶Ruby會議03
our talks
http://www.flickr.com/photos/igaiga/8564676738/

21. 回顧
Retrospective

22. 我們的目標
= 快樂的mruby開發
Our goals is mruby for fun

23. mruby on Mac OS X
$ git clone https://github.com/mruby/mruby.git
$ ruby ./minirake
$ ./bin/mruby -e 'p "Hello World!"'
"Hello World!"
$
mruby for PCs is not so hard

24. http://www.flickr.com/photos/29638108@N06/8030322376/

25. mruby on embedded system
● get board
● get JTAG cable
● connect wire
● configure OpenOCD
● (....)
● (...we have not touched mruby...)
mruby for embedded is pretty hard

26. http://www.flickr.com/photos/everexplore/8536595421/

27. 我們需要更容易的開發環境
We need more easy-to-use environment

28. http://www.pageplugins.com/generators/fordummies/

29. “For Dummies” ???
●
指令碼語言(mruby!!)
● 不使用軟銲、不使用面包板
●
硬體(cross)除錯器
● GUI整合開發環境
● 便利的工具

30. 開發板: STM32F4 Discovery
http://www.st.com/web/catalog/tools/FM116/SC959/SS1532/PF252419
now we use STM32F4 discovery
・ARM (Coretex M4)
・1MB Flash, 192KB RAM
・4 LED
・1 switch
・on board STLINK

31. mruby的特徵
●
embeddable
●
configurable
●
pluggable

32. embeddable
Ruby
libmruby
C/C++ app/usr/bin/ruby
CRuby mruby

33. CRuby
Ruby Interpreter
*.rb (your code)
*.rb (stdlib) ext

34. mruby
mrubyVM
*.rb (stdlib)
*.rb (your code)Bytecode
(C String)
C/C++

35. pluggable
● mruby-sprintf
● mruby-print
● mruby-math
● mruby-time
● mruby-struct
● mruby-enum-ext
● mruby-string-ext
● mruby-numeric-ext
● mruby-array-ext
● mruby-hash-ext
● mruby-random
● mruby-eval
standard mrbgems

36. configurable
● MRB_USE_FLOAT
● MRB_INT64
● MRB_NAN_BOXING
● MRB_ENDIAN_BIG
● MRB_FUNCALL_ARGC_MAX
●
MRB_HEAP_PAGE_SIZE
● MRB_USE_IV_SEGLIST
● MRB_IVHASH_INIT_SIZE
● MRB_IREP_ARRAY_INIT_SIZE
● KHASH_DEFAULT_SIZE
● POOL_ALIGNMENT
● POOL_PAGE_SIZE
● MRB_STR_BUF_MIN_SIZE
● MRB_PARSER_BUF_SIZE
● MRB_PARSER_BUF_SIZE
● ENABLE_DEBUG
#define in mrbconf.h

37. 開發環境
● Eclipse + CDT
● YAGARTO GNU ARM toolchain
● st-util
● mruby tools plugin
development tools

38. 我們的軟件
● mrbgem generator (eclipse plugin)
● mruby-LED class (extensional library)
which tools/library we created

39. Our sample mruby code
● LED control class (mruby)
● porting C library into mruby
● Create mrbgem control LED port library

40. List of tools
● EclipseCDT
http://www.eclipse.org/downloads/
● GDBServer
https://github.com/texane/stlink
● YAGARTO GNU ARM toolchain
http://www.yagarto.de/
● STM32board firmware package(example code)
http://www.st.com/web/en/catalog/tools/PF257904
● mruby tools plugin (Eclipse plugin)
github(https://github.com/yamanekko) coming soon!

41. The process
1. create mrbgem for LED control
2.create mrubylibrary(include LED control gem)
3.create STM32F4Discovery project
4.create ruby program
5.execute

42. Create new mruby project

43. USE EGit
● mruby is distributed on Github
● Clone mruby repository

44. mruby project was created
● create mruby project with cloned mruby

45. CREATE CUSTOM mrbgems
● create the mrbgem to control STM32F4-Discovery's
LED port from ruby

46. CREATE NEW mrbgem WIZARD
● mrbgem wizard can create necessary files, directory
constitution and template files

47. add your code to your mrbgem

48. build_config.rb
● Write MRuby::CrossBuild with mruby-led

49. Build mruby
● Project -> Build Project
● mruby library was created. use this library in
the project of STM32f4

50. CREATE STM32F4DISCOVERY'S
PROJECT
● Get example from STMicroelectronics's site
● Get STM32F4-Discovery example from emb4fun's site
● Do necessary modifications

51. STM32F4-DISCOVERY
● Get example code from STMicroelectronics's site
http://www.st.com/web/en/catalog/tools/PF257904
stsw-stm32068.zip
● unzip -> STM32F4-Discovery_FW_V1.1.0

52. gcc's file
● .ld, makefile .s etc
http://www.emb4fun.de/arm/examples/index.html
STM32F4-Discovery.zip
STM32F4-Discovery/prj/stm32f4xxxg_flash.ld
STM32F4-Discovery/src/syscalls.c
STM32F4-Discovery/makefile
STM32F4-Discovery/cmsis/device/startup_stm32f4xx.s

53. CREATE STM32F4DISCOVERY'S
PROJECT
● Create new makefile project with existing code

54. modify makefile
● Include path
● Use mruby library
● Increase Heap size <- the most important point!
● etc...

55. Write ruby code
● Insert “beginning tag” and “ending tag”
● write ruby cord in between beginning tag and ending
tag
● Two ways to embed ruby code
1.Use menu bar
2.Use tool bar
Insert ruby code in .c file
Insert .rb file name in .c file
/* <ruby->
...
<-ruby> */
/* <rubyfile->
aaa.rb
<-rubyfile> */

56. Rubycode -> bytecode use mrbc
● to generate executable mruby code

57. Build
● Create elf file
●

58. debug
● 1. run -> externalTools -> “ST-Link”
● 2. run -> debug as -> “STM32F4-Discovery Build”

59. GDBServer infomation
● Remote debugging
●

60. Debug information
● Debug configurations
● To input Remote target

61. To start GDBServer
● Select ST-Link setting from External tools menu

62. debug

63. DEMO
● LED brink
Green on -> Orange on -> Red on -> Blue on -> all off
● 10times repeat

64. 結論
更快樂的mruby開發!
Conclusion
Happy mruby Hacking!

65. 謝謝！