osd-contiki/platform/avr-rss2/README.md
2016-02-22 20:46:07 +01:00

5.3 KiB

Getting Started with Contiki using avr-rss2

This guide's aim is to help you start using Contiki for RSS2 boards The platform supports different AtMega-RF boards:

  • Based on MCU AtMega128RFR2
  • Based on MCU AtMega256RFR2
  • Based on MCU AtMega128RFA1

Boards looks the same. "Made in EU" labeled on the AtMega256RFR2 boards The platform and CPU code, are common for both boards, can be found under `$(CONTIKI)/platfrom/avr-rssa. The port was developed and tested with RSS2. This guide assumes that you have basic understanding of how to use the command line and perform basic admin tasks on UNIX family OSs. You should' also have understanding about the Contiki OS design as well have C programming skills.

Boards Features

  • Chip Antenna. Supercardiod.

  • Robust radio performance. Up to 300 meter line-of-sight.

  • Unique EUI64 address via chip combined with EEPROM

  • Onboard temp sensor DS18B20,

  • Light Sensor.

  • 32kHz RTC xtal

  • Comparator chip and input.

  • SW FET, (relay) for power on/off of sensors.

  • DC input via LDO up to 25V.

  • Standard. 6-pin TTL-USB header for FTDI cable for UART.

  • PCB formfactor for cheap project box G.40X IP54

  • Power/current: ** RX ~10mA (Full RPC AtMegaXXRFR2). ** Sleep ~45uA @ 16MHz XTAL ** Sleep ~15uA @ 8MHz using internal oscillator

  • Preprogammed bootloader.

  • CE certified by test institute.

UART

The board has one UART via the 6-pin TTL-USB adapter, The recommended baudrate is 38400 bps. This speed gives the lowest error with respect of the used clock frequency used internally. A possible hi-speed is 250000 bps wich gives 0% Error with 16MHz clock.

Port Features

The platform has the following key features:

  • Standard, E64 address from built-in chip.
  • First hooks for RPC (Reduced Power Consumption) for AtMegaXXXRFR2.

Toolchain needs

The Atmel toolcahin is available in most operating system. Note. The native OS packages does not yet support the new AtMega256RfR2 MCU.

We'll use toolchain from Atmels web-site. You might also consider Instant Contiki

  • For Linux. See http://www.atmel.com/tools/ATMELAVRTOOLCHAINFORLINUX.aspx Download the proper 8-bit platform 32 or 64 bit. Unpack unpack under /usr/local Also add to your search PATH. For example .bashrc add: export PATH=$PATH:/usr/local/avr8-gnu-toolchain-linux_x86/bin or export PATH=$PATH:/usr/local/avr8-gnu-toolchain-linux_x86_64/bin

For flash programming you'll need avrdude. For OS using apt-get apt-get install avrdude

  • For Windows. Goes here

Contiki build TARGET

make TARGET=avr-rss2

For AtMega128RFR2 boards: make TARGET=avr-rss2 MCU=atmega128rfr2

For AtMega128RFA1 boards: make TARGET=avr-rss2 MCU=atmega128rfa1

Flashing

Programming using avrdude using serial bootloader. (TTL-USB cable) Press the RESET button. The bootloader with wait for boot commands for 3 seconds.

Flashing commnad line example 256k MCU: avrdude -p m256rfr2 -c stk500v2 -P /dev/ttyUSB0 -b 38400 -e -U flash:w:hello-world.avr-rss2

Flashing commnad line example 128k MCU: avrdude -p m128rfa1 -c avr109 -P /dev/ttyUSB0 -b 38400 -e -U flash:w:hello-world.avr-rss2

Older boards may use the avr109 boot loader. The stk500v2 uses the yellow lED while the avr109 uses the red LED.

Tested applications and examples

hello-world ipv6/rpl-udp ipv6/simple-udp-rpl rime ipv6/multicast example-shell Needs symbol.c to be added to project also seems like in core/dev/serial-line.c process_poll must be replaced with process_post.

/* Wake up consumer process */

  • process_poll(&serial_line_process);
  • process_post(&serial_line_process, 0, 0);

examples/powertrace

Platform tutorial applications .----------------------------- Example to read out various sensors leds serial numbers etc. platform/avr-rss2/examples/hello-sensors/

This example shows the sensd data encoding. But UDP using 6lowpan. platform/avr-rss2/examles/ipv6/rpl-udp-report/

NAT ip64 ethernet GW based on Contiki core/net/ip64 code platform/avr-rss2/examples/ipv6/rpl-border-router/

Regressions tests

Travis compile regression for platform: regression-tests/23-compile-avr

Port adds newer version of avr-gcc compiler (4.9.2), to support testing of newwr Atmel MCU as Atmega256RFR2. Work by Atis Elsts

Board approvals

Summary:

  • R&TTE 73/23/EEC, 89/336/EEC and 99/5/EC
  • Safety: EN 60950-1:2006 + A12: 2011
  • RF: ETSI EN 300 328 V1.7.1 (2006-10)
  • EMC: ETSI EN 301 489-1 V1.9.2 (2011-09), ETSI EN 301 489-17 V2.2.1 (2012-09)
  • EMF: EN 62479:2010
  • Human exposure to electromagnetic fields: EN 62479:2010

Commercial availability

Through vendor and though resellers. Note board is will only available were CE approval is covered. This may be further restricted by WEEE. Contact vendor. For research legislation is more relaxed in most countries.

References

AtMega64/128/256/RFR2 chip documentation available via Atmel. Schematics and boards description. Available via Radio-Senors Smart Reduced Power Consumption Techniques. AT02594 available via Atmel.

ToDo

API for radio power saving settings introduced Atmels app note AT02594. Also function for the desensitizing RPC resister.

Vendor info

http://radio-sensors.com/

Maintainer

Robert Olsson robert@radio-sensors.com