OrgGo
/
hybridgroup.gobot
mirror of https://github.com/hybridgroup/gobot.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

digispark: update README with latest development info 

Signed-off-by: deadprogram <ron@hybridgroup.com>
This commit is contained in:
deadprogram 2017-05-27 12:19:14 +02:00
parent 6131198828
commit 431b394589
1 changed files with 37 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
platforms/digispark/README.md
View File

@ -27,7 +27,7 @@ $ sudo apt-get install libusb-dev
Now you can install the package with
```
go get -d -u gobot.io/x/gobot/... && go install gobot.io/x/gobot/platforms/digispark
go get -d -u gobot.io/x/gobot/...
```
## How to Use
@ -62,51 +62,58 @@ func main() {
robot.Start()
}
```
## How to Connect
If your Digispark already has the Little Wire protocol firmware installed, you can connect right away with Gobot.
Otherwise, for instructions on how to install Little Wire on a Digispark check out http://digistump.com/board/index.php/topic,160.0.html
Otherwise, you must first flash your Digispark with the Little Wire firmware.
The easiest way to flash your Digispark is to use Gort [https://gort.io](https://gort.io).
Download and install Gort, and then use the following commands:
Then, install the needed Digispark firmware.
```
gort digispark install
```
### OSX
**Important**: 2012 MBP The USB ports on the 2012 MBPs (Retina and non) cause issues due to their USB3 controllers,
currently the best work around is to use a cheap USB hub (non USB3).
Plug the Digispark into your computer via the USB port and run:
```
Important: 2012 MBP The USB ports on the 2012 MBPs (Retina and non) cause issues due to their USB3 controllers,
currently the best work around is to use a cheap USB hub (non USB3) - we are working on future solutions. The hub on a Cinema display will work as well.
gort digispark upload littlewire
```
Plug the Digispark into your computer via the USB port and you're ready to go!
### Ubuntu
Ubuntu requires a few extra steps to set up the digispark for communication with Gobot:
- Add a udev rule to allow access to the Digispark device
- Plug in the Digispark to the USB port
- Connect to the device via Gobot
First, you must add a udev rule, so that Gobot can communicate with the USB device. Ubuntu and other modern Linux distibutions use udev to manage device files when USB devices are added and removed. By default, udev will create a device with read-only permission which will not allow to you download code. You must place the udev rules below into a file named /etc/udev/rules.d/49-micronucleus.rules.
Ubuntu requires an extra one-time step to set up the Digispark for communication with Gobot. Run the following command:
```
# UDEV Rules for Micronucleus boards including the Digispark.
# This file must be placed at:
#
# /etc/udev/rules.d/49-micronucleus.rules (preferred location)
# or
# /lib/udev/rules.d/49-micronucleus.rules (req'd on some broken systems)
#
# After this file is copied, physically unplug and reconnect the board.
#
SUBSYSTEMS=="usb", ATTRS{idVendor}=="1781", ATTRS{idProduct}=="0c9f", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="1781", ATTRS{idProduct}=="0c9f", MODE:="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0753", MODE:="0666"
KERNEL=="ttyACM*", ATTRS{idVendor}=="16d0", ATTRS{idProduct}=="0753", MODE:="0666", ENV{ID_MM_DEVICE_IGNORE}="1"
#
# If you share your linux system with other users, or just don't like the
# idea of write permission for everybody, you can replace MODE:="0666" with
# OWNER:="yourusername" to create the device owned by you, or with
# GROUP:="somegroupname" and mange access using standard unix groups.
gort digispark set-udev-rules
```
You might need to enter your administrative password. This steps adds a udev rule to allow access to the Digispark device.
Once this is done, you can upload Little Wire to your Digispark:
```
gort digispark upload littlewire
```
### Windows
We need instructions here, because it supposedly works.
### Manual instructions
For manual instructions on how to install Little Wire on a Digispark check out http://digistump.com/board/index.php/topic,160.0.html
Thanks to [@bluebie](https://github.com/Bluebie) for these instructions! (https://github.com/Bluebie/micronucleus-t85/wiki/Ubuntu-Linux)
Now plug the Digispark into your computer via the USB port.