Fused is a full-system simulator for modelling energy-driven computers. To accurately model the interplay between energy-availability, power consumption, and execution; Fused models energy and execution in a closed feedback loop.

The power model is based on recording high-level events (memory accesses, peripheral operations etc.) and states (modules on/off, peripheral operation modes etc.), and computing the instantaneous power consumption at runtime. Simultaneously, external circuitry such as e.g. energy storage, power supply and power management is modelled. The power consumption, power supply, and energy-availability, is then used to calculate the supply voltage, which in turn is monitored by the modeled microcontroller. In this way, we can model an embedded system through power cycles.

Some key features of Fused include:

• Simulates power consumption and power supply in a closed feedback loop;
• Hosts a GDB server to interface with most software development environments;
• Enables debugging functionality across power cycles, and the ability to freeze and step through the dynamic power/energy state in lockstep with execution.
• Executes unmodified binaries to be deployed on real hardware;
• Allows modelling of complex external circuitry through SystemC-AMS.

Fused was presented at the 2020 ISPASS conference, the Fused presentation video is available on YouTube. Please cite the following paper when using Fused in your research.

"Fused: Closed-loop Performance and Energy Simulation of Embedded Systems",

Sivert T. Sliper, William Wang, Nikos Nikoleris, Alex S. Weddell, Geoff V. Merrett,

2020 International Symposium on Performance Analysis of Systems and Software (ISPASS),

Boston, MA, USA, 2020.

The paper is available at ePrints , and the supporting dataset at DOI 10.5258/SOTON/D1200.

We've set up two alternatives for building and using Fused. The easiest way to get started is to build and run Fused through Docker. Docker can slow down compilation and execution though, so if you need more performance, you can install Fused on your linux machine.

In either case, the first step is to clone the repository:

$> git clone https://github.com/UoS-EEC/fused.git
$> cd fused

Continue the installation by following the instructions for Using Docker or `On linux (tested on Ubuntu 18.04)`_ below.

First, make sure you have Docker Engine installed and running. Then launch an interactive session on the prebuilt docker image for Fused development as follows:

# in fused/
$> docker run -v ${PWD}:/opt/src -p 51000:51000 -it sivertism/fused-dev:latest /bin/bash

The first time you run this might take a while, as Docker downloads the prebuilt image.

Within this session, you can build and run Fused. To build Fused run the following commands:

#in docker session
$> mkdir build && cd build
$> cmake .. -GNinja
$> ninja

After this, the fused executable will have been built, as well as the target software workloads, which are found in fused/sw/build. Test the installation by running ninja test inside the build directory. Usage of Fused is described in Basic usage.

If you need to rebuild the docker image, e.g. to modify one of the dependencies or add some tools to the image, run the following command:

$> docker build -t local-fused-dev . --build-arg SSH_PRIVATE_KEY="$(cat ~/.ssh/id_rsa)"

First, install a few tools:

$> sudo apt install libboost-dev build-essential g++ ninja-build git gdb \
   libncurses5 libncursesw5 libtinfo5 libpython2.7

Then install a recent version of CMake (>= version 3.13):

$> wget https://github.com/Kitware/CMake/releases/download/v3.15.4/cmake-3.15.4-Linux-x86_64.sh
$> chmod a+x cmake*.sh
$> sudo ./cmake*.sh --skip-license --prefix=/usr/local

Now download, build & install Fused's dependencies and target toolchains, using CMake (this may take a while):

# in fused/
$> mkdir build && cd build
$> cmake .. -GNinja -DINSTALL_DEPENDENCIES=ON -DINSTALL_TARGET_TOOLCHAINS=ON
$> ninja

By default, this installs to ~/.local, but you can providea different install path with the EP_INSTALL_DIR variable, e.g. -DEP_INSTALL_DIR=${HOME}/fused-deps.

To build target software, we need to set a few environment variables, add these lines to your ~/.bashrc (or your shell's equivalent):

export ARM_GCC_ROOT=${HOME}/.local/arm-gcc
export MSP430_GCC_ROOT=${HOME}/.local/msp430-gcc
export MSP430_INC=${HOME}/.local/msp430-inc
export PATH="${HOME}/.local/msp430-gcc/bin:${PATH}"
export PATH="${HOME}/.local/arm-gcc/bin:${PATH}"

Now, to build Fused boards, disable INSTALL_DEPENDENCIES and rebuild:

# in fused/build
$> cmake .. -GNinja -DINSTALL_DEPENDENCIES=OFF
$> ninja

sw/ contains validation programs for Fused, along with a build system to compile them. These will already have been built when compiling Fused, but if you'd like to compile them separately, just cd into sw/, make a build folder and run CMake.

$> cd sw && mkdir build && cd build
$> cmake .. -GNinja -DTARGET_ARCH=msp430
$> ninja

Make sure to completely clear the build directory if you build for one target and then switch to another. Alternatively, you can run the script sw/buildall.sh to clean & build for all targets.

Note: You may need to create a directory for Fused's output files first, so for a default config.yaml, do mkdir /tmp/fused-outputs.

Launch a fused-prototype/board from the build folder, the basic command is:

$>./fused

This will launch Fused, with configurations read from build/config.yaml. The config.yaml settings can be overridden by command line arguments, so to e.g. specify a different board, you can run:

$>./fused --board Cm0SensorNode

To load a hex-formatted binary file (hex-file), and immediately start simulation, launch Fused with the -x option, followed by the path to the hex-file:

# in fused/build
$> ./Msp430TestBoard -x <path/to/program.hex>

Alternatively, set up config/config.yaml.in with GdbServer: False and ProgramHexFile: <path/to/program.hex>, then rerun CMake/rebuild to update build/config.yaml.

Fused will then run until one of the one of the exit conditions are hit (e.g. SimTimeLimit or when the target program stops simulation via SIMPLE_MONITOR).

Configure config/config.yaml.in to GdbServer: True, rebuild/rerun CMake, and launch fused without the -x option. Fused will then start a GDB server and halt execution while waiting for a client connection.

To connect to the server, start your GDB client, and connect to the Fused GDB server, e.g. as follows:

$> msp430-elf-gdb <path/to/program.hex>
(gdb) tui enable
(gdb) target remote :51000
(gdb) load
(gdb) break main
(gdb) continue

See LICENSE

Contributions are accepted under the Apache 2.0 license. Only submit contributions where you have authored all of the code.