[BAZEL] added flash rules (#1)

* [BAZEL] added flash rules

* [GITHUB] run workflows on main

Author: hexdae

.github/workflows/linux.yml

@@ -2,9 +2,9 @@ name: Linux
 
 on:
   push:
-    branches: [ master ]
+    branches: [ main ]
   pull_request:
-    branches: [ master ]
+    branches: [ main ]
 
 jobs:
 

.github/workflows/mac.yml

@@ -2,9 +2,9 @@ name: macOS
 
 on:
   push:
-    branches: [ master ]
+    branches: [ main ]
   pull_request:
-    branches: [ master ]
+    branches: [ main ]
 
 jobs:
 

.github/workflows/windows.yml

@@ -2,9 +2,9 @@ name: Windows
 
 on:
   push:
-    branches: [ master ]
+    branches: [ main ]
   pull_request:
-    branches: [ master ]
+    branches: [ main ]
 
 jobs:
 

README.md

@@ -66,4 +66,28 @@ You can use cargo flash to load binaries or elf files to any target that uses a
 
 You can invoke the tool directly from the command line with `bazel run @rust_embedded//:cargo-flash -- --chip CHIP --elf ELF` or use the target in your bazel rules.
 
+You can also use the built in rules, as the following example shows
+
+'''python
+# package/BUILD
+
+load("@rust_embedded//:rules.bzl", "cargo_flash")
+
+cargo_flash(
+    name = "flash",
+    file = "<your/bazel/elf>",
+    chip = "STM32F103C8",
+)
+
+cargo_flash(
+    name = "flash_bin",
+    file = "<your/bazel/elf>",
+    chip = "STM32F103C8",
+    bin = True,
+)
+
+'''
+
+Then `bazel run //package:flash` will load the file to the rarget
+
 

rules.bzl

@@ -0,0 +1,30 @@
+""" Rules """
+
+
+def cargo_flash(name, file, chip, bin=False):
+    """Use cargo-flash to load an elf file onto a chip
+
+        To find the supported chip targets use the following command
+        bazel run @rust_embedded//:cargo-flash -- --list-chips
+
+    Args:
+        name: the target name as a string
+        file: the label to the elf file
+        chip: string, the target chip
+        bin: set to True the file is a binary, False by default
+    """
+
+    file_type = "bin" if bin else "elf"
+    tool = "@rust_embedded//:cargo-flash"
+    cmd = """
+        echo "$(locations {}) --chip {} --{} $(location {})" > $@
+    """.format(tool, chip, file_type, file)
+
+    native.genrule(
+        name = name,
+        srcs = [file],
+        outs = [name + ".sh"],
+        executable = True,
+        tools = [tool],
+        cmd = cmd,
+    )