Project Files of GSR Galvanic Skin Response Sensor Library for Proteus

GSR GALVANIC SKIN RESPONSE SENSOR LIBRARY FOR PROTEUS - V1.0 (a GSR sensor with a pop-up)
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/gsr-galvanic-skin-response-sensor-library-for-proteus.html
Report a bug or suggest a feature (our forum):
  https://www.theengineeringprojects.com/forum/category/gsr-sensor-proteus-library
The demo runs on our Arduino UNO V4.0 (included) - working LEDs, RESET and a
built-in serial monitor, no Virtual Terminal to wire - its own article:
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
Support us (the libraries are free):
  https://www.theengineeringprojects.com/donate

FILE STRUCTURE
GSR-Sensor-TEP-v1.0/
|-- Proteus Library Files/
|   |-- ArduinoV4TEP.LIB                              201.9 KB   TEP Arduino boards V4.0 (UNO) -> LIBRARY
|   |-- TEPGSR.LIB                                     14.6 KB   the library -> LIBRARY folder
|-- Proteus Model Files/
|   |-- TEPARDUINO.DLL                                883.5 KB   the Arduino board model -> MODELS folder
|   |-- TEPGSR.DLL                                    319.5 KB   the model -> MODELS folder
|-- Proteus Simulation/
|   |-- GSR_Demo.hex                                   18.4 KB   the demo firmware
|   |-- GSR-Sensor-ArduinoUnoV4.pdsprj                 18.3 KB   the demo project
|   |-- TEPARDUINO.DLL                                883.5 KB   copy of the board model
|   |-- TEPGSR.DLL                                    319.5 KB   copy of the model
|-- Arduino Code/
|   |-- GSR_Demo/GSR_Demo.ino                           3.5 KB   the demo sketch (source of the .hex)
|-- README.txt                                        ~13.8 KB   this file
Total: 2.61 MB (unzipped). The C++ source code of the models is not included.

WHAT IS IT?
A galvanic skin response (GSR) sensor in the style of the Grove GSR, drawn at true scale (20 x 20
mm, 24 mm with its connector) - our
own drawing:
  * A blue board with the LM324 in the middle, the sensitivity trimmer, the cable to two nickel
    finger electrodes, a PWR LED and the
    4-pin connector: GND, VCC, NC, SIG.
  * The skin: no contact until WEAR; then the conductance settles towards SCL (microsiemens) in
    about 0.6 s. Every stimulus in EVENTS
    ("time:response in uS, ...") brings a skin conductance response 1.5 s later - a Bateman curve
    that peaks 1.39 s after its onset and is
    half recovered about 2.9 s after the peak. A small slow wander.
  * The sensor: the resistance between the fingers, R = 1 / G, read as the reading x = (R cal -
    10,240,000) / (R + 20,000) of a 10-bit
    converter on VCC - the inverse of the maker's formula R = (1024 + 2x) 10000 / (cal - x). cal,
    the reading with no fingers, is set by
    the trimmer (TRIM, % of VCC). SIG = x / 1024 x VCC within the LM324's swing (0 - VCC - 1.5 V).
  * Click it at Run for the pop-up: the hand with the electrodes (sweating with the responses), the
    skin conductance and SIG over the run
    with the stimuli marked, and every response measured.
The body is drawn as on the real part and to true scale against our Arduino.
The TEP signature and the pop-up are TEP additions.

ONE DEVICE (search "GSR" in Pick Devices):
  GSRGROVETEP   "GSR Sensor V1.0" in TEPGSR.LIB (Biomedical > GSR), prefix U, model TEPGSR.DLL
  (analog).
                Pins GND, VCC, NC, SIG (the connector, 2.54 mm apart; NC is not connected).

THE POP-UP
Click the part at Run. Tabs:
    Skin       the hand (sweat drops with the response, a STIMULUS badge), the skin conductance and
    SIG over the whole run with the stimuli
               marked, and eight live values: the conductance, the resistance, SIG and the reading,
               the response now and the rest level,
               VCC, the trimmer, the responses and the last one's latency, rise and size.
    Graphs     the live values over the last 2, 6 or 15 s. Live / Freeze.
    Event log  every change and warning; filters All / Changes / Warnings, Pause, Clear
    Check      what the part is doing and what to look at, each with a verdict (green = fine, amber
    = check, red = wrong)
    Settings   theme, text size, open at Run, window size
    Help       report a bug, suggest a feature, article, updates, donate, forum; Copy diagnostics
    for a bug report

