Hello friends, I hope you all are doing great. Today, I am going to share the Arduino Portenta H7 Library for Proteus, so you can run a Wi-Fi simulation of Arduino's professional board. The Portenta H7 carries the STM32H747, a dual-core microcontroller with a Cortex-M7 at 480 MHz and a Cortex-M4 at 240 MHz, and a Murata module for Wi-Fi and Bluetooth, on a board the size of an MKR. With this library it runs your Arduino sketch in Proteus 8.5, joins a Wi-Fi network, serves web pages to a phone, and its RGB LED shows what is going on.
Arduino Portenta H7 Library for Proteus
Latest version: V1.0 (November 2026, this tutorial)
Other new Arduino boards: UNO R4 WiFi · Nano ESP32 · UNO WiFi Rev2 · Nano 33 IoT · UNO Q · UNO R4 Minima · Nano Every · MKR WiFi 1010 · Nano RP2040 Connect · STM32 Black Pill · Nucleo-F401RE · STM32 Blue Pill · Teensy 4.1 · Arduino Due · Arduino Leonardo · Arduino Micro · BBC micro:bit V2 · GIGA R1 WiFi · MKR WAN 1310 · Nano 33 BLE Sense · XIAO nRF52840 Sense · RAK4631 WisBlock · Nano Matter · nRF52840 DK · nRF5340 DK · nRF9151 DK · nRF7002 DK · Nordic Thingy:53 · xG24 Dev Kit · xG24 Explorer Kit · Thunderboard BG22 · SiWx917 Dev Kit · B-L475E-IOT01A · NUCLEO-WB55RG · NUCLEO-WL55JC1 · NUCLEO-H743ZI2 · SAM R21 Xplained Pro · FRDM-MCXN947
RF modules: nRF24L01 · nRF24L01 PA LNA · CC1101 · RFM69HCW · HC-12 · 433MHz RF · XBee
Temperature and weather sensors: DHT11 / DHT22 · DS18B20 · BME280 · BMP280 · SHT31 · AHT20 · BME680 · MLX90614 · MAX6675
Helping Tools
- Laptop WiFi Monitor: a laptop on the Wi-Fi of your design: a browser, a TCP / UDP terminal and ping
- Mobile WiFi Monitor: a smartphone that opens the pages of your board and sends it commands
- Serial Monitor Advance: a serial terminal window for the UART of your board
For the demo we built a Wi-Fi greenhouse fan. A BME280 measures the air, a relay runs the fan when it gets hot, and a web page on the board lets you watch the greenhouse from a phone and force the fan on or off.
NOTICE: Proteus has no STM32H747 model, so our team has put a lot of effort into building this board ourselves: the pins, the RGB LED, Wi-Fi and Bluetooth LE are all our own model, and your sketch compiles with our free TEP Boards for Proteus add-on. Your feedback is the fuel that keeps us going, so please tell us what you think in the comments below. And if our free libraries help you, you can buy us a coffee. So, let's get started with the Arduino Portenta H7 Library for Proteus:
What is the Portenta H7?
The Portenta H7 is the first board of Arduino's Pro range. It follows the MKR form factor, with two rows of 14 pins along the long edges, and adds two 80-pin high-density connectors underneath for carrier boards. Its STM32H747 has two cores: a Cortex-M7 at 480 MHz and a Cortex-M4 at 240 MHz, which call functions on each other through a remote procedure call mechanism. The Murata 1DX module adds Wi-Fi and Bluetooth 5.1, with a u.FL socket for an external antenna. The board also carries SDRAM, QSPI flash, a USB-C port and an RGB LED, and the chip has a graphics accelerator and a JPEG codec.
| Part | The real Portenta H7 | In the library |
|---|---|---|
| MCU | STM32H747: Cortex-M7 480 MHz + Cortex-M4 240 MHz | your Arduino sketch |
| Radio | Murata 1DX: Wi-Fi + Bluetooth 5.1 | WiFi.h and ArduinoBLE |
| LED | RGB LED, each colour active LOW | LEDR, LEDG, LEDB |
| Pins | MKR rows (D0 to D14, A0 to A6) + two 80-pin connectors | the MKR rows |
| USB | USB-C | the serial monitor |
| Memory | 2 MB flash, 1 MB RAM, 8 MB SDRAM | about 256 KB of flash, 8 KB of RAM |
Two Cores Working Together
The two cores of the STM32H747 can run different programs at the same time. A common split puts the fast, time-critical work - motor control, signal processing, a camera - on the M7, and the slower tasks like networking or a user interface on the M4, or the other way round. On the Portenta, one core can even run MicroPython while the other runs an Arduino sketch, and the two talk through RPC calls. Our simulation runs your sketch as one program, which is what most projects start with.
Wi-Fi and Bluetooth in One Module
The Murata 1DX holds a complete Wi-Fi and Bluetooth radio in a small shielded can. Wi-Fi gives the Portenta a fast link to a router and the internet - for web pages, cloud dashboards and firmware updates - while Bluetooth LE talks to phones and sensors nearby at very low power. Both can run at the same time, so a product can, for example, be set up from a phone app over Bluetooth and then report its data over Wi-Fi.
The Pro Range and Carriers
Arduino built the Portenta family for industry. The high-density connectors carry every signal of the chip - camera, display, Ethernet, CAN, more serial ports - to carrier boards such as the Breakout, the Max Carrier or the Vision Shield. The same Portenta can move from a breadboard prototype to a product on a custom carrier without changing the code. For the MKR family it grew from, see our Arduino MKR WiFi 1010 Library for Proteus.
Where Is It Used?
The Portenta H7 shows up in industrial monitoring and control, machine vision with the Vision Shield, robotics, test equipment and smart agriculture - our greenhouse is a small example of the last one. Universities use it because it combines Arduino's simple programming with a processor powerful enough for serious research. For an ST board with Ethernet in this series, see our NUCLEO-H743ZI2 Library for Proteus.
A simulation lets you build the control logic and the web interface before the board is on the desk: the readings, the thresholds, the relay and the page. When the sketch works in the Proteus simulation, the real board only has to confirm it.
Features of the Portenta H7 Library for Proteus
- The board as it looks: the black Portenta PCB with the USB-C, the STM32H747, the SDRAM and QSPI flash, the Murata 1DX can with its u.FL socket (it glows with the Wi-Fi), the RGB LED, RESET, our PANEL pad and the two MKR rows, drawn compact, with our small TEP signature.
- Your sketch: a .hex for "Arduino Portenta H7 (TEP Proteus)" with the Arduino mbed core's names: D0 to D14, A0 to A6, LEDR, LEDG, LEDB and LED_BUILTIN.
- Wi-Fi: WiFi.h with the Portenta's names - WiFi.begin() waits for the join, WiFiServer, WiFiClient, WiFiUDP - with our router, our phone and our laptop.
- Bluetooth LE: ArduinoBLE, with the phone as the central.
- A real RGB LED: each colour lights when its pin is LOW, as on the real board, and the colours mix.
- A complete package: about 4.2 MB with the part, the add-on, the BME280, the relay, the phone and the demo, without the source code of the models.
The Portenta H7 in Proteus Simulation
Search PORTENTA in Pick Devices; the device is in TEPPORTH7.LIB (Microprocessor ICs, Arduino Wi-Fi Boards), with the prefix U. The USB-C opens the serial monitor, and the PANEL pad or a click on the Murata module opens the Wi-Fi panel.
The Pins
| Pins | What the library does with them |
|---|---|
| D0 to D14 | GPIO, attachInterrupt; PWM on D0 to D6; SPI on D7 to D10; Wire on D11 / D12; Serial1 on D13 / D14 |
| A0 to A6 | analogRead 0 to 1023 for 0 to 3.3 V, or GPIO |
| LEDR, LEDG, LEDB | the RGB LED, each colour lit when LOW (LED_BUILTIN is LEDG) |
| VCC, 5V, GND, RESET | the supply and the reset |
Download Arduino Portenta H7 Library for Proteus
Click the button below to download Arduino-Portenta-H7-Library-for-Proteus-v1.0.zip (about 4.2 MB, without the source code of the models):
Arduino Portenta H7 Library for Proteus V1.0- README.txt: installation, the demo, the pins, the properties, troubleshooting and the limits.
- Proteus Library Files:
TEPPORTH7.LIB, the BME280 and the relay (TEPBME280.LIB,TEPRELAY.LIB) and the phone and laptop (TEPMOBILE.LIB,TEPLAPTOP.LIB). - Proteus Model Files:
TEPNET.DLL,TEPBME280.DLLandTEPRELAY.DLL. - Arduino Code: the demo sketch and the TEP Boards for Proteus add-on 1.75.0, with WiFi and ArduinoBLE.
- Proteus Simulation: the demo project, its HEX file and copies of the DLLs.
No Proteus yet? Read How to Download and Install Proteus 7 and 8. New to libraries? Follow How to Install a New Library in Proteus.
How to Install Arduino Portenta H7 Library for Proteus
- Close Proteus and extract the whole zip file, for example to your Desktop.
- Copy the files from Proteus Library Files into the LIBRARY folder of Proteus.
- Copy the DLLs from Proteus Model Files into the MODELS folder, replacing an older
TEPNET.DLL. - Delete
TEPPORTH7.IDXfrom the LIBRARY folder if it is there. - For your own sketches, copy Arduino Code\TEP Boards for Proteus\hardware into your Arduino sketchbook (Documents\Arduino) and restart the Arduino IDE; the board is Arduino Portenta H7 (TEP Proteus). The demo also needs Adafruit BME280 and Adafruit Unified Sensor from the Library Manager.
- Start Proteus, press P and search for PORTENTA.
Demo: a Wi-Fi Greenhouse Fan in Simulation
On a sunny afternoon a closed greenhouse heats up fast, and plants suffer above 30 C. A fan that starts by itself solves most of it, and a web page lets the gardener check the greenhouse from anywhere on the network and take over when needed - for example to keep the fan off while watering.
Open Portenta-WiFi-Greenhouse.pdsprj. U1 runs Portenta_Greenhouse.hex. U2 is our BME280 (Advance) on D11 and D12, RLY1 is the fan's relay on D5, and MOB1 is our Mobile WiFi Monitor, a phone on the same Wi-Fi; its browser's home page is the board's page. The serial monitor is the same window as our TEP Serial Monitor Advance for Proteus.
| Mode | The fan | RGB LED |
|---|---|---|
| AUTO | on at 30 C, off at 27 C | green (off) or yellow (running) |
| FORCED ON | on, whatever the temperature | blue |
| FORCED OFF | off, whatever the temperature | blue |
Running the Fan
runFan() decides every 2 seconds. In AUTO it uses two thresholds, 30 C and 27 C, so the fan does not switch on and off around a single value:
void runFan() {
if (mode == MODE_ON) setFan(true);
else if (mode == MODE_OFF) setFan(false);
else if (tempC >= FAN_ON_C) setFan(true);
else if (tempC <= FAN_OFF_C) setFan(false);
else showLed();
}
setFan() switches the relay - its input is active LOW - and prints only real changes:
void setFan(bool on) {
if (on != fanOn) {
fanOn = on;
digitalWrite(FAN_PIN, on ? LOW : HIGH);
Serial.print(on ? F(">> Fan ON at ") : F(">> Fan OFF at ")); Serial.print(tempC, 1); Serial.print(F(" C (")); Serial.print(MODE_NAME[mode]); Serial.println(F(")"));
}
showLed();
}
The RGB LED
Each colour of the Portenta's RGB LED lights when its pin is LOW. Red and green together make yellow:
void showLed() { // the RGB LED: each colour lit when LOW
const bool blue = mode != MODE_AUTO, yellow = !blue && fanOn;
digitalWrite(LEDR, yellow ? LOW : HIGH);
digitalWrite(LEDG, (!blue) ? LOW : HIGH);
digitalWrite(LEDB, blue ? LOW : HIGH);
}
Joining the Wi-Fi
As on the real Portenta, WiFi.begin() waits until the board has joined and returns the status:
while (WiFi.begin(SSID, PASS) != WL_CONNECTED) { Serial.println(F(" retrying...")); delay(2000); }
server.begin();
Serial.print(F("Wi-Fi connected, IP ")); Serial.println(WiFi.localIP());
The Web Page
handleWeb() reads the first line of each request; /auto, /on and /off change the mode, and every request gets the page back:
void handleWeb() {
WiFiClient client = server.available();
if (!client) return;
String request; // the first line: "GET /on HTTP/1.1"
const unsigned long t0 = millis();
while (client.connected() && millis() - t0 < 1000) {
if (!client.available()) continue;
const String line = client.readStringUntil('\n');
if (!request.length()) request = line;
if (line.length() <= 1) break; // the empty line after the header
}
if (request.startsWith("GET /auto")) setMode(MODE_AUTO);
else if (request.startsWith("GET /on")) setMode(MODE_ON);
else if (request.startsWith("GET /off")) setMode(MODE_OFF);
sendPage(client);
delay(1);
client.stop();
}
A Page Without a Web Library
The sketch answers HTTP itself: it writes the status line, the content type, an empty line and the HTML, with every fixed piece of text in flash through F(). That keeps the page small and fast, and it works the same way on the real Portenta, whose core has WiFiServer but no separate web-server library. The four links are plain addresses, so the page also works from any browser on the network, not only from our phone.
Run the Simulation
Press Run. The board joins TEP-WiFi, prints its address and the page's link, and the greenhouse is fine, so the LED is green:
Portenta H7 Wi-Fi Greenhouse Fan - The Engineering Projects
Connecting to TEP-WiFi
Wi-Fi connected, IP 192.168.1.101
Greenhouse page: http://192.168.1.101/
Greenhouse 24.0 C 60 % fan OFF AUTO
Open the Page
Click the phone and press Go: the browser opens the board's page.
A Hot Afternoon
In the BME280's window, click the temperature track at about 32.5 C. The fan starts, the relay clicks on and the LED turns yellow:
>> Fan ON at 32.5 C (AUTO)
Here is the complete circuit while the simulation runs:
Take Over From the Phone
Tap FAN OFF: the mode becomes FORCED OFF, the fan stops even though it is hot, and the LED turns blue. Tap AUTO and the temperature is in charge again:
Cool Again
Click the track at about 25 C: below 27 C the fan stops by itself and the LED turns green. Finally tap FAN ON to run the fan anyway:
>> Mode FORCED OFF (from the phone)
>> Fan OFF at 32.5 C (FORCED OFF)
>> Mode AUTO (from the phone)
>> Fan ON at 32.5 C (AUTO)
>> Fan OFF at 25.0 C (AUTO)
>> Mode FORCED ON (from the phone)
>> Fan ON at 25.0 C (FORCED ON)
Why Two Thresholds?
A single threshold makes a fan chatter: at 29.9 C it stops, the air warms by a tenth of a degree, it starts again, and so on. Two thresholds with a gap between them - on at 30 C, off at 27 C - give the fan time to do its work. This is called hysteresis, and you find it in every thermostat.
Where to Put the Sensor
In a greenhouse the air near the roof can be several degrees warmer than at the plants. Mount the BME280 at plant height, in the shade, and away from the fan's direct stream, or the fan will cool its own sensor and stop too early. A small white cover with holes - a radiation shield - keeps the sun off the sensor while the air flows through.
Who Is in Charge?
Automatic control is good, but a person must always be able to overrule it. That is why the page has FAN ON and FAN OFF, and why the LED turns blue whenever the phone is in charge: anyone walking into the greenhouse sees at a glance that the fan is not following the temperature. AUTO hands the control back, and the sketch prints every change of mode, so the log shows who did what.
Bluetooth LE on the Same Board
The demo uses Wi-Fi, but the same board also speaks Bluetooth LE through ArduinoBLE. A greenhouse sensor could advertise the temperature as a characteristic, so a phone in the greenhouse reads it without any network, while the web page serves everyone on the Wi-Fi. Our Mobile WiFi Monitor has a Bluetooth app for exactly that, as in our other Bluetooth demos.
Try It Yourself
- Change
FAN_ON_CandFAN_OFF_Cfor your plants. - Add a second relay on D6 for a heater that starts below 15 C.
- Add the humidity to the page as a coloured bar.
- Advertise the temperature over Bluetooth LE with ArduinoBLE as well, for the phone's Bluetooth app.
Ideas to Extend the Greenhouse
- Add a soil moisture sensor on A0 and a water pump on a third relay.
- Keep the highest and lowest temperature of the day and show them on the page.
- Get the time from NTP and run the fan harder at midday.
- Send an alarm to a server when the greenhouse goes above 35 C.
Your Own Sketches
Write the sketch in the Arduino IDE with the board Arduino Portenta H7 (TEP Proteus), use Sketch > Export Compiled Binary and set the part's PROGRAM property to the .hex. Use the router name and password of the part's WIFISSID and WIFIPASS.
Moving to a Real Portenta H7
- Install "Arduino Mbed OS Portenta Boards" from the Boards Manager and select Portenta H7 (M7 core).
- Connect the antenna to the u.FL socket.
- Put your own network's name and password in the sketch.
- Wire the BME280 to D11 / D12 and the relay module to D5, with 3.3 V logic.
- Upload, open the Serial Monitor and open the printed address from a phone on the same network.
The sketch is the same: the Wi-Fi calls, the pin names and the RGB LED move across without changes.
Things to Know Before Using a Real Portenta H7
- The antenna: the Murata module needs the external antenna on the u.FL socket.
- 3.3 V logic: the pins are 3.3 V; check every module before you connect it.
- Two cores: a sketch uploaded for the M7 core runs there; the M4 core needs its own sketch.
- Bootloader: double-tap RESET to enter the bootloader if an upload fails.
Properties of the Portenta H7
| Property | What it does |
|---|---|
| PROGRAM | the sketch: a .hex from TEP Boards for Proteus (board "Arduino Portenta H7") |
| WIFISSID, WIFIPASS | the router the board sees and its password |
| MONITOR, BAUD, AUTOOPEN | the built-in serial monitor: on, its baud rate (115200), open at Run |
| TIME | the clock for NTP: PC, or a fixed UTC time |
Troubleshooting
- "retrying...": the network name or the password in the sketch differs from WIFISSID and WIFIPASS.
- The phone shows nothing: press Go after the page's address is printed; the sketch must call
server.begin(). - The LED looks inverted: each colour of the RGB LED lights when its pin is LOW.
- A number goes wrong above 32767: int is 16 bits in the simulation - use long.
Limitations of the Simulation
- Your sketch is one program: the M4 core and the RPC between the cores are not modelled.
- The high-density connectors, the SDRAM, the camera, display and Ethernet signals are not modelled.
- Your sketch gets 8 KB of RAM in the simulation, and int is 16 bits there.
- Arduino and Portenta are names of Arduino, STM32 of STMicroelectronics and Murata of Murata, and the Bluetooth word mark belongs to Bluetooth SIG; this library is not made or endorsed by them or by Labcenter.
- Tested in Proteus 8.5 in November 2026 (the demo as shipped, about 30 s of simulation). Proteus 7 is not supported.
So, that was all about the Arduino Portenta H7 Library for Proteus. I hope it helps you try your connected ideas on a Portenta in a simulation before you buy the board - the sensor, the relay, the web page and the phone, all on one sheet. If you have any questions, ask in the comments and I will help you out. Till the next tutorial, take care and have fun!