Skip to content
Pral2a edited this page Feb 20, 2014 · 14 revisions

Technical information

Hardware and Firmware documentation.

Getting Started

Quick guide

<iframe src="http://player.vimeo.com/video/67899036?title=0&byline=0&portrait=0" frameborder="0" width="500" height="281"></iframe>

Download and install Arduino IDE

The first step to use and configure a SCK is getting the Arduino IDE, which is nothing more than the program you use to upload a program (also called sketch) to an Arduino board. You can download the appropiate binaries for your operating system from the official website of Arduino. Install drivers if necessary and get the system up and running, as described in the official website (choose your OS). The SCK core is a modified Arduino, thus you have to select it in the type of board in the Arduino IDE as follows:

  • If you have a new kit coming after the Kickstarter campaign: Tools>>Board>>Arduino LilyPad Arduino USB.
  • If you have a Goteo campaign kit: Tools>>Board>>Arduino Leonardo.

Arduino IDE window

We are continuously making improvements of the firmware, the best way to get the most stable and reliable version is to follow the instructions when you get your kit:

  • You will always find the latest stable release to download here.

Next open the main file, Sck_*.ino, with the previously downloaded IDE and press the Upload button or CTRL+U, which will upload the program to the board.

Board versions:

New Smart Citizen kits are running in 3.3v thanks to an improvement by our team, this means you will have to change to board type on the Tools>>Boards as following:

  • If you have a new kit coming after the Kickstarter campaign: Tools>>Board>>Arduino LilyPad Arduino USB.
  • If you have a Goteo campaign kit: Tools>>Board>>Arduino Leonardo.

For developers: If you have Git installed in your machine you can just type the following in your terminal: git clone git://github.com/fablabbcn/Smart-Citizen-Kit.git

Configuring the SCK

First of all, you shall create a user account in the platform. To do so, go to our Register section. Once the account is created and confirmed, log in to the website and press the Add Smart Citizen Kit. Afterwards you have to fill in all the fields. To better geolocate your SCK you can directly click the map to indicate a precise location.

Board versions:

You will need to select V1.1 in the version menu. V1.0 is for Goteo campaign kits and it is not compatible with new versions.

Adding a SCK

If you downloaded the latest version of our firmware or stayed with the default one now the board knows "what to do" but it also has to be able to upload all gathered information to the Internet, thus you need to configure your network. You can easily do this inside the very own platform. To do so, go to the Dashboard and select the Sensors tab, where you'll see sensor board you just registered. Inside that sensor tab, press the Configure button.

Configuring the SCK

Your browser will probably ask for permissions to run a Java applet, where you shall press the Run button.

Giving permissions to the Java applet

Notes on Java:

Oracle just released a new java version a few month ago, this Java increases the security settings and will not run any Java Applet which is not signed. In order to run the Smart Citizen Java Applet you must go to your Java Control Panel and set the Security Level to Medium. This panel is available under Windows, Mac and Linux on the Control Panel or Preferences Panel menu.

Configuring the Java Security Options

For Mac users we remember you that Java is not supported under Google Chrome (Java runs at 64-bits while Chrome stills runs on 32-bits) we encourage you to use Safari or Firefox instead.

Register the kit:

Once the webpage is fully loaded, enter the appropriate section and select the ESSID, its password, the encryption scheme it uses (WEP, WPA, WPA2 or open) and the kind of antenna the SCK will be using (internal or external). Finally press the setup the kit button and the applet will do the rest for you.

After waiting a few seconds, you'll find below a subsection called register the kit, where the MAC address of your WiFly module shall be loaded automatically. Note that this is not the full MAC address but the last 12 digits. You can also perform this step manually by having a look at the WiFly module and writing the short address yourself.

Now you're ready to go. After 1-5 min you should see that your sensor started transmitting information. Remember, sharing is caring.

On the other hand, you can browse the code and "hardcode" all these values in the config file, named SCKBase.ino.

Clone this wiki locally