Table of contents


If your question isn't answered here, contact us via email.


Getting Started - What do the light's blinking patterns mean?

In combination with our website, the LED on your Twine helps communicate what state it's in. Here's a brief summary:

No light - normal operation. Most of the time, your Twine’s light will be off as it helps your battery last as long as possible. Of course, there will also be no light if your Twine's batteries are dead, but you'll get an email warning before that happens. (Another good clue is if the website says your Twine hasn't been heard from for a while.)

Solid - in access point mode. Go to http://twinesetup.com to proceed with network configuration or set right side up to get Twine to connect to the network and resume normal operation.

Steady pulsing - attempting to connect to the network.

3 quick flashes - the connection has failed. Often this is because the network name/password don't match — you can turn Twine over to put it back in setup mode. If you do nothing, it will try again in two hours


Getting Started - Setup troubleshooting

How will I know when my Twine is up and running? Check your Twine account at https://twine.supermechanical.com. If you see a Twine connected, you’re all set!

Why don't I see my Twine after setup? When you see the light pulsing on your Twine, it means Twine is trying to connect to your network. If the light blinks quickly 3 times, setup wasn’t successful. If that happens, there are two options:
1. Wait for Twine to reconnect on its own. Twine will try to connect every 2 hours.
2. Double check your Wi-Fi password and go to http://twinesetup.com to enter it again. Without the right password, Twine won’t be able to connect.

Does Twine work with my Wi-Fi router? Twine works with most home Wi-Fi routers. We recommend the Linksys E1200.

Twine uses 802.11b (at 2.5GHz) — your router will need to have support for this turned on.

Security methods that are supported include WPA/WPA2 personal, WEP, and open. If you’re using Twine in a business, it doesn’t work with routers that are configured for WPA2 Enterprise.

To use Twine with a hidden network, your Twine needs to be running firmware 2.0 and radio May 24 2013 or later.

Twine can get confused by extended/bridged networks, where multiple routers have the same network name. Try creating a second network ("Enable Guest Network" in Airport Utility) on your main router for Twine to connect to.

To communicate with the internet. Twine needs to be able to get through on UDP port 32887 and TCP port 32888 outbound. Please check your firewall settings on your router and any other upstream filters that may be in place.


Getting Started - How do I get into setup mode?

When your Twine's LED is solid white, you're in setup mode. In this state, you can give your Twine a new wireless network to connect to, starting at http://twinesetup.com

If your Twine isn't connected to a network, you can get into setup mode by flipping it on its back.

If your Twine is connected to a network already, the light will be off. You can get into setup mode by either:


Getting Started - I'm stuck at "waiting for you..." How do I get past step 2?

Is this your situation? You're stuck at the "waiting for you..." step 2 of http://twinesetup.com, even though you've:

If you have manually entered DNS servers (such as Google Public DNS), temporarily disable them during setup. This disrupts your browser's ability to recognize that it's connected to your Twine's network.

If that isn't your situation, here's a workaround so you can get your Twine up and running in the meantime. While you're connected to the \||| Twine access point, follow these steps:

  1. Load http://twinesetup.com/gainspan/profile/tls/config and copy the text you see into an email to help@supermechanical.com so that we can register your Twine to your account. Also include your operating system version and browser to assist us in tracking down the problem.
  2. Reload http://twinesetup.com. You will see a bright green settings page.
  3. Select "Wireless and Network Configuration".
  4. Select "Select an Existing Network"
  5. You should see a list of all the nearby networks to join. Select yours.
  6. Enter your passphrase and any other necessary information, and select "Next".
  7. Select "Save And Apply".
  8. Wait for us to register your Twine - we'll send you a response when it's ready to go.

Getting Started - Network doesn't show in step 3 of setup

Is this your situation? Your network doesn't show up on Step 3 of Twine Setup

Here's a workaround so you can get your Twine up and running. While you're connected to the ||| Twine access point, follow these steps:

  1. Load http://twinesetup.com/gainspan/profile/tls/config and copy the text you see into an email to help@supermechanical.com so that we can register your Twine to your account. Also include your operating system version and browser to assist us in tracking down the problem.
  2. Reload http://twinesetup.com. You will see a bright green settings page.
  3. Select "Wireless and Network Configuration".
  4. Select "Manual Configuration"
  5. Enter your wireless network's information, and select "Next".
  6. Select "Save And Apply".
  7. Wait for us to register your Twine - we'll send you a response when it's ready to go.

Using Twine - Power: frequently asked questions

How does my Twine get power? Use two (2) AAA alkaline batteries to provide power to your Twine, or a micro USB power adapter such as many cell phones use. Twine wasn't designed with rechargeable batteries in mind, so with rechargables your battery life will vary and the low battery email may not be sent at the appropriate time (your mileage may vary).

How long can I expect my battery to last? Your battery life will depend on how often Twine sends you a message, how often you update it, and the quality of your batteries. Our tests currently estimate that Twine, running firmware 2.0 and radio May 24 2013, will last 60 days on good alkaline batteries.

How will I know if my Twine is about to lose power? Twine knows when it’s running out of power, and it will send you an email about 5 days before you need to change the battery.

How can I extend the battery life of my Twine? Twine currently runs 60 days on fresh alkaline AAA batteries (when running firmware 2.0 and radio May 24 2013), but if you want to extend that time, there are two things you can do:
1. Set all your rules at once. Changing rules often requires more frequent Twine updates.
2. When you don’t need Twine to be portable, plug it into a micro USB charger. Just about any micro USB power supply will work. This won’t charge Twine, but it will stop it from using battery power.


Using Twine - Using the website

When I create a new rule, when does it go into effect? If you want your new rule to go into effect immediately, flip your Twine over so it’s upside down, and then flip it back, so it’s right side up; like this. Otherwise, Twine will recognize your new rule in 2 hours or less.

Does Twine work with my web browser? Twine's website works in most modern web browsers. It works great in Chrome, Firefox and Safari, and has been tested to work in Internet Explorer 9 or greater. Unfortunately, the website may not work well in earlier versions of Internet Explorer.


Using Twine - Security

Is the information shared by Twine secure? Twine sends information to your account using SSL-level encryption, to protect your data from being intercepted. Your Twine is as secure as most other online services that you use.

Does the password to my home Wi-Fi network get sent to my Twine account? No. You enter the password to your home network to make sure Twine can connect, but this information is only stored on your Twine.


Using Twine - What are the ports on the back of Twine?

png.png

Twine has three holes on the back. What are they for?

  1. 3.5mm port - this is for external sensors. While you can technically use 4-conductor audio cables in this, we've designed custom shielded cables that keep the sensor signal from degrading over distances.

  2. micro USB port - this is for external power, not data. You can power Twine off of your computer or any cellphone charger. While your Twine is on external power, it won't use the batteries (and it won't charge them). If you unplug Twine from external power and it has good batteries in it, Twine won't miss a beat.

  3. LED - you need to see the status light somehow! What is the light trying to tell me?


