RTsoft Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
=== Proton Arduboy Simulator ==

{{:proton:arduboysim.png?300}}

See a Vine of it in action [[https://vine.co/v/i9H5ZYWvLFV|here]].

== What does it do? ==

It's a harness to run code written for the [[https://www.arduboy.com|Arduboy]] in Visual C++ 2005. It fakes the Arduboy API (Based on V1.2 of the Arduboy library) so I can test and debug my stuff in my favorite development environment.  The identical code can then be run on the real Arduboy.

== Features/Good stuff ==

  * Runs the Arduboy examples at full speed
  * Can interact with the mouse (click the buttons, easy) or the keyboard
  * Pixel perfect simulation, includes AbPrinter, WCharacter, WString, etc
  * Even code pieces that lacks reentrancy (like a giant while loop until a key is pressed) work ok

== Issues/Bad stuff ==

  * This is NOT an emulator that can run Arduino binaries.  It's a simulator that can compile Arduboy Arduino sketches - so this is only useful if you are a developer!
  * No EEPROM simulation (eeprom.h exists but it just stubs stuff out to avoid errors)
  * No audio simulation (ArduboyPlaytune.h exists but it just stubs stuff out to avoid errors)
  * No LED light simulation, those commands will just do nothing
  * Somewhat hacky, only works with Windows. Wouldn't be tough to fix that and make it worth with other things though, for example, a html5 export shouldn't be too hard hard
  * Unfortunately optimized stuff like TEAM a.r.g's games won't run because they don't use the original Arduboy.h/cpp class. You'd have to modify Arglib.* in a similar way as I did for Ardoboy.* for it to work, or add any missing things to my version of the Arduboy class.

== How to compile and run it as is ==
* The Proton ArduboySim/win subdirectory contains the Visual C++ solution to open.  This is included with the main Proton distribution which you can get [[http://www.rtsoft.com/wiki/doku.php?id=proton:download|here]]. (What's Proton SDK?  It's kind of like SDL but you include all the .cpp files rather than use a library)

By default I've included a slightly modified version of Arduboy's breakout example. To run it, open the Visual Studio project and compile the "Debug GL" or "Release GL" configuration.

Hopefully it runs.

== How to convert your own Arduboy code/sketch to run ==

  * Add your sketch files to <proton install dir>/ArduboySim/Arduboy. (you should probably delete break_outbitmaps.* as your sketch likely doesn't use them)
  * Replace ardu_main.cpp with the contents of your .ino file. Delete your .ino file, you won't need it anymore, Arduboy.ino will be used instead
  * Rename begin() and loop() to main_being() and main_loop()
  * You can now try compiling.  Likely it will fail with a bunch of errors because Visual C++ isn't automatically creating function declarations now that it's a normal .cpp file.  Create your own (example: void myfunction();) and paste them at the top of the .cpp or in its .h file.
  * Your thing might run now!  If not, it's probably because of something I'm not simulating yet and you'll have to add it

== How to run your converted sketch on the real Arduino ==

Just double click <proton install dir>/ArduboySim/Arduboy/Arduboy.ino and compile and install like usual, it should work.  You can zip up just that dir if you want to give the Sketch source to somebody, it works the same as usual despite the tweaks.

== Thoughts/Notes ==

  * Maybe there is a better way than the dummy .ino file calling main_begin() and main_loop(), dunno, but this does work.
  * Most code is copied from the Arduboy/Arduino project and not mine. Feel free to use/steal any the stuff I wrote in the ArduboySim or /shared/Arduboy directory trees as needed.