Project Files of RAK4631 WisBlock Library for Proteus: LoRa and Bluetooth Greenhouse

RAK4631 WISBLOCK LIBRARY FOR PROTEUS - V1.0 (YOUR SKETCH WITH LORA AND BLUETOOTH LE)
Designed by The Engineering Projects
www.TheEngineeringProjects.com

IMPORTANT LINKS
Article (read it first - pictures, step by step, every feature explained):
  https://www.theengineeringprojects.com/2026/11/rak4631-wisblock-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/rak4631-wisblock-proteus-library
The demo's other parts are our libraries (included) - their articles:
  https://www.theengineeringprojects.com/2026/10/aht20-sensor-library-for-proteus-v1-0.html
  https://www.theengineeringprojects.com/2026/10/relay-module-library-for-proteus-v1-0.html
  https://www.theengineeringprojects.com/2026/10/mobile-wifi-monitor-library-for-proteus.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
RAK4631-WisBlock-TEP-v1.0/
|-- Proteus Library Files/
|   |-- TEPAHT20.LIB                                     96.9 KB   the AHT20 (demo), to LIBRARY
|   |-- TEPLAPTOP.LIB                                    39.5 KB   the laptop (demo), to LIBRARY
|   |-- TEPMOBILE.LIB                                    13.1 KB   the phone (demo), to LIBRARY
|   |-- TEPRAK4631.LIB                                   33.8 KB   the RAK4631 WisBlock, to LIBRARY
|   |-- TEPRELAY.LIB                                    490.4 KB   the relay (demo), to LIBRARY
|-- Proteus Model Files/
|   |-- TEPAHT20.DLL                                    336.5 KB   the AHT20, to MODELS
|   |-- TEPNET.DLL                                       2.89 MB   the board + monitors + network, to MODELS
|   |-- TEPRELAY.DLL                                    330.0 KB   the relay, to MODELS
|-- Arduino Code/
|   |-- RAK_Field_Gateway/RAK_Field_Gateway.ino           4.9 KB   the demo sketch
|   |-- RAK_Greenhouse_Node/RAK_Greenhouse_Node.ino       4.4 KB   the demo sketch
|   |-- TEP Boards for Proteus/hardware/                 1.08 MB   the Arduino IDE add-on 1.57.0 (264 files)
|-- Proteus Simulation/
|   |-- RAK_Field_Gateway.hex                            35.0 KB   the demo sketch (U2)
|   |-- RAK_Greenhouse_Node.hex                          47.3 KB   the demo sketch (U1)
|   |-- RAK4631-WisBlock-Greenhouse.pdsprj               21.5 KB   the demo: a greenhouse node, a gateway, a phone
|   |-- TEPAHT20.DLL                                    336.5 KB   copy of the model
|   |-- TEPNET.DLL                                       2.89 MB   copy of the model
|   |-- TEPRELAY.DLL                                    330.0 KB   copy of the model
|-- README.txt                                          ~12.0 KB   this file
Total: 8.94 MB (unzipped). The source code of the models is not included.

WHAT IS IT?
Proteus 8 has no nRF52840 processor model, so this is NOT a real nRF52840 chip. Our team has put a lot of effort into
building this board ourselves: it is the RAKwireless WisBlock Core RAK4631 (a Nordic nRF52840 with a Semtech SX1262)
on the RAK19007 WisBlock Base Board, 60 x 30 mm, that runs YOUR Arduino sketch in Proteus:
  * You write a normal sketch with the base's pins (TX1, RX1, AIN1, IO1, IO2, SCL, SDA: WB_IO1, WB_IO2, WB_A1, Wire,
    Serial, Serial1) and compile it in the Arduino IDE with our board package "TEP Boards for Proteus" 1.57.0 (in
    Arduino Code - see INSTALLATION).
  * LoRa works: #include <SX126x-RAK4630.h>, lora_rak4630_init(), RadioEvents_t, Radio.Init, Radio.SetChannel,
    Radio.SetTxConfig, Radio.SetRxConfig, Radio.Send, Radio.Rx, with the callbacks OnTxDone and OnRxDone, as in RAK's
    LoRa point-to-point examples. It is the same air as our other LoRa boards.
  * Bluetooth LE works: #include <bluefruit.h>, Bluefruit, BLEUart, the connect callbacks and the advertising calls.
    The central is our Mobile WiFi Monitor: its Bluetooth app lists what advertises, connects, shows the last line and
    writes a line.
  * The green and blue LEDs are on the base: LED_GREEN and LED_BLUE, lit when HIGH. LED_CONN follows the Bluetooth
    connection by itself.
