A. INTRODUCTION TO PTUTOR

PTutor is an AI (Artificial Intelligence) designed to assist students in effortlessly writing code programs and enhancing the efficiency of learning Leanbot programming. PTutor helps Leanbot programming with the following main features:

B. HOW TO USE PTUTOR

To use PTutor, users need to visit the Leanbot IDE page, then click on PTutor. 

• The Leanbot IDE is a tool used for writing programs and compiling code to upload to the Leanbot robot.
• With PTutor, users will quickly comprehend the meaning of each command line, code segment, functions used or debug the programming your code programs.

I. ACCESS LEANBOT IDE TO PROGRAMMING LEANBOT

STEP 1. LOG IN TO THE LEANBOT IDE

• Access Leanbot IDE from your course on PLearn, or directly to link https://ide.pythaverse.space/ to write a program for the Leanbot robot.
• You need to log in to your Pythaverse account, then click “Login” button (if not logged in):

• Go to the Leanbot IDE page interface after successfully logging in:

STEP 2. SELECT “CODE” AND CREATE NEW PROJECT

• Select “CODE”

• Create New Project: enter Project Name and click “CREATE”

STEP 3. WRITING PROGRAMS FOR LEANBOT

On Leanbot IDE, users perform programming to run Leanbot as shown below:

STEP 4. CHECK THE PROGRAM ON PTUTOR

To better understand and check the correctness of your program, you can refer to PTutor in the section ‘PTUTOR USER GUIDE‘.

II. PTUTOR USER GUIDE

ACCESS TO PTUTOR

Click “PTUTOR” on Leanbot IDE

This is the PTutor interface:

HOW TO USE PTUTOR

PTutor has four features, and its usage is as follows:

Select “Explain the code for me”

• You need to paste your code here, then click “Enter” to start.
• For example: Copy and paste the provided sample code, then observe the results.

• PTutor will provide feedback promptly below:

• You can utilize the chat feature to ask any additional questions if further clarification is needed, available in the ‘Chat here‘ box.

Select “Help me debug the code”

• You need to paste your code here, then click “Enter” to start.
• For example: Copy and paste the provided sample code, then observe the results.

• PTutor will provide feedback promptly below:

Select “Example code for function”

Here, users can better understand the functions used to program Leanbot through specific examples.

• First, enter the function name. Just enter three characters, and PTutor will suggest functions from the corresponding Leanbot library for you to choose from.

• Next, select a function and press “Enter” to view example code.

• If you wish to view another function example, simply delete the selected one, enter a new function, and press Enter.

Select “Example code to do a task”

• Enter the task description and press enter. For example, Program Leanbot to open and close the gripper.

• PTutor will provide feedback below. For example:

• Users can add additional prompts in the chat box.

To experience Leanbot Digital Twin, you need to grant Leanbot permission to connect to the Internet for transmitting and receiving data related to Leanbot’s activities within the system. To achieve this, you can follow this Using PC Gateway tutorial (DO NOT use Android Gateway app).
Here are detailed instructions on how to use Gateway PC:
The steps include:

I. Upload code to Leanbot

Step 1. Visit the PGit page to go to the DigitalTwin folder

• On PGit, click on leanbot/Example/DigitalTwin folder.
• Here, you will find program codes for experiencing Leanbot Digital Twin.

Step 2. Double-click to open a mission file

For example, select the “Mission_1.1.ino” file

Step 3. Copy all program code, click “PCodeEditor” to redirect to PIDE page

• (1) Select all program code and press “Ctrl+C” key to copy
• (2) Click “PCodeEditor” to redirect to PIDE page

Step 4. Create a new project on PIDE page

• (1) Click “CREATE A NEW PROJECT” button
• (2) Input your project
• (3) Click “CREATE” button

Step 5. Press “Ctrl+A” and “Ctrl+V” keys at ‘area to paste the copied code’

Step 6. Connect Leanbot to PC

Using a USB cable to connect Leanbot to PC.

Note: It is recommended to turn Leanbot on before connecting to the computer.

Step 7. Select the “Compile & Upload” icon

Step 8. Select USB Serial (COMx) on your PC, click “Connect” to upload code to Leanbot

Step 9. Successfully upload program code to Leanbot

• Icon (1) displays when Leanbot is successfully connected to the PC via USB cable.

• Receive a notification when the code upload is successfully completed, it will display “100% – Done!”(2).

II. Connect Leanbot to PC via Bluetooth

Step 1. Search for Bluetooth on your PC (personal computer)

• On your PC, Click on the ‘Start’ menu-> Enter key ‘Bluetooth’ to search -> then select “Bluetooth and other devices settings“.
• For example, Bluetooth settings on Windows 10 Pro.

Step 2. Turn on the Leanbot robot

When the robot is turned on, you can see the Bluetooth light on the robot blinking.

Step 3. Search Leanbot ID (without BLE) and click “Pair“

• Select Leanbot ID (without BLE) and click “Pair“.
• For example, select Bluetooth connection with ‘Leanbot ID‘ as Leanbot 157163. Do not select Leanbot 157163 BLE.

• Verify your Leanbot ID (as shown in the image below)

