new documents about the makerbot

including images, and templates for "figure" and "image" ReST directives

8 files changed, 522 insertions, 0 deletions

diff --git a/src/HW/makerbot/cupcake-build/document.en.rest.tt b/src/HW/makerbot/cupcake-build/document.en.rest.tt
new file mode 100644
index 0000000..757c913
--- /dev/null
+++ b/src/HW/makerbot/cupcake-build/document.en.rest.tt
@@ -0,0 +1,203 @@
+==================================
+ Building the MakerBot CupCake
+==================================
+:CreationDate: 2009-09-07 09:15:47
+:Id: HW/makerbot/cupcake-build
+:tags: - hardware
+       - 3dPrint
+
+
+Wednesday 2009-09-02 I started building the CupCake, together with a
+few friends.
+
+Actually, the package had arrived on 2009-08-20, but I've been away
+from home for about ten days, and I couldn't build it as soon as it
+arrived. I had photographed the package's contents, though:
+
+[% INCLUDE 'image.tt' pic='img_0888' alt="The package's contents" %]
+
+Having all the pieces, and the instructions, we start building.
+
+The ``USBtinyISP`` programmer
+=============================
+
+(`link to the instructions <http://www.ladyada.net/make/usbtinyisp/make.html>`_)
+
+It would not have been strictly necessary, since the batch #5 CupCakes
+come with pre-programmed microcontrollers, but it was in the package,
+and maybe one day I'll need it, so I built it.
+
+[% WRAPPER 'figure.tt' pic='img_0948' alt='PCB, resistors, ICs,
+connectors…' %]
+The USBtinyISP kit.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0949' alt='Dakkar working the
+soldering iron'
+%]
+The soldering.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0951' alt='Soldering iron touching the PCB'
+%]
+Soldering detail: an IC's pins.
+[% END %]
+
+Motherboard and controllers
+===========================
+
+(`link to the instructions <http://wiki.makerbot.com/cupcake-electronics-assembly>`_)
+
+Now we start building and testing the rest of the electronics. After
+having connected the motherboard to the steppers' and extruder's
+controllers, we turn it on: the technical name of this operation is
+"smoke test".
+
+[% INCLUDE 'image.tt' pic='img_0952' alt='Smoke test' %]
+
+Although I had read `the warning about the power supply
+<http://wiki.makerbot.com/cupcake-dont-do-that#toc2>`_, I managed to
+blow up the nice power supply included in the kit. Luckily I have a
+few of my own!
+
+[% WRAPPER 'figure.tt' pic='img_0953'
+   alt='Powre supply, motherboard, controllers' %]
+Electronics, plugged in and turned on.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0955'
+   alt='Motherboard with lights' %]
+Detail of the motherboard, you can see the green lights;
+in the background, the extruder controller, also turned on.
+[% END %]
+
+Assembling the body
+===================
+
+(`link to the instructions <http://wiki.makerbot.com/cupcake-body-assembly>`_)
+
+Nothing hard: the assemblage with tabs and captive nuts is a stroke of genius.
+
+[% WRAPPER 'figure.tt' pic='img_0956' alt="CupCake's body, with Z
+belt" %]
+The body, essentially completed, including the threaded rods for Z
+translation, and steppers for Z and X.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0957' alt='Z belt and pulleys' %]
+Detail of the top part of the body; note how the pulleys on the rods
+have been aligned by simply having them touch the bearing brackets.
+[% END %]
+
+(Yes, I've skipped a few steps, I haven't shot everything)
+
+[% WRAPPER 'figure.tt' pic='img_0958' alt='Body, completed' %]
+X and Y stages built and installed, electronics installed, including
+the end-stops.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0959' alt="Electronics in its place" %]
+Electronics installed in place; cables for the end-stops and the
+extruder controller are still missing.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0960' alt='X and Y stages' %]
+X and Y stages built and installed; you can see the Y end-stops and
+the (paper) tabs to trigger them.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0961' alt='Y end-stop, glued' %]
+While I was tightening the bolts for this end-stop, the wood broke. I
+then fixed the end-stop with hot glue.
+[% END %]
+
+I stopped here for the first day, also because it was already dinner
+time. I started again the following morning.
+
+The extruder
+============
+
+(`link to the instructions <http://wiki.makerbot.com/plastruder-mk3>`_)
+
+It seems that for many people this part is the hardest, and the one
+giving the most problems: I did not have any particular difficulty.
+
+[% WRAPPER 'figure.tt' pic='img_0965' alt='Extrusion head' %]
+The completed extrusion head; the red wire is connected to the
+nichrome resistor, the black wire to the thermistor.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0967' alt="Extrusion mechanic, completed" %]
+The mechanic part of the extruder, completed.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0968' alt="Pinch wheel and idler
+wheel" %]
+The idler wheel aligned perfectly on the first try.
+[% END %]
+
+A note on the alignment of the idler pulley: I followed exactly the
+`alignment instructions
+<http://wiki.makerbot.com/plastruder-mk3-assembly#toc16>`_, then I put
+the wheel inside the extruder body: on one side it was too near the
+motor, on the other it was precisely centered.
+
+.. note:: Double idler wheel
+
+   Someone built a `double-width idler wheel
+   <http://wiki.makerbot.com/when-things-go-wrong#toc14>`_, by gluing
+   together the two wheels included in the kit. In my case,
+   and `apparently also for someone else
+   <http://groups.google.com/group/makerbot/msg/05a43a719f7dcb0f>`_,
+   the resulting wheel is too thick to fit between the flanges of the
+   pinch wheel, so it's impossible to use.
+
+[% WRAPPER 'figure.tt' pic='img_0970' alt="Extrusion canal" %]
+View along the extrusion canal; the hole at the end is the exit of the
+melted filament.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0971' alt='Extruder at work' %]
+Extrusion test: it works! Note that the short black ABS wire I used
+for the test has been extruded completely.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0972' alt='ABS filament' %]
+Results of the extrusion test: a black ABS filament, randomly curved.
+[% END %]
+
+First print
+===========
+
+Finally, I can print! The test object is a `clip-on Z end-stop trigger
+<http://www.thingiverse.com/thing:929>`_, since my kit's Z platform
+doesn't have the slots for the triggers.
+
+[% WRAPPER 'figure.tt' pic='img_0973' alt='CupCake printing the first
+layer of the raft' %]
+First layer of the raft.
+
+This is actually the third try. The first try caused a head crash,
+resulting in a small hole in the print platform; the second try
+started too high, and the raft did not adhere to the platform.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0975' alt='CupCake finishing printing
+the clip' %]
+Final layers of the clip.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0978' alt='Finished clip' %]
+The finished clip: I must study SkeinForge's parameters before
+obtaining something actually usable.
+[% END %]
+
+Summary
+=======
+
+About 19 hours of work, very few problems, and a working printer:
+probably the best-spent two full days of work so far ``:)``
+
+.. _`CupCake`: http://wiki.makerbot.com/cupcake
+.. _`l'avvertimento relativo all'alimentatore`: http://wiki.makerbot.com/cupcake-dont-do-that#toc2
+
diff --git a/src/HW/makerbot/cupcake-build/document.it.rest.tt b/src/HW/makerbot/cupcake-build/document.it.rest.tt
new file mode 100644
index 0000000..183a7c5
--- /dev/null
+++ b/src/HW/makerbot/cupcake-build/document.it.rest.tt
@@ -0,0 +1,207 @@
+==================================
+ Montaggio della MakerBot CupCake
+==================================
+:CreationDate: 2009-09-07 09:15:47
+:Id: HW/makerbot/cupcake-build
+:tags: - hardware
+       - 3dPrint
+
+Mercoledì 2009-09-02 ho cominciato a montare la CupCake_, assieme a
+un po' di amici.
+
+In effetti il pacco mi era arrivato il 2009-08-20, ma sono stato fuori
+casa per una decina di giorni, per cui non ho potuto montarla
+subito. Avevo comunque fatto una foto al contenuto del pacco:
+
+[% INCLUDE 'image.tt' pic='img_0888' alt='Il contenuto del pacco' %]
+
+Armati di tutto il materiale, e delle istruzioni, ci mettiamo a
+montare i pezzi.
+
+Il programmatore ``USBtinyISP``
+===============================
+
+(`link alle istruzioni <http://www.ladyada.net/make/usbtinyisp/make.html>`_)
+
+Non sarebbe stato proprio necessario, visto che le CupCake batch #5
+vengono spedite con i microcontroller già programmati, ma visto che
+era nel pacco e che prima o poi potrebbe servire, l'ho montato.
+
+[% WRAPPER 'figure.tt' pic='img_0948' alt='PCB, resistenze, integrati,
+connettori…' %]
+I componenti del kit USBtinyISP.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0949' alt='Dakkar curvo sul saldatore'
+%]
+L'opera di saldatura.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0951' alt='Saldatore che tocca il PCB'
+%]
+Dettaglio di saldatura: piedini di un integrato.
+[% END %]
+
+Motherboard e controller
+========================
+
+(`link alle istruzioni <http://wiki.makerbot.com/cupcake-electronics-assembly>`_)
+
+A questo punto cominciamo a montare e provare il resto
+dell'elettronica. Dopo aver connesso la motherboard ai controller dei
+motori passo-passo e dell'estrusore, diamo corrente: operazione detta
+in gergo "smoke test".
+
+[% INCLUDE 'image.tt' pic='img_0952' alt='Smoke test' %]
+
+Peccato che, sebbene avessi letto `l'avvertimento relativo
+all'alimentatore
+<http://wiki.makerbot.com/cupcake-dont-do-that#toc2>`_, sono riuscito
+a far esplodere il bell'alimentatore fornito col kit. Per fortuna ne
+ho un po' di riserva!
+
+[% WRAPPER 'figure.tt' pic='img_0953'
+   alt='Alimentatore, motherboard, vari controller' %]
+L'elettronica, collegata e accesa.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0955'
+   alt='Motherboard con lucette accese' %]
+Dettaglio della motherboard, si possono notare le lucette accese;
+sullo sfondo, il controller dell'estrusore, anch'esso acceso.
+[% END %]
+
+Montaggio corpo
+===============
+
+(`link alle istruzioni <http://wiki.makerbot.com/cupcake-body-assembly>`_)
+
+Niente di difficile; il metodo di montaggio a incastri e dadi
+prigionieri è geniale.
+
+[% WRAPPER 'figure.tt' pic='img_0956' alt='Corpo della CupCake, con
+cinghia Z' %]
+Il corpo sostanzialmente finito, comprese le barre per la traslazione
+Z e i motori per Z e X.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0957' alt='Cinghia e pulegge Z' %]
+Dettaglio della parte superiore del corpo; si noti che le pulegge
+dentate sulle barre filettate sono state allineate semplicemente
+appoggiandole sui supporti dei cuscinetti.
+[% END %]
+
+(Sì, ho saltato un po' di passaggi, non ho fatto foto a tutto)
+
+[% WRAPPER 'figure.tt' pic='img_0958' alt='Corpo sostanzialmente
+completo' %]
+Stadi X e Y montati e installati, elettronica installata, compresi i
+fine-corsa ottici.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0959' alt="L'elettronica montata al
+suo posto" %]
+Elettronica montata al suo posto; mancano i cavi dei fine-corsa e il
+controller dell'estrusore.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0960' alt='Stadi X e Y' %]
+Stadi X e Y montati e installati; si vedono i fine-corsa Y e le
+linguette (di carta) per attivarli.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0961' alt='Fine-corsa Y incollato' %]
+Mentre stavo stringendo i bulloni per questo fine-corsa, mi si è
+spezzato il legno. Ho quindi fissato il fine-corsa con colla a caldo.
+[% END %]
+
+Ho interrotto qui il primo giorno di lavoro, anche perché ora ormai
+ora di cena. Ho ripreso la mattina successiva.
+
+L'estrusore
+===========
+
+(`link alle istruzioni <http://wiki.makerbot.com/plastruder-mk3>`_)
+
+Sembra che per molti questa sia la parte più complessa e che dà più
+problemi: io non ho trovato particolari difficoltà.
+
+[% WRAPPER 'figure.tt' pic='img_0965' alt='Testa di estrusione' %]
+La testa di estrusione completata; il filo rosso è collegato alla
+resistenza in nichel-cromo, il filo nero alla termo-resistenza di
+controllo.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0967' alt="Meccanica dell'estrusore, completa" %]
+La parte meccanica dell'estrusore completata.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0968' alt="Ruota dentata e ruota di appoggio" %]
+La ruota di appoggio è venuta allineata correttamente, al primo tentativo.
+[% END %]
+
+Una nota sull'allineamento della ruota di appoggio: io ho seguito
+esattamente le `istruzioni per l'allineamento
+<http://wiki.makerbot.com/plastruder-mk3-assembly#toc16>`_, dopodiché
+ho montato la ruota di appoggio all'interno del corpo dell'estrusore:
+per un verso era troppo vicina al motore, per l'altro era precisamente
+centrata.
+
+.. note:: Doppia ruota d'appoggio
+
+   Qualcuno ha montato una `ruota d'appoggio spessa il doppio
+   <http://wiki.makerbot.com/when-things-go-wrong#toc14>`_, ottenuta
+   incollando assieme le due ruote contenute nel kit. Nel mio caso,
+   e `sembra anche per qualcun altro
+   <http://groups.google.com/group/makerbot/msg/05a43a719f7dcb0f>`_,
+   tale ruota doppia è troppo spessa per entrare tra le pareti della
+   ruota dentata, per cui non è possibile usarla.
+
+[% WRAPPER 'figure.tt' pic='img_0970' alt="Canale di estrusione" %]
+Vista attraverso il canale di estrusione; il foro in fondo è l'uscita
+del filamento ammorbidito.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0971' alt='Estrusore in funzione' %]
+Test di estrusione: funziona! Notare che il corto filo di ABS nero che
+ho usato per la prova è stato estruso completamente.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0972' alt='Filamento di ABS' %]
+Risultato del test di estrusione: un filamento di ABS nero, annodato a caso.
+[% END %]
+
+Prima stampa
+============
+
+Finalmente, posso stampare! L'oggetto di prova è una `linguetta a clip
+per i fine-corsa Z <http://www.thingiverse.com/thing:929>`_, visto che
+nel mio kit il piano Z non ha le fessure per fermare le linguette.
+
+[% WRAPPER 'figure.tt' pic='img_0973' alt='CupCake che stampa il primo
+strato della "raft"' %]
+Primo strato della "raft".
+
+Questo è in effetti il terzo tentativo. Il primo tentativo ha causato
+un "head crash" col risultato che la piastra di stampa ha ora un
+piccolo foro al centro; il secondo tentativo è partito troppo in alto,
+e la raft non ha aderito alla piastra.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0975' alt='CupCake che finisce di
+stampare la clip' %]
+Ultimi strati della clip.
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0978' alt='Clip completata' %]
+La clip completata: devo studiare bene tutti i parametri di SkeinForge
+prima di ottenere qualcosa di davvero usabile.
+[% END %]
+
+Riassunto
+=========
+
+Circa 19 ore di lavoro, pochissimi problemi, e una stampante
+funzionante: probabilmente i due giorni di lavoro meglio spesi fin'ora ``:)``
+
+.. _`CupCake`: http://wiki.makerbot.com/cupcake
diff --git a/src/HW/makerbot/cupcake-build/du2html.xsl b/src/HW/makerbot/cupcake-build/du2html.xsl
new file mode 120000
index 0000000..7364257
--- /dev/null
+++ b/src/HW/makerbot/cupcake-build/du2html.xsl
@@ -0,0 +1 @@
+../../../../templates/du2html.xsl
\ No newline at end of file
diff --git a/src/HW/makerbot/document.en.rest.txt b/src/HW/makerbot/document.en.rest.txt
index 262c53c..bf295b7 100644
--- a/src/HW/makerbot/document.en.rest.txt
+++ b/src/HW/makerbot/document.en.rest.txt
@@ -12,4 +12,8 @@ document everything I do with it.
 First step: `build the Arduino development environment
 <arduino-on-gentoo/>`_.
 
+Second step: `build the printer <cupcake-build/>`_.
+
+Third step: `model and print objects <printed-objects/>`_.
+
 .. _`MakerBot CupCake`: http://wiki.makerbot.com/cupcake
diff --git a/src/HW/makerbot/document.it.rest.txt b/src/HW/makerbot/document.it.rest.txt
index 33f6057..1d26b6d 100644
--- a/src/HW/makerbot/document.it.rest.txt
+++ b/src/HW/makerbot/document.it.rest.txt
@@ -12,4 +12,8 @@ tutto quel che ci faccio.
 Primo passo: `compilare l'ambiente di sviluppo Arduino
 <arduino-on-gentoo/>`_.
 
+Secondo passo: `costruire la stampante <cupcake-build/>`_.
+
+Terzo passo: `modellare e stampare oggetti <printed-objects/>`_.
+
 .. _`MakerBot CupCake`: http://wiki.makerbot.com/cupcake
diff --git a/src/HW/makerbot/printed-objects/document.en.rest.tt b/src/HW/makerbot/printed-objects/document.en.rest.tt
new file mode 100644
index 0000000..85775b2
--- /dev/null
+++ b/src/HW/makerbot/printed-objects/document.en.rest.tt
@@ -0,0 +1,52 @@
+================================
+ Some objects I printed
+================================
+:CreationDate: 2009-09-07 15:32:20
+:Id: HW/makerbot/printed-objects
+:tags: - hardware
+       - 3dPrint
+
+The round 12-sided die
+======================
+
+A friend of mine, member of my D&D group, asked me, as soon as he
+discovered that I would get a 3-D printer: «can you print me the
+intersection of three cylinders?»
+
+New, the resulting object is not exactly easy to visualize, but it's a
+12-sided solid, where each side would be a square, were it flat; in
+fact, the sides are curved.
+
+Obviously there is no way to print an object similar to a sphere on
+the CupCake: we would need some support material. What we can do,
+instead, is to print a half-sphere; we print it twice, we glue the
+halves together, and we get a sphere.
+
+[% WRAPPER 'figure.tt' pic='img_0980' alt="half-die, from an edge" %]
+Half of the die, seen from an edge
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0981' alt="half-die, from above" %]
+Half of the die, seen from above
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0982' alt="half-die, from the side" %]
+Half of the die, seen from the side
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0983' alt="half-die, from the side and
+edge" %]
+Half of the die, seen from the side, looking at an edge
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0984' alt="half-die, upside-down" %]
+Half of the die, upside-down. It rolls well enough, after a little sanding
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0985' alt="half-die, from the top" %]
+Half of the die, seen from the top: it's a very good approximation of
+a circle
+[% END %]
+
+Sadly, the two halves have warped a bit during printing, and it will
+not be easy to glue them in such a way as to keep them "round".
diff --git a/src/HW/makerbot/printed-objects/document.it.rest.tt b/src/HW/makerbot/printed-objects/document.it.rest.tt
new file mode 100644
index 0000000..63b07cf
--- /dev/null
+++ b/src/HW/makerbot/printed-objects/document.it.rest.tt
@@ -0,0 +1,50 @@
+================================
+ Alcuni oggetti che ho stampato
+================================
+:CreationDate: 2009-09-07 15:32:20
+:Id: HW/makerbot/printed-objects
+:tags: - hardware
+       - 3dPrint
+
+Il dado a 12 facce, tondo
+=========================
+
+Un mio amico, membro del gruppo di D&D, appena ha saputo che avrei
+avuto una stampante 3d, mi ha chiesto «potrai stamparmi l'intersezione
+di tre cilindri?».
+
+Ora, l'oggetto risultante non è esattamente facile da visualizzare, ma
+è un solido a 12 facce che sarebbero quadrate se fossero piane; in
+effetti le facce sono curve.
+
+Ovviamente non c'è modo di stampare un coso simile a una sfera con la
+CupCake: servirebbe un materiale di supporto. Quello che si può
+stampare è metà sfera; se ne stampano due, si incollano assieme, e si
+ottiene una sfera.
+
+[% WRAPPER 'figure.tt' pic='img_0980' alt="mezzo dado, d'angolo" %]
+Metà dado, visto d'angolo
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0981' alt="mezzo dado, dall'alto" %]
+Metà dado, visto dall'alto
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0982' alt="mezzo dado, di lato" %]
+Metà dado, visto di lato, con una faccia davanti
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0983' alt="mezzo dado, di lato e spigolo" %]
+Metà dado, visto di lato, con uno spigolo davanti
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0984' alt="mezzo dado, capovolto" %]
+Metà dado, capovolto. Rotola abbastanza bene, dopo una lieve carteggiatura
+[% END %]
+
+[% WRAPPER 'figure.tt' pic='img_0985' alt="mezzo dado, da sopra" %]
+Metà dado, visto da sopra: è un'ottima approssimazione di un cerchio
+[% END %]
+
+Purtroppo, le due metà si sono un po' imbarcate durante la stampa, e
+non sarà facile incollarle in modo che restino "tonde".
diff --git a/src/HW/makerbot/printed-objects/du2html.xsl b/src/HW/makerbot/printed-objects/du2html.xsl
new file mode 120000
index 0000000..7364257
--- /dev/null
+++ b/src/HW/makerbot/printed-objects/du2html.xsl
@@ -0,0 +1 @@
+../../../../templates/du2html.xsl
\ No newline at end of file