TEP additions: the USB port opens the serial monitor (the same window as our TEP Serial Monitor Advance). The LORADIST
property sets the distance between the boards.
Limits (say them before you start): LoRa is point-to-point here: LoRaWAN is not modelled. This board is a Bluetooth
peripheral: the central role is not in this version. The WisBlock sensor and IO slots are drawn, not modelled: wire
your modules to the headers.
Your sketch gets 8 KB of RAM in the simulation, about 256 KB of flash, and int is 16 bits in the simulation (use long
for big numbers). No FreeRTOS tasks. See MODEL SCOPE AND LIMITS.

ONE DEVICE (search "RAK4631" in Pick Devices):
  RAK4631 WISBLOCK  "RAK4631 WisBlock" V1.0 (Microprocessor ICs > Bluetooth Boards), prefix U, model TEPNET.DLL. Its
  TEP window has no Windows title bar: the serial monitor (the USB port, 115200 baud: Monitor, Plotter and Board
  tabs).
The same TEPNET.DLL also runs our other sketch boards and the phone; it replaces any older TEPNET.DLL (keep only this
newest one in MODELS).

TEST STATUS
V1.0: verified in Proteus 8.5 on 31 Oct 2026 with the demo project as shipped. What the Proteus run showed:
* RAK4631-WisBlock-Greenhouse: U1 the node, every 5 s ">> Sent: 26.4 C  58 %  fan OFF auto"; U2 the gateway "<< Node:
  26.4 C  58 %  fan OFF auto  (RSSI -108, SNR 8)" with both boards at LORADIST 2 km.
* The phone's Bluetooth app listed TEP Gateway; Connect: ">> Phone connected", the blue LED, and the line of the last
  report on the phone.
* FAN ON written on the phone: ">> Phone: FAN ON (waits for the next report)", then after the next report ">> To the
  node: FAN ON", ">> Gateway says: FAN ON", ">> Fan ON", the relay on, ">> Sent: 26.4 C  58 %  fan ON by hand".
* AUTO written on the phone: ">> Gateway says: AUTO", ">> Fan OFF" (the air is below 28 C).
* The AHT20's pop-up, +5 twice: ">> Fan ON", ">> Sent: 36.4 C  58 %  fan ON auto"; -5 twice: ">> Fan OFF". Disconnect:
  ">> Phone left".
* about 44 s of simulation, no errors, with both monitors, the AHT20's and the relay's windows and the phone open.

