From 3fb51a2369bc9b37971d9c5b6eeb832769f8da25 Mon Sep 17 00:00:00 2001 From: Florent Revest Date: Thu, 21 Dec 2017 20:09:36 +0100 Subject: [PATCH] Adds a documentation page about upgrading asteroid with instructions on how to use opkg over usb --- pages/wiki/documentation.hbs | 1 + pages/wiki/update-asteroidos.hbs | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+) create mode 100644 pages/wiki/update-asteroidos.hbs diff --git a/pages/wiki/documentation.hbs b/pages/wiki/documentation.hbs index b566e50..f869bfd 100644 --- a/pages/wiki/documentation.hbs +++ b/pages/wiki/documentation.hbs @@ -11,6 +11,7 @@ layout: documentation
  • Porting Status
  • SSH
  • Useful commands
  • +
  • Update AsteroidOS
  • Bluetooth
  • Translating AsteroidOS
  • Licenses
  • diff --git a/pages/wiki/update-asteroidos.hbs b/pages/wiki/update-asteroidos.hbs new file mode 100644 index 0000000..fd502c7 --- /dev/null +++ b/pages/wiki/update-asteroidos.hbs @@ -0,0 +1,32 @@ +--- +title: Update AsteroidOS +layout: documentation +--- + +

    AsteroidOS currently doesn't offer any nice OTA experience. The main limitation being the connectivity of watches. AsteroidOS watches don't have direct access to the Internet which is very limitating when it comes to upgrades. This page tries to document how to upgrade Asteroid.

    + + + +

    The easiest way, as of today, is just to reflash the entire OS following the usual installation instructions.

    + + + +

    If you don't want to loose your personal data and would prefer upgrading Asteroid without reflashing it you can use asteroid's package manager: opkg. However, your watch most likely lacks Internet connectivity so you'll need to connect your watch to the Internet somehow. The following instructions describe how to share your computer's connectivity with your watch.

    + +

    Configure a NAT on your computer (note: replace eth0 with the name of the interface that connects your computer to the Internet) with:

    +
    echo 1 > /proc/sys/net/ipv4/ip_forward
    +iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
    + +

    Configure a default gateway and DNS on the watch with the following commands ran via SSH:

    + +
    route add default gw 192.168.2.1
    +echo "nameserver 8.8.8.8" >> /etc/resolv.conf
    + +

    You can now upgrade your distribution with opkg using the standard commands:

    + +
    opkg update
    +opkg ugrade