Here’s how to start using your SLX Porcupine

  1. First, make sure you have an Internet connection via ethernet for your Porcupine, Google Chrome on your PC and an Android or Apple device with access to Google Play or the AppStore

  2. Create an account on wappsto.com, using Google Chrome on your PC
    1. Either sign in with Google
    2. Or register with your email address (you should receive a welcome email which you need to confirm)

  3. Install the “Seluxit Device List” app from the Apple AppStore or from Google Play Store, start it and log in using the newly created account

  4. In the “Seluxit Device List” app, press the plus button in the upper-right-hand corner and then add the Porcupine to your account by scanning the QR Code

    (IMPORTANT! Please do the following before doing step 4: connect your Porcupine the internet via ethernet and connect the porcupine to power and wait until the LED indicator shows a solid green light and the orange light is off. This typically takes two minutes.)

  5. Once you’ve added your Porcupine to your wappsto account:
    1. Put your Seluxit universal connector hat on the Porcupine (see picture below)
    2. Connect the Porcupine to the Internet via ethernet
    3. Connect the Porcupine to power
    4. Once the green LED indicator is solid green and the orange LED is off, you can start using the rapid-prototyping tools
    seluxit porcupine
  6. In Google Chrome on your PC, log into wappsto.com and select “Store” in the left-hand navigation

  7. Install the “IoT Rapid Prototyping” wapp and then press “open last installed”
    (What's a wapp? See the explanation at the bottom of this page)

  8. Add a new template, and choose “LED + Button”

  9. At the top of the page, click the blue pencil icon to give your template a name, for example, “Porcupine demo”

  10. Follow the on-screen instructions to add your “LED + Button”, making sure to disconnect the power from your Porcupine before adding the physical actuator

  11. You will “save and deploy”, choosing “select existing hardware device > continue”

  12. You’ll recognize the UUID of your Porcupine. Select and click “Next”

  13. The version name is mostly relevant when having made adjustments. For your purposes now, you can just type in “v1”

  14. Click on “Deploy”. You’ll notice the orange light blinking during deployment. Make sure to wait until the orange LED is not lit and the green LED indicator is blinking before proceeding

  15. On your Android or Apple device, go back to the “Seluxit Device List” app and notice that your Porcupine, named “Porcupine Demo” is visible, both as the live deployment, and as a shadow version indicated with the qualifier “(Prototype)” and displayed with a gray color

  16. In the app on the live deployment version, try altering the “desired state” of the LED on-off value, and notice how the light changes on the physical device. Try to click the button, and notice how the Button’s “current state” changes

  17. Back in your browser, try to add the other sensors and actuators (buzzer, relay, barometer and CO2 sensor) in the same manner, following the on-screen instructions. Note that you should scroll down to see the image indicating which slot the sensors and actuators should be added to for each type

Once your Porcupine is up and running with your sensors and actuators, there are several wapps that you can now use. Seluxit’s “Dashboard” allows you to create tables and graphs from your data assets. You can export your data using the “Historical Data” wapp. You can choose which firmware should run on which devices by using “Firmware Update” wapp. You can create your own wapp by using “Wapp Creator” where you will find “Hello World” wapps to get you started.

Expected release date

1 May 2020

Additional Notes/Known Issues

  • Note that configuration of WiFi by means of Bluetooth (BluFi) is not yet supported
  • The secure-boot functionality is not enabled in the pre release version
  • Porcupine has an SSH server running by default. You can log in using the root account. It has no password set. Set this in order to secure your Porcupine. You can use the root login to retrieve logs, modify structure and change functionality
  • Seluxit may assist you with remote debugging by means of VPN. This feature is disabled by default. The owner of a Porcupine will be able to enable this feature when needed. Contact iot@seluxit.com for assistance
  • It is possible to factory reset the Porcupine. Contact iot@seluxit.com for more documentation and help
  • After a factory reset, a reboot might be needed
  • Minor bugs, expected fixed in the final release:
    • The relay and the LEDs states are not properly handled during the boot process. This results in the relay clicking multiple times
    • There is a known issue with opkg which can result in a failure to install some packages
  • If you experience any other issues, your feedback would be appreciated

What's a Wapp?

Wapps are web apps that have been created in Wappsto. The point of wapps is to combine different things and services in an automated functionality. Wapps consist of background and foreground tasks. Background tasks run server side and automate processes, while foreground will be run in the browser and allow the user to configure the automations.

A wapp is comparable with a lambda function with the additional feature of a frontend interface. You can currently create wapps in JavaScript, and will in the future be able to use Python and R to create wapps.

There are two kinds of wapps, converter wapps and mash-up wapps. Converter wapps take the data model of the thing or service, exposed by their API, into the Wappsto unified data model. Mash-up wapps combine things and services in new automations.

Wapps can be published and sold in the Wappsto Store. The price of a wapp is determined by the developer.

Further Reading

Further information on SLX Porcupine and SLX Connector Hat

Here is information about selected sensors and actuators.

We have collected links to our documentation on our developers page.