INSTALLATION (about 3 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" to the LIBRARY folder of Proteus, for example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (on some PCs: C:\ProgramData\Labcenter Electronics\Proteus 8 Professional\LIBRARY). TEPRAK4631.LIB is the board;
   the others are the demo's parts: TEPAHT20.LIB, TEPRELAY.LIB, TEPMOBILE.LIB and TEPLAPTOP.LIB.
3. Copy the DLLs from "Proteus Model Files" (TEPNET.DLL, TEPAHT20.DLL, TEPRELAY.DLL) to the MODELS folder (...\Proteus
   8 Professional\MODELS) -
   replace an older TEPNET.DLL (this one is the first that knows this board).
4. Delete TEPRAK4631.IDX from the LIBRARY folder if it is there.
5. The Arduino IDE (only to compile your own sketches - the demo has its HEX files): copy the folder
   "Arduino Code\TEP Boards for Proteus\hardware" into your sketchbook folder (normally Documents\Arduino), so that
   Documents\Arduino\hardware\tep\avr\boards.txt exists (replace an older copy); restart the IDE. The Arduino AVR Boards
   platform must be installed (it comes with IDE 1.8.x; in IDE 2.x install "Arduino AVR Boards" from the Boards
   Manager once).
   Tools > Board > TEP Boards for Proteus > RAK4631 WisBlock (TEP Proteus). SX126x-Arduino and Bluefruit are in the
   board package. From the Library Manager: Adafruit AHTX0.
6. Start Proteus. In Pick Devices (P) search "RAK4631".

RUN THE DEMO
Keep the .hex files and the DLLs beside the project in "Proteus Simulation".
RAK4631-WisBlock-Greenhouse.pdsprj - a greenhouse fan you can reach from a phone. U1 the node
(RAK_Greenhouse_Node.hex): U3 = the AHT20 (Advance) on I2C, RLY1 = the fan's relay (Advance) on IO1. U2 the gateway
(RAK_Field_Gateway.hex). MOB1 = the phone (Mobile WiFi Monitor). There is no wire between U1 and U2: only LoRa.
Press Run. Every 5 seconds the node sends a report, and the gateway prints it. On the phone open the Bluetooth app and
click Connect beside TEP Gateway: the blue LED lights and the last report appears.
Click the To the board row, type FAN ON and press Send. The gateway keeps the command until the next report, because
the node only listens for a second after it sends. Then the relay clicks on. AUTO hands the fan back to the node.
On the AHT20's pop-up click +5 twice: above 30 C the node starts the fan by itself, and below 28 C it stops it.
Closed a window? The USB port opens the monitor, the OPEN PANEL pads open the AHT20 and the relay, a click on the
phone's screen the phone.

THE PINS (the label on the part, what it can do in the simulation)
  TX1, RX1        Serial1, or GPIO (16, 15)
  AIN1            WB_A1: analogRead 0 .. 1023 for 0 .. 3.3 V, or GPIO (31)
  IO1, IO2        WB_IO1, WB_IO2: GPIO, PWM, interrupt (17, 34)
  SCL, SDA        Wire (14, 13)
  VDD, VBAT, GND  3.3 V (the logic), the battery line, ground
  BOOT            drawn, not modelled
LED_GREEN and LED_BLUE are on the base, lit when HIGH. LED_BUILTIN is LED_GREEN, LED_CONN is LED_BLUE. Serial is the
USB: the board's built-in monitor.

PROPERTIES (double-click the part > Edit Properties)
  PROGRAM      the sketch's HEX (Arduino IDE: Sketch > Export Compiled Binary with RAK4631 WisBlock (TEP Proteus))
  LORADIST     the LoRa distance to the other boards: 10 m, 100 m, 1 km, 2 km, 5 km, 10 km, 15 km, 20 km
  MONITOR      YES = the built-in serial monitor on Serial;  BAUD  its speed (115200, or AUTO)
  AUTOOPEN     YES = the monitor window opens at Run (the demo: YES)

TROUBLESHOOTING
* No report arrives: both boards need the same frequency, bandwidth, spreading factor and coding rate, and a callback
  must call Radio.Rx again. Try a shorter LORADIST.
* The phone's list is empty: Bluefruit.begin(), then Bluefruit.Advertising.start(0). The phone needs this TEPNET.DLL
  or newer.
* "The AHT20 did not answer": it needs 100 ms after power-up: wait before aht.begin().
* A command never reaches the node: it only listens for RX_WINDOW_MS after each report.
* A relay module acts backwards: its IN is active LOW.
* An integer goes wrong above 32767: int is 16 bits in the simulation - use long.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot and the Serial Monitor text:
  https://www.theengineeringprojects.com/forum/category/rak4631-wisblock-proteus-library

LICENCES AND THIRD-PARTY NOTES
* The board model (TEPNET.DLL), the symbols and artwork (TEPRAK4631.LIB) and the AHT20 and relay models are made by
  The Engineering Projects. The source code of the models is not included.
* TEP Boards for Proteus (Arduino Code): its core, the variants and the EEPROM, SPI and Wire libraries are modified
  copies of the Arduino AVR core 1.8.6 - GNU Lesser General Public License 2.1 (LGPL 2.1, the text:
  LICENSE-LGPL-2.1.txt); its WiFi, WebServer, ArduinoBLE, the sensor libraries and the others and our core files are
  MIT (LICENSE-MIT.txt).
* Our SX126x-Arduino and bluefruit.h have the calls of the libraries of those names by Bernd Giesecke and Adafruit;
  their code is ours.
* The demo sketch uses Adafruit AHTX0 and Adafruit Unified Sensor (BSD, Apache 2.0): install them with the Library
  Manager to rebuild.
* Proteus is a product of Labcenter Electronics and is not included. WisBlock and RAK are names of RAKwireless,
  nRF52840 of Nordic Semiconductor, SX1262 and LoRa of Semtech. The Bluetooth word mark belongs to Bluetooth SIG. This
  library is not made or endorsed by them or by Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX files are supplied. Install TEP Boards for Proteus (INSTALLATION step 5), open Arduino
Code\RAK_Greenhouse_Node or Arduino Code\RAK_Field_Gateway, select RAK4631 WisBlock (TEP Proteus) and use Sketch >
Export Compiled Binary. For real boards use RAK's RAKwireless nRF Boards package and install SX126x-Arduino.

MODEL SCOPE AND LIMITS
Modelled: the base's header pins; digital I/O, analogRead 0 .. 1023, PWM (analogWrite), tone and attachInterrupt
through the board model; Serial (the board's monitor), Serial1 and Wire; the green and blue LEDs; LoRa point-to-point
between our boards, with RSSI and SNR from the distance; Bluetooth LE as a peripheral, with one central.
Not modelled: the nRF52840 itself, the WisBlock slots and modules, LoRaWAN, FSK, the Bluetooth central role, pairing
and bonding, the battery and solar charger. The simulation runs below real time.

VERSION
TEP RAK4631 WisBlock library V1.0 (Nov 2026). Device RAK4631 WISBLOCK (TEPRAK4631.LIB / TEPNET.DLL), TEP Boards for
Proteus 1.57.0 (adds this board, SX126x-Arduino and Bluefruit52Lib).
Demo sketches RAK_Greenhouse_Node and RAK_Field_Gateway V1.0. Demo parts: AHT20ADVTEP, RELAY1ADVTEP and MOBILE WIFI
MONITOR.