Support Move38 boards

.github/workflows/examples.yml

@@ -12,6 +12,7 @@ jobs:
           - "examples/arduino-blink"
           - "examples/arduino-external-libs"
           - "examples/arduino-internal-libs"
+          - "examples/arduino-move38-colorwheel"
           - "examples/arduino-own-src_dir"
           - "examples/assembly-blink"
           - "examples/digitstump-mouse"

boards/move38_blink.json

@@ -0,0 +1,38 @@
+{
+  "build": {
+    "core": "blinklib",
+    "extra_flags": "-DARDUINO_AVR_BLINK_168",
+    "f_cpu": "8000000L",
+    "mcu": "atmega168pb",
+    "variant": "standard",
+    "ldscript": "avr5-atmega168pb.xn",
+    "builtinbase": "0x1700"
+  },
+  "bootloader": {
+    "file": "BlinkBIOS-168PB.hex",
+    "lfuse": "0x62",
+    "hfuse": "0xDF",
+    "efuse": "0xf8"
+  },
+  "debug": {
+    "simavr_target": "atmega168p"
+  },
+  "fuses" : {
+    "lfuse": "0x62",
+    "hfuse": "0xDF",
+    "efuse": "0xf8"
+  },
+  "frameworks": [
+    "arduino"
+  ],
+  "name": "Blink",
+  "upload": {
+    "maximum_ram_size": 1024,
+    "maximum_size": 5888,
+    "protocol": "usbtiny",
+    "require_upload_port": false,
+    "speed": 115200
+  },
+  "url": "https://move38.com/",
+  "vendor": "Move38"
+}

boards/move38_blink328.json

@@ -0,0 +1,38 @@
+{
+  "build": {
+    "core": "blinklib",
+    "extra_flags": "-DARDUINO_AVR_BLINK_328",
+    "f_cpu": "8000000L",
+    "mcu": "atmega328pb",
+    "variant": "standard",
+    "ldscript": "avr5-atmega328.xn",
+    "builtinbase": "0x3900"
+  },
+  "bootloader": {
+    "file": "BlinkBIOS-328PB.hex",
+    "lfuse": "0x62",
+    "hfuse": "0xD8",
+    "efuse": "0xff"
+  },
+  "debug": {
+    "simavr_target": "atmega328p"
+  },
+  "fuses" : {
+    "lfuse": "0x62",
+    "hfuse": "0xD8",
+    "efuse": "0xff"
+  },
+  "frameworks": [
+    "arduino"
+  ],
+  "name": "Blink328",
+  "upload": {
+    "maximum_ram_size": 1024,
+    "maximum_size": 5888,
+    "protocol": "usbtiny",
+    "require_upload_port": false,
+    "speed": 115200
+  },
+  "url": "https://move38.com/",
+  "vendor": "Move38"
+}

boards/move38_blinkmax.json

@@ -0,0 +1,38 @@
+{
+  "build": {
+    "core": "blinklib",
+    "extra_flags": "-DARDUINO_AVR_BLINK_328",
+    "f_cpu": "8000000L",
+    "mcu": "atmega328pb",
+    "variant": "standard",
+    "ldscript": "avr5-atmega328.xn",
+    "builtinbase": "0x3900"
+  },
+  "bootloader": {
+    "file": "BlinkBIOS-328PB-MAX.hex",
+    "lfuse": "0x62",
+    "hfuse": "0xD8",
+    "efuse": "0xff"
+  },
+  "debug": {
+    "simavr_target": "atmega328p"
+  },
+  "fuses" : {
+    "lfuse": "0x62",
+    "hfuse": "0xD8",
+    "efuse": "0xff"
+  },
+  "frameworks": [
+    "arduino"
+  ],
+  "name": "BlinkMAX",
+  "upload": {
+    "maximum_ram_size": 2048,
+    "maximum_size": 7936,
+    "protocol": "usbtiny",
+    "require_upload_port": false,
+    "speed": 115200
+  },
+  "url": "https://move38.com/",
+  "vendor": "Move38"
+}

boards/move38_blinknfc.json

