Crate machine_check_avr

source ·
Expand description

§AVR microcontroller machine-code verification using machine-check

The executable in this crate allows formal verification of machine-code programs for the AVR ATmega328P microcontroller via machine-check.

In addition to common machine-check executable arguments, the executable takes a pair of arguments specifying path to Intel HEX file containing the ATmega328P program code: --hex-file abc.hex.

See machine-check for details on verifying specifications.

Note that both machine-check and this crate are currently experimental and awaiting further improvement and stabilization.

§Known system problems

  • Some lesser-used instructions are unimplemented.
  • Only general-purpose I/O peripherals are supported.
  • The program counter is not always checked for overflow.

§Inherent panics

  • Jumps and calls outside program memory.
  • Execution of reserved or illegal opcodes.
  • Illegal or discouraged reads and writes.
  • Push, pop, call, return with values read or written outside data memory.
  • Unimplemented instructions, reads and writes.

§Used resources

The system is written using the official AVR instruction set manual and non-automotive ATmega328P datasheet.

§License

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Re-exports§

  • pub use util::read_hex_into_progmem;

Structs§