#MoonBit ESP32 Binding

#How to Use

• Use the following command to create a new MoonBit project:

  moon new hello-esp32

• After entering the hello-esp32 project directory, activate your ESP IDF development environment and ensure idf.py is properly configured and available:

  $ idf.py --help
  Usage: idf.py [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

• Run the following command to update the index and ensure you get the latest version:

  moon update

• Add the ESP32 support package:

  moon add moonbitlang/esp32

  This command will automatically generate a template project .moonbit_esp32, configure the ESP IDF toolchain path, and generate a Makefile.

• Use the MoonBit ESP32 Binding to blink an LED: First, import the relevant packages in src/main/moon.pkg.json:

  "import": [
      "moonbitlang/esp32/ctypes",
      "moonbitlang/esp32/components/gpio",
      "moonbitlang/esp32/components/task"
  ],

  Then write the following code in src/main/main.mbt:

  ///|
  const LED_GPIO_PIN = 12
  
  ///|
  pub fn moonbit_main() -> Unit {
    let _ = @gpio.gpio_config?(
      pin_bit_mask=1UL << LED_GPIO_PIN,
      mode=@gpio.GPIO_MODE_OUTPUT,
      pull_up_en=@gpio.GPIO_PULLUP_ENABLE,
      pull_down_en=@gpio.GPIO_PULLDOWN_DISABLE,
      intr_type=@gpio.GPIO_INTR_DISABLE,
    )
    let _ = @task.xTaskCreate(
      fn(_) {
        for {
          @task.vTaskDelay(@task.pdMS_TO_TICKS(1000))
          let _ = @gpio.gpio_set_level?(LED_GPIO_PIN, 1)
          @task.vTaskDelay(@task.pdMS_TO_TICKS(1000))
          let _ = @gpio.gpio_set_level?(LED_GPIO_PIN, 0)
  
        }
      },
      @ctypes.CString::from_bytes(b"LED Blink\x00"),
      2048,
      5,
    )
    for {
      for {
        println("Hello, Moonbit!")
        @task.vTaskDelay(@task.pdMS_TO_TICKS(1000))
      }
    }
  }
  
  ///|
  fn main {
    moonbit_main()
  }

  The above code creates two tasks: one for blinking the LED and another for printing "Hello, Moonbit!".

• Configure the build target (using ESP32-C3 as an example):

  idf.py -C ./.moonbit_esp32 set-target esp32c3

• Build the project:

  make build

  This command will package your MoonBit project into a .a file and copy it to the template project folder .moonbit_esp32.

• Choose one of the following options to proceed:
  1. Compile and flash to the device:

     idf.py -C ./.moonbit_esp32 build
     idf.py -C ./.moonbit_esp32 flash monitor

  2. Simulate using QEMU (if installed):

     idf.py -C ./.moonbit_esp32 qemu monitor

     You can find the installation instructions for QEMU here.