@@ -0,0 +1,38 @@
+{
+  "build": {
+    "core": "blinklib",
+    "extra_flags": "-DARDUINO_AVR_BLINK_328",
+    "f_cpu": "8000000L",
+    "mcu": "atmega328pb",
+    "variant": "standard",
+    "ldscript": "avr5-atmega328.xn",
+    "builtinbase": "0x3900"
+  },
+  "bootloader": {
+    "file": "BlinkBIOS-328PB-MAX-NFC.hex",
+    "lfuse": "0x62",
+    "hfuse": "0xD8",
+    "efuse": "0xff"
+  },
+  "debug": {
+    "simavr_target": "atmega328p"
+  },
+  "fuses" : {
+    "lfuse": "0x62",
+    "hfuse": "0xD8",
+    "efuse": "0xff"
+  },
+  "frameworks": [
+    "arduino"
+  ],
+  "name": "BlinkNFC",
+  "upload": {
+    "maximum_ram_size": 2048,
+    "maximum_size": 7936,
+    "protocol": "usbtiny",
+    "require_upload_port": false,
+    "speed": 115200
+  },
+  "url": "https://move38.com/",
+  "vendor": "Move38"
+}

builder/frameworks/arduino.py

@@ -130,6 +130,20 @@ def get_bootloader_size():
         ],
     )
 
+#
+# Expand linker script to its full path
+# Add special linker options
+# Make bootloader file available as env variable
+# (needs to be flashed in one go)
+#
+if build_core in ("blinklib"):
+    ldscript = board.get("build.ldscript")
+    env.Replace(LDSCRIPT_PATH=join(FRAMEWORK_DIR, "linkscripts", ldscript))
+    env.Append(
+        LINKFLAGS=["-mrelax", "-nostartfiles"],
+        BOOTLOADER_FILE=join(FRAMEWORK_DIR, "bootloaders", board.get("bootloader.file"))
+    )
+
 #
 # Take into account bootloader size
 #

builder/main.py

@@ -107,6 +107,9 @@ def _rpi_sysgpio(path, value):
     PROGSUFFIX=".elf",
 )
 