Using Twine - Static IP for Twine

Overview

Some users are having trouble maintaining reliable connections even when using the Nov. 15 firmware release. This note explains how to set your Twine to use a static IP address, which seems to help this issue. (Side note: if you're having connection issues and don't have a firmware version later than Nov. 15 --- please email us.)

Details

WIth the Nov. 15th and later firmware versions, when connected Twine checks its link is good every 45 seconds. If the link has failed, it attempts to re-associate with the wireless network (pulsing light). On occasion this re-association attempt fails, usually due to DHCP issues with Apple Airport routers. If the re-association fails, Twine waits 120 minutes before re-trying in order to prevent excessive power consumption during legitimate network outages. We are currently working on a more sophisticated re-association algorithm to handle these issues, but in the meantime we have found that giving Twine a static IP can mitigate these issues.

Steps

  1. Determine a suitable static IP address for your Twine, along with your netmask, default gateway, and DNS server

  2. Put your Twine into setup mode (solid light). If your Twine is already disconnected, simply flip it on its back. If your Twine is connected and you still want to do this, remove power, wait five seconds, re-add power, and then flip your Twine while the LED is pulsing.

  3. Connect to the ||| Twine wireless network.

  4. Go to twinesetup.com after connecting to the network. You should see some very green web pages.

  5. Click Wireless and Network Configuration-->Select an Existing Network

  6. Click the Select button next to your network.

  7. Enter your network security information and then click the Advanced Options check box.

  8. Click Static IP Address Configuration and then fill in the remaining fields with the information from step 1.

  9. Click Next.

  10. Verify your settings and then click Save and Apply. The LED should begin pulsing and then extinguish after several seconds.

  11. Reconnect to your normal wireless network and visit twine.supermechanical.com to verify that your Twine is working correctly.


Using Twine - My external sensor doesn't appear when I plug it in, or it disappears after a while.

If your external sensor never shows up when you plug it into your working Twine, here are a few things to check:

If your sensor shows up at first but disappears after a while, this is fixed in a software update. Resave your rules, even if they're empty, to get the update.


Using Twine - Removing a Twine from your Account

Twines can only be registered to one account at a time. If you are selling/giving your Twine away, or would just like to have it removed from your account, delete your rules from your Twine and then email us at help@supermechanical.com from the email address the Twine is registered under, and we'll delete it from your account.


Using Twine - External sensor isn't working?

If your external sensor isn't showing up on your Twine's dashboard when it is plugged in, make sure that both ends of the cable are firmly plugged in.
Still doesn't show up? Check which version of firmware your Twine is running. You can check the firmware version by hovering your cursor over your Twine's name on the dashboard. Support for external sensors was added in 1.1.1. If your Twine is running an earlier version, save a rule and the firmware will also update.


Using Twine - Multiple Twines not updating on the dashboard.

