User Tools

Site Tools


wswan:tutorial:development_environment

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
wswan:tutorial:development_environment [2024/02/17 13:46] asiewswan:tutorial:development_environment [2025/07/12 06:15] (current) asie
Line 21: Line 21:
 ===== Configuring an IDE ===== ===== Configuring an IDE =====
  
-The Wonderful toolchain currently recommends using [[https://vscodium.com/|VSCodium]] (or another fork of VSCode) with the [[https://clangd.llvm.org/installation.html|clangd plugin]] installed. +Typically, Wonderful code is written using [[https://vscodium.com/|VSCodium]] (or another fork of VSCode) with the [[https://clangd.llvm.org/installation.html|clangd plugin]] installed.
- +
-<WRAP round info> +
-Other IDEs and editors with clangd support, such as Sublime Text and vim, should also have full compatibility. In addition, the proprietary Visual Studio Code with Microsoft's own C/C++ extensions is partially supported. +
-</WRAP>+
  
 To install the clangd plugin in VSCodium: To install the clangd plugin in VSCodium:
Line 33: Line 29:
   - Select the project extension named "clangd" provided by "llvm-vs-code-extensions".   - Select the project extension named "clangd" provided by "llvm-vs-code-extensions".
   - Press the "Install" button and follow any further instructions displayed by the IDE.   - Press the "Install" button and follow any further instructions displayed by the IDE.
 +
 +Other IDEs and editors with clangd support, such as Sublime Text and vim, should also have full compatibility. In addition, the following IDEs have been tested and should at least partially work:
 +
 +  * Visual Studio Code, using Microsoft's own C extension with IntelliSense,
 +  * CLion, using JetBrains's own C engine.
  
 ===== Installing an emulator ===== ===== Installing an emulator =====
  
-Unfortunately, the WonderSwan does not currently have a fully hardware-accurate emulator, and so verification of finished homebrew on hardware is still essentialRegardless, they are sufficient for development - there are two options available:+The best emulator for doing WonderSwan development is [[https://github.com/SourMesen/Mesen2/|Mesen 2]]. It provides a fully-featured low-level debugger and high (if not perfect) emulation accuracy. 
 + 
 +{{ :wswan:tutorial:mesen2.png?direct&600 |}} 
 + 
 +Other options include:
  
-* [[https://ares-emu.net/|Ares]] - medium-high accuracy, but does not provide a debugger ((As of recently, Ares supports debugging via a GDB stub, but gdb itself doesn't play well with 16-bit 8086 concepts.)). +  * [[https://ares-emu.net/|Ares]] - high accuracy, but does not provide a debugger ((As of recently, Ares supports debugging via a GDB stub, but gdb itself doesn't play well with 16-bit 8086 concepts.)). 
-* [[https://github.com/WonderfulToolchain/wf-mednafen/releases|wf-mednafen]] - medium accuracy, but *does* provide [a debugger](https://mednafen.github.io/documentation/debugger.html); a fork of [Mednafen](https://mednafen.github.io/).+  * [[https://github.com/WonderfulToolchain/wf-mednafen/releases|wf-mednafen]] - medium accuracy, but *does* provide [[https://mednafen.github.io/documentation/debugger.html|a debugger]]; a fork of [[https://mednafen.github.io/|Mednafen]].
  
 ===== Testing on physical hardware ===== ===== Testing on physical hardware =====
Line 57: Line 62:
 === InsideGadgets flash cartridge === === InsideGadgets flash cartridge ===
  
-InsideGadgets sells [[https://shop.insidegadgets.com/product/wonderswan-4mb-8mb-32kb-fram-flash-cart/|a compatible flash cartridge]]. These provide 64 megabits (8 megabytes) for code, 32 KB of save RAM ((A future revision may provide 128 KB of save RAM)) .+InsideGadgets sells [[https://shop.insidegadgets.com/product/wonderswan-4mb-8mb-32kb-fram-flash-cart/|a compatible flash cartridge]]. These provide 64 megabits (8 megabytes) for code, 32 KB of save RAM ((A future revision may provide 128 KB of save RAM.)) .
  
 Available for $54 new when in stock, though a new customer has to spend an additional $10 for the edge adapter and $30 for the USB flasher device, for a total of $94. If you happen to also be interested in GB/GBC/GBA homebrew, said flasher might be a good investment. Available for $54 new when in stock, though a new customer has to spend an additional $10 for the edge adapter and $30 for the USB flasher device, for a total of $94. If you happen to also be interested in GB/GBC/GBA homebrew, said flasher might be a good investment.
wswan/tutorial/development_environment.1708177580.txt.gz · Last modified: by asie