# big-button

Just some interesting embedded Rust tutorial series I found floating around
the internet that I wanted to try.

Run me with `cargo run --release`

# Generated by Cargo - will have compiled files and executables
debug/
target/
vendor/

# Removing Cargo.lock from gitignore if creating an executable, leave it for libraries
# More information here https://doc.rust-lang.org/cargo/guide/cargo-toml-vs-cargo-lock.html
Cargo.lock

# These are backup files generated by rustfmt
**/*.rs.bk

# MSVC Windows builds of rustc generate these, which store debugging information
*.pdb

# General Items
.DS_Store
Thumbs.db
*.log
*.tmp
*.swp
*.env
*.bak

# IDE Specific Configurations
.idea/
.vscode/
*.sublime-project
*.sublime-workspace
.project
Session.vim
.Session.vim

# Secrets files
**/*secrets.*

[toolchain]

# Specifies using the nightly version of Rust, which has the latest experimental features
channel = "nightly"

# Lists the Rust components to include in the toolchain
components = ["rust-src", "rust-std", "rustc-dev", "cargo", "rustfmt", "clippy"]

# Defines the cross-compilation target for bare-metal ARM Cortex-M0 devices
# Format: <ARCHITECTURE>-<PLATFORM_VENDOR>-<OPERATING_SYSTEM>-<APP_BINARY_INTERFACE>
targets = ["thumbv6m-none-eabi"]

# Reference: https://doc.rust-lang.org/cargo/reference/config.html

##############################################################################
# Build and Compiler Settings
# Reference: https://doc.rust-lang.org/cargo/reference/config.html#build
[build]
4 collapsed lines
target = "thumbv6m-none-eabi" # Chip: Cortex-M0 and Cortex-M0+ (RP2040)
rustc = "rustc"               # Rust Compiler
rustdoc = "rustdoc"           # Rust Documentation Generator
jobs = 1                      # Number of parallel jobs to run

##############################################################################
# Run Specification for Spcific Target Platform
# Reference: https://doc.rust-lang.org/cargo/reference/config.html#target
[target.thumbv6m-none-eabi]
14 collapsed lines
runner = [
  "probe-rs",
  "run",
  "--chip=RP2040",
  "--log-format",
  "{[{L}]%dimmed%bold} {{f:dimmed}:{l:dimmed}%30}: {s}",
]
# Custom flags for compiler for this target
rustflags = [
  "-C",
  "link-args=-Tlink.x -Tlink-rp.x -Tdefmt.x",
  "-C",
  "no-vectorize-loops",
]

##############################################################################
# Environmental Variables
# Reference: https://doc.rust-lang.org/cargo/reference/config.html#env
[env]
2 collapsed lines
# Logger Formatting: https://defmt.ferrous-systems.com/custom-log-output
DEFMT_LOG = { value = "debug", force = true }

########################################################################################
# This Project/Package Metadata
# Reference: https://doc.rust-lang.org/cargo/reference/manifest.html
[package]
6 collapsed lines
authors = ["Your Own Name"] # HEY YOU! UPDATE ME!
edition = "2021"            # Reference: https://doc.rust-lang.org/edition-guide/rust-2021/index.html
license = "MIT"
name = "big-button"
version = "0.1.0"           # This project version
readme = "README.md"

########################################################################################
# Rust program dependencies
# Reference: https://doc.rust-lang.org/cargo/guide/dependencies.html
[dependencies]
31 collapsed lines
cortex-m = "0.7"    # Core support for ARM Cortex-M microcontrollers
cortex-m-rt = "0.7" # Startup code and minimal runtime for Cortex-M
panic-halt = "1.0"  # Basic panic handler that halts on panic
defmt = "0.3"       # Deferred formatting for embedded logging
defmt-rtt = "0.4"   # RTT (Real-Time Transfer) transport for defmt

# Debug probe panic handler with defmt support
panic-probe = { version = "0.3", features = ["print-defmt"] }

# Embassy Rust embedded framework dependencies
embassy-executor = { git = "https://github.com/embassy-rs/embassy.git", branch = "main", features = [
  "arch-cortex-m",
  "executor-thread",
  "executor-interrupt",
  "defmt",
  "task-arena-size-98304",
] }
embassy-rp = { git = "https://github.com/embassy-rs/embassy.git", branch = "main", features = [
  "defmt",
  "unstable-pac",
  "time-driver",
  "critical-section-impl",
  "rp2040",
] }
embassy-time = { git = "https://github.com/embassy-rs/embassy.git", branch = "main", features = [
  "defmt",
  "defmt-timestamp-uptime",
] }
embassy-sync = { git = "https://github.com/embassy-rs/embassy.git", branch = "main", features = [
  "defmt",
] }

########################################################################################
# Compiler profile for when running cargo run --release
# Reference: https://doc.rust-lang.org/cargo/reference/profiles.html
[profile.release]
9 collapsed lines
codegen-units = 1        # Number of codegen units - 1
debug = 2                # Debug info included in compiled binary - 0: none, 1: line numbers, 2: full
debug-assertions = false # Debug assertion - disabled
incremental = false      # Incremental compilation - disabled
lto = 'fat'              # Link-time optimization - fat: Perform optimization across all crates
opt-level = "s"          # Optimize compile - s: optimize for binary size
overflow-checks = true   # Integer overflow checks - disabled
panic = "abort"          # Panic strategy - abort: terminate process upon panic
rpath = false            # Relative path - disabled

/* memory.x - Tell linker how much memory is available and where it is */
/* Note that these values are specific to our microcontroller */
/* Source: https://github.com/embassy-rs/embassy/blob/main/examples/rp/memory.x */

MEMORY {
    BOOT2 : ORIGIN = 0x10000000, LENGTH = 0x100
    FLASH : ORIGIN = 0x10000100, LENGTH = 2048K - 0x100
    RAM   : ORIGIN = 0x20000000, LENGTH = 264K
}

//! This build script runs during code compilation
//! Runs on host computer, where `std` Rust tools are available here

use std::env;
use std::fs::File;
use std::io::Write;
use std::path::PathBuf;

fn main() {
    // Put `memory.x` in our output directory and ensure it's on the linker search path.
    let out = &PathBuf::from(env::var_os("OUT_DIR").unwrap());
    File::create(out.join("memory.x"))
        .unwrap()
        .write_all(include_bytes!("memory.x"))
        .unwrap();
    println!("cargo:rustc-link-search={}", out.display());

    // Re-run on any changes `memory.x` and `build.rs`
    println!("cargo:rerun-if-changed=build.rs");
    println!("cargo:rerun-if-changed=memory.x");
}

#![no_std]
#![no_main]
#![allow(unused_variables)] // for development
#![allow(unused_imports)] // for development

use defmt::*;
use defmt_rtt as _;
use panic_probe as _;

use embassy_executor::Spawner;
use embassy_rp::config::Config;
use embassy_rp::gpio;
use embassy_time::Timer;

#[embassy_executor::main]
async fn main(spawner: Spawner) {
    // Initialize system with proper clock configuration
    let config = Config::default();
    let _peripherals = embassy_rp::init(config);

    // Start an infinite loop
    loop {
        info!("Hello World!");
        Timer::after_secs(1).await;

        info!("Goodbye World!");
        Timer::after_secs(1).await;
    }
}