From ccc8911f347d5aa789fa599c73baacec426d7a59 Mon Sep 17 00:00:00 2001 From: Chitoku YATO Date: Wed, 17 May 2023 17:16:34 -0700 Subject: [PATCH 1/4] Embed YouTube videos in iframe --- docs/examples/collision_avoidance.md | 2 +- docs/examples/object_following.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/examples/collision_avoidance.md b/docs/examples/collision_avoidance.md index 1fa7924d..7d7f3572 100644 --- a/docs/examples/collision_avoidance.md +++ b/docs/examples/collision_avoidance.md @@ -3,7 +3,7 @@ In this example we'll collect an *image classification* dataset that will be used to help keep JetBot safe! We'll teach JetBot to detect two scenarios ``free`` and ``blocked``. We'll use this AI classifier to prevent JetBot from entering dangerous territory. -[![](http://img.youtube.com/vi/6cLk9TSgFSw/0.jpg)](http://www.youtube.com/watch?v=6cLk9TSgFSw "Launching of JetBots") + #### Step 1 - Collect data on JetBot diff --git a/docs/examples/object_following.md b/docs/examples/object_following.md index 3c723727..54674fed 100644 --- a/docs/examples/object_following.md +++ b/docs/examples/object_following.md @@ -5,7 +5,7 @@ In this example we'll have JetBot follow an object using a pre-trained model capable of detecting common objects like``Person``, ``Cup``, and ``Dog``. While doing this, JetBot will run the collision avoidance model from Example 3 to make sure it stays safe! -[![](http://img.youtube.com/vi/MBUEbU9Q6wg/0.jpg)](http://www.youtube.com/watch?v=MBUEbU9Q6wg "Dancing with JetBot") + 1. Download the object detection model according to the table below From b3f64b0fd28281a4df4e936e590d9c164851bf08 Mon Sep 17 00:00:00 2001 From: Chitoku YATO Date: Mon, 29 Apr 2024 17:27:04 -0700 Subject: [PATCH 2/4] Add Orin Nano version of BoM page --- docs/bill_of_materials_orin.md | 74 ++++++++++++++++++++++++++++++++++ mkdocs.yml | 4 +- 2 files changed, 77 insertions(+), 1 deletion(-) create mode 100644 docs/bill_of_materials_orin.md diff --git a/docs/bill_of_materials_orin.md b/docs/bill_of_materials_orin.md new file mode 100644 index 00000000..296fb37c --- /dev/null +++ b/docs/bill_of_materials_orin.md @@ -0,0 +1,74 @@ +# Bill of Materials - Jetson Orin Nano version + +This page lists all the parts you need to build the open-source JetBot with the new [**Jetson Orin Nano 8GB Developer Kit**](https://developer.nvidia.com/embedded/learn/get-started-jetson-orin-nano-devkit), along with purchasing links from popular vendors. + +Some of the parts are 3D printed. We provide the STL files needed to print these parts. Please see our [3d printing](3d_printing.md) page for tips on printing. + +### Common parts + +You need these components for each JetBot. + +| **Part** | **Quantity** | **Cost** | **URL** | **Notes** | +| --- | --: | --: | --- | --- | +| Jetson Orin Nano 8GB Developer Kit | 1 | $499.00 | [NVIDIA](https://store.nvidia.com/jetson/store/) | | +| Micro SD card | 1 | $14.95 | [Amazon](https://a.co/d/0aOqPQh) | 128GB | +| Battery | 1 | $12.99 | [Amazon](https://a.co/d/5DvsXGu) | PD 20W output, 10,000mAh | +| USB-C PD cable | 1 | $10.99 | [Amazon](https://a.co/d/ihjA431) | USB-C to DC 5.5mm x 2.5mm, right angle | +| Motor | 2 | $5.90 | [Adafruit](http://adafru.it/3777), [Amazon(1)](https://a.co/d/cQ489BJ), [Amazon(2)](https://amzn.to/2MU9zPb) | "TT" form factor | +| Motor Driver | 1 | $19.95 | [Adafruit](http://adafru.it/2927), [Amazon](https://a.co/d/aUs8dwA) | | +| Caster ball | 1 | $10.99 | [Amazon](https://a.co/d/3WmVtqU) | 1-inch diameter | +| USB cable pack | 1 | $6.99 | [Amazon](http://amzn.com/B01N337FQF/) | Type A to Micro, right angle | +| *PiOLED* display | 1 | $13.45 | [Adafruit](http://adafru.it/3527), [Amazon](https://a.co/d/cmRS0RE) | | +| *PiOLED* header | 1 | $7.99 | [Adafruit](http://adafru.it/1541), [Amazon](https://a.co/d/fGDbnIE), [Sparkfun](https://www.sparkfun.com/products/12792) | 2x(3+) right angle male | +| Chassis | 1 | -- | [STL file](cad/chassis.stl) | see [3D printing](3d-printing) | | +| Camera Mount | 1 | -- | [STL file](cad/camera_mount.stl) | see [3D printing](3d-printing) | + +### Camera + +You need a camera module with 22pin cable for interfacing to Jetson Orin Nano 8GB Developer Kit carrier board and the appropriate wide field of view for each JetBot. + +Select an option and get the parts specified. + +#### Option 1 (default) - IMX219 175-degree FoV camera + +| **Part** | **Quantity** | **Cost** | **URL** | **Notes** | +| --- | --: | --: | --- | --- | +| Camera | 1 | $19.99 | [ArduCam](https://www.arducam.com/product/8mp-imx219-175-degree-ultra-wide-angle-raspberry-pi-b0392/), [Amazon](https://a.co/d/gbWtB9X) | ArduCam B0392 - IMX219 175-degree | + + + +### Wheels + +You need wheels with a "TT" motor shaft connector for each JetBot. Select an option and get the parts specified. + +#### Option 1 - 60mm + +| **Part** | **Quantity** | **Cost** | **URL** | **Notes** | +| --- | --: | --: | --- | --- | +| Wheel | 2 | $5.00 | [Adafruit](http://adafru.it/3757) | 60mm diameter | +| Caster base | 1 | -- | [STL file](cad/caster_base_60mm.stl) | for 60mm wheel | +| Caster shroud | 1 | -- | [STL file](cad/caster_shroud_60mm.stl) | for 60mm wheel | + +#### Option 2 - 65mm + +| **Part** | **Quantity** | **Cost** | **URL** | **Notes** | +| --- | --: | --: | --- | --- | +| Wheel | 2 | $3.00 | [Adafruit](https://www.adafruit.com/product/3763) | 65mm diameter | +| Caster base | 1 | -- | [STL file](cad/caster_base_65mm.stl) | for 65mm wheel| +| Caster shroud | 1 | -- | [STL file](cad/caster_shroud_65mm.stl) | for 65mm wheel | + +### Assembly Hardware + +You need the following parts to build JetBot. They come in packs, so order the quantity you need for the number of JetBots you are going to build. + +| **Part** | **Qty per JetBot** | **Qty per pack** | **Cost per JetBot** | **URL** | **Notes** | +| --- | --- | --: | --: | --: | --- | +| Adhesive Strips (Poster Strips) | 2 | 60 | $0.14 | [Amazon](https://a.co/d/0vJTr7M) | | +| M2 screw | 20 | 100 | $1.40 | [Amazon](https://a.co/d/cyiag7K) | 8mm long, self tapping | +| M3 screw | 4 | 60 | $0.47 | [Amazon](https://a.co/d/2foBYX5) | 25mm long| +| M3 nut | 4 | 150 | $0.20 | [Amazon](https://a.co/d/05wzwMC) | | +| Jumper wires | 4 | 40 | $0.56 | [Amazon](https://a.co/d/5FdEzo4) | Female-female, ~20cm | diff --git a/mkdocs.yml b/mkdocs.yml index e4c1c827..c5296e21 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -3,7 +3,8 @@ theme: name: "material" logo: images/logo.png favicon: images/favicon.png - font: Incosolata + font: + text: Incosolata palette: scheme: nvgreen features: @@ -36,6 +37,7 @@ nav: - Home: index.md - Getting Started: getting_started.md - Bill of Materials: bill_of_materials.md + - Bill of Materials (Orin): bill_of_materials_orin.md - Hardware Setup: hardware_setup.md - Software Setup: - Using SD Card Image: software_setup/sd_card.md From 95fbec2a3d9c5022902b4c10028ac7280c23cdfd Mon Sep 17 00:00:00 2001 From: Chitoku YATO Date: Tue, 7 May 2024 09:57:40 -0700 Subject: [PATCH 3/4] Add notes on original Jetson Nano EOL --- docs/bill_of_materials.md | 10 ++++++++++ docs/bill_of_materials_orin.md | 9 +++++++++ 2 files changed, 19 insertions(+) diff --git a/docs/bill_of_materials.md b/docs/bill_of_materials.md index 90bc75ce..955c6a60 100644 --- a/docs/bill_of_materials.md +++ b/docs/bill_of_materials.md @@ -1,3 +1,13 @@ +!!! note + + JetBot was originally designed with ***Jetson Nano Developer Kit***, which was [discontinued](https://forums.developer.nvidia.com/t/jetson-nano-developer-kit-eol/276729). + + For those newly starting, we recommend planning the JetBot assembly with **Jetson Orin Nano 8GB Developer Kit**.
+ The Bill of Materials for Orin version of JetBot is laid out on [Bill of Materials (Orin)](./bill_of_materials_orin.md) page. + + Please note that, currently, the software for the Orin version of JetBot is still work in progress. + + This page lists everything you need to build JetBot, along with purchasing links from popular vendors. Some of the parts are 3D printed. We provide the STL files needed to print these parts. Please see our [3d printing](3d_printing.md) page for tips on printing. diff --git a/docs/bill_of_materials_orin.md b/docs/bill_of_materials_orin.md index 296fb37c..ebb543c5 100644 --- a/docs/bill_of_materials_orin.md +++ b/docs/bill_of_materials_orin.md @@ -1,5 +1,14 @@ # Bill of Materials - Jetson Orin Nano version +!!! note + + JetBot was originally designed with ***Jetson Nano Developer Kit***, which was [discontinued](https://forums.developer.nvidia.com/t/jetson-nano-developer-kit-eol/276729). + + For those newly starting, we recommend planning the JetBot assembly with **Jetson Orin Nano 8GB Developer Kit**. + + Please note that, currently, the software for the Orin version of JetBot is still work in progress. + + This page lists all the parts you need to build the open-source JetBot with the new [**Jetson Orin Nano 8GB Developer Kit**](https://developer.nvidia.com/embedded/learn/get-started-jetson-orin-nano-devkit), along with purchasing links from popular vendors. Some of the parts are 3D printed. We provide the STL files needed to print these parts. Please see our [3d printing](3d_printing.md) page for tips on printing. From 5e5776627c601417cb4bd8f7065b02a3c21b2812 Mon Sep 17 00:00:00 2001 From: Chitoku YATO Date: Tue, 7 May 2024 14:49:37 -0700 Subject: [PATCH 4/4] Add note on 15W vs 7W mode --- docs/bill_of_materials_orin.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/bill_of_materials_orin.md b/docs/bill_of_materials_orin.md index ebb543c5..f3d5f9cf 100644 --- a/docs/bill_of_materials_orin.md +++ b/docs/bill_of_materials_orin.md @@ -21,8 +21,6 @@ You need these components for each JetBot. | --- | --: | --: | --- | --- | | Jetson Orin Nano 8GB Developer Kit | 1 | $499.00 | [NVIDIA](https://store.nvidia.com/jetson/store/) | | | Micro SD card | 1 | $14.95 | [Amazon](https://a.co/d/0aOqPQh) | 128GB | -| Battery | 1 | $12.99 | [Amazon](https://a.co/d/5DvsXGu) | PD 20W output, 10,000mAh | -| USB-C PD cable | 1 | $10.99 | [Amazon](https://a.co/d/ihjA431) | USB-C to DC 5.5mm x 2.5mm, right angle | | Motor | 2 | $5.90 | [Adafruit](http://adafru.it/3777), [Amazon(1)](https://a.co/d/cQ489BJ), [Amazon(2)](https://amzn.to/2MU9zPb) | "TT" form factor | | Motor Driver | 1 | $19.95 | [Adafruit](http://adafru.it/2927), [Amazon](https://a.co/d/aUs8dwA) | | | Caster ball | 1 | $10.99 | [Amazon](https://a.co/d/3WmVtqU) | 1-inch diameter | @@ -32,6 +30,17 @@ You need these components for each JetBot. | Chassis | 1 | -- | [STL file](cad/chassis.stl) | see [3D printing](3d-printing) | | | Camera Mount | 1 | -- | [STL file](cad/camera_mount.stl) | see [3D printing](3d-printing) | +### Power source + +| **Part** | **Quantity** | **Cost** | **URL** | **Notes** | +| --- | --: | --: | --- | --- | +| Battery | 1 | $12.99 | [Amazon](https://a.co/d/5DvsXGu) | PD 20W output, 10,000mAh | +| USB-C PD cable | 1 | $10.99 | [Amazon](https://a.co/d/ihjA431) | USB-C to DC 5.5mm x 2.5mm, right angle | + +!!! note + + With this power source option, we recommend setting Jetson Orin Nano in `7W` mode (`sudo nvpmodel -m 1`), as we observed Jetson in `15W` mode shutdown in certain scenarios like suddenly ramping up the motor from 0% to 100% speed or having motors stalled. + ### Camera You need a camera module with 22pin cable for interfacing to Jetson Orin Nano 8GB Developer Kit carrier board and the appropriate wide field of view for each JetBot.