• Each Leanbot is assigned a unique Leanbot ID.

Step 4. Enter the passcode as: “1234” and click“Next“ button to connect.

Step 5. Successfully connect Leanbot robot to PC via Bluetooth

When Leanbot robot is successfully connected to the computer via Bluetooth, and it will display “Connected“.

Step 6. How to verify the Port (COMx) before connecting Leanbot to the PC Gateway

• Search for “Devices and Printers“
• The example image is on the Windows 10 Pro operating system.

• Double click on the Leanbot ID icon.
• For example, Leanbot has ID 157163.

• You will rely on the COM port found on your computer and use it to connect to PC Gateway.
• For example, Leanbot uses Port (COMx) to connect to the Gateway, and in this case, it’s Port (COM4).

III. Connect Leanbot to PC Gateway for data transmission

Step 1. Access to the Gateway

There are 2 ways as follows:

• Option 1: Access LEANBOT – DIGITAL TWIN DEMO course on PLearn page.
  Open the lesson to perform the mission on Leanbot Digital Twin, then click on “Gateway” button on the mission screen.
  • For example, ms1 – The Leanbot moves forward, backward.
    • On the left menu, select a mission.
    • Left-click to open it.
    • Then, click the “Gateway“ button.
  • Other missions are also performed similarly to ms1.

• Option 2: Access to the Gateway

Step 2. (Only if you experience Chrome crashing) Reset permission on Chrome browser

• Do not select Leanbot ID, because this will lead to Chrome crash
• In case Leanbot ID is selected by mistake (in step 4), please correct the mistake by following these ‘Reset permission’ steps:
  • Click on the “Lock” icon (1). For example, Leanbot ID is Leanbot 157163
  • Then click the “Reset permission” button (2)
  • Go to Step 3.

Step 3. Click the “Select Leanbot to connect”

Step 4. Select a connection Port (for robot connected on PC via Bluetooth)

• Select the correct Port (COMx). There are various COM ports available depending on your computer.
• Then click “Connect”.
• DO NOT select Leanbot ID. If you select it incorrectly, repeat Step 2.
• Example 1: as shown in the picture, the Port (COMx) corresponds to Port (COM4). This image is used on Chrome browser version 117.0.5938.134 or higher.

• Example 2: the port (COMx) corresponds to Port (COM6). This image is used on older versions of Chrome browser.

Step 5. Connect Leanbot to Gateway for successful data transfer

• The Bluetooth light stops blinking when the Gateway connection is successful

• During the experience, if the robot is disconnected, the Bluetooth light on Leanbot robot is blinking, you need to reload this page and repeat steps from Step 2 to Step 5.

IV. Experience Leanbot Digital Twin

Step 1. Prepare

To experience Leanbot Digital Twin, you must use the following codes to upload to Leanbot, then access LEANBOT – DIGITAL TWIN DEMO course on PLearn.

Step 2. Click “Run” at the mission practice screen on PLearn page

– Example 1 with mission “ms1.1“

– With mission ‘Leanbot movement on Mars Field Track‘ as “ms11.1″, “ms11.2” also does the same.

Step 3. Wait for the system to check the connected devices

– Example 1, mission “ms1.1”

Click “Start now” button to begin.

– With respect to mission ‘Leanbot movement on Mars Field Track’ as “ms11.1”, “ms11.2” performs the same action.

Step 4. Robot runs mission on the Leanbot Digital Twin

– With mission “ms1.1” move forward and backward

• Place the robot on a flat table.
• Then, go to Step 5

– With missions Leanbot movement on Mars Field Track as “ms11.1” or “ms11.2” moving along the black line

• The Leanbot robot must first learn to recognize black and white lines on the Mars fieldtrack.
• Next, go to Step 4

Step 5. Place the robot at starting point A and go to Step 5

• All experience missions perform this step.
• Regarding the mission ms1, you can choose whether to use the Mars fieldtrack or just do it as Step 4. After that, continue to Step 5, and the robot will execute the mission.

Step 6. Run Leanbot robot on Digital Twin

The Digital Twin screen displays the following information: Status: Ready, Time: 0.000000 and Score: 0, then click the “Start” button to begin.

Note: To guarantee the robot transmits accurate data, only click the “Start“ button when all the above information (Status, Time, Score) is displayed.

– Example 1 with mission “ms1.1”

– With mission Leanbot movement on Mars Field Track “ms11.1”, “ms11.2”

Step 7. Leanbot robot completes the mission

When Leanbot robot completes the mission, the updated status is Finish.

– Example 1 with mission “ms1.1”

– Example 2 with mission “ms11.2”

The final step is confirming mission completion

• To confirm mission completion, click “Verify task completion” (1), click “OK” (2) and close the tab (3) on the browser screen to conclude the mission.

• At the mission screen on PLearn, search for robot activities by clicking the “Search” to find recently executed robot activities

Note:
– You need to follow the above steps correctly to join in the Leanbot Digital Twin experience.

– DO NOT turn off the Leanbot robot.

– If you wish to run a mission again, you can “Reload this page” after completing Step 7, then press the “Reset“ button on the robot and follow the instructions in Step 6

