summaryrefslogtreecommitdiff
path: root/digital/dev/doc/usage.txt
blob: de1030a5745c3aaf5b0023020b58a153e06eefdc (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
64
===============================
How to use the development card
===============================
:Author: djerem


Introduction
============

The development card is use to power, program and communicate with others
card. It has two working modes:

  program
    it is used to program the AVR on the card link to it;

  serial
    it is used to communicate with the AVR on the card link to it.


How to use it?
==============
Pre-requires
------------

You need to install:
 * avrdude (at least version 5.5);

 * usbprog.


The voodoo ceremonial
---------------------

As ``usbprog`` is quite buggy (no error checks), here is the best working
procedures we have found:

 #. power up the development card using the external power;

 #. power up your card using the power provided by the development card;

 #. plug the USB cable to your computer. You should see ``atmel`` in the
    output of ``sudo lsusb``;

 #. plug the dev cable to the card you want to program.

 #. use ``avrdude`` to program your card, with something like:
    ``avrdude -p m128 -c avrispv2 -P usb -U flash:w:your_program.hex``
    If it does not work, just remove the serial and USB cable and try again the
    procedure.

 #. remove the serial cable from the card.

 #. remove the USB cable from your computer and plug it back in.

 #. launch ``usbprog`` to put the development card in serial mode:
    ``sudo usbprog device 0 upload blinkdemo devices``. It should failed with
    something like *Unable to find update device (2).* but that's normal. You
    should see in the kernel message something like:
    *cdc_acm 2-2:1.0: ttyACM0: USB ACM device*.

 #. plug the dev cable.

 #. launch ``minicom`` in */dev/ttyACM0 8N1* mode.