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

To change the information, follow these steps:

Step 1. Log in to your Pythaverse account

Once logged in, you will be able to access to your workspace.

Log in to your Pythaverse account

Step 2. Click “Profile”

Hover over and click “Profile” to open your profile page.

Step 3. Update Personal Information

• After clicking “Profile” you’ll be directed to your user profile page, where you can update various personal information (if desired).
• The information you can modify includes
• Student name: Change your first and last name in this section.
• Password: Refer to the ‘Change the Password’ section to view detailed step-by-step instructions.
• Email address: Update your email address as needed.
• Date of Birth: Update your date of birth.
• Country: select your country.
• State/City/Province: select State/City/Province.
• School Name: select or input your school name.
• (You cannot edit the faded field).

Step 4. Click “Submit”

Click “Submit” button to save the information and complete the personal information update.

How to change the password

To change the password, follow these steps:

Step 1. Click “Profile”

• Once you’ve logged into your account and accessed your workspace, click on “Profile”

Step 2. Click “Change password”

Click “Change password” to initiate the password change process

Step 3. Start changing your password

To change your password, you need to enter the following information:

• Password: Enter your current password in the “Password” field. This confirms that you have the authorization to change the password.
• New Password: Type the password you want to use. Make sure it meets any password requirements set by the platform, such as a mix of upper and lower case letters, numbers, and special characters.
• Confirmation: Re-enter the new password exactly as you typed it in the previous step. This helps ensure that you haven’t made any typing errors.

Input password details

Step 4. Click “Save”

After entering all the information, click “Save” button to apply the changes.

Click “Save”

Step 5. Logout and Login

• To verify that the new password is functioning, log out of your account and then log back in using the updated password.

Log out of your account

• Click “Sign Out” to log out of your account.

Click “Sign Out”

• Alternatively, if you have closed the ‘Change Password’ tab on the website, then you can click ‘Logout’ as shown in the image below to log out of your account.

Log into your account using the newly changed password

Log in to your account

Note: Remember, it’s important to keep your passwords secure and avoid sharing them.

PLEARN

Access the link https://learn.pythaverse.space/

• The Learning Management System specifically designed to enhance learning experience, track Learners progress, produce progress reports, log achievement into digital assets, ease content delivery to classroom, and to help Facilitators to assess Learners individually or in groups.
• It encompasses all the pythaverse Learning tools (PSim, PHub, PCode, PGit, PLab, PVr, PAvatar, etc).

PLearn User interface

PAVATAR

Access the link https://avatar.pythaverse.space/

• PAvatar is short for Pythaverse Avatar. It is a design tool designed for students to create personal avatars on the Pythaverse platform. Through the use of this tool, students can enhance their creativity in the fields of design and art.

PAvatar User interface

PCODE

PCode is short for Pythaverse Code. It is a collection of tools used for programming, including: PGit, PMinetest Blockly, Leanbot Blockly, Leanbot IDE.

PGit

Access the link https://git.pythaverse.space/

• PGit stands for Pythaverse Git. It is a cloud-based version control system for programming files, tracking changes, and collaborating on code.
• Students can download source code to their computers or upload source code from their computers to PGit for storage.
• PGit can be used anytime, anywhere with a computer by logging in to the Pythaverse account.

PGit User interface

PMinetest Blockly IDE

Access the link https://ide.pythaverse.space/mteditor/

PMinetest Blockly is used to create simple programs and commands with basic Blockly LUA programming by dragging, dropping, and sending code to PMinetest.

PMinetest Blockly User interface

Leanbot Blockly IDE

Access the link https://ide.pythaverse.space/lbeditor/

Leanbot Blockly is a visual programming language with an intuitive and user-friendly interface. Students use it by dragging and dropping command blocks to create programs and operations for the Leanbot robot.

Leanbot Blockly User interface

Leanbot C++ IDE

Access the link https://ide.pythaverse.space/#/code

Leanbot IDE stands for Leanbot Integrated Development Environment. It is an integrated environment for students to learn programming, write code, compile, and upload programs to the Leanbot robot.

Leanbot IDE User interface

PNOTE

Access the link https://note.pythaverse.space/

PNote stands for Pythaverse Note. It is an interactive learning tool that helps to record Learners idea, track work, observation, and thoughts, and provide reflection on the progress.

PNote User interface

PSIM

Access the link https://pythaverse.space/sim/

PSim stands for Pythaverse Simulator for Education. It is an immersive learning solution build on top of MineTest with instructional design scenarios for Learners to join, craft, build, expend, explore, and collaborate in real-time.

PSim User interface

PLAB

Access the link https://pythaverse.space/lab/

PLab stand for Pythaverse laboratory. This is a virtual laboratory integrated with experiments covering various topics from biology, chemistry, physics to environmental science.

PLab User interface

PVR

Access the link https://pythaverse.space/vr/

PVr stand for Pythaverse Virtual Excursion for Students – this is an immersive virtual tour designed with the latest role-playing technology, allowing students to explore and learn about various topics in a virtual environment, as well as enabling remote learning.

PVr User interface

PHUB

Access the link: https://pythaverse.space/hub/

• PHub stand for Pythaverse Hub – 3D environment is designed to simulate classroom, conference room… and to explore various virtual spaces specifically designed for learning purposes
• PHub is a Common verse of Pythaverse. This is an open interoperable metaverse that can integrate with 3rd party metaverse, digital assets, and blockchains. Participants, including educators, parents, students, and visitors, can join virtually and visit (free or paid) public events and spaces, such as museums, galleries, workshops, competitions, and themed parks.

PHub User interface

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