Difference between revisions of "JetRacer Pro 2GB AI Kit"

From Waveshare Wiki
Jump to: navigation, search
(Created page with "<div class="tabber"> <div class="tabbertab" title="Instruction"> {{infobox item |img=File:JetRacer-Pro-2GB-AI-Kit-1.jpg|300px|alt=JetRacer AI Kit|link=https://www.waveshare....")
 
Line 43: Line 43:
 
All the examples use WIFI, we need to connect JetRacer to WIFI firstly.
 
All the examples use WIFI, we need to connect JetRacer to WIFI firstly.
 
*Open a browser (we recommend you to use Chrome) and navigate to <font style="background-color:#EEEEEE; color:red">192.168.55.1:8888 </font>
 
*Open a browser (we recommend you to use Chrome) and navigate to <font style="background-color:#EEEEEE; color:red">192.168.55.1:8888 </font>
*Sign in with default password <font style="background-color:#EEEEEE; color:red">jetson</font>
+
*Sign in with default password <font style="background-color:#EEEEEE; color:red">jetbot</font>
 
*Open a terminal in Jupyter Lab by click '''File''' -> '''New''' -> '''Terminal'''
 
*Open a terminal in Jupyter Lab by click '''File''' -> '''New''' -> '''Terminal'''
 
*In the terminal, type the following command to list available WiFi networks, and find the '''ssid_name''' of your network. You can also skip this step if you have known the available network.
 
*In the terminal, type the following command to list available WiFi networks, and find the '''ssid_name''' of your network. You can also skip this step if you have known the available network.
Line 57: Line 57:
 
; Step 5. Install the python package
 
; Step 5. Install the python package
 
*Access JetRacer by going to <font style="background-color:#EEEEEE"  color=#red><nowiki>http://<jetracer_ip_address>:8888</nowiki></font>
 
*Access JetRacer by going to <font style="background-color:#EEEEEE"  color=#red><nowiki>http://<jetracer_ip_address>:8888</nowiki></font>
*Launch a new terminal. Default user name and password are both '''jetson'''
+
*Launch a new terminal. Default user name and password are both '''jetbot'''
 
*Get and install the latest JetRacer Pro repository from GitHub.The some of the python package provided here are modified by Waveshare for Waveshare JetRacer Pro AI Kit.  
 
*Get and install the latest JetRacer Pro repository from GitHub.The some of the python package provided here are modified by Waveshare for Waveshare JetRacer Pro AI Kit.  
 
; Step 6. Configure power mode
 
; Step 6. Configure power mode
Line 63: Line 63:
 
*You need to launch a new Terminal and enter the following commands to select 5W power mode
 
*You need to launch a new Terminal and enter the following commands to select 5W power mode
 
  sudo nvpmodel -m1
 
  sudo nvpmodel -m1
*Check if the mode is correct
+
*Check if the model is correct
 
  sudo nvpmodel -q
 
  sudo nvpmodel -q
 
【Note】m1: 5W power mode, m2: 10W power model
 
【Note】m1: 5W power mode, m2: 10W power model
Line 85: Line 85:
 
;(3) Interactive-regression
 
;(3) Interactive-regression
 
*Navigate to <font style="background-color#EEEEEE" color=#red><nowiki>https://<jetracer_ip_address>:8888</nowiki></font>
 
*Navigate to <font style="background-color#EEEEEE" color=#red><nowiki>https://<jetracer_ip_address>:8888</nowiki></font>
*Sign in with the default password jetson
+
*Sign in with the default password jetbot
 
*Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
 
*Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
 
*Open the notebook interactive_regression.ipynb and following it
 
*Open the notebook interactive_regression.ipynb and following it
 
;(4) Road-following
 
;(4) Road-following
 
*Navigate to <font style="background-color#EEEEEE" color=#red><nowiki>https://<jetracer_ip_address>:8888</nowiki></font>
 
