macchina / arduino-boards-sam Goto Github PK

View Code? Open in Web Editor NEW

6.0 4.0 6.0 631 KB

Arduino IDE support for the M2 and other SAM-based boards.

License: GNU Lesser General Public License v2.1

C 22.60% C++ 50.32% Makefile 21.61% GDB 2.18% JavaScript 3.29%

arduino-boards-sam's Introduction

Macchina SAM Boards for Arduino IDE

Note that this is a work-in-progress, so please report any issues.

Installation

Under "Preferences", in the "additional Boards Manager URLs" field, paste:

https://macchina.cc/package_macchina_index.json

and hit "OK"

Then select "Board Manager" under Tools -> Boards, and install the following:

Arduino SAM Boards (32-bit ARM Cortex-M3) by Arduino
Macchina SAM Boards by Macchina

You should now have a "Macchina SAM Boards" category under the Tools -> Boards menu in the Arduino IDE.

Manual installation instructions (not using the Board Manager) can be found in CONTRIBUTING.md.

Contributing

Contributions welcome! For information on how to install this via git clone for easier hacking, please see CONTRIBUTING.md.

Pin Names

See: variant.h or Pin Mapping in the Macchina Documentation.

Acknowledgments

A big thank you to @TDoust for initially putting together these files. The result is a much cleaner, easy to set up, and less confusing development experience.

References

The Arduino IDE 3rd-party Hardware Specification provides the guidelines on how the content is structured and what can be included.

The Arduino IDE package_index.json format specification contains the details for integrating with the Arduino Board Manager. You may also be interested in arduino-boards-index which generates our index file.

arduino-boards-sam's People

Contributors

Stargazers

Watchers

Forkers

adamvoss tdoust saiuz pdp7 limon93 vegadome

arduino-boards-sam's Issues

Unused Library?

The SAM does NOT have an MCP2515
But if you look in https://github.com/macchina/arduino-boards-sam/tree/master/sam/libraries
...you will notice the inclusion of the MCP2515 library
I guess this was relevant for the original ATMega2560 based Macchina, and was accidentally carried over when the new SAM/M2 devkit was created.

Should this dependency be completely removed from the SAM/Macchina2 dev kit?

Which libraries should be included with the board configuration?

Referencing the Macchina Community Showcase's list of libraries, which should be included with the board configuration so users do not need to download them separately?

/cc @rocketjosh

What is required to upstream/mainline this work?

@morganrallen wrote:
We can eventually have Macchina as a variant in that repo, making this obsolete.

Mainlining seems like a worthwhile goal. The hope is that information on what is required before that can happen will be added here.

@morganrallen Do have any information or advice you can give?

Motivational SamNonDuePin example does not work against M2 configuration

Using the first motivation example from the README the code behaves as expected when uploading using the "Arduino Due (Native USB Port)" configuration. However, when I upload using "Macchina M2 (Beta)", only the Yellow LED will turn on.

I used SerialUSB.println and it appears the likely culprits X0, X1, and PIN_EMAC_ERX1 are the same either way so likely not the cause.

Should LED_BUILTIN be one of the RGB LEDs?

Since the RGB LED (DS7) is on the end, it is most likely to be visible when plugged into the OB2 port possibly making it a little more convenient in some use cases.

@TDoust Is there any significance to the choice of the red LED (DS2) for the LED_BUILTIN constant?

Where did all these files come from?

Where did the files in this repository come from?

This is important on two fronts:

whether there is any attribution we need to provide.
consideration when specifying a license for this repository. (Ex. was was anything GPL licensed)

Are the RGB LED pins different on the Beta board?

On my board they are 19 (blue), 20 (red), 21 (green); which does not match the numbers used here.

Serial definitions do not look correct

I went to create a PR adding a #define Serial SerialUSB to better M2 compatibility with Due sketches. In the process I noticed that Serial configuration looks to be unmodified from the Due version and would thus be incorrect because the M2 does not have all the same serial interfaces.