Running Code from Further - Further Link

To run code from Further we use a program on the pi-top called Further Link

Deploying code to your pi-top [4]

  1. Ensure you are connected to the same network as your pi-top.
  2. Open any challenge on Further.
  3. Click the pi-top icon in the menu bar at the top of the page.
  4. Find your device's IP Address from the miniscreen menu and enter it into the input in the connection box.
  5. Click 'Connect' and you're set! Runnable Python code on the page will have the Run button enabled.

You will need to scroll through the screens on the OLED to get your IP Address -

It's always a set of 4 numbers separated by dots
192.168.1.65
172.10.3.5

And it's that simple!

Make sure your pi-top is up to date before deploying code from Further.
When you connect, Further will remind you if you haven't

Troubleshooting

You may encounter a screen such as the one below when trying to connect to your device through the Further Link.

Try the troubleshooting steps below. If you're still having trouble, then get in touch with us at support@pi-top.com.

Is Further Link enabled?

If Further Link is installed already, you should see a page for it in the Mini Screen, by going to the Settings page in the Menu.  Further Link will have to be enabled. To enable it press ‘O' twice to open Settings, ‘▲' or ‘▼' until you find Further Link, 'O’ to toggle it, 'X’ twice to return to device info. If you can't find Further Link but you can see SSH  and VNC, then it's likely it's not been installed on your pi-top [4]. Once you update your OS and reboot, it will appear on the OLED Display.

 

Can you connect to Further Link?

Copy and paste the URL below into your browser, replacing the numbers with the IP Address of your pi-top, using dashes instead of dots.

https://192-168-1-1.further-link.pi-top.com:8028/status

If your connection works then you'll see the screen above. Otherwise, you'll get a regular "site can't be reached" screen.

I still can't connect to Further Link

There's a fix for this. It will require you to set up Cloudflare DNS. The instructions for which can be found on the Cloudflare website here, with a brief intro into what it is.

1.1.1.1-fancycolor

There's an individual fix for Windows, macOS and Linux.

Try this link - https://1.1.1.1/help - to see if it's been configured correctly

Advanced troubleshooting / Not using pi-topOS?

  1. Is the service actually installed?  To do that, run the command
    sudo apt install -y pt-further-link

    This will attempt to install Further link manually. If it's already installed, it will say so, if not, it will install it.

  2. Check that further-link service is running
    sudo systemctl is-active pt-further-link.service

    If the service is active, check the IP address is correct.  If you still can't connect, please contact support@pi-top.com

  3. If the service is NOT active (from 2 above), please run:

    sudo systemctl start pt-further-link.service

    sudo systemctl enable pt-further-link.service

    then reboot and try again.  If you still can't connect please contact support@pi-top.com