TEST STATUS
V1.0: verified in Proteus 8.5 on 7 Nov 2026 (the demo project as shipped: an A4 sheet, an Arduino UNO V4.0).
What the runs showed (the model's own numbers and the sketch's monitor):
  * The project loads and starts cleanly; the demo runs 26 simulated seconds in about four minutes
    on our PC.
  * No fingers (the first second): SIG at 2.50 V, the trimmer's 50 %; the sketch read cal = 512.0.
  * Fingers on at 1.00 s (the sketch saw them at 1.05 s): the skin conductance settled within 3 s -
    4.97 uS at 4.0 s, 5.00 uS (R 200 kohm,
    reading 418.9) by 6.6 s; the sketch printed x 419.0, R 200.2 kohm, SC 4.99 uS.
  * The three responses, as the sensor's model measured them at the electrodes: stimulus at 6 s -
    onset 7.50 s (1.50 s later), peak
    +0.79 uS at 8.89 s (rise 1.39 s), half recovered 2.87 s after the peak; at 13 s - onset 14.50 s,
    +1.44 uS at 15.83 s (rise 1.33 s),
    half recovered after 2.59 s; at 20 s - onset 21.50 s, +0.39 uS at 22.56 s (rise 1.06 s), half
    recovered after 1.73 s.
  * The sketch found all three from the readings alone and printed: onset 7.45 s, peak 8.90 s, rise
    1.45 s, +0.78 uS (4.99 to 5.77);
    onset 14.45 s, peak 15.82 s, rise 1.37 s, +1.40 uS (5.17 to 6.57); onset 21.50 s, peak 22.62 s,
    rise 1.12 s, +0.36 uS (5.35 to 5.71).
  * The largest conductance 6.60 uS; SIG stayed between 1.92 and 2.50 V (no clipping). The pop-up:
    Skin, Graphs, Event log, Check - all
    four pages followed the run.

