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!

ACCOUNT LOGIN

Open Chrome browser, type in the address bar: pythaverse.space.

Click “Login” to open the login screen

Login to your Pythaverse account

1. Enter the Username and Password provided.
2. Click on Login to access Pythaverse account.

GETTING STARTED WITH PYTHAVERSE

Visiting the Student Workspace

After successfully logging into your account, you will see the Student Workspace (Learning space Management page). Here, you will be able to view:

1. Dashboard (View and access the main feature and content)
2. My Courses (View enrolled enrolled courses)
3. My Contests (Manage registered contests).
4. Learning Tools (Access the learning tools provided by Pythaverse)
5. Leanbot (Manage purchased Leanbot)
6. My Twinspace (Discover the virtual world)
7. My Achievement (View and manage achievement)
8. My Orders (View and manage the submitted orders)
9. My Profile (Manage user’s information)
10. Help (Access to the knowledge base)
11. From PGuide (Quickly view the user activity in Contests and Course)
12. My Badges (View and manage the achieved badge from Contests or Course)
13. Enrolled Courses (View and access the enrolled courses)
14. My Contests (View and access the registered contests)
15. Other courses and Contests (Discover the new courses and contests)
16. Notification (View notifications from contests, orders, courses and more)

Accessing the PLearn Page

• At 13. Enrolled Courses item, click on “Go” to access the enrolled course on PLearn.

Updating Information

Edit personal information (if necessary)

• Select Profile to view personal information.
• Edit the information you want to change.
• Click Submit to save.

Add parent account from the student’s account

At the My Profile screen, click Add Parent to connect the parent account:

• To connect with an existing Parent account on Pythaverse, enter the Username (Parent’s account username) on Pythaverse into the Username field and click on “Connect this account” (1). 
• Or students enter Parent’s email in the Email box and click ‘Send Invitation‘ to invite parents to create an account on Pythaverse (2).

• After the parent successfully connects the account with the child, the student’s account profile will display the parent’s information as follows:

Access Learning Tools

• On the Student Workspace page, students can access Learning tools on Pythaverse, such as: PAvatar, PSim, PGit, PHub, PMinetest Blockly, Leanbot IDE, Leanbot Blockly, PNote, PLab, PVr, etc..
• The latest tools will be continuously updated here.

INTRODUCTION TO THE PLEARN

PLearn is a learning management system specifically designed to enhance the learning experience, track progress, generate learning reports, record achievements in digital assets, make it easy for learners to access the course and support teachers in valuating each student individually or in class groups.

VIEW DASHBOARD

The Dashboard displays the following information:

• Courses Enrolled: is the total number of courses enrolled.
• Courses Completed: is the total number of completed courses.
• Activities Completed: is the number of completed operations.
• Activities Due: is the number of activities that are due and need to be completed.

VIEW COURSES PROGRESS

The progress of a course is calculated by the percentage of completed activities within the course.

VIEW THE COURSES

Click the ‘Open quick menu‘ icon and select ‘Course Archive Page‘ to view courses on PLearn.

VIEW MY COURSES

• To view recently accessed course: Select the “Recently accessed courses” tab.
• To view the learning progress: Select the “My Learning” tab.
• To view registered courses: Select the “My courses” tab.
• To view an overview of the course: Select the “Course overview” tab.

SEARCH COURSES

You can search for suitable courses based on course name in the Course overview

• In the “Search box: Enter a course name
• Click the “Enter” key to find.

VIEW COMPLETION LEVELS

Students can see the level of completion in the courses.

CALENDAR, EVENTS

• You can create reminders for important milestones and view upcoming events by clicking on the Calendar, Upcoming Events, Timeline.

• Create a study schedule or event:

1. Select Calendar
2. Click on New event
3. At Event title: enter the Title; at Date: select date and time; click Show more to enter more information.
4. Click Save.

CONTROL PANEL ON ‘DASHBOARD’

• On the Dashboard, open the control panel, click on the Open block drawer icon located in the upper right corner.

1. Resource exchange, Change PMinetes login password at My Passcode => students will be guided detail in the course Build a Sustainable City in Pythaverse.
2. View Recently Visited Courses in My socials.
3. View the Latest badges.

PLEARN LEARNING GUIDE

ACCESS MY COURSES

• After logging into PLearn, you will see your courses on the green Course Progress bar (when at least one lesson has been completed).
• Click on the course name to enter the course

LEARNING AND PRACTICING IN THE COURSE

• Each course will have Course menu, including many sections such as:
• Learning Instructions
• Course Description/ Introduction
• List of Lession (Units)
• After accessing the course, you can navigate and click on the lesson names in the Course Menu (on the left side) to view the content.
• Each course will have different content and requirements. Students open each lesson to view lectures, follow instructions, and submit assignments for completion. These results will be automatically recorded by the system and displayed on the right side of the screen.
• The illustration is from the course “Build a Sustainable City in Pythaverse“.

