DiatomStudio / Piccolo

Piccolo is a pocket-sized stand-alone CNC platform.
www.piccolo.cc
351 stars 58 forks source link

Getting started guide doesn't say what should happen when pressing test button #6

Closed sowbug closed 9 years ago

sowbug commented 9 years ago

and test it by pushing the “test” button.

Then what?

Also, it's unclear whether Step 1 (Assemble) requires Step 2 to be completed first. Whatever it is that the test button does, wouldn't it depend on which firmware were programmed in the Arduino? Nowhere in the assembly step does it say anything about programming it, so it seems unlikely the test button would work unless step 2 were completed first.

sowbug commented 9 years ago

I see something in the usbTether sketch:

// If button two is pressed for more than two seconds, draw test circles.

I tried this after uploading this sketch, and sure enough, that's what seemed to happen (I actually haven't finished assembling the whole thing yet so I'm inferring behavior from servo movement). I saw X and Y move back and forth in a sine/cosine pattern with the period shrinking. I am not sure whether this is a spiral or circle; I didn't see Z moving at all (which one might expect if it were lifting a pen briefly off the page and it were discrete circles). That last part might be an error in my PCB assembly.

This tends to confirm, however, that the assembly steps are out of order. Step 0 should involve uploading the usbTether sketch to the Arduino.

sowbug commented 9 years ago

Hang on, I'm wrong. Step 9 of the assembly instructions does include uploading usbTether. So this issue report is invalid. But it would be nice if the Getting Started guide included a repeat of this part of the instructions, as someone might get a Piccolo already assembled from someone else, and it might not have the right firmware installed.

gregsaul commented 9 years ago

Thanks for the feedback! I've reordered the getting started instructions a little to make it clear that USBTether will need to be uploaded before the "test" button will function.

sowbug commented 9 years ago

@gregsaul Perfect! It reads much better now. Thanks!