Butterfly chonky

Robot Butterfly

Robot Butterfly invites you to experience nature's elegance alongside it, while interacting with the surrounding wilderness! Available now as a kit to build yourself.

For more information, check out: robotzwrrl.xyz/robot-butterfly. As well, see the instructions to build your own!

Robot Butterfly's design files are released as open source hardware, provided under these unique terms: If you replicate it, please take a photo of it in nature and email it to me with the city and its nickname! ☺️

---

Bug Fix 12-15-24

A 3D printable bugfix is available! The three pieces to print are:

• Servo Horn Indent L
• Servo Horn Indent R
• Spacer Back

The servo horn piece has been updated to work with the new horns that have an indent, rather than being flat in the previous version. The horn is placed on the side that has the arrow indicator. The fasteners go through holes #1 and #4. See photo below for reference.

The spacer back piece has been updated to have clearance for the chamfer around the switch housing on the enclosure. This provides a cleaner fit and smoother lid installation process.

---

Electronics

The Butterfly Chonky board connects with Keystone and Boostlet!. Those two boards are also open source, and can be found in these repositories:

• https://github.com/RobotGrrl/boostlet
• https://github.com/RobotGrrl/Keystone

What do the LEDs mean?

There are a few LEDs that are visible through the windows on the back of the enclosure.

On Chonky, there are two yellow 5 mm LEDs. On the left hand side, is D2. In the firmware, D2 is LED_COMMS_PIN (pin 5). On the right hand side, this is D1. In the firmware, D1 is LED_HEARTBEAT_PIN (pin 13).

LEDs from Keystone are also visible through the LED ports on the back side of the enclosure. As well, sometimes their brightness reflects in Chonky’s 5 mm LEDs. On the left hand side is power. The power LED is on all the time. On the right hand side are TX and RX. The TX and RX LEDs are activated whenever there is data on the serial port. This can be useful for a visual check, but it also just looks techno cool.

In the inaugural version, all the LEDs are yellow, which can sometimes make it tricky to visually differentiate between Chonky and Keystone's LEDs. This will be changed in a future production revision :)

---

Manufacturing

---

Firmware

Firmware is in active development

Download the Robot Butterfly library and install it into your Arduino library folder (for example: ~/Documents/Arduino/libraries).

Boards Manager

In the Arduino IDE boards manager (Tools > Board > Board Manager), search for esp32. Under esp32 by Espressif Systems, choose 2.0.4, and install it.

Library Dependencies

In the Arduino IDE library manager (Tools > Manage Libraries), please install the following libraries with the designated versions:

• Streaming - v5.0.0
• movingAvg - v2.3.2
• MPU6050 - v1.4.3
• Adafruit Neopixel - v.1.12.4
• ESP32Servo - v3.0.6
• ServoEasing - v3.4.0
• DHT - v1.4.6
• Adafruit Unified Sensor - v1.1.15
• HC-SR04 - v1.1.3

Upload Code

Here's how to upload code to Robot Butterfly!

Please see steps above to ensure all dependencies are installed properly

1. Tools > Board > esp32 > Set board to ESP32 Dev Module

2. Tools > Set upload speed to 115200 baud (at the bottom of the menu)

3. Tools > Set CPU speed to 80 MHz (first setting after a divider in the menu)

4. Tools > Manage Libraries There are library dependencies that will need to be downloaded, see list above

5. Open a Robot Butterfly example sketch

6. Plug in Robot Butterfly

7. Tools > Port > Select the port

8. Upload

9. Congrats! You have uploaded code to Robot Butterfly!

Animations

For developers - here's how to make your own animation (servo and neopixel):

1. Add identifier to enum servoAnimName

SERVO_ANIM_SOARING

2. Add the run function prototype

void runServoAnim_soaring(struct ServoAnimation *animation);

3. Write the run function

void runServoAnim_soaring(struct ServoAnimation *a) { ... }

4. Write the init function

void initServoAnim_soaring(struct ServoAnimation *a) { ... }

5. Add the case to setServoAnim

case SERVO_ANIM_SOARING: initServoAnim_soaring(a); break;

6. Call the animation to run it!

setServoAnim(&servo_animation_alert, SERVO_ANIM_SOARING, SERVO_ANIM_ALERT); startServoAnim(&servo_animation_alert);

---

Debugging

Please see this page for debugging FAQ.

---

License

Robot Butterfly (C) Copyright Erin RobotZwrrl, Robot Missions Inc.

05-30-24 v1.0

RobotZwrrl.xyz/robot-butterfly

RobotMissions.org

This hardware is released under:

CERN Open Hardware License Version 2.0 - Permissive (CERN-OHL-P)

https://cern-ohl.web.cern.ch/

The software is released under:

The MIT License

https://opensource.org/license/mit

The documentation is released under:

CC-BY-SA-4.0

https://creativecommons.org/licenses/by-sa/4.0/

Disclaimer: Distributed as is. No warranty is given. Not responsible or liable for any damage or harm that result from this product.