Bytebeat virtual machine for M5Stack Cardputers.
Running bytebeat on ESP32 boards using i2s api can be simple as:
#include <ESP_I2S.h>
I2SClass i2s;
int t = 0;
void setup() {
i2s.setPins(41, 43, 42);
i2s.begin(I2S_MODE_STD, 8000, I2S_DATA_BIT_WIDTH_16BIT, I2S_SLOT_MODE_STEREO);
}
void loop() {
uint8_t b = t*(((t>>12)|(t>>8))&(63&(t>>4)));
int16_t s = (b - 128) * 50;
uint32_t frame = (s & 0xFFFF) | (s << 16);
i2s.write((uint8_t*)&frame, 4);
t++;
}
Upload this to your ESP board and boom! You have some classic bytebeat going on. If you are happy with this do not bother reading further. Just be happy and move on.
However ... If you want to program bytebeat and floatbeat on the fly on your tiny winey cardputer ... Keep on reading then, I suppose.
Bytebed started as a simple bytecode virtual machine for the bytebeat. Main feature is still on the fly support for interpreting and playing classic bytebeats. It also has more extensive and experimental features like:
- Dual syntax: Switching between infix and postfix on the fly using tab key
- Opionated floatbeat support: No while or for, just map and reduce
- JS-like arrow functions
- Strings interpreted as Base 62 number arrays
- Magic global variables and arrays for delays, feedback and such
- Forth like stack operators in prefix mode (dup, swap, over, rot)
- Comments // and /* */
- Syntax validator and error messages
- Other undocumented features (See tests)
- All math: sin/s, cos/c, floor, int, cbrt and constants like pi, e ... etc ...
- Accelerometer: ax, ay, az (Cardputer ADV only)
- Gyroscope: gx, gy, gz (Cardputer ADV only)
- Mouse (for wasm): mx, my, mv (velocity)
- ctrl + 0-9: Select bank (Presets & User patches)
- opt + 0-9: Load patch from current bank
- alt + 0-9: Save patch to location
- ctrl + z/r: Undo & Redo
- fn + 1-4: Classic visualizations
- fn + 0: History view
- fn + t: Change theme color
- fn + s: Change samplerate
- fn + f: Change between: bytebeat / floatbeat
Syncing the clock (ESP-NOW sync mode) with multiple cardputers works by setting one cardputer as the master and others as slaves. Pressing fn+m will also overwrite the current function to all the slaves that are listening.
- fn + m: Master mode: Sync
- fn + l: Slave mode: Listen
Bytebed supports two "screensharing" options that can be used to share your tiny screen using wifi captive portal or by using cardputer as bluetooth keyboard and use WASM version. These are hacky implementations for sharing the screen when performing live with cardputer.
- fn + w: Wifi sync
Use captive portal via WIFI to share the screen locally. Captive portal appears as "BYTEBED" in your wifi connections. You can also close captive portal and connect to bytebeat.local when connected to the wifi.
- fn + b: Bluetooth keyboard
Use bluetooth and wasm emulator (pages/player) if you want to share the screen over the internet. Appears as BYTEBED in your bluetooth devices. It's pretty pointless to use cardputer keyboard in this case, but hey ... it kind of works :D
Compile & Upload using Platform.io or by using M5Burner (Search for Bytebed). Latest firmware also available in Firmware folder.
- Better tests and more systematic approach for supporting floatbeat?
- Documentation huh? Meanwhile look at test/tests.h ... and vm.cpp
- Some bytebeat / floatbeat tutorial maybe?
Use platform.io and see platform.ini for configuration.
To compile to wasm and wasm binary header file, run this in wasm folder:
emcc ../src/vm.cpp ../src/compiler.cpp ../src/validator.cpp ../src/decompiler.cpp wasm_wrapper.cpp -I. -I../include -I../src -s EXPORTED_FUNCTIONS="['_main', '_get_input_buffer', '_wasm_compile', '_wasm_execute', '_wasm_decompile', '_wasm_set_sample_rate', '_wasm_set_play_mode']" -O3 -s WASM=1 -s STANDALONE_WASM --no-entry -o bytebed.wasm
xxd -i bytebed.wasm | sed 's/unsigned char/const unsigned char/g' > ../include/wasm_binary.h
Testing native and cardputer using platformio:
pio test -e native
For more verbose testing:
pio test -e native -v
For testing the hardware:
pio test -e cardputer
Brave testers needed. Free slots for your bytebeats are available!
Just do a pull request directly to free slots in state.cpp or post Issue.
Bug reports are also welcome.
- viznut: For the very first bytebeats
- SthephanShinkufag: Bytebeat-composer
- All the rest with examples from: https://dollchan.net/bytebeat/
- tanakamasayuki: EspHttpServer