====== Getting Started ======

This guide helps beginner CUBLOC and Python developers get started with LogicPython.

===== Device and Firmware Requirement =====

The target device must be a microcontroller board with the LogicPython firmware installed.

===== Install LogicPython Firmware =====

    - Download the LogicPython firmware file (UF2 format), for example ''LogicPython_*.uf2''.
    - Disconnect the target device from USB.
    - Press and hold the BOOTSEL button on the device.
    - While holding BOOTSEL, connect the device to USB, then release BOOTSEL.
    - A removable drive appears (commonly named ''RPI-RP2'').
    - Copy the firmware UF2 file to that drive.
    - Wait for the copy to complete; the device will reboot automatically.
    - Reconnect to LogicPython and verify serial/device communication works.

===== Browser Requirements =====

LogicPython requires a browser that supports all of the following web APIs:

    * File System Access API
    * Web Serial API
    * Web USB API

If your browser does not support these APIs, project folder access and device communication features will not work.

===== What You Need =====

  * A supported microcontroller board
  * A USB cable for data
  * A modern browser with Web Serial support

===== Basic Workflow =====

  - Open a project folder.
  - Edit your Python code.
  - Run the project to deploy to the connected device.
  - Watch output in the Serial Monitor.

===== Next Steps =====

    * [[logicpython:first_program|Write your first program]]
    * [[logicpython:running_on_device|Deploy and run on device]]
    * [[logicpython:serial_monitor|Use the Serial Monitor]]
    * [[logicpython:index|Browse the CUBLOC API reference section]]