*Navigate to <font style="background-color#EEEEEE" color=#red><nowiki>https://<jetracer_ip_address>:8888</nowiki></font>
*Sign in with the default password jetson
+
*Sign in with the default password jetbot
 
*Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
 
*Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
 
*Open the notebook road_following.ipynb and following it
 
*Open the notebook road_following.ipynb and following it
Line 132: Line 132:
 
{{FAQ|What batteries does JetRacer AI Kit use?
 
{{FAQ|What batteries does JetRacer AI Kit use?
 
| Four 18650 batteries are used and the voltage of every battery is 3.7V. Generally, the voltage per battery is 4.2V when full charging. Please use batteries without a protective plate.
 
| Four 18650 batteries are used and the voltage of every battery is 3.7V. Generally, the voltage per battery is 4.2V when full charging. Please use batteries without a protective plate.
BTW, Power of JetRacer is down when the voltage of the whole system is similar to 9V (it is not accurate), we recommend you to charge batteries if the voltage displayed is lower than 10V.<br />
+
BTW, the Power of JetRacer is down when the voltage of the whole system is similar to 9V (it is not accurate), we recommend you to charge batteries if the voltage displayed is lower than 10V.<br />
 
We recommend you to use high-quality batteries like Sanyo or Panasonic.<br />
 
We recommend you to use high-quality batteries like Sanyo or Panasonic.<br />
 
[[File:batteries _18650_en.jpg|500px]]
 
[[File:batteries _18650_en.jpg|500px]]
 
|}}
 
|}}
 
{{FAQ|What is the power adapter used to do?
 
{{FAQ|What is the power adapter used to do?
|The 8.4V power adapter is used to charge the batteries. '''DO NOT''' directly connect it to Jetson Nano Developer board.
+
|The 8.4V power adapter is used to charge the batteries. '''DO NOT''' directly connect it to the Jetson Nano Developer board.
 
|||}}
 
|||}}
 
