Skip to main content

ProtoPie Player

Connection omni
released in 0.4.8


A component that allows your hardware prototype to communicate directly with the ProtoPie Player app.

The ProtoPie Player connection is only supported in the ProtoPie Player app for iOS at the moment. Support for Android will follow in the future.



The ProtoPie Player integration is only supported in the ProtoPie Player app for iOS at the moment. Support for Android will follow in the future.

ProtoPie Integration

Our ProtoPie integration enables you to control your ProtoPie prototype with your blokdots prototype and in the other direction as well!

How the ProtoPie connection works

In order to let blokdots talk to ProtoPie we’re making use of the messaging feature built into ProtoPie via the Send / Receive triggers. It’s a nifty feature that lets different prototypes talk to each other. With the help of ProtoPie Connect we can tap into the messaging system and exchange messages between blokdots and ProtoPie.

If you want to play around a little more with it, take a look at the ProtoPie Connect component in blokdots. The orange message field in blokdots corresponds to the Message field in the Send/Receive trigger in ProtoPie.

When you use ProtoPie Connect for the Then action of any input capable hardware component, the integration will send the message and will also try to send a corresponding value with the message. I.e. if you use the ProtoPie Connect component with a potentiometer you will get the values from 0 to 1023 that you receive from the potentiometer attached to the message. You don’t need to do anything with the value in ProtoPie, but you can.

For the return route – sending messages from ProtoPie to blokdots – you can use messages to trigger behavior on the If…then cards or if you want to use a value from ProtoPie to fade an LED in and out, you can use a Map…onto card to map the incoming value to the hardware component in blokdots.

Create your own interactions

You can experiment with what’s possible by creating your own messages to be send and received. Best to keep the messages short, i.e. “ToggleLED” is better than “Toggle the LED light on or off”.

The ProtoPie live slot
Live Slot — ProtoPie

Once you selected the ProtoPie Connect component component in the Live View you will see the slot shown above. If blokdots is able to connect to the ProtoPie Connect software—so if the software is up and running—the little connection indicator at the bottom left of the ProtoPie icon should turn green.

If your ProtoPie Connect server should not be at the default location, e.g., it is not running on your computer but on someone else's, then you can simply change the address in the field filled with http://localhost:9981. Usually, this address should work with your setup.

Above the text field and if expanded, you can see the last communication between ProtoPie and blokdots. It behaves similarly to the connection between Signal Tower components.

ProtoPie to blokdots

In ProtoPie Studio:

Sending messages — ProtoPie
  1. Configure a trigger and use the “Send” response.
  2. Select “ProtoPie Studio" as the channel.
  3. Enter the message to be sent.
  4. Optional: Choose a value to be sent with the message

In blokdots:

Receiving messages — blokdots
  1. Create a new Card and select the ProtoPie Connect component. It should be set to "receiving".
  2. Enter the message in the orange input field. It needs to match the message configured in ProtoPie exactly.
  3. Define the Then reaction in the card by adding a component and selecting what it should do.

Receiving messages with values — blokdots

To use the message value as a string, you can access it via {{value}} in a text input field, e.g. when you want to send a message from ProtoPie to an LCD module, it would look like this ↑.

Receiving messages and map values — blokdots

To use numerical values sent with messages, use a Mapping Card to set, e.g., the brightness of an LED or the movement angle of a servo motor.

blokdots to ProtoPie

In blokdots:

Sending values — blokdots
  1. Create a new card with an input component, i.e. a button, potentiometer or another sensor you have available
  2. Use the ProtoPie Connect component for the Then reaction
  3. Enter the message to be sent in the orange input field

In ProtoPie Studio:

Receiving values — ProtoPie
  1. Use “Receive” as a new trigger
  2. Select “ProtoPie Studio” as the channel
  3. Enter the message exactly as configured in blokdots
  4. 💡 Tip: Create a variable in your Pie and use the Assign to Variable feature. Blokdots will try to attach a value for your input component and the value will then be assigned to the variable in your Pie.
  5. Continue with defining the triggered responses in ProtoPie Studio

Code Export

When you export a project using the ProtoPie Player integration to Javascript code and then run the script following the instructions in the README file, you should see a QR code printed to the terminal window. Scan this QR code in the ProtoPie Player app to connect to blokdots.

QR code for ProtoPie Player in the terminal window