Setting up Further Code Runner Connection

To deploy code from Further to a pi-top you will need to run a program on your pi-top we call "Further Link".

Installing and Enabling Further Link

If Further Link is installed already, you should see a page to 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.

 

Deploying code to your pi-top [4]

  1. Ensure you are connected to the same Network as your pi-top. You can find the IP Address from either the WiFi or LAN pages.
  2. Open any challenge on Further.
  3. Click the green </> code icon in the bottom right.
  4. Find you device's IP Address and enter it into the input in the Code Runner dialog.
  5. Click Connect and the Run button will be enabled! Enter some python code, click Run and see your code in action.

And it's that simple!

Troubleshooting

If you still can't connect, check the following.

  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

Troubleshooting Steps

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

There's a fix for this. It will require you to set up 1.1.1.1. The instructions for which can be found on the cloudlfare 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.