• Reload this page to run a mission again.

• Reset Leanbot robot. DO NOT turn off the robot.

Pythaverse Team.

Back to Top

Port Connection Error Image

Cause: The computer does not have the connector driver installed

• You can try to follow the instruction video below:

• Or follow these steps:

Step 1: Visit to link https://learn.sparkfun.com/tutorials/how-to-install-ch340-drivers/all

Step 2: Click Drivers (If You Need Them)

Click “Drivers (If You Need Them)”

Step 3: Click “Window (EXE)” to download the driver file for Windows OS

• Click Window (EXE) to download

Click Windows (EXE) to download

• Note: You have the choice to select the fitting driver for your computer’s operating system.

Step 4: Select the folder to save the file and click “Save” on your computer”

Click “Save” on your computer

Step 5: Select Open file

• After the download is complete, we will get the CH341SER.EXE file as shown below.
• Right click and select Open file or double click to proceed with the installation.

Select Open file

Step 6: Click “Run” button

Click Run to install

Step 7: Click “Install” button

Click the “Uninstall” button first, then click on the “Install” button.

Windows CH340 Driver Installation

Step 8: Click OK to complete the installation

• Wait for a few seconds, a window will appear saying that the installation is successful, select OK to finish.

Click OK to finish the installation

• Congratulations, you have successfully installed the port driver connected to the Arduino board!

A. CREATE A REPOSITORY ON PGIT

To create a repository on PGit, you need to do the following steps:

Step 1. Login to PGit

• Visit to the link https://git.pythaverse.space/, click ‘Sign in with Pythaverse eID’ button.

• Login to PGit successfully

Step 2. Click ‘New repository’

You can create a new repository on your personal account or any organization where you have sufficient permissions

• In the upper-right corner of any page, use the  drop-down menu (1), and select ‘New repository’ (2).

• Enter your ‘Repository name’: type a name for your repository (1), and add a description of your repository.
• You choose ‘Initialize this reponsitory with an empty commit‘ (2)
• Next, press the ‘Create repository’ (3) button.

• Repository created successfully

B. RENAME A REPOSITORY ON PGIT

• To rename a repository, you click to ‘Settings’ (1)
• Select the ‘Danger Zone’ tab (2).
• At the ‘Rename repository’ section, enter a new repository name (3) and click the ‘Rename’ (4) button.

• Click the ‘OK’ button to confirm the repository rename

C. HOW TO SAVE PROGRAMMING CODE FILES ON PGIT

• On PGIt, select one of your repositories to save the code files.

• Then, click on ‘Create a new file’.

• Copy the code program created on PIDE and paste it into the file (1), give the file a name (2), and click the ‘Commit changes’ button (3) to create the file and save the information.

• Your program file has been successfully created and saved on PGit.

Step 1. Charge Leanbot by plugging in the cord as shown in the photo

Step 2. You should see the LED above the battery flashing (blue or red). This means that the Robot battery is being charged.

Step 3. When you see that the LED is no longer blinking, it means that the robot battery is fully charged.
Charging time is usually between 2-4 hours, depending on how long the robot is used.

To learn Leanbot effectively, you will regularly use the following 4 learning aids, throughout the learning process:

1. Pythaverse Homepage: Access link https://pythaverse.space/ and log in to your Pythaverse account to access your Main Workspace page.

2. PLearn page: Click PLearn on Main Workspace or visit the link https://learn.pythaverse.space/ to open a page dedicated to learning.

3. Leanbot IDE page: https://ide.pythaverse.space/#/code is a page for editing, compiling, and uploading code to Leanbot.

4. PGIT page: https://git.pythaverse.space/ is a page that saves and manages code.

5. Leanbot Blockly: https://ide.pythaverse.space/lbeditor/ is page for programming with Basic Blockly

Prepare

At the Leanbot IDE page, ready to upload coding the program into Leanbot

Step 1. Turn on Leanbot

When Leanbot is turned on (1), you will see the light on Leanbot glow red (2).

Step 2. Plug USB cable from computer into Leanbot

Step 3. Click “Compile & Upload” button

To load the program into Leanbot, press the “Compile & Upload” button.

Step 4. Select COM port

4a. If no window popup, go directly to Step 5.
(When upload was successful previously)

4b. If “wants to connect to a serial port” window popup:

1. Select the correct serial port
2. Then click “Connect”

4c. If wants to connect to a serial port window popup but empty:

1. Plug in the USB cable again
2. Then go to Step (4b)

Step 5. Wait until Upload done (100%)

5a. Wait for the program to upload…

• Uploading 25%…
• Uploading 50%…
• Please wait a few seconds until it’s done!

5b. The code program is uploaded successfully
On the web browser appears the icon (1) has successfully connected Leanbot with your computer.
The screen shows the message:“100% – Done!” (2)

Step 6. Leanbot is now running the newly uploaded program

After the code program is uploaded, unplug Leanbot from the computer.

Notes:

• Do not need to Refresh / Reload page before Uploading code.
• Make sure BOARD is ARDUINO UNO or ARDUINO NANO.
• Leanbot is fully charged before loading the program.