Home
- General Hardware Information.
- How to configure the kit using serial commands.
- How to make your own shields
You can find the complete guide here.
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:
-
For SmartCitizen Kit version 1.0 (Goteo campaign) select
Tools/Boards/Arduino Leonardoon the Arduino IDE (ATmega 32U4 at 16Mhz) -
For SmartCitizen Kit version 1.1 (Kickstarter campaign) select
Tools/Boards/Lylipad Arduino USBon the Arduino IDE (ATmega 32U4 at 8Mhz)
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.
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:
-
For SmartCitizen Kit version 1.0 (Goteo campaign) select
Tools/Boards/Arduino Leonardoon the Arduino IDE (ATmega 32U4 at 16Mhz) -
For SmartCitizen Kit version 1.1 (Kickstarter campaign) select
Tools/Boards/Lylipad Arduino USBon the Arduino IDE (ATmega 32U4 at 8Mhz)
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
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.
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.
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.
Your browser will probably ask for permissions to run a Java applet, where you shall press the Run button.
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.
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.
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.