VIEW LEARNING INSTRUCTIONS

To view learning instructions, select the ‘Learning Instructions’. This provides guidance to help students understand and perform activities, tasks, or assignments related to the course.

VIEW COURSE INFORMATION

To view course information, select the ‘Course Information’. This section provides detailed information about the course, such as course description, objectives, study plan, etc, to help students understand the goals, tasks, and learning path of the course.

START LEARNING

Students open each Unit (lesson) sequentially to perform the following activities:

• Watch Lectures: Students self-study the lectures to grasp the knowledge and skills provided through the lessons.
• Take Quizzes (if available).
• Engage in Sharing Activities (if available).
• Submit Practical Assignments: These may include programming exercises, video presentations, robot running videos, etc., as required for each lesson.

• Note: Students watch lectures and complete activities sequentially in the course to unlock the next set of activities.
• In the course, completed activities are transitioned from sea-blue color to green

View lectures

• Click on the name of each lesson in the left menu to view the lectures.

• View lectures slide by slide: Click on each slide in the navigation bar.
• Note that during the first viewing, you need to go through the slides in sequence to unlock the lessons.

• Complete the quiz in the lecture (if available) and click Check to verify the answers.

• If you choose the correct result, the following screen will be displayed:

• If you choose the wrong result, click Retry to try again.

• A lesson is considered completed after the student has viewed all the lecture slides and selected “Next activity” to proceed to the next activity within the same lesson, or select “Next section” to move to the next lesson.

Take Quizzes (if available)

• Select Attempt quiz to start the quiz.

• Select the answer at (1) and click Next page (2) to move to the next question.

• After selecting the answer for the last question, click Finish attempt… to complete the quiz.

Sharing activities (if available)

• In the course, the instructor can introduce open-ended topics for students to interact, discuss, and share experiences in the learning process, programming, etc.

• Students click on the discussion topic to view and participate in the discussion. Choose Reply (1), Enter the response at (2), and click Post to forum (3) to submit the answer.

Submit practice exercises (if available)

• Click Add submission to open the file upload link from the computer.

• You need to submit assignments as required in the lesson. 

         >> If the assignment is saved on PGit (https://git.pythaverse.space/), copy the link from PGit and paste it into the Online text box (2).

        >> Or if it’s an image, video presentation, or task video saved on your computer, You can drag and drop files here to add them at (3), then press the Save changes (4) button as shown in the image to submit the assignment.

• The completed submission is marked as Done: Make a submission

VIEW COURSE CONTENT LIST

• Click Open course index ở bên trái màn hình.

• View Course Menu

VIEW COMPLETION PROGRESS AND LEARNING TOOLS

• To open the control panel in the course: click on Open block drawer

• View course completion progress: select Completion Progress

• View the learning tools used in the course: open and check in.Learning Tools

VIEW GRADES

• View overall grades: Right-click on the Avatar and select Grades

• View grades for each course: Click on Grade, then select the course you want to view the grades for.

VIEW CERTIFICATE

After completing the course, click on the View certificate button to see the certificate.

Go to Pythaverse homepage
Go to PLearn

To program and run your own creations on the Leanbot, please follow these phases in order:

Phase 1: Initial Setup & Connection

• Step 1: Power On the Robot
  • Turn on the power switch located on the Leanbot’s body.

• Step 2: Pair Bluetooth (First-Time Connection Only)
  • On your computer or device, search for and connect to the Bluetooth network named Leanbot XXXXXX BLE (where XXXXXX is the ID printed on the robot’s body). [And enter the code “1234” if the system requires]

• • You will hear a “Beep” sound from the Leanbot upon a successful connection.

(Note: You can skip this step if you have connected to this robot before).

• Step 3: Physical Connection
  • Using the provided USB cable, connect the Leanbot to your computer.

Phase 2: Programming in the PIDE

• Step 4: Access the Programming Environment
  • Open your web browser and access to:  https://ide.pythaverse.space/#/code

• Step 5: Create a Project and Write Your Code
  • Click “Click a new project, enter a name for your new project then hit “Create”.

• • Use the web-based programming interface to create your program for the robot.

Phase 3: Uploading Code to the Robot

• Step 6: Compile Your Code
  • Once you have finished coding, click the “Compile” button.

• • A browser pop-up window will appear with a title similar to: “ide.pythaverse.space wants to connect to a serial port”.

• Step 7: Select Port and Connect
  • In the pop-up window, find and select the correct Serial port that corresponds to your Leanbot.
  • After selecting, click the “Connect” button.

• Step 8: Upload and Wait for Signals
  • The system will immediately begin uploading your code to the robot. You will hear a single “Beep” to signal that the process has started.

• • IMPORTANT: Do not unplug the USB cable at any point during this process.
  • Upon completion, the system will display a success message, and you will hear a sequence of sounds: one “Beep” (signaling the upload is finished), followed immediately by a “Beep Beep” (signaling the robot is ready to run the new program).

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.