{{FAQ|Why doesn't the motor work after setting up?
 
{{FAQ|Why doesn't the motor work after setting up?

Revision as of 09:42, 22 October 2021

JetRacer Pro 2GB AI Kit
JetRacer AI Kit

AI Racing Robot Kit base on Jetson Nano 2GB Developer Kit
{{{name2}}}

{{{name3}}}

{{{name4}}}

{{{name5}}}

Introduction

This is an AI Racing Robot kit based on Jetson Nano 2GB Developer Kit. Supports deep learning, auto line following, autonomous driving, and so on.

Notice

The Jetson Nano 2GB Developer Kit is not included in the Acce Kit, you need to buy it separately.

We do not provide batteries in the AI Kit or the Acce Package because of the shipping policy, you need to buy batteries in the local market.

User Guides

1. Hardware setup

2. Software setup

【Note】 The software part of this guide is mostly based on NVIDIA JetRacer wiki

Step 1. Write JetRacer image to SD card
JetBot AI Kit Manual 1.jpg
  • After writing, eject the SD card
Step 2. Startup Jetson Nano Developer Kit
  • Insert SD card to SD card slot of Jetson nano (slot is under Jetson Nano board)
  • Power on JetRacer AI Kit, and connect the micro USB interface of Jetson Nano Developer Kit to your PC

【Note】You had better test the Jetson Nano Developer Kit before you assemble JetRacer

Step 3. Connect JeRacer to WIFI

All the examples use WIFI, we need to connect JetRacer to WIFI firstly.

  • Open a browser (we recommend you to use Chrome) and navigate to 192.168.55.1:8888
  • Sign in with default password jetbot
  • Open a terminal in Jupyter Lab by click File -> New -> Terminal
  • In the terminal, type the following command to list available WiFi networks, and find the ssid_name of your network. You can also skip this step if you have known the available network.
sudo nmcli device wifi list
  • Connect to the selected WIFI network. Please replace the <ssid_name> and <password> to the actual name and password.
sudo nmcli device wifi connect <ssid_name> password <password>
  • After getting the successfully information, please check the ip_addtess of Wlan0 interface by the following command
ifconfig
Step 4. Connect to JetRacer over WIFI
  • Unplug the USB cable from Jetson Nano
  • Close the previous Jupyter Lab Browser tab
  • Open a new browser tab and navigate to http://<jetracer_ip_address>:8888
Step 5. Install the python package
  • Access JetRacer by going to http://<jetracer_ip_address>:8888
  • Launch a new terminal. Default user name and password are both jetbot
  • Get and install the latest JetRacer Pro repository from GitHub.The some of the python package provided here are modified by Waveshare for Waveshare JetRacer Pro AI Kit.
Step 6. Configure power mode

To ensure that the Jetson Nano doesn't draw more current than the battery pack can supply, place the Jetson Nano in 5W mode by calling the following command

  • You need to launch a new Terminal and enter the following commands to select 5W power mode
sudo nvpmodel -m1
  • Check if the model is correct
sudo nvpmodel -q

【Note】m1: 5W power mode, m2: 10W power model

3. Examples

(1) Basic motion
  • Access JetRacer by going to http://<jetracer_ip_address>:8888, navigate to ~/Notebooks/basic_motion/
  • Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
  • Open basic_motion.ipynb file and following the notebook

【Note】You can click icon ▶ to run codes, or select Run -> Run Select Cells. Make sure the JetRacer has enough space to run.

Note
If you get error when running the motion script, please open a new termial, resintall Adafruit-PureIO librares with following commands and try again.
sudo pip3 install --upgrade pip
sudo pip3 uninstall Adafruit-PureIO
sudo pip3 install Adafruit-PureIO
(2) Teleoperations
  • Access JetRacer by going to https://<jetracer_ip_address>:8888, navigate to ~/Notebooks/teleoperation/
  • Open teleoperation.ipynb file and following notebook
(3) Interactive-regression
  • Navigate to https://<jetracer_ip_address>:8888
  • Sign in with the default password jetbot
  • Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
  • Open the notebook interactive_regression.ipynb and following it
(4) Road-following
  • Navigate to https://<jetracer_ip_address>:8888
  • Sign in with the default password jetbot
  • Browse to the folder ~/jetracer/notebooks in the Jupyter Lab file browser
  • Open the notebook road_following.ipynb and following it

Guide of DonkeyCar

FAQ

 Answer:
Please open the terminal and run the following command to install torch-1.2.0
wget https://nvidia.app.box.com/public/static/06vlvedmqpqstu1dym49fo7aapgfyyu9.whl -O torch-1.2.0a0+8554416-cp36-cp36m-linux_aarch64.whl
sudo apt-get install python3-pip libopenblas-base libopenmpi-dev 
pip3 install Cython
pip3 install numpy torch-1.2.0a0+8554416-cp36-cp36m-linux_aarch64.whl --user
sudo reboot

Do not forget to reboot at the end.


 Answer:
Four 18650 batteries are used and the voltage of every battery is 3.7V. Generally, the voltage per battery is 4.2V when full charging. Please use batteries without a protective plate.

BTW, the Power of JetRacer is down when the voltage of the whole system is similar to 9V (it is not accurate), we recommend you to charge batteries if the voltage displayed is lower than 10V.
We recommend you to use high-quality batteries like Sanyo or Panasonic.
Batteries 18650 en.jpg

{{{4}}}

{{{5}}}


 Answer:
The 8.4V power adapter is used to charge the batteries. DO NOT directly connect it to the Jetson Nano Developer board.


 Answer:
Please make sure that you have installed the codes of Waveshare instead of NVIDIA's. The drive codes of the motor are different between Waveshare's and NVIDIA's. If you have updated the one from NVIDIA's, please remove the Jetracer folder and download ours by following step 5.


Supports

Support

If you require technical support, please go to the Support page and open a ticket.