.. note::

    Hello, welcome to the SunFounder Raspberry Pi & Arduino & ESP32 Enthusiasts Community on Facebook! Dive deeper into Raspberry Pi, Arduino, and ESP32 with fellow enthusiasts.

    **Why Join?**

    - **Expert Support**: Solve post-sale issues and technical challenges with help from our community and team.
    - **Learn & Share**: Exchange tips and tutorials to enhance your skills.
    - **Exclusive Previews**: Get early access to new product announcements and sneak peeks.
    - **Special Discounts**: Enjoy exclusive discounts on our newest products.
    - **Festive Promotions and Giveaways**: Take part in giveaways and holiday promotions.

    👉 Ready to explore and create with us? Click [.pnglink_sf_facebook.png] and join today!

1.5 Quick Guide on Thonny
==================================

.. _open_run_code_py:

Open and Run Code Directly
---------------------------------------------

The code section in the projects tells you exactly which code is used, so double-click on the ``.py`` file with the serial number in the ``newton-lab-kit/micropython/`` path to open it. 

However, you must first download the package and upload the library, as described in :ref:`download_upload`.

#. Open Code

   For example, ``2.1_hello_led.py``.
   
   If you double click on it, a new window will open on the right. You can open more than one code at the same time.

   .. image:: img/open_code.png

#. Select Correct Interpreter

   Use a micro USB cable to connect the Pico to your computer and select the "MicroPython (Raspberry Pi Pico).COMxx" interpreter.

   .. image:: img/sec_inter.png

#. Run the Code

   To run the script, click the **Run current script** button or press F5.

   .. image:: img/run_it.png

   If the code contains any information that needs to be printed, it will appear in the Shell; otherwise, only the following information will appear.

   Click **View** -> **Edit** to open the Shell window if it doesn't appear on your Thonny.

   .. code-block::
      
      MicroPython v1.24.0-preview.201.g269a0e0e1 on 2024-08-09; Raspberry Pi Pico 22 with RP2350
      Type "help()" for more information.
      >>> %Run -c $EDITOR_CONTENT

   * The first line shows the version of MicroPython, the date, and your device information.
   * The second line prompts you to enter "help()" to get some help.
   * The third line is a command from Thonny telling the MicroPython interpreter on your Pico to run the contents of the script area - "EDITOR_CONTENT".
   * If there is any message after the third line, it is usually a message that you tell MicroPython to print, or an error message for the code.

#. Stop Running

   .. image:: img/stop_it.png

   To stop the running code, click the **Stop/Restart backend** button. The **%RUN -c $EDITOR_CONTENT** command will disappear after stopping.

#. Save or Save as

   You can save changes made to the open example by pressing **Ctrl+S** or clicking the **Save** button on Thonny.
   
   * The code can be saved as a separate file within the Raspberry Pi Pico 2 by clicking on **File** -> **Save As**.

     .. image:: img/save_as.png

   * Select **Raspberry Pi Pico 2**.

     .. image:: img/sec_pico.png

   * Then click **OK** after entering the file name and extension **.py**. On the Raspberry Pi Pico 2 drive, you will see your saved file.

     .. image:: img/sec_name.png

     .. note::
        Regardless of what name you give your code, it's best to describe what type of code it is, and not give it a meaningless name like ``abc.py``.
        When you save the code as ``main.py``, it will run automatically when the power is turned on.


Create File and Run it
---------------------------


The code is shown directly in the code section. You can copy it to Thonny and run it as follows.

#. Create a new file

   Open Thonny IDE, click **New** button to create a new blank file.

   .. image:: img/new_file.png

#. Copy Code

   Copy the code from the project to the Thonny IDE.

   .. image:: img/copy_file.png

#. Select Correct Interpreter

   Plug the Pico into your computer with a micro USB cable and select the "MicroPython (Raspberry Pi Pico).COMxx" interpreter in the bottom right corner.

   .. image:: img/sec_inter.png

#. Run and Save the Code

   You need click **Run Current Script** or simply press F5 to run it. If your code has not been saved, a window will pop up asking to save to **This computer** or **Raspberry Pi Pico 2**.

   .. image:: img/where_save.png

   .. note::
        Thonny saves your program on the Raspberry Pi Pico 2 when you tell him to, so if you unplug the Pico and plug it into someone else's computer, your program remains intact.

   * Click OK after selecting the location, naming the file and adding the extension **.py**.

     .. image:: img/sec_name.png

     .. note::
        Regardless of what name you give your code, it's best to describe what type of code it is, and not give it a meaningless name like ``abc.py``.
        When you save the code as ``main.py``, it will run automatically when the power is turned on.

   * Once your program is saved, it will run automatically and you will see the following information in the Shell area.

   * Click **View** -> **Edit** to open the Shell window if it does not appear on your Thonny.


     .. code-block::

        MicroPython v1.24.0-preview.201.g269a0e0e1 on 2024-08-09; Raspberry Pi Pico 22 with RP2350

        Type "help()" for more information.
        >>> %Run -c $EDITOR_CONTENT


     * The first line shows the version of MicroPython, the date, and your device information.
     * The second line prompts you to enter "help()" to get some help.
     * The third line is a command from Thonny telling the MicroPython interpreter on your Pico to run the contents of the script area - "EDITOR_CONTENT".
     * If there is any message after the third line, it is usually a message that you tell MicroPython to print, or an error message for the code.


#. Stop Running

   To stop the running code, click the **Stop/Restart backend** button. The **%RUN -c $EDITOR_CONTENT** command will disappear after stopping.

   .. image:: img/stop_it.png

#. Open File

   Here are two ways to open a saved code file.

   * The first method is to click the open icon on the Thonny toolbar, just like when you save a program, you will be asked if you want to open it from **this computer** or **Raspberry Pi Pico 2**, for example, click **Raspberry Pi Pico 2** and you will see a list of all the programs you have saved on the Pico.
   * The second is to open the file preview directly by clicking **View**-> **File** -> and then double-clicking on the corresponding ``.py`` file to open it.