INSTALLATION (about 2 minutes)
1. Close Proteus. Extract the WHOLE ZIP to a normal folder (e.g. Desktop).
2. Copy everything in "Proteus Library Files" (TEPGSR.LIB and our Arduino library V4.0,
ArduinoV4TEP.LIB, with the ARDUINO UNO V4.0 used by the demo) to the LIBRARY folder of Proteus, for
example:
     C:\Program Files (x86)\Labcenter Electronics\Proteus 8 Professional\LIBRARY
   (use the folder that already holds Proteus's own .LIB files).
3. Copy TEPGSR.DLL and TEPARDUINO.DLL from "Proteus Model Files" to the MODELS folder (...\Proteus 8
Professional\MODELS).
4. Delete TEPGSR.IDX from the LIBRARY folder if it is there (Proteus makes a new index).
5. Start Proteus. In Pick Devices (P) search "GSR".

RUN THE DEMO
"Proteus Simulation\GSR-Sensor-ArduinoUnoV4.pdsprj" (an A4 sheet) - keep the .hex file and the DLLs
beside the project.
  ARD1:   Arduino UNO V4.0 running GSR_Demo.hex, its serial monitor built in (window "TEP Arduino
  UNO - ARD1").
  U1:     the GSR sensor (SCL 5, WEAR 1, EVENTS 6:0.8, 13:1.5, 20:0.5, TRIM 50): VCC (5 V), GND, SIG
  - A0.
  1. Every 50 ms the sketch takes the mean of 10 readings; the first 0.6 s, before the fingers go
  on, give cal.
  2. The maker's formula turns each reading into R and the skin conductance (1,000,000 / R
  microsiemens).
  3. A response starts 0.15 uS above the lowest point and ends 0.10 uS down from its peak; the
  sketch prints its onset, peak, rise time
     and size; the UNO's LED (D13) is on while it rises. Every half second it prints the reading, R
     and the conductance.
Closed the monitor? Click the UNO's USB port.

WIRING (the same in Proteus and on a real board)
  VCC: 3.3 or 5 V (the UNO's 5 V here); GND; SIG: an analog pin. NC stays open.
REAL HARDWARE:
 * Not a medical device and not a lie detector - for learning and hobby projects only; power it from
   a battery or USB, never from mains.
 * Put the electrode sleeves on the middle phalanges of the index and middle fingers, palm side,
   snug but not tight; keep the hand still.
 * Set the trimmer with the electrodes off: turn it until the reading is 512 (or note the open
   reading and use it as cal).
 * Responses vary a lot between people and with room temperature; compare a person with their own
   rest level, not with others.

THE DEMO SKETCH ON THE SERIAL MONITOR (GSR_Demo V1.0, 9600 baud)
There are no commands. The sketch calibrates, then follows the skin conductance and measures each
response.
EXPECTED MONITOR OUTPUT
  GSR Sensor - The Engineering Projects
  cal = 512.0 (no fingers)
  t=1.05 s: fingers on
  t=4.05 s  x 419.0  R 200.2 kohm  SC 4.99 uS
  t=9.90 s: response 1 - onset 7.45 s, peak 8.90 s, rise 1.45 s, +0.78 uS (from 4.99 to 5.77 uS)

PROPERTIES (double-click the part > Edit Properties)
  Skin conductance at rest (SCL)       microsiemens, the tonic level once the electrodes have
  settled
  Fingers on (WEAR)                    the time the electrodes go on, seconds
  Stimuli (EVENTS)                     "time:response, ..." in seconds and microsiemens
  Trimmer (TRIM)                       the output with no fingers, % of VCC (50 % gives cal 512)
Every run starts again from the properties.

LINKS.INI (OPTIONAL)
The Help page cards of the pop-up open web pages. To point them somewhere else without a new DLL,
put a text file named links.ini next to TEPGSR.DLL with lines KEY=URL, for example:
  ARTICLE=https://www.theengineeringprojects.com/...
Keys: WEBSITE, FORUM, BUG_REPORT, FEATURE_REQUEST, ARTICLE, USER_GUIDE,
UPDATE_CHECK, DONATE. Only http:// and https:// links are used; lines starting
with # are comments.

TROUBLESHOOTING
* NO SUPPLY: VCC is missing or under 3 V.
* NO FINGERS: the reading stays at cal until WEAR - calibrate in that time.
* The conductance reads wrong: cal in the sketch is not the open reading - recalibrate with the
  electrodes off.
* SIG at the LM324's limit: the trimmer is set too high for VCC - set TRIM lower.
* A response is missed: it is smaller than the sketch's 0.15 uS threshold, or it came while the last
  one was still decaying.
* The part is not simulated: TEPGSR.DLL is missing from MODELS and from the project folder. No UNO /
  no monitor window: TEPARDUINO.DLL is missing, or click the UNO's USB port.

BUG REPORTS AND FEATURE REQUESTS
Please post them in our forum with a screenshot, the Serial Monitor text, the
simulation log and the pop-up's Copy diagnostics text:
  https://www.theengineeringprojects.com/forum/category/gsr-sensor-proteus-library

SUPPORT US
This library is free. If it saves you time, please support our work:
  https://www.theengineeringprojects.com/donate

WEBSITE
  https://www.theengineeringprojects.com/

LICENCES AND THIRD-PARTY NOTES
* The model (TEPGSR.DLL), the symbols and artwork, the other parts of ours in the demo and the
  Arduino Library V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, with its built-in TEP Serial Monitor
  Advance) are made by The Engineering Projects. The models use only standard Windows libraries; no
  Visual C++ redistributable is needed.
  The C++ source code is not included.
* Arduino UNO V4.0 (ArduinoV4TEP.LIB / TEPARDUINO.DLL, our Arduino Library V4.0 - its
  microcontroller is Proteus's own AVR model): The Engineering Projects,
  https://www.theengineeringprojects.com/2026/10/arduino-uno-library-for-proteus-v40.html
* The .hex file is built from the demo sketch and the Arduino AVR core 1.8.6, which includes
  LGPL-licensed code; its source code is available at
  https://github.com/arduino/ArduinoCore-avr/tree/1.8.6
* Proteus is a product of Labcenter Electronics and is not included. Arduino is a trademark of Arduino SA.
  This library is not made or endorsed by Arduino or Labcenter.

REBUILDING THE FIRMWARE (OPTIONAL)
The HEX file is supplied; Arduino IDE is not needed to run the demo. To edit the sketch, open
Arduino Code\GSR_Demo\GSR_Demo.ino, select Arduino Uno and use Sketch > Export Compiled Binary.
Replace the simulation's .hex with the exported HEX. The sketch needs 6,694 bytes of flash and 434
bytes of RAM.

MODEL SCOPE AND LIMITS
Modelled: the electrode contact, the tonic level, phasic responses with latency, rise and decay,
overlapping responses, a slow wander, the
maker's resistance formula, the trimmer, the LM324's swing.
Not modelled: sweat building up over minutes, temperature, breathing and movement artifacts,
spontaneous (non-specific) responses.

VERSION
TEP GSR Sensor library V1.0 (Nov 2026). Device GSRGROVETEP (TEPGSR.LIB / TEPGSR.DLL). Demo sketch
GSR_Demo V1.0. Demo board: ARDUINO UNO V4.0 (TEP Arduino Library V4.0) with its built-in serial
monitor.