v3_firmware/README.md

# ATTNode v3 Firmware (WiP)

## Disclaimer

THIS IS STILL WORK IN PROGRESS!

## Documentation

**The full documentation for firmware options, payload decoders and programming can be found at [attno.de](https://www.attno.de/21-firmware-v3)**

## Configuration and Programming

This is the Work in Progress Repository for ATTNode v3 compatible firmware. At the moment it supports LoRa communication using OTAA and a BME280 or SHT21 sensor, as well as deep sleep between measurements.

As there is no PlatformIO Support for the ATTiny3216 yet, it is (for now) developed using Arduino IDE and the [MegaTinyCore](https://github.com/SpenceKonde/megaTinyCore). You also need to set the correct Settings for programming the ATTiny3216 in ArduionIDE. Here is a screenshot of the settings I use:

![ArduinoIDE Settings](ide_settings.png)

You also need to install the MCCI Arduino LMIC Library form the IDEs Library Manager or from https://github.com/mcci-catena/arduino-lmic

Before Compiling and Flashing make sure to copy config.h.example to config.h and set your LoRa OTAA Keys there. You can also set the Sending Interval and used Sensors there.

Programming is done using a [MicroUPDI Programmer](https://github.com/MCUdude/microUPDI) - for other pogramming variants see the MegaTinyCore documentation.

## Configuring via Downlink

It is possible to change the sending interval via Downlink-Packets at runtime. The time between Transmits is specified in minutes (or more exactly, 64 Second intervals) and has to be sent as a 2 byte value, which will be interpreted as an uint. so for example 0x0001 means 1 Minute, 0x0002 means 2 Minutes and so on. Sending 0xFFFF resets the value to the compiled in default.

## Acknowledgements

Parts of this code where kindly provided by [@shempe](https://twitter.com/shempe)
Initial Checkin 2020-11-26 15:56:36 +00:00			`# ATTNode v3 Firmware (WiP)`

Use LMIC and OTAA, Implement BME280 support 2020-12-01 20:04:27 +00:00			`## Disclaimer`
Initial Checkin 2020-11-26 15:56:36 +00:00
Use LMIC and OTAA, Implement BME280 support 2020-12-01 20:04:27 +00:00			`THIS IS STILL WORK IN PROGRESS!`
Initial Checkin 2020-11-26 15:56:36 +00:00
Add Link to Firmware Documentation 2020-12-28 18:08:02 +00:00			`## Documentation`

			`The full documentation for firmware options, payload decoders and programming can be found at [attno.de](https://www.attno.de/21-firmware-v3)`

Use LMIC and OTAA, Implement BME280 support 2020-12-01 20:04:27 +00:00			`## Configuration and Programming`
Initial Checkin 2020-11-26 15:56:36 +00:00
Add SHT21 Support 2020-12-04 17:24:13 +00:00			`This is the Work in Progress Repository for ATTNode v3 compatible firmware. At the moment it supports LoRa communication using OTAA and a BME280 or SHT21 sensor, as well as deep sleep between measurements.`
Use LMIC and OTAA, Implement BME280 support 2020-12-01 20:04:27 +00:00
			`As there is no PlatformIO Support for the ATTiny3216 yet, it is (for now) developed using Arduino IDE and the [MegaTinyCore](https://github.com/SpenceKonde/megaTinyCore). You also need to set the correct Settings for programming the ATTiny3216 in ArduionIDE. Here is a screenshot of the settings I use:`

			`![ArduinoIDE Settings](ide_settings.png)`

			`You also need to install the MCCI Arduino LMIC Library form the IDEs Library Manager or from https://github.com/mcci-catena/arduino-lmic`

			`Before Compiling and Flashing make sure to copy config.h.example to config.h and set your LoRa OTAA Keys there. You can also set the Sending Interval and used Sensors there.`

			`Programming is done using a [MicroUPDI Programmer](https://github.com/MCUdude/microUPDI) - for other pogramming variants see the MegaTinyCore documentation.`

Add Serial Debug Functions, Configuring Interval via Downlink 2020-12-20 10:48:23 +00:00			`## Configuring via Downlink`

			`It is possible to change the sending interval via Downlink-Packets at runtime. The time between Transmits is specified in minutes (or more exactly, 64 Second intervals) and has to be sent as a 2 byte value, which will be interpreted as an uint. so for example 0x0001 means 1 Minute, 0x0002 means 2 Minutes and so on. Sending 0xFFFF resets the value to the compiled in default.`

Use LMIC and OTAA, Implement BME280 support 2020-12-01 20:04:27 +00:00			`## Acknowledgements`

			`Parts of this code where kindly provided by [@shempe](https://twitter.com/shempe)`