If you have 4 or more Twines in one account, they may not update on the main dashboard properly due to limitations of most browsers. This issue only affects the dashboard; your Twines and rules will still function properly, and you can see each Twine updating regularly by going to its rules page. You can read more about what is happening and why here: http://stackoverflow.com/questions/985431/max-parallel-http-connect...

If you'd prefer to have each Twine's sensor data always at your fingertips, we can split your Twines into multiple accounts, or you can create a new account when you set each Twine up (just sign out of your existing account first, and you'll have this option).


Using Twine - Updating to 2.0 firmware

When your Twine is connected and you're signed into your Twine account, go to the Account page and click on "Upgrade to 2.0 firmware". This update comes in two parts.

You'll need to have the latest ARM firmware before we can upgrade the radio. If you don't already have it, you'll be prompted to update it at the beginning of the process.

Next, you'll upgrade your Twine's radio. Make sure your Twine has a strong Wi-Fi signal and fresh batteries (or external power) before you start the upgrade process. Click "Begin Upgrade" when you and your Twine are ready to start. Flip your Twine from any orientation other than bottom side up to bottom side up (like during the setup process), and click "It's flipped" to start the upgrade. Leave your Twine bottom side up until the upgrade process is complete.

If something unexpected happens, or if you have any questions, email us at help@supermechanical.com.


Rules and Notifications - SMS notifications

We offer an optional paid plan to have your Twine send SMS (and voice call) notifications. You can read more about it here: https://twine.supermechanical.com/plus. If you're signed up and aren't getting SMSs, please send us a message.

To have your Twine sends SMS messages through the recipient's carrier's email gateway, check http://en.wikipedia.org/wiki/List_of_SMS_gateways to see the proper way to format the email address. The email to SMS gateway does not work reliably for most carriers so we no longer support this method.

If your AT&T phone is not getting a text message from Twine, visit http://mymessages.wireless.att.com/ and see if there are settings you can change that will let through email from twine@supermechanical.net.

If your Rogers phone is not getting a text message from Twine, you need to allow email-to-SMS messages. To do this, text 'Subscribe' to 0000000000. Then text 'Allow supermechanical.net' to the same number. This will allow text messages from your Twine to get through, and not marked as spam. Read Rogers' documentation.

If your Vodafone D2 phone is not getting a text message, enable the receipt of e-mail based text messages by sending an SMS with the word OPEN to the short number 3400. Important: Make sure the short message service center +49 172 2270 333 is stored in your mobile phone.

If your O2 phone is not getting text messages, compose a text message with the word 'ON' and send it to shortcode 212. Then follow the on-screen prompts.


Rules and Notifications - Emails aren't being received

Always test your rules to make sure you get notifications before you set your Twine up to monitor its surroundings!

Some providers classify or block Twine notifications as spam (we've especially noticed this with icloud.com/mac.com/me.com). The content of your emails can affect this—if you write the notification message like you would write an email, it will improve the chances of getting through the spam filters.

You can also whitelist (put on a list of approved senders) the email address your Twine sends from—find this address under the Account tab.

If you get some emails and some go missing, it may be because your Twine has hit the rate limit of 30 notifications per hour.

If you aren't getting emails as expected and they aren't getting sent to your spam folder, send us an email at help@supermechanical.com.


Rules and Notifications - How rules work

Rules are how your Twine connects your world to your technology. You can tell Twine what to do with rules like "WHEN the orientation is front-side up, THEN email me."

Let’s say you want to get an email when the temperature rises above 80º.
First, click on the "Add Rule" button.
Click the “Add a Condition” button, and choose “Temperature” from the drop down menu. Select the “Rises Above” option, and set the temperature to 80º.
Click “Add an action”, and select email from the drop down menu. Enter your email address and a message.
To save your rule to Twine, click on "Save to Twine".
You’ll have to flip your Twine over or wait for your Twine to connect to our servers, and then Twine will tell you what’s going on in your world!
Remember: Your Twine has a rate limit of 30 notifications (emails, text messages, HTTP calls, etc.) per hour.

How the rule options work:
A rule triggers only at the point when a value is crossed — for example, at the moment that the temperature goes from below 80ºF to above 80ºF.
The "trigger after X seconds" is the amount of time that the condition has to be met (the temperature must stay above 80ºF for X seconds) before it runs the actions.
If there are more than one actions in one rule, Twine treats them as an AND. You’ll only be notified when all conditions are met simultaneously.
The "untrigger" value is the amount of time your Twine needs to be in a different state before your rule can be triggered again. If you have a rule setup to notify you when your Twine is top side up with a 30 second untrigger value, your Twine will need to be in a state other than top side up for more than 30 seconds.


Rules and Notifications - HTTP Requests

You can send HTTP or HTTPS requests to any port from Twine using GET or POST.

The server Twine sends the request to must be publicly accessible so Supermechanical's server can communicate with it.


Range - Need help with your Range?

Looks like you've stumbled onto the Twine help site. If you have questions about the Range smart thermometer for iOS, follow this link to our Range specific support site.