summaryrefslogtreecommitdiffhomepage
path: root/digital/dev2/doc/dev2.txt
blob: 0c3b7f286323232e4af0162f64e56658b169c9ed (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
===============================================================
 dev2 - Multi-purpose development board using USB and Ethernet
===============================================================

USB connection
==============

As there is no driver for the dev2 board in the kernel and there is not enough
USB end points in the AT90USB162 to implement a ACM class device with two
serial ports, you should load the generic serial driver:

 modprobe usbserial vendor=0x03eb product=0x204e

Then look at kernel messages to locate the new serial devices (/dev/ttyUSBx).

If two functions are presents in the same firmware, two serial devices should
be detected.

Controlling the output
======================

The board can be controlled using the dev2ctl.py program which uses libusb.

Use it to select an output.

You can also use it to deselect an output so that no current flows into it.

It can also be used to control GPIO when available in the loaded firmware.

To select an output:

 dev2ctl.py -s *1 to 4*

To make all output unconnected:

 dev2ctl.py -u

Before powering off connected boards, you should deselect outputs so that it
is not powered by dev2 I/O pins.

About the vendor and product ID
===============================

They come from LUFA, the USB library we use for dev2.  This is not supposed to
be done in a commercial USB product, but this is OK for hobbyists.  That's why
dev2ctl parses the product name to make sure it talks to the right device.

Changing firmware
=================

The dev2 firmware can be updated using the USB bootloader.  First of all,
switch the board in DFU mode:

 dev2ctl.py --dfu

Then you can use a DFU programmer to update the firmware.  For example:

 dfu-programmer at90usb162 erase
 dfu-programmer at90usb162 flash dev2_gpio.hex

Then the uploaded firmware can be started and used directly:

 dfu-programmer at90usb162 start