Skip to content

Commit

Permalink
Fix #34: add KR920 support
Browse files Browse the repository at this point in the history
  • Loading branch information
terrillmoore committed Aug 14, 2019
1 parent 58c5b25 commit f378ad7
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 8 deletions.
18 changes: 10 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
This repository contains the source code and configuration files of the Arduino Core
for MCCI Catena IoT devices. It is based on the Arduino core
for Atmel's SAMD21 processor (used on the Arduino/Genuino Zero, MKR1000 and MKRZero boards),
as extended by Adafruit for their SAMD Boards such as the Feather M0, and further extended by MCCI to support its MCCI Catena® LoRaWAN® technology boards.
as extended by Adafruit for their SAMD Boards such as the Feather M0, and further extended by MCCI to support its MCCI Catena LoRaWAN® technology boards.

[![GitHub release](https://img.shields.io/github/release/mcci-catena/ArduinoCore-samd.svg)](https://github.com/mcci-catena/ArduinoCore-samd/releases/latest) [![GitHub commits](https://img.shields.io/github/commits-since/mcci-catena/ArduinoCore-samd/latest.svg)](https://github.com/mcci-catena/ArduinoCore-samd/compare/v2.0.0...master)

Expand Down Expand Up @@ -33,7 +33,7 @@ as extended by Adafruit for their SAMD Boards such as the Feather M0, and furthe

The easy approach is to install the package following the instructions given here:

[https://github.com/mcci-catena/arduino-boards/blob/master/README.md](https://github.com/mcci-catena/arduino-boards/blob/master/README.md)
[`https://github.com/mcci-catena/arduino-boards/blob/master/README.md`](https://github.com/mcci-catena/arduino-boards/blob/master/README.md)

However, if you need to development, it's more complicated. See the following section.

Expand All @@ -55,8 +55,8 @@ If you want to develop and test changes to this package, we suggest the followin
| Linux | <code>~/.arduino15</code> |

7. From this location, change directory to `packages/mcci/samd`.
8. Look at the direcory contents with `ls`. You'll see a directory named like a version number, for example `1.2.0`.
9. Move the directory you just found away from the `samd` directory. It's convenient to have it around, so we sugest not delete it.
8. Look at the directory contents with `ls`. You'll see a directory named like a version number, for example `1.2.0`.
9. Move the directory you just found away from the `samd` directory. It's convenient to have it around, so we suggest that you not delete it.
10. Create a symbolic link to the sandbox you created in step (3) above. On macOS and Linux, this is done using the `ln -s` command. On Windows 10, this is done with the `mklink /d` command. (On older versions of Windows, unless you're very experienced, you might want to use a Linux VM in VirtualBox -- we can't advise on the best way to do this.)

- On any system you can also simply move the old directory out of the way, and then move your sandbox in. The old directory cannot simply be renamed `packages/mcci/samd`, but it can be put (for example) in `packages/mcci/hide-samd-1.2.0` (or whatever version it was). After moving the old directory away, you can move the repo that you cloned in step 5, above, into the `packages/mcci/samd` directory using a suitable version number.
Expand All @@ -72,24 +72,26 @@ Remember to restart the IDE whenever you change `platform.txt`, `boards.txt` or

## Bugs or Issues

If you find a bug you can submit an issue here on github:
If you find a bug you can submit an issue here on GitHub:

[github.com/mcci-catena/ArduinoCore-samd/issues](https://github.com/mcci-catena/ArduinoCore-samd/issues)
[`github.com/mcci-catena/ArduinoCore-samd/issues`](https://github.com/mcci-catena/ArduinoCore-samd/issues)

Before posting a new issue, please check if the same problem has been already reported by someone else
to avoid duplicates.

## Release History

- HEAD adds support for the LoRaWAN Region KR-920 (issue [#34](https://github.com/mcci-catena/ArduinoCore-samd/issues/34)).

- [v2.0.0](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v2.0.0) makes a major version jump primarily to avoid reusing versions that are used by tags in the repo for Adafruit BSPs. It also adds `_mcci_arduino_version` (issue [#28](https://github.com/mcci-catena/ArduinoCore-samd/issues/28)).

- [v1.3.1](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v1.3.1) corrected the version in `platform.txt`, which was missed.

- [v1.3.0](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v1.3.0) increases the serial port ring-buffer size (issue [#26](https://github.com/mcci-catena/ArduinoCore-samd/issues/26))

- [v1.2.0](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v1.2.0) adds several features. It moves flags in the link script to accomodate the BME680 BSEC library. It adapts the JSON templating system from the [MCCI STM32 BSP](https://github.com/mcci-catena/Arduino_Core_STM32). The `millis()` routine was updated so that the clock value will advance even if interrupts are disabled (issue [#17](https://github.com/mcci-catena/ArduinoCore-samd/issues/16)). Properly define the country code for as923jp (issue [#13](https://github.com/mcci-catena/ArduinoCore-samd/issues/13)). Fix typo `au915` should have been `au921`(issue [#12](https://github.com/mcci-catena/ArduinoCore-samd/issues/12)).
- [v1.2.0](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v1.2.0) adds several features. It moves flags in the link script to accommodate the BME680 BSEC library. It adapts the JSON templating system from the [MCCI STM32 BSP](https://github.com/mcci-catena/Arduino_Core_STM32). The `millis()` routine was updated so that the clock value will advance even if interrupts are disabled (issue [#17](https://github.com/mcci-catena/ArduinoCore-samd/issues/16)). Properly define the country code for as923jp (issue [#13](https://github.com/mcci-catena/ArduinoCore-samd/issues/13)). Fix typo `au915` should have been `au921`(issue [#12](https://github.com/mcci-catena/ArduinoCore-samd/issues/12)).

- [v1.1.0](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v1.1.0) adds support for the MCCI Catena 4420 and 4470. It also adds the ability to select the target LoRaWAN region from the IDE Tools menu (assuming that you're using the [MCCI Catena arduino-lmic](https://github.com/mcci-catena/arduino-lmic) library). It also fixes the USB product ID numbers to match the official numbers assigned by MCCI release engineering (issue [#9](https://github.com/mcci-catena/ArduinoCore-samd/issues/9)).
- [v1.1.0](https://github.com/mcci-catena/ArduinoCore-samd/releases/tag/v1.1.0) adds support for the MCCI Catena 4420 and 4470. It also adds the ability to select the target LoRaWAN region from the IDE Tools menu (assuming that you're using the [MCCI Catena `arduino-lmic`](https://github.com/mcci-catena/arduino-lmic) library). It also fixes the USB product ID numbers to match the official numbers assigned by MCCI release engineering (issue [#9](https://github.com/mcci-catena/ArduinoCore-samd/issues/9)).

## License and credits

Expand Down
2 changes: 2 additions & 0 deletions boards.template
Original file line number Diff line number Diff line change
Expand Up @@ -96,13 +96,15 @@ menu.lorawan_region=LoRaWAN Region
{{board}}.menu.lorawan_region.au921=Australia 921 MHz
{{board}}.menu.lorawan_region.as923=Asia 923 MHz
{{board}}.menu.lorawan_region.as923jp=Japan 923 MHz
{{board}}.menu.lorawan_region.kr920=Korea 920 MHz
{{board}}.menu.lorawan_region.in866=India 866 MHz
{{board}}.menu.lorawan_region.projcfg=Use arduino-lmic/project_confic/lmic_project_lmic_config_preconditions.h
{{board}}.menu.lorawan_region.us915.build.lorawan_flags=-DCFG_us915=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.eu868.build.lorawan_flags=-DCFG_eu868=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.au921.build.lorawan_flags=-DCFG_au921=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.as923.build.lorawan_flags=-DCFG_as923=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.as923jp.build.lorawan_flags=-DCFG_as923=1 -DLMIC_COUNTRY_CODE=LMIC_COUNTRY_CODE_JP -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.kr920.build.lorawan_flags=-DCFG_kr920=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.in866.build.lorawan_flags=-DCFG_in866=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
{{board}}.menu.lorawan_region.projcfg.build.lorawan_flags=

Expand Down
10 changes: 10 additions & 0 deletions boards.txt
Original file line number Diff line number Diff line change
Expand Up @@ -66,13 +66,15 @@ mcci_catena_4410.menu.lorawan_region.eu868=Europe 868 MHz
mcci_catena_4410.menu.lorawan_region.au921=Australia 921 MHz
mcci_catena_4410.menu.lorawan_region.as923=Asia 923 MHz
mcci_catena_4410.menu.lorawan_region.as923jp=Japan 923 MHz
mcci_catena_4410.menu.lorawan_region.kr920=Korea 920 MHz
mcci_catena_4410.menu.lorawan_region.in866=India 866 MHz
mcci_catena_4410.menu.lorawan_region.projcfg=Use arduino-lmic/project_confic/lmic_project_lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.us915.build.lorawan_flags=-DCFG_us915=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.eu868.build.lorawan_flags=-DCFG_eu868=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.au921.build.lorawan_flags=-DCFG_au921=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.as923.build.lorawan_flags=-DCFG_as923=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.as923jp.build.lorawan_flags=-DCFG_as923=1 -DLMIC_COUNTRY_CODE=LMIC_COUNTRY_CODE_JP -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.kr920.build.lorawan_flags=-DCFG_kr920=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.in866.build.lorawan_flags=-DCFG_in866=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4410.menu.lorawan_region.projcfg.build.lorawan_flags=

Expand Down Expand Up @@ -113,13 +115,15 @@ mcci_catena_4420.menu.lorawan_region.eu868=Europe 868 MHz
mcci_catena_4420.menu.lorawan_region.au921=Australia 921 MHz
mcci_catena_4420.menu.lorawan_region.as923=Asia 923 MHz
mcci_catena_4420.menu.lorawan_region.as923jp=Japan 923 MHz
mcci_catena_4420.menu.lorawan_region.kr920=Korea 920 MHz
mcci_catena_4420.menu.lorawan_region.in866=India 866 MHz
mcci_catena_4420.menu.lorawan_region.projcfg=Use arduino-lmic/project_confic/lmic_project_lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.us915.build.lorawan_flags=-DCFG_us915=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.eu868.build.lorawan_flags=-DCFG_eu868=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.au921.build.lorawan_flags=-DCFG_au921=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.as923.build.lorawan_flags=-DCFG_as923=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.as923jp.build.lorawan_flags=-DCFG_as923=1 -DLMIC_COUNTRY_CODE=LMIC_COUNTRY_CODE_JP -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.kr920.build.lorawan_flags=-DCFG_kr920=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.in866.build.lorawan_flags=-DCFG_in866=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4420.menu.lorawan_region.projcfg.build.lorawan_flags=

Expand Down Expand Up @@ -160,13 +164,15 @@ mcci_catena_4450.menu.lorawan_region.eu868=Europe 868 MHz
mcci_catena_4450.menu.lorawan_region.au921=Australia 921 MHz
mcci_catena_4450.menu.lorawan_region.as923=Asia 923 MHz
mcci_catena_4450.menu.lorawan_region.as923jp=Japan 923 MHz
mcci_catena_4450.menu.lorawan_region.kr920=Korea 920 MHz
mcci_catena_4450.menu.lorawan_region.in866=India 866 MHz
mcci_catena_4450.menu.lorawan_region.projcfg=Use arduino-lmic/project_confic/lmic_project_lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.us915.build.lorawan_flags=-DCFG_us915=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.eu868.build.lorawan_flags=-DCFG_eu868=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.au921.build.lorawan_flags=-DCFG_au921=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.as923.build.lorawan_flags=-DCFG_as923=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.as923jp.build.lorawan_flags=-DCFG_as923=1 -DLMIC_COUNTRY_CODE=LMIC_COUNTRY_CODE_JP -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.kr920.build.lorawan_flags=-DCFG_kr920=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.in866.build.lorawan_flags=-DCFG_in866=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4450.menu.lorawan_region.projcfg.build.lorawan_flags=

Expand Down Expand Up @@ -207,13 +213,15 @@ mcci_catena_4460.menu.lorawan_region.eu868=Europe 868 MHz
mcci_catena_4460.menu.lorawan_region.au921=Australia 921 MHz
mcci_catena_4460.menu.lorawan_region.as923=Asia 923 MHz
mcci_catena_4460.menu.lorawan_region.as923jp=Japan 923 MHz
mcci_catena_4460.menu.lorawan_region.kr920=Korea 920 MHz
mcci_catena_4460.menu.lorawan_region.in866=India 866 MHz
mcci_catena_4460.menu.lorawan_region.projcfg=Use arduino-lmic/project_confic/lmic_project_lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.us915.build.lorawan_flags=-DCFG_us915=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.eu868.build.lorawan_flags=-DCFG_eu868=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.au921.build.lorawan_flags=-DCFG_au921=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.as923.build.lorawan_flags=-DCFG_as923=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.as923jp.build.lorawan_flags=-DCFG_as923=1 -DLMIC_COUNTRY_CODE=LMIC_COUNTRY_CODE_JP -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.kr920.build.lorawan_flags=-DCFG_kr920=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.in866.build.lorawan_flags=-DCFG_in866=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4460.menu.lorawan_region.projcfg.build.lorawan_flags=

Expand Down Expand Up @@ -254,13 +262,15 @@ mcci_catena_4470.menu.lorawan_region.eu868=Europe 868 MHz
mcci_catena_4470.menu.lorawan_region.au921=Australia 921 MHz
mcci_catena_4470.menu.lorawan_region.as923=Asia 923 MHz
mcci_catena_4470.menu.lorawan_region.as923jp=Japan 923 MHz
mcci_catena_4470.menu.lorawan_region.kr920=Korea 920 MHz
mcci_catena_4470.menu.lorawan_region.in866=India 866 MHz
mcci_catena_4470.menu.lorawan_region.projcfg=Use arduino-lmic/project_confic/lmic_project_lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.us915.build.lorawan_flags=-DCFG_us915=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.eu868.build.lorawan_flags=-DCFG_eu868=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.au921.build.lorawan_flags=-DCFG_au921=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.as923.build.lorawan_flags=-DCFG_as923=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.as923jp.build.lorawan_flags=-DCFG_as923=1 -DLMIC_COUNTRY_CODE=LMIC_COUNTRY_CODE_JP -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.kr920.build.lorawan_flags=-DCFG_kr920=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.in866.build.lorawan_flags=-DCFG_in866=1 -DCFG_sx1276_radio=1 -DARDUINO_LMIC_PROJECT_CONFIG_H=lmic_config_preconditions.h
mcci_catena_4470.menu.lorawan_region.projcfg.build.lorawan_flags=

Expand Down

0 comments on commit f378ad7

Please sign in to comment.