+# Some Arduino cores need to relocate their firmware to a different address
+builtinbase = env.BoardConfig().get("build", {}).get("builtinbase", "")
+
 env.Append(
     BUILDERS=dict(
         ElfToEep=Builder(
@@ -133,7 +136,8 @@ def _rpi_sysgpio(path, value):
         ElfToHex=Builder(
             action=env.VerboseAction(
                 " ".join(
-                    ["$OBJCOPY", "-O", "ihex", "-R", ".eeprom", "$SOURCES", "$TARGET"]
+                    ["$OBJCOPY", "-O", "ihex", "-R", ".eeprom", "$SOURCES", "$TARGET"] if builtinbase == "" else \
+                    ["$OBJCOPY", "--change-addresses", builtinbase, "-O", "ihex", "-R", ".eeprom", "$SOURCES", "$TARGET"]
                 ),
                 "Building $TARGET",
             ),

examples/arduino-move38-colorwheel/.gitignore

@@ -0,0 +1,2 @@
+.pio
+.vscode

examples/arduino-move38-colorwheel/include/README

@@ -0,0 +1,39 @@
+
+This directory is intended for project header files.
+
+A header file is a file containing C declarations and macro definitions
+to be shared between several project source files. You request the use of a
+header file in your project source file (C, C++, etc) located in `src` folder
+by including it, with the C preprocessing directive `#include'.
+
+```src/main.c
+
+#include "header.h"
+
+int main (void)
+{
+ ...
+}
+```
+
+Including a header file produces the same results as copying the header file
+into each source file that needs it. Such copying would be time-consuming
+and error-prone. With a header file, the related declarations appear
+in only one place. If they need to be changed, they can be changed in one
+place, and programs that include the header file will automatically use the
+new version when next recompiled. The header file eliminates the labor of
+finding and changing all the copies as well as the risk that a failure to
+find one copy will result in inconsistencies within a program.
+
+In C, the usual convention is to give header files names that end with `.h'.
+It is most portable to use only letters, digits, dashes, and underscores in
+header file names, and at most one dot.
+
+Read more about using header files in official GCC documentation:
+
+* Include Syntax
+* Include Operation
+* Once-Only Headers
+* Computed Includes
+
+https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html

examples/arduino-move38-colorwheel/lib/README

@@ -0,0 +1,46 @@
+
+This directory is intended for project specific (private) libraries.
+PlatformIO will compile them to static libraries and link into executable file.
+
+The source code of each library should be placed in a an own separate directory
+("lib/your_library_name/[here are source files]").
+
+For example, see a structure of the following two libraries `Foo` and `Bar`:
+
+|--lib
+|  |
+|  |--Bar
+|  |  |--docs
+|  |  |--examples
+|  |  |--src
+|  |     |- Bar.c
+|  |     |- Bar.h
+|  |  |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html
+|  |
+|  |--Foo
+|  |  |- Foo.c
+|  |  |- Foo.h
+|  |
+|  |- README --> THIS FILE
+|
+|- platformio.ini
+|--src
+   |- main.c
+
+and a contents of `src/main.c`:
+```
+#include <Foo.h>
+#include <Bar.h>
+
+int main (void)
+{
+  ...
+}
+
+```
+
+PlatformIO Library Dependency Finder will find automatically dependent
+libraries scanning project source files.
+
+More information about PlatformIO Library Dependency Finder
+- https://docs.platformio.org/page/librarymanager/ldf.html

examples/arduino-move38-colorwheel/platformio.ini

@@ -0,0 +1,37 @@
+; PlatformIO Project Configuration File
+;
+;   Build options: build flags, source filter
+;   Upload options: custom upload port, speed and extra flags
+;   Library options: dependencies, extra library storages
+;   Advanced options: extra scripting
+;
+; Please visit documentation for the other options and examples
+; https://docs.platformio.org/page/projectconf.html
+
+[env]
+; global settings
+platform = atmelavr
+framework = arduino
+; use USBtinyISP as programmer
+; burn bootloader and firmware at the same time
+upload_protocol = custom
+upload_flags =
+    -C
+    ${platformio.packages_dir}/tool-avrdude/avrdude.conf
+    -p
+    $BOARD_MCU
+    -c
+    usbtiny
+upload_command = avrdude $UPLOAD_FLAGS -U flash:w:$SOURCE:i -Uflash:w:"$BOOTLOADER_FILE":i
+
+[env:move38_blink]
+board = move38_blink
+
+[env:move38_blink328]
+board = move38_blink328
+
+[env:move38_blinkmax]
+board = move38_blinkmax
+
+[env:move38_blinknfc]
+board = move38_blinknfc

examples/arduino-move38-colorwheel/src/main.cpp

@@ -0,0 +1,30 @@
+#include <Arduino.h>
+// Spin around in goovy HSB color space
+// HSB stands for Hue, Saturation, and Brightness
+// https://en.wikipedia.org/wiki/HSL_and_HSV
+
+void setup() {
+  // No setup needed for this simple example!  
+}
+
+byte hue=0;
+
+Timer nextStep;
+
+void loop() {
+
+  if (nextStep.isExpired()) {
+
+    // Spin the hue while keeping color saturation and brightness at max  
+    setColor( makeColorHSB( hue , 255 , 255 ) );
+
+    // Becuase we are using an 8-bit byte for the `hue` variable, 
+    // this will automatically roll over from 255 back down to 0  
+    // (255 is 11111111 in binary, and 11111111 + 00000001 = 00000000)
+    hue++;      
+
+    nextStep.set(10);     // Step to (slightly) different color 100 times per second - whole cycle will take 255 steps *10ms = ~2.5 seconds. 
+
+  }
+
+}

examples/arduino-move38-colorwheel/test/README

@@ -0,0 +1,11 @@
+
+This directory is intended for PlatformIO Test Runner and project tests.
+
+Unit Testing is a software testing method by which individual units of
+source code, sets of one or more MCU program modules together with associated
+control data, usage procedures, and operating procedures, are tested to
+determine whether they are fit for use. Unit testing finds problems early
+in the development cycle.
+
+More information about PlatformIO Unit Testing:
+- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html

platform.json

@@ -49,6 +49,11 @@
       "owner": "platformio",
       "version": "~2.0.3"
     },
+    "framework-arduino-avr-blinklib": {
+      "type": "framework",
+      "optional": true,
+      "version": "https://github.com/maxgerhardt/pio-blinks-core.git"
+    },
     "framework-arduino-avr-core13": {
       "type": "framework",
       "optional": true,