| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| wswan:guide:porting_wwitch [2024/03/16 18:30] – asie | wswan:guide:porting_wwitch [2024/03/17 07:21] (current) – asie |
|---|
| * These macros and functions are provided in ''<wwcl.h>'', which is a new header that can be used instead of ''<sys/bios.h>''. | * These macros and functions are provided in ''<wwcl.h>'', which is a new header that can be used instead of ''<sys/bios.h>''. |
| * The macros are entirely optional. If you want to declare the memory layout yourself using [[wswan:guide:memory_management|the Wonderful toolchain's]] memory management, that is supported - use ''wwcl_init_custom()'' in this situation. | * The macros are entirely optional. If you want to declare the memory layout yourself using [[wswan:guide:memory_management|the Wonderful toolchain's]] memory management, that is supported - use ''wwcl_init_custom()'' in this situation. |
| * gcc-ia16 requires a ''__far'' modifier for all constant arrays stores in ROM. See [[wswan:guide:memory_management#addressing_ram_and_rom|Addressing RAM and ROM]] for more information. | * A Freya application uses on-cartridge SRAM as static data space. This is not currently available on Wonderful - however, WonderSwan Color |
| * The Text API operates on Shift-JIS strings. To make gcc-ia16 use Shift-JIS strings instead of UTF-8 strings, pass ''-fexec-charset=shift-jis''. | * gcc-ia16 requires a ''__far'' modifier for all constant arrays to be stored in ROM. See [[wswan:guide:memory_management#addressing_ram_and_rom|Addressing RAM and ROM]] for more information. |
| | * The Text API operates on Shift-JIS strings. To make gcc-ia16 use Shift-JIS strings instead of UTF-8 strings, pass ''-fexec-charset=shift-jis'' to the compiler. |
| |
| ===== Implementation status ===== | ===== Implementation status ===== |
| //The implementation is incomplete; you can help by [[https://github.com/WonderfulToolchain/target-wswan-syslibs/tree/main/libwwcl|expanding it]].// | //The implementation is incomplete; you can help by [[https://github.com/WonderfulToolchain/target-wswan-syslibs/tree/main/libwwcl|expanding it]].// |
| |
| * The following headers should be fully implemented: | |
| * Display (''disp.h'') | |
| * Color (''libwwc.h'') | |
| * Sound (''sound.h'') | |
| * Bank (''bank.h'') is not implemented. | * Bank (''bank.h'') is not implemented. |
| * Comm (''comm.h'') implements everything except ''comm_xmodem''. | * Color (''libwwc.h'') is mostly implemented. |
| * Key (''key.h'') is missing key repeat support. | * Comm (''comm.h'') is mostly implemented (''comm_xmodem'' missing). |
| * Text (''text.h'') is not implemented. | * Display (''disp.h'') is fully implemented. |
| * Timer (''timer.h'') is missing RTC (real time clock) support. | * Key (''key.h'') is partially implemented (key repeat support missing). |
| * The implementation of System (''system.h'') is very limited. However, many of its functions are not useful when not running on top of Freya. | * Sound (''sound.h'') is mostly implemented. |
| | * System (''system.h'') is partially implemented (a lot of its functionality is only useful inside a FreyaOS environment, however). |
| | * Text (''text.h'') is partially implemented (cursor support missing). |
| | * Timer (''timer.h'') is partially implemented (real time clock support missing). |
