ATMEGA32U4: Difference between revisions

From Nottinghack Wiki
Jump to navigation Jump to search
← Older editNewer edit →
Line 120: Line 120:


* HID descriptor help http://www.usb.org/developers/hidpage#HID Descriptor Tool
* HID descriptor help http://www.usb.org/developers/hidpage#HID Descriptor Tool
Test for ProMicro with 8 inputs, debounce, multitasking and serial output: -
<div style ="height:200px;overflow-x:hidden;overflow-y:auto;border: 4px solid green;">
<syntaxhighlight lang="cpp" line="GESHI_FANCY_LINE_NUMBERS">
/* Pro Micro Test Code
  by: Nathan Seidle
  modified by: Jim Lindblom
  SparkFun Electronics
  date: September 16, 2013
  license: Public Domain - please use this code however you'd like.
  It's provided as a learning tool.
  This code is provided to show how to control the SparkFun
  ProMicro's TX and RX LEDs within a sketch. It also serves
  to explain the difference between Serial.print() and
  Serial1.print().
  modified by: Michael Erskine
  Nottingham Hackspace
  date: August 28th, 2015
  Added digital inputs from 2-9 with debounce and simple multitasking
 
*/
int RXLED = 17;  // The RX LED has a defined Arduino pin
// The TX LED was not so lucky, we'll need to use pre-defined
// macros (TXLED1, TXLED0) to control that.
// (We could use the same macros for the RX LED too -- RXLED1,
//  and RXLED0.)
void setup()
{
  pinMode(RXLED, OUTPUT);  // Set RX LED as an output
  // TX LED is set as an output behind the scenes
  Serial.begin(9600); //This pipes to the serial monitor
  Serial1.begin(9600); //This is the UART, pipes to sensors attached to board
  inputs_setup();
}
const int da_start = 2;
const int da_num = 4;
static uint8_t da_inputs = 0;
void inputs_setup(void) {
  for(int i = 0; i < da_num; i++) {
    pinMode(da_start + i, INPUT_PULLUP);
  }
  da_inputs = inputs_read();
}
uint8_t inputs_read(void)
{
  uint8_t da_samp = 0;
  for(int i = 0; i < da_num; i++) {
    bitWrite(da_samp, i, (digitalRead(da_start + i) ? 0 : 1));
  }
  return da_samp;
}
void loop()
{
  task_led_toggle();
  task_inputs();
  task_serial_read();
}
void task_inputs(void)
{
  static uint32_t last;
  uint32_t now = millis();
  if(now - last > 5) {
    last = now;
    uint8_t da_samp = inputs_read();
    uint8_t toggle;
    da_samp = debounce(da_samp, &toggle);
    if(da_samp != da_inputs) {
      da_inputs = da_samp;
      Serial.print("Inputs: ");
      Serial.println(da_inputs, BIN);
    }
  }
}
void task_led_toggle(void)
{
  static uint32_t last;
  static bool on = false;
  uint32_t now = millis();
  if(now - last > 1000) {
    last = now;
    // Serial.println("Hello world");  // Print "Hello World" to the Serial Monitor
    // Serial1.println("Hello!");  // Print "Hello!" over hardware UART
    if(on){
      digitalWrite(RXLED, LOW);  // set the LED on
      TXLED0; //TX LED is not tied to a normally controlled pin
    } else {
      digitalWrite(RXLED, HIGH);    // set the LED off
      TXLED1;
    }
    on = !on;
  }
}
void task_serial_read(void) {
  // TODO
}
/*
* http://www.compuphase.com/electronics/debouncing.htm
*/
unsigned char debounce(unsigned char sample, unsigned char *toggle)
{
    static unsigned char state, cnt0, cnt1;
    unsigned char delta;
    delta = sample ^ state;
    cnt1 = (cnt1 ^ cnt0) & delta;
    cnt0 = ~cnt0 & delta;
    *toggle = delta & ~(cnt0 | cnt1);
    state ^= *toggle;
    return state;
}
</syntaxhighlight>
</div>

Revision as of 13:32, 28 August 2015

