atusb/fw3/: added copyright headers and title comments

atusb/fw3/atusb.c

@@ -1,3 +1,16 @@
+/*
+ * fw/atusb.c - ATUSB initialization and main loop
+ *
+ * Written 2008-2011 by Werner Almesberger
+ * Copyright 2008-2011 Werner Almesberger
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ */
+
+
 #include <stdint.h>
 
 #include <avr/io.h>

atusb/fw3/board.c

@@ -0,0 +1,139 @@
+/*
+ * fw/board.c - Board-specific functions
+ *
+ * Written 2011 by Werner Almesberger
+ * Copyright 2011 Werner Almesberger
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ */
+
+
+#include <stdint.h>
+
+#include <avr/io.h>
+#include <avr/interrupt.h>
+
+#define F_CPU   8000000UL
+#include <util/delay.h>
+
+#include "at86rf230.h"
+#include "board.h"
+#include "spi.h"
+
+
+static void set_clkm(void)
+{
+	/* switch CLKM to 8 MHz */
+
+	/*
+	 * @@@ Note: Atmel advise against changing the external clock in
+	 * mid-flight. We should therefore switch to the RC clock first, then
+	 * crank up the external clock, and finally switch back to the external
+	 * clock. The clock switching procedure is described in the ATmega32U2
+	 * data sheet in secton 8.2.2.
+	 */
+
+	spi_begin();
+	spi_send(AT86RF230_REG_WRITE | REG_TRX_CTRL_0);
+	spi_send(CLKM_CTRL_8MHz);
+	spi_end();
+}
+
+
+void reset_rf(void)
+{
+	/* AT86RF231 data sheet, 12.4.13, reset pulse width: 625 ns (min) */
+
+	CLR(nRST_RF);
+	_delay_us(1);
+	SET(nRST_RF);
+
+	/* 12.4.14: SPI access latency after reset: 625 ns (min) */
+
+	_delay_us(1);
+
+	/* we must restore TRX_CTRL_0 after each reset (9.6.4) */
+
+	set_clkm();
+}
+
+
+uint8_t read_irq(void)
+{
+	return PIN(IRQ_RF);
+}
+
+
+void led(int on)
+{
+	if (on)
+		SET(LED);
+	else
+		CLR(LED);
+}
+
+
+void panic(void)
+{
+	cli();
+	while (1) {
+		SET(LED);
+		_delay_ms(100);
+		CLR(LED);
+		_delay_ms(100);
+	}
+}
+
+
+void board_init(void)
+{
+	/* We start with a 1 MHz/8 clock. Disable the prescaler. */
+
+	CLKPR = 1 << CLKPCE;
+	CLKPR = 0;
+
+	/* set up all the outputs; default port value is 0 */
+
+	OUT(LED);
+	OUT(nRST_RF);   /* resets the transceiver */
+	OUT(SLP_TR);
+}
+
+
+static void wr(uint8_t reg, uint8_t val)
+{
+	spi_begin();
+	spi_send(AT86RF230_REG_WRITE | reg);
+	spi_send(val);
+	spi_end();
+}
+
+
+void rf_init(void)
+{
+	wr(REG_TRX_STATE, TRX_CMD_TRX_OFF);
+	wr(REG_IRQ_MASK, 0xff);
+	_delay_us(50);
+}
+
+
+void rf_send(const char *s)
+{
+	const char *p;
+	int len = 0;
+
+	wr(REG_TRX_STATE, TRX_CMD_PLL_ON);
+	for (p = s; *p; p++)
+		len++;
+	spi_begin();
+	spi_send(AT86RF230_BUF_WRITE);
+	spi_send(len);
+	while (*s)
+		spi_send(*s++);
+	spi_end();
+	wr(REG_TRX_STATE, TRX_CMD_TX_START);
+	_delay_ms(10);
+}

atusb/fw3/board.h

@@ -1,3 +1,15 @@
+/*
+ * fw/board.h - Board-specific functions and definitions
+ *
+ * Written 2008-2010 by Werner Almesberger
+ * Copyright 2008-2010 Werner Almesberger
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ */
+
 #ifndef BOARD_H
 #define	BOARD_H
 
@@ -42,6 +54,7 @@
 #define	OUT(n)		OUT_1(n##_PORT, n##_BIT)
 #define	PIN(n)		PIN_1(n##_PORT, n##_BIT)
 
+
 void reset_rf(void);
 uint8_t read_irq(void);
 void led(int on);

atusb/fw3/descr.c

@@ -1,5 +1,5 @@
 /*
- * atspi/descr.c - USB descriptors
+ * fw/descr.c - USB descriptors
  *
  * Written 2008-2011 by Werner Almesberger
  * Copyright 2008-2011 Werner Almesberger

atusb/fw3/ep0.c

@@ -1,8 +1,8 @@
 /*
- * atspi/ep0.c - EP0 extension protocol
+ * fw/ep0.c - EP0 extension protocol
  *
- * Written 2008-2010 by Werner Almesberger
- * Copyright 2008-2010 Werner Almesberger
+ * Written 2008-2011 by Werner Almesberger
+ * Copyright 2008-2011 Werner Almesberger
  *
  * This program is free software; you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -19,10 +19,6 @@
 #define NULL 0
 #endif
 
-//#include "regs.h"
-//#include "uart.h"
-//#include "usb.h"
-
 #include "usb.h"
 
 #include "at86rf230.h"

atusb/fw3/spi.c

@@ -1,3 +1,16 @@
+/*
+ * fw/spi.c - ATmega8 family SPI I/O
+ *
+ * Written 2011 by Werner Almesberger
+ * Copyright 2011 Werner Almesberger
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ */
+
+
 #include <stdint.h>
 
 #include <avr/io.h>

atusb/fw3/spi.h

@@ -1,3 +1,15 @@
+/*
+ * fw/spi.h - ATmega8 family SPI I/O
+ *
+ * Written 2011 by Werner Almesberger
+ * Copyright 2011 Werner Almesberger
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ */
+
 #ifndef SPI_H
 #define	SPI_H
 

atusb/fw3/usb/atu2.c

@@ -1,5 +1,5 @@
 /*
- * u/atu2.c - Chip-specific driver for Atmel ATxxxU2 USB chips
+ * fw/usb/atu2.c - Chip-specific driver for Atmel ATxxxU2 USB chips
  *
  * Written 2008-2011 by Werner Almesberger
  * Copyright 2008-2011 Werner Almesberger

atusb/fw3/usb/usb.c

@@ -1,5 +1,5 @@
 /*
- * u/usb.c - USB hardware setup and standard device requests
+ * fw/usb/usb.c - USB hardware setup and standard device requests
  *
  * Written 2008-2011 by Werner Almesberger
  * Copyright 2008-2011 Werner Almesberger

atusb/fw3/usb/usb.h

@@ -1,5 +1,5 @@
 /*
- * common/usb.h - USB hardware setup and standard device requests
+ * fw/usb//usb.h - USB hardware setup and standard device requests
  *
  * Written 2008, 2009 by Werner Almesberger
  * Copyright 2008, 2009 Werner Almesberger

atusb/fw3/version.h

@@ -1,5 +1,5 @@
 /*
- * boot/version.h - Automatically generated version string
+ * fw/version.h - Automatically generated version string
  *
  * Written 2008, 2011 by Werner Almesberger
  * Copyright 2008, 2011 Werner Almesberger