I just got a Cosmic Pi as a CERN Beamline for Schools runner up prize, what do I do now? We'll answer all your questions here, as soon as we can! To start with you should take your Cosmic Pi out of the box, it should look like this:
Open the bag, you should find inside a GPS antenna and a very short USB cable (A to micro-B).
You should also find an AC adapter (9V with a barrel jack) in the box.
Connect the GPS antenna first, ensure that it can 'see' the sky - it's magnetic, so perhaps you can stick it to something, or sellotape it to a window, or if you're in a wooden structure it might just work. Try to avoid coiling the cable around the Cosmic Pi setup, as this will interfere with reception.
Next connect the AC adapter, you can connect it to a nearby socket and then into the socket marked Power on the Cosmic Pi. It should light up immediately, with a short flash on both the power and event green LEDs. If it doesn't flash, check that the plug you're using works! After both LEDs have flashed, they will go out until the unit acquires a GPS fix. We'll be changing the operation of the LEDs in a future firmware version so that the Power LED comes on when the unit is powered and only blinks every second when we get the timing pulse from the GPS - but we haven't done that yet so please be patient.
Make sure you connect and power the AC adapter before connecting the USB. Otherwise you'll need to do it again!
Now connect the Micro-B end of the USB cable to the Programming USB socket. You should connect the A end either to a Raspberry Pi - but don't worry if you don't have one, any internet connected machine running Linux can be used.
If you type in cat < /dev/ttyACM0 (on Ubuntu based Linux, you can find out which USB devices you have in Linux by typing "sudo lsusb -t" at the command prompt) at the terminal of your linux machine or Raspberry Pi, you should see data from the Cosmic Pi being transmitted straight away. You should set the baud rate for the connection to 9600bps. If you can't access the USB port, you may wish to access it as superuser, or to check that you have user access permissions for the modem group. The unit might take up to 5 minutes to acquire a GPS lock, after which time the Power LED will flash at a rate of 0.5 Hz to indicate that the PPS (Pulse Per Second) signal is coming through from the GPS receiver. The event light should start to flash shortly after this, and it will flash every time there is an event (a Muon) detected. Note that the event light shouldn't be active until a valid PPS signal has been received. It may also take a few minutes (again allow another 5 or 6) before events start to be detected. This is because the detector requires a very precise voltage to be applied to the analogue circuit board and it takes a while for our algorithm to tune the voltage, as a function of temperature and the output signal.
What next? When you've got your system up and running and both the Power and Event lights are blinking, you can start to play with the unit by analysing the data. We're working on some nice software for users, but in the meantime our python test routines, and the Arduino source code for compilation if you want to update your device, can be downloaded here.