From 23e3a0027f0f2ad57cd72dc37a628a8fca2c345c Mon Sep 17 00:00:00 2001 From: Gianpaolo Macario Date: Sun, 13 Oct 2024 10:38:47 +0200 Subject: [PATCH 1/2] docs(howto): add howto-anavi-handle.md Signed-off-by: Gianpaolo Macario --- docs/howto/howto-anavi-handle.md | 90 ++++++++++++++++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 docs/howto/howto-anavi-handle.md diff --git a/docs/howto/howto-anavi-handle.md b/docs/howto/howto-anavi-handle.md new file mode 100644 index 0000000..ab3b964 --- /dev/null +++ b/docs/howto/howto-anavi-handle.md @@ -0,0 +1,90 @@ +--- +title: "HOWTO - ANAVI Handle" +date: "2024-10-12" +--- + +## Introduction + +Following up to [a thread on X](https://x.com/leonanavi/status/1834916587679498323) we tried to use a [ANAVI Handle](https://www.crowdsupply.com/anavi-technology/anavi-handle) to interact and control [FREISA](https://github.com/B-AROL-O/FREISA). + +## Reference Documents + +* [ANAVI Handle on CrowdSupply](https://www.crowdsupply.com/anavi-technology/anavi-handle) +* [ANAVI Handle Assembly Guide for Open Source Nunchuk to USB Adapter](https://www.youtube.com/watch?v=ZAnON53XiUk) - Leon Anavi on YouTube, 2024-05-22 +* [GitHub: AnaviTechnology/anavi-handle](https://github.com/AnaviTechnology/anavi-handle) +* [GitHub: AnaviTechnology/anavi-handle-sw](https://github.com/AnaviTechnology/anavi-handle-sw) +* [Seeed Studio XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html) - Supports Arduino, MicroPython and CircuitPython + +## Assembling and testing ANAVI Handle + +ANAVI Handle is an open source hardware USB-C adapter with [XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html) for [Nunchuk compatible controllers](https://en.wikipedia.org/wiki/Wii_Remote#Nunchuk). It allows you to connect Nunchuk controller to a personal computer and use it as USB device (HID): mouse, keyboard or joystick/gamepad. + +This chapter provides step by step instructions how to assemble ANAVI Handle. + +### ANAVI Handle Assembly Guide + +Follow [this video on YouTube](https://www.youtube.com/watch?v=ZAnON53XiUk) + +[![ANAVI Handle Assembly Guide for Open Source Nunchuk to USB Adapter](https://img.youtube.com/vi/ZAnON53XiUk/0.jpg)](https://www.youtube.com/watch?v=ZAnON53XiUk "ANAVI Handle Assembly Guide for Open Source Nunchuk to USB Adapter") + +ANAVI Handle comes as a do-it-yourself kit in a very simple packaging. + +The kit contains the Printed Circuit Board, Acrylic Enclosures, nuts and screws. +Furthermore, there are additional kits that provide a compatible [Nunchuk controller](https://en.wikipedia.org/wiki/Wii_Remote#Nunchuk), either in black or white colors. + +#### Step 1: Peel Off Protective Films + +Step number 1 is to peel off the protective films from both sides of the Acrylic Enclosures. + +#### Step 2: Top Acrylic Enclosure + +ANAVI Handle comes with: + +* 4x M2.5 10mm screws +* 8x M2.5 nuts + +Take the Top Acrylic Enclosure which has a notch for the Nintendo Nunchuk controller. + +Place the four screws in the dedicated mounting holes, and fasten them with the four nuts. +You can even do it without a screwdriver, you can do it with your bare hands. +The process is super-simple and straightforward. + +#### Step 3: PCB + +Take the Printed Circuit Board and insert the Top Acrylic Enclosure with the screws and the nuts in the mounting holes of the PCB. + +As a result, the PCB of the ANAVI Handle will be below the four nuts. + +#### Step 4: Bottom Acrylic Enclosure + +Take the Bottom Acrylic Enclosure, place it below the Printed Circuit Board, and fasten it with four nuts. + +As you can see in the video you can do it with your bare hands. +Of course, if you use a screwdriver, it might be slightly easier. + +By the end of this step, you have your ANAVI Handle fully assembled. + +#### Step 5: Nunchuk + +Step number 5 is to a plug a Nunchuk or a compatible controller into the ANAVI Handle and to connect it to a computer using a USB-C cable. + +A green light will indicate that the connection to the computer and the controller is successful. + +### ANAVI Handle Demo + +ANAVI Handle is an entirely Open Source that combines an Open Source Hardware Printed Circuit Board with free and Open Source firmware written in [CircuitPython](https://circuitpython.org/). +The source code is [available at GitHub](https://github.com/AnaviTechnology/anavi-handle-sw). + +The default open-source firmware uses an RGB LED to indicate the connection status: + +* Green light: Nunchuk controller is connected correctly. +* Blue light: The Nunchuk controller is disconnected from the ANAVI Handle. +* Red light: The Nunchuk controller is absent or improperly connected. + +A green LED confirms a successful connection between the Nunchuk, the ANAVI Handle, and your computer. + +## Using ANAVI Handle to control FREISA Robot Dog + +TODO + + From e8f61cdfda2236ead9bbfc5caaf4c0658116992e Mon Sep 17 00:00:00 2001 From: Gianpaolo Macario Date: Sun, 13 Oct 2024 10:48:06 +0200 Subject: [PATCH 2/2] docs(howto-anavi-handle): after running prettier --- docs/howto/howto-anavi-handle.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/howto/howto-anavi-handle.md b/docs/howto/howto-anavi-handle.md index ab3b964..595c7f8 100644 --- a/docs/howto/howto-anavi-handle.md +++ b/docs/howto/howto-anavi-handle.md @@ -9,11 +9,11 @@ Following up to [a thread on X](https://x.com/leonanavi/status/18349165876794983 ## Reference Documents -* [ANAVI Handle on CrowdSupply](https://www.crowdsupply.com/anavi-technology/anavi-handle) -* [ANAVI Handle Assembly Guide for Open Source Nunchuk to USB Adapter](https://www.youtube.com/watch?v=ZAnON53XiUk) - Leon Anavi on YouTube, 2024-05-22 -* [GitHub: AnaviTechnology/anavi-handle](https://github.com/AnaviTechnology/anavi-handle) -* [GitHub: AnaviTechnology/anavi-handle-sw](https://github.com/AnaviTechnology/anavi-handle-sw) -* [Seeed Studio XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html) - Supports Arduino, MicroPython and CircuitPython +- [ANAVI Handle on CrowdSupply](https://www.crowdsupply.com/anavi-technology/anavi-handle) +- [ANAVI Handle Assembly Guide for Open Source Nunchuk to USB Adapter](https://www.youtube.com/watch?v=ZAnON53XiUk) - Leon Anavi on YouTube, 2024-05-22 +- [GitHub: AnaviTechnology/anavi-handle](https://github.com/AnaviTechnology/anavi-handle) +- [GitHub: AnaviTechnology/anavi-handle-sw](https://github.com/AnaviTechnology/anavi-handle-sw) +- [Seeed Studio XIAO RP2040](https://www.seeedstudio.com/XIAO-RP2040-v1-0-p-5026.html) - Supports Arduino, MicroPython and CircuitPython ## Assembling and testing ANAVI Handle @@ -40,8 +40,8 @@ Step number 1 is to peel off the protective films from both sides of the Acrylic ANAVI Handle comes with: -* 4x M2.5 10mm screws -* 8x M2.5 nuts +- 4x M2.5 10mm screws +- 8x M2.5 nuts Take the Top Acrylic Enclosure which has a notch for the Nintendo Nunchuk controller. @@ -77,14 +77,14 @@ The source code is [available at GitHub](https://github.com/AnaviTechnology/anav The default open-source firmware uses an RGB LED to indicate the connection status: -* Green light: Nunchuk controller is connected correctly. -* Blue light: The Nunchuk controller is disconnected from the ANAVI Handle. -* Red light: The Nunchuk controller is absent or improperly connected. +- Green light: Nunchuk controller is connected correctly. +- Blue light: The Nunchuk controller is disconnected from the ANAVI Handle. +- Red light: The Nunchuk controller is absent or improperly connected. A green LED confirms a successful connection between the Nunchuk, the ANAVI Handle, and your computer. ## Using ANAVI Handle to control FREISA Robot Dog -TODO +To be continued...