Added some documentation.

This commit is contained in:
2026-03-13 11:33:28 +01:00
parent 7c609ea452
commit 3bacff9ea6
2 changed files with 51 additions and 49 deletions

100
README.md
View File

@@ -1,58 +1,60 @@
Eggduino
====
# Der Sternenlabor EggBot
* Basiert auf EggDuino mit folgenden Anpassungen
* portiert auf ESP32
* Bessere Stepper Library
* Einfache Bahnplanung (weniger Verzerrungen)
* Stift Servo mit Rampensteuerung
* Webinterface für Logging und Einstellungen (Anschlussbelegung)
* BLE Interface (http://Eggbot.app)
* Web Socket Interace (aktuell ungetestet)
* RS232 Kommunikation mit 115200 (zuvor 9600)
* Inkscape Plugin AxiDraw_395 (siehe GIT)
* Modifizierte ebb_serial.py zur Erkennung
* Modifizierte eggbot.py - entfernt Pausen zwischen Bewegungen
* Verwendung ohne Inkscape mittels http://EggBot.app
Arduino Firmware for Eggbot / Spherebot with Inkscape-Integration
Ohne angepasstes Inkscape Plugin kann keine Kommunikation zum EggBot aufgenommen werden.
Version 1.6a
tested with Inkscape Portable 0.91, Eggbot Extension and patched eggbot.py
# Materialliste
Regards: Eggduino-Firmware by Joachim Cerny, 2015
Schrauben:
* Motor Welle Ei: M3x8
* Motorbefestigung: 8x M3x10
* Motor Welle Stift: M3x12
* Klemme für Eihalterung: 2x M3x16
* Spannschraube Stift: M3x25
* Armgelenk: M3x30
* Mutter: 4x M3 **vierkant!**
* Platine Schrauben: 4x M2.3x5
* Schrauben für Feder: 2x M2.3x5
* Scheiben für Feder: 2x M3x6x0.5
Thanks for the nice libs ACCELSTEPPER and SERIALCOMMAND, which made this project much easier. Thanks to the Eggbot-Team for such a funny and enjoyable concept! Thanks to my wife and my daughter for their patience. :-)
Sonstiges:
* Zugfeder: 8x17 (entspannt)
* O-Ring: 3x 18x2
* Kugellager: 608ZZ (8x22x7)
Features:
Elektronik:
* 2x Schrittmotor Nema 17 (200 Schritte/Umd.)
* 2x Anschlusskabel
* 1x Micro Servo
* 1x CNC Shield (z.B. AZDelivery)
* 2x Schrittmotor Treiber DRV8825
* 1x ESP32 Arduino UNO Formfaktor
* 1x Netzteil 12V min. 1A
* 1x Micro USB Kabel
- Implemented Eggbot-Protocol-Version 2.1.0
- Turn-on homing: switch-on position of pen will be taken as reference point.
- No collision-detection!!
- Supported Servos: At least one type ;-) I use Arduino Servo-Lib with TG9e- standard servo.
- Full Arduino-Compatible. I used an Arduino Uno
- Button-support (3 buttons)
3D-Druckteile: https://www.thingiverse.com/thing:3431363 (hoffentlich bald in unserem GIT)
Tested and fully functional with Inkscape.
# Elektronik
Damit der ESP32 mit angeschlossenem CNC Shield korrekt funktioniert. Muss zwischen Enable und GND ein 1k Widerstand eingelötet werden.
![CNC Mod](res/cnc-shield-mod.png)
Installation:
- Upload Eggduino.ino with Arduino-IDE or similar tool to your Arudino (i.e. Uno)
- Disable Autoreset on Arduinoboard (there are several ways to do this... Which one does not matter...)
- Install Inkscape Tools wit Eggbot extension. Detailed instructions: (You yust need to complete Steps 1 and 2)
http://wiki.evilmadscientist.com/Installing_software
- Because of an bug in the Eggbot-extension (Function findEiBotBoards()), the Eggduino cannot be detected by default.
Hopefully, the guys will fix this later on. But we can fix it on our own.
It is quiete easy:
- Go to your Inkscape-Installationfolder and navigate to subfolder .\App\Inkscape\share\extensions
- open File "eggbot.py" in texteditor and search for line:
"Try any devices which seem to have EBB boards attached"
- comment that block with "#" like this:
# Try any devices which seem to have EBB boards attached
# for strComPort in eggbot_scan.findEiBotBoards():
# serialPort = self.testSerialPort( strComPort )
# if serialPort:
# self.svgSerialPort = strComPort
# return serialPort
- In my version lines 1355-1360
## Setup
Add credentials.h file with content like this:
const char *kWifiSsid = "MySSID";
const char *kWifiPassword = "MySecret";
To disable Wifi:
const char *kWifiSsid = 0;
const char *kWifiPassword = 0;
## Anschlussbelegung
* Ei-Drehen Stepper: Y
* Stift-Bewegen Stepper: X
* Servo Ctrl Pin: Z-Step
* USB Versorgung an ESP32 UNO (nötig)
* 12V Netzteil an CNC Shield (nicht ESP32 UNO Buche)
Falls von der Anschlussbelegung abgewichen wird, muss die geänderte Belegung über das Webinterface angepasst werden.

BIN
docs/res/cnc-shield-mod.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 364 KiB