Many hackers wish to produce a USB device that presents itself as a HID joypad, keyboard, or mouse to a PC or Pi to provide interesting interactions and I/O opportunities in a "standardised" manner. The Arduino Micro and more recently the Leonardo use a micro with an inbuilt USB peripheral device that can be repurposed directly. Previously the Arduino boards used a second small micro or dedicated USB chip (essentially another micro) to perform the USB-serial task but the cost of this additional device was high (often more than the micro itself) and that essential USB device feature soon found itself integrated into a number of Atmel chips. This was an opportunity for the Arduino project to divorce itself from a massive dependence on FTDI (in good time for #FTDIGATE !!) and for hackers to get involved with the delights of the at90usb82, atmega16u2, etc. as secondary processors for USB comms.

Time rolls on and the excitement of the brilliant but non-open Minimus project dies down to find a number of crazy-cheap options where the USB chip is the main chip. The Atmega32U4 can be found on the Arduino Micro (currently for about £20) but also on the wonderful Teensy 2.0 and some really cheap little "Pro Micro" boards from China that at £4 each are cheaper than buying just the chip from here in the UK (in reasonable quantities). Myself (Michael E) and Spencer have ordered some of these bonkers-cheap units for initial testing and evaluation. They would appear to be clones of the Sparkfun Pro Micro https://www.sparkfun.com/products/12640

Info Dump

Initial Works for DELIVERY 1

  • board inspection: -
    • what is included other than the MCU and a 16MHz crystal?
    • what is missing other than the ICSP header?
  • programming the board as an Arduino with Arduino IDE
  • programming with dfu-programmer and avr-gcc, avr-libc, etc.
  • what bootloader is provided? The Teensy 2.0 HALFKAY?

Chip markings (from ebay photos until we receive our first delivery) 

   ATMEL
   MEGA32U4
   -MU
   1448E    TH
   A2N7XA

Initial risks and mitigations: -

  • not a real ATMEL chip or bad batch/revision
  • closer inspection of chip markings and initial firmware tests
  • check JTAG IDs and Device Identification Register (26.3.2 in datasheet)
  • bad oscillator circuitry or configuration
  • pinout mapping for Arduino/teensy/Micro


    J1  |USBu|    
   TX0          RAW
   RX1          GND
   GND          RST
   GND          VCC
     2          A3
     3          A2
     4          A1
     5          A0
     6          15
     7          14
     8          16
     9          10
  +----------------+

Michael's USB-HID Work

Origins: -

New project - very similar...


Test for ProMicro with 8 inputs and keyboard output: - 

static uint8_t bprev;
static uint8_t bnew;

const int pmin = 2;
const int pmax = 9;


void setup() {
  
  for(int i = pmin; i <= pmax; i++){
    pinMode(i, INPUT_PULLUP);
  }
  Serial.begin(9600);
  Keyboard.begin();
  bprev = bnew = btn_read();
}

void loop() {
  bnew = btn_read();
  if(bnew != bprev){
    Keyboard.write('z');
    Serial.print("btns = ");
    Serial.println(bnew, HEX);
    bprev = bnew;
  }
  // force change with any serial input
  if(Serial.available() > 0) {
      int b = Serial.read();
      Serial.print("RX: ");
      Serial.println(b, DEC);
      bprev = ~bprev;
  }
}

uint8_t btn_read(void) {
  uint8_t v = 0;
  for(int i = pmin; i <= pmax; i++){
    bitWrite(v, i-pmin, digitalRead(i));
  }  
  return v;  
}


Test for ProMicro with 8 inputs, debounce, multitasking and serial output: - 

/* Pro Micro Test Code
   by: Nathan Seidle
   modified by: Jim Lindblom
   SparkFun Electronics
   date: September 16, 2013
   license: Public Domain - please use this code however you'd like.
   It's provided as a learning tool.

   This code is provided to show how to control the SparkFun
   ProMicro's TX and RX LEDs within a sketch. It also serves
   to explain the difference between Serial.print() and
   Serial1.print().

   modified by: Michael Erskine
   Nottingham Hackspace
   date: August 28th, 2015
   Added digital inputs from 2-9 with debounce and simple multitasking
   
*/

int RXLED = 17;  // The RX LED has a defined Arduino pin
// The TX LED was not so lucky, we'll need to use pre-defined
// macros (TXLED1, TXLED0) to control that.
// (We could use the same macros for the RX LED too -- RXLED1,
//  and RXLED0.)

void setup()
{
  pinMode(RXLED, OUTPUT);  // Set RX LED as an output
  // TX LED is set as an output behind the scenes

  Serial.begin(9600); //This pipes to the serial monitor
  Serial1.begin(9600); //This is the UART, pipes to sensors attached to board

  inputs_setup();
}

const int da_start = 2;
const int da_num = 4;
static uint8_t da_inputs = 0;

void inputs_setup(void) {
  for(int i = 0; i < da_num; i++) {
    pinMode(da_start + i, INPUT_PULLUP);
  }
  da_inputs = inputs_read();
}

uint8_t inputs_read(void)
{
  uint8_t da_samp = 0;
  for(int i = 0; i < da_num; i++) {
    bitWrite(da_samp, i, (digitalRead(da_start + i) ? 0 : 1));
  }
  return da_samp;
}

void loop()
{
  task_led_toggle();
  task_inputs();
  task_serial_read();
}

void task_inputs(void)
{
  static uint32_t last;
  uint32_t now = millis();
  if(now - last > 5) {
    last = now;
    uint8_t da_samp = inputs_read();
    uint8_t toggle;
    da_samp = debounce(da_samp, &toggle);
    if(da_samp != da_inputs) {
      da_inputs = da_samp;
      Serial.print("Inputs: ");
      Serial.println(da_inputs, BIN);
    }
  }
}

void task_led_toggle(void)
{
  static uint32_t last;
  static bool on = false;
  uint32_t now = millis();
  if(now - last > 1000) {
    last = now;
    // Serial.println("Hello world");  // Print "Hello World" to the Serial Monitor
    // Serial1.println("Hello!");  // Print "Hello!" over hardware UART
    if(on){
      digitalWrite(RXLED, LOW);   // set the LED on
      TXLED0; //TX LED is not tied to a normally controlled pin
    } else {
      digitalWrite(RXLED, HIGH);    // set the LED off
      TXLED1;
    }
    on = !on;
  }
}

void task_serial_read(void) {
  // TODO

}

/*
 * http://www.compuphase.com/electronics/debouncing.htm
 */
unsigned char debounce(unsigned char sample, unsigned char *toggle)
{
    static unsigned char state, cnt0, cnt1;
    unsigned char delta;

    delta = sample ^ state;
    cnt1 = (cnt1 ^ cnt0) & delta;
    cnt0 = ~cnt0 & delta;

    *toggle = delta & ~(cnt0 | cnt1);
    state ^= *toggle;

    return state;
}
Retrieved from "https://wiki.nottinghack.org.uk/index.php?title=ATMEGA32U4&oldid=10856"