
renode v1.17.0
Framework de simulação de código aberto para desenvolver, testar e depurar software não modificado para sistemas embarcados e IoT multinó, suportando ARM, RISC-V, x86 e mais.
Renode
Copyright (c) 2010-2026 Antmicro
O que é o Renode?
O Renode foi criado pela Antmicro como uma ferramenta de desenvolvimento virtual para redes embarcadas multi-nó (com e sem fio) e tem como objetivo possibilitar um fluxo de trabalho escalável para a criação de sistemas IoT eficazes, testados e seguros.
Com o Renode, desenvolver, testar, depurar e simular software não modificado para dispositivos IoT é rápido, econômico e confiável.
As arquiteturas suportadas incluem:
- ARMv7 e ARMv8 Cortex-A, Cortex-R e Cortex-M
- x86 e x86_64
- RISC-V
- SPARC
- POWER
- Xtensa
- MSP430X
Por que usar o Renode?
O Renode foi criado com base em muitos anos de experiência no desenvolvimento de software para sistemas embarcados - tanto para gateways, computadores de bordo, quanto para nós de sensores e microcontroladores.
Testar e desenvolver sistemas embarcados físicos é difícil devido à baixa reprodutibilidade e à falta de visibilidade sobre o estado atual de um sistema, especialmente em cenários multi-nó.
O Renode resolve esse problema permitindo que você execute binários não modificados, idênticos aos que você normalmente gravaria no hardware de destino, em uma placa virtual ou em um sistema de placas.
Um aspecto importante da ferramenta é que ela simula não apenas CPUs, mas SoCs inteiros (por exemplo, SoCs multicore heterogêneos e diversos periféricos), bem como as conexões com e sem fio entre eles, permitindo que os usuários abordem cenários complexos e testem software de produção real.
Instalação
Builds e releases disponíveis
Builds noturnos
Builds noturnos do Renode para todos os sistemas estão disponíveis em builds.renode.io.
As builds mais recentes estão sempre disponíveis como pacotes renode-latest.*.
Os seguintes formatos de pacote estão disponíveis:
renode-latest.linux-portable.tar.gz- pacote Linux portátil, inclui o runtime dotnetrenode-latest.linux.tar.gz- arquivo pré-compilado para Linux, requer dotnet instalado no hostrenode-latest.pkg.tar.xz- pacote Arch Linuxrenode-latest.x86_64.rpm- pacote Red Hat / Fedorarenode-latest.deb- pacote para distribuições baseadas em Debianrenode-latest.osx-arm64-portable.dmg- pacote macOS para Macs Apple Silicon (arm64)renode-latest.windows-portable.zip- pacote portátil para Windows, sem instaladorrenode-latest.setup.exe- instalador para Windowsrenode-latest.tar.xz- código-fonte do Renode
Releases estáveis
Releases estáveis e numeradas, juntamente com suas notas de versão, estão disponíveis na seção Releases no GitHub.
Instalação a partir do homebrew tap
No macOS, tanto as versões estáveis quanto as noturnas do Renode podem ser instaladas com o Homebrew a partir do nosso tap personalizado.
Para instalar a versão estável, use brew install renode/tap/renode, ou brew install renode/tap/renode-nightly para a build noturna mais recente.
Isso instalará todas as dependências, incluindo a pré-configuração do ambiente python para o renode-test
Usando a versão portátil para Linux
Se você é usuário de Linux, a maneira mais fácil de usar o Renode é baixar o linux-portable mais recente da seção de releases e descompactá-lo usando:
mkdir renode_portable
wget https://builds.renode.io/renode-latest.linux-portable.tar.gz
tar xf renode-latest.linux-portable.tar.gz -C renode_portable --strip-components=1
Para usá-lo a partir de qualquer local, entre no diretório criado e adicione-o ao caminho do sistema:
cd renode_portable
export PATH="`pwd`:$PATH"
Observe que o pacote portátil requer GTK2 disponível no host para ser executado com a interface gráfica habilitada.
Siga a seção Pré-requisitos adicionais se desejar usar o Robot Framework para testes. Caso contrário, prossiga para a seção 'Executando o Renode'.
Instalando dependências
dotnet
O Renode requer dotnet >= 10.0.
Para instalar o dotnet, siga o guia oficial de instalação.
Outras dependências (somente Linux)
No Ubuntu 20.04, você pode instalar as dependências restantes com o seguinte comando:
sudo apt-get install policykit-1 libgtk2.0-0 screen uml-utilities gtk-sharp2 libc6-dev libicu-dev gcc python3 python3-pip
Se estiver a utilizar uma distribuição diferente, terá de instalar uma lista análoga de pacotes utilizando o seu gestor de pacotes; note que os nomes dos pacotes podem diferir ligeiramente.
Instalar a partir de pacotes
Vá à secção de releases deste repositório e descarregue o pacote adequado para o seu sistema.
Linux
Instale o Renode com o seu gestor de pacotes preferido utilizando os pacotes *.deb, *.rpm ou *.pkg.tar.xz fornecidos.
macOS
Utilize o *.dmg fornecido normalmente.
Adicionalmente, para utilizar o Renode a partir da linha de comandos no macOS, crie os aliases adequados adicionando alias renode='/Applications/Renode.app/Contents/MacOS/renode' e alias renode-test='/Applications/Renode.app/Contents/MacOS/renode-test' ao seu ficheiro .bashrc ou .zshrc, dependendo da shell que estiver a utilizar.
Windows
Instale o Renode a partir do ficheiro *.msi fornecido. O instalador permitir-lhe-á adicionar ícones ao seu Ambiente de Trabalho e/ou ao Menu Iniciar e uma entrada ao seu PATH.
Pré-requisitos adicionais
Testes com Robot Framework
Para escrever e executar casos de teste, o Renode integra-se com a framework de testes Robot.
Isto requer que instale o Python 3 (no Windows, também precisará do Cygwin - consulte as instruções de instalação avançada) com pip (note que o pacote relevante pode chamar-se python-pip ou python3-pip no Linux).
Depois de ter o Python 3 e o pip, instale os módulos adicionais:
python3 -m pip install -r tests/requirements.txt
Outras ferramentas
Além disso, cada uma das ferramentas no subdiretório /tools pode conter um arquivo requirements.txt separado dos requisitos do Renode.
Instale-as em seu ambiente virtual com pip install -r requirements.txt.
Compilando a partir do código-fonte
Para obter informações sobre como compilar o Renode a partir do código-fonte, consulte a documentação.
Executando o Renode
Após seguir as instruções acima sobre a instalação a partir de um pacote, você deverá ter o comando renode disponível em todo o sistema:
renode [flags] [file]
Se você o compilou a partir do código-fonte, navegue até o diretório relevante e use:
./renode [flags] [file]
O argumento opcional [file] permite fornecer o caminho para um script a ser executado na inicialização.
O script permite vários sinalizadores opcionais, dos quais os mais úteis são apresentados abaixo: