diff --git a/platforms/upboard/up2/README.md b/platforms/upboard/up2/README.md
index 9aa956fa..0a71d57d 100644
--- a/platforms/upboard/up2/README.md
+++ b/platforms/upboard/up2/README.md
@@ -6,9 +6,24 @@ For more info about the UP2 Board, go to [http://www.up-board.org/upsquared/](ht
 
 ## How to Install
 
-We recommend updating to the latest Ubuntu when using the UP2.
+### Setting up your UP2 board
 
-You would normally install Go and Gobot on your workstation. Once installed, cross compile your program on your workstation, transfer the final executable to your UP2, and run the program on the UP2 as documented here.
+We recommend updating to the latest Ubuntu and firmware when using the UP2 board. For more information go to:
+
+URL
+
+Once your UP@ has been updated, you will need to provide permission to the `upsquared` user to access the I2C subsystem on the board. To do this, run the following command:
+
+```
+sudo usermod -aG i2c upsquared
+```
+
+**IMPORTANT NOTE REGARDING I2C:** 
+The current UP2 firmware is not able to scan for I2C devices using the `i2cdetect` command line tool. If you run this tool, it will cause the I2C subsystem to malfunction until you reboot your system. That means at this time, do not use `i2cdetect` on the UP2 board.
+
+### Local setup
+
+You would normally install Go and Gobot on your local workstation. Once installed, cross compile your program on your workstation, transfer the final executable to your UP2, and run the program on the UP2 as documented below.
 
 ```
 go get -d -u gobot.io/x/gobot/...
@@ -30,12 +45,12 @@ led := gpio.NewLedDriver(r, "13")
 Compile your Gobot program on your workstation like this:
 
 ```bash
-$ GOARCH=386 GOOS=linux go build examples/up2_blink.go
+$ GOARCH=amd64 GOOS=linux go build examples/up2_blink.go
 ```
 
 Once you have compiled your code, you can you can upload your program and execute it on the UP2 from your workstation using the `scp` and `ssh` commands like this:
 
 ```bash
-$ scp up2_blink ubuntu@192.168.1.xxx:/home/ubuntu/
-$ ssh -t ubuntu@192.168.1.xxx "./up2_blink"
+$ scp up2_blink upsquared@192.168.1.xxx:/home/upsquared/
+$ ssh -t upsquared@192.168.1.xxx "./up2_blink"
 ```