XYO Foundation Dev Portal
  • Guides

›Bridge

Getting Started

  • Getting Started

Updates

  • Latest Updates
  • News Archive

Changemaker Challenge

  • UC San Diego and XYO

Using our Mobile SDKs

  • SDK Guide

XYO Foundation

  • Open Source Initiative

XYO Network App

  • How To Use

Explore App

  • How To Use

Bridge

  • Bridge X

Smart Contract Apps

  • Dapploy
  • Dapper
  • SCSC Library

SDKs

  • Android SDK
  • Swift SDK
  • Node Core SDK
  • Swift Core SDK
  • Kotlin Core SDK

Tools

  • XYO Tools

BRIDGE X

The XYO Foundation provides this source code available in our efforts to advance the understanding of the XYO Procotol and its possible uses. We continue to maintain this software in the interest of developer education. Usage of this source code is not intended for production. Developer usage of the BridgeX app is intended for educational purposes on geospatial location blockchain protocol.

There is an update to the Bridge software coming in Q3 2020. Although you can still download and use the current bridge in your Raspberry Pi 3. For Windows users, we highly encourage you to use Windows Subsystem for Linux (WSL) 2 with a Linux distribution. This will allow you to follow along the linux instructions for install and update. This guide will also be updated to coincide with the upcoming BridgeX update.

WSL 2 Documentation

Difficulty Level: Intermediate

Current Version - 1.0.2

Downloads Available

Click Here to Download The Latest Bridge Image in Mac, Linux, or Windows

1.0.2 (2019-04-26)

Changes

  • general bug fixes
  • UI fix for display connect issues

Extract the image on Windows

IMPORTANT: To Extract the Image on Windows, download 7zip here

We will update the image zip file to accommodate all platforms

BridgeX Consumer Help Articles

BridgeX Set Up Guide

Flashing an SD Card with BridgeX

All BridgeX Consumer Help Articles

Advanced Setup and Update Options for MacOS or Linux

  • First insert your SDCard into your chosen dongle USB to SDCard reader

Next we want to download the latest Bridge X Image

  • Click here to download
  • Double click on the zipped file to expand it
  • You should now see the img file appear in the same folder where the img.tar.gz file appeared

Flash the image

  • Open your Mac's disk utility and navigate to 16gb disk NORELSYS 1081
  • Click Erase
  • Select ExFAT as your format for the new partition
  • Check for successful erase
  • Click on the info button in the disk utility
  • Scroll down to the parent disks
  • Take note of the parent disks name

Go into a terminal window

  • Navigate to the image
    • In downloads (or wherever you keep your downloads) .img file
  • Enter this command
  sudo diskutil unmountDisk /dev/<your parent disks name>
  • Then install image to the Bridge
  sudo dd if=./xyobridge.img of=/dev/<your parent disks name> bs=1m
  • Once that is completed, you can eject the SDCard and install it in your Bridge X

Updating the Bridge through unattended upgrades

Once we have set up our Bridge X it would be a good idea to check on and complete upgrades

There are two ways that we can do this

  • First, enter this command to execute commands on your Bridge
  ssh bridge@<ip address of your bridge>
  • You will be prompted to enter a password, you will enter the default password for the Bridge filestore - geohacker
bridge@<ip address of your bridge>'s password: 
  • Then enter this command
sudo apt update
  • Enter the device password again for the Bridge - geohacker
[sudo] password for bridge:
  • You should see the Bridge pulling the latest from the repo
Hit:1 http://repo.xyo.network/repos/apt/raspbian stretch InRelease
Hit:2 http://raspbian.raspberrypi.org/raspbian stretch InRelease
Get:3 http://archive.raspberrypi.org/debian stretch InRelease [25.4 kB]
Fetched 25.4 kB in 1s (15.0 kB/s)
Reading package lists... Done
Building dependency tree
Reading state information... Done
31 packages can be upgraded. Run 'apt list --upgradable' to see them.
  • Now run this command to upgrade
sudo apt upgrade
  • You will be prompted on whether you would like to continue with the upgrade
The following packages will be upgraded:
<packages to be upgraded will be listed here>
31 upgraded, 0 newly installed, 0 to remove and 0 not upgraded.
Need to get 106 MB of archives.
After this operation, 303 kB disk space will be freed.
Do you want to continue? [Y/n] y

This upgrade includes a lot of downloading and unpacking of new packages, so please be patient with the process

You should see a progress bar

Progress: [ <percent complete>%] [#################################################################################################################################..........................................................]

Once it completes, you are all set with your upgrade. Be sure to visit the Bridge X App to verify that it is still functioning

You can also use this command after sudo apt update to execute an unattended upgrade

sudo unattended-upgrades -d

The confirmation output after this upgrade process should look like this

+ @xyo-network/bridge.pi@0.123.0
updated 1 package in 71.157s
xyo-bridge-pi is ready
All upgrades installed
InstCount=0 DelCount=0 BrokenCount=0
Extracting content from '/var/log/unattended-upgrades/unattended-upgrades-dpkg.log' since '2019-04-18 22:08:09'

Congrats you have upgraded your Bridge X!

Changing linux default password

If you don't want our default password to run your bridge, you are more than welcome to change it

  • First, enter this command to execute commands on your Bridge
  ssh bridge@<ip address of your bridge>

NOTE you can change the password to your Bridge filestore by entering this command

sudo passwd bridge

You will then get a prompt to enter the current password (geohacker)

[sudo] password for bridge:

Enter a new password

Enter new UNIX password:

Then confirm this new password

Retype new UNIX password:

After the password is confirmed you will see this message and you may continue operating on the Bridge with your own password

passwd: password updated successfully

Adding an archivist

Use the Bridge X UI

  • Scroll down on the dashboard to your connected archivists - you will see that we have one connected which is XYO's Archivist

archivist-gui

  • Click +Connect More Archivists

You should see a Add Archivist modal pop up on your screen

  • Enter the IP Address or DNS Name
  • Enter the Port number
  • Click Save

add-archivist

  • Once we save the information, we should now see another Archivist under Connected Archivists

connected-archivists

We have now connected an Archivist to the Bridge X using the Bridge's native UI!

Changelog

Version - 1.0.1

Click Here to Download The Latest Bridge Image

Download link is also in the guide

1.0.1 (2019-04-23)

New Features

  • add ui component for last resort update (for large scale bridge issues)
  • add ui to display current npm and apt versions

Changes

  • about tag in footer is new location for force update and last resort
  • general bug fixes

Version - 1.0.0

Click Here to Download The Previous Bridge Image

1.0.0 (2019-04-18)

Changes

  • more consistent force update of bridges
  • general bug fixes
Last updated on 5/26/2020
← How To UseNext →
  • Current Version - 1.0.2
    • Downloads Available
    • Changes
    • Extract the image on Windows
  • BridgeX Consumer Help Articles
  • Advanced Setup and Update Options for MacOS or Linux
    • Flash the image
    • Updating the Bridge through unattended upgrades
    • Changing linux default password
  • Adding an archivist
    • Use the Bridge X UI
  • Changelog
    • Version - 1.0.1
    • Version - 1.0.0

XYO | Developers

Copyright © 2020 XYO
DocsExplore AppProtocolSource Code
Community
GitHubTwitter