Xevro User’s manual installation guide 2018
User’s Manual guide
Arduino simulator 1.5 MacOS
Made by Marc Van Den Berge and Louis D’Hont (Xevro)
Warning: The computer must by connect to a Arduino UNO.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Introduction
The Arduino UNO Simulator is made for quick tests and small projects. there is still
further developed in order to obtain the widest possible I/O functions. The Arduino
Simulator is designed to test a program quickly with the Arduino UNO without real-
ly having connections to external I/O (buttons, potentiometers, display, 7 segment
display, ...).
To be use the simulator we need 3 programs:
• - Java JDK
• - The Arduino simulation program
• - The Arduino software
In order to use the Simulator we need to download the Java JDK on our MacBook or
iMac, you can find the download link on the website of Xevro. Or go to this link and
download the MacOS version:
[Link]/technetwork/java/javase/downloads/jdk8-downloads-
[Link]
Arduino software
For we start using the Arduino Simulator we need the Arduino software, it is also free
available on the Arduino website: [Link]
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Installation guide
1. Before you can use the Arduino Simulator you will need to install the Java JDK.
On Windows computers it’s enough to install the basic Java JRE.
The Java JDK isn’t automatically installed and the simulator will not run without
the Java JDK.
[Link]/technetwork/java/javase/downloads/jdk8-downloads-
[Link]
2. Xevro is an unauthorized company so your Mac will give a message to give us
permissions. In order to do that you will go to ‘System Preferences’ and go to
the ’Security & Privacy’. Click on the tab ‘General’ and press on the ‘Open Anyway’
button, and the Arduino Simulator will start.
3. The first time when you start the Arduino Simulator you will get a window pop-
up that asks to give your password. This is to change the permissions of the Ja-
va/extensions folder where the Serial driver needs to come. It will close automati-
cally after type in your password. This will just happen ones.
4. Drag the Arduino Simulator 1.5 MacOS in the Programs folder.
5. Copy the license key in the Arduino Simulator of the website page.
If you bump into a mistake or problem, please send me an e-mail to
info@[Link]
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
License activation
The Arduino Simulator is free available to use. The first time you open the
Simulator there will be an activation pops up where you can activate the Simulator.
Click on the ‘Change Product Key’ to insert the license key you copied on the
website. To vivificate the license key you click on the ‘Activate’ button.
License key input field
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
How to use it
The Arduino Simulator is very easy to understand. The simulator needs 5 simple
things in order to work correctly.
1. Connect the Arduino board
2. Upload your custom Arduino code with the corresponding library file
3. Change the original Arduino code
4. Select the used in-outputs in the Arduino Simulator
5. Connect the Arduino Simulator to the Arduino board with the right serial
port
1. Connect the Arduino Board
The Arduino Simulator works with a lot of Arduino boards:
• Arduino UNO
• Arduino Mega
• Arduino Nano
• Arduino Micro
• Arduino Leonardo
• Arduino ...
Only the digital and analog pins that are available on the Simulator can be used!
Disconnect the Arduino Simulator before uploading the Arduino code.
2. Upload your custom Arduino code with the corresponding library file
Open the simulator and go to 'Help -> Arduino UNO programming code -> Arduino
UNO programming code (Ino)’.
This will open a Arduino (ino) file with the corresponding library and important
code in it.
3. Change the original Arduino code
In order to let the Simulator understand the code, we have devised our own in-
structions. To maintain the usability, we have decided to change the current in-
structions a little bit and replace only the first letter with a capital letter. We have
modified the instructions with a point so that the point may be omitted.
digitalWrite(13, HIGH); -> DigitalWrite(13, HIGH);
[Link]("x"); -> lcdprint("x");
4. Select the used in-outputs in the Arduino Simulator
Each input and output on the Simulator has a selection box where the used digital
or analog pin can be connected.
5. Connect the Arduino Simulator to the Arduino board with the right serial port
The Arduino Simulator knows which port is the Arduino board.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Make sure the Arduino is disconnect while uploading the Arduino code.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Code Changes
The Arduino program works with instructions that the I/O read and write, we must
convert this to serial communication, now we need to write new instructions for
this.
We don’t want to change the real instructions so we decided to make the first
character as a capital. And the instructions with a point in it are changed with no
point.
Example:
digitalWrite(12, HIGH);
become DigitalWrite(12, HIGH);
The first letter is now a case of removing the tip:
Instructions Arduino Instructions Arduino Simulator
digitalWrite(x,y); = DigitalWrite(x,y); attention: capital letter
digitalRead(x); = DigitalRead(x); attention: capital letter
analogWrite(x,y); = AnalogWrite(x,y); attention: capital letter
analogRead(x); = AnalogRead(x); attention: capital letter
[Link](x); = myservowrite(x); attention: the ‘.’ remove
[Link](x); = Serialprint(x); attention: the ‘.’ remove
tone(x,y ,z); = Tone(x,y ,z); attention: capital letter
noTone (x); = NoTone(x); attention: capital letter
[Link](x,y); = lcdsetCursor(x,y); attention: the ‘.’ remove
[Link](long x); = lcdprint(x); attention: the ‘.’ remove
[Link](“x”); = lcdprint(“x”); attention: the ‘.’ remove
[Link](); = lcdautoscroll(); attention: the ‘.’ remove
[Link](); = lcdnoAutoscroll(); attention: the ‘.’ remove
[Link](); = lcdclear(); attention: the ‘.’ remove
[Link](); = lcddisplay(); attention: the ‘.’ remove
[Link](); = lcdnoDisplay(); attention: the ‘.’ remove
[Link](); = lcdblink(); attention: the ‘.’ remove
[Link](); = lcdnoBlink(); attention: the ‘.’ remove
[Link](x); = lcdwrite(x); attention: the ‘.’ remove
[Link](); = lcdrightToLeft(); attention: the ‘.’ remove
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
[Link](); = lcdleftToRight(); attention: the ‘.’ remove
[Link](); = lcdhome(); attention: the ‘.’ remove
[Link](); = lcdcursor(); attention: the ‘.’ remove
[Link](); = lcdscrollDisplayLeft(); attention: the ‘.’ remove
[Link](); = lcdscrollDisplayRight(); attention: the ‘.’ Remove
For starters just open an example and edit these.
What to do:
1. Open a ‘ino’ file from the Arduino Simulator: go to Help -> Arduino UNO
programming code -> Arduino UNO programming code (Ino).
2. Change your code with the right instructions (the list of instructions are on
the next page)
3. Upload your code, done!
attention:
Remember to adjust the 'Void Setup to initialize the real I/O!!
Example: pinMode (0, OUTPUT);
pinMode (1, INPUT);
To understand better performance are elaborated numerous examples.
In each sketch are the instructions changed, so you only need to connect the inputs
and outputs through the screen and the sketch should work.
With Save you can store the settings for later:
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Preparing the Arduino UNO program
Open a new sketch (Help -> Arduino UNO programming code -> Arduino UNO pro-
gramming code (Ino)
The Simulator UNO-program (.ino) and the Simulator library “SimulatorProgram.h”
can found under Help:
Start the “Arduino UNO programming code” application
Now you can set your own code into the Arduino, if its upload in the Arduino you
can test it with the Simulator.
Attention: The library “SimulatorProgram.h” stand by the Simulator.
Uploading of a new program to the Arduino UNO
• Start the Arduino application
• Open the sketch
• Arduino UNO connecting with the Mac:
• Select board “Arduino UNO”
• Select the serial port
• Upload the program into the Arduino UNO
Attention: The BaudRate on the simulator is 9600.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Configure the serial port
Set the BaudRate
The BaudRate is set by default at 9600 or chance the BaudRate in the Arduino code
and also in the Simulator.
Set the Com port
First you need to select the serial port, the USB port that is used by the Arduino.
The Simulator auto detects the Arduino and turns ‘red’.
Before the selection After the selection
Attention:
- At start-up, we also see the state of the simulator at the bottom of the serial port:
- Once you have selected the correct serial port changes to this text:
You will get a error message when you want to connect with a pin that is already
used.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Use the digital I/O
Digital Inputs
- The Arduino UNO has 14 digital I/O pins we can configure this pins into inputs or
outputs I/O.
- This pins get symbolic images as D0 to D13 and the text change red if its select.
- We have 8 buttons, this buttons can set to one of the
inputs D0… D13, After the selection change the color
green.
Buttons
- When you keep pressing it send a ‘1’ to the Arduino
- No pressing send an ‘0’ to the Arduino
- With this button:
- There are text boxes to set a little information.
Leds
- We have 14 leds, each led coupled to one output D0… D13.
- After each selected led turns the combobox green.
- There is a text box for comments.
- If you click on the led you change the color of the led. Available colors:
Red, Green, Blue and Yellow. It’s also possible to use a relay as output.
Buzzer
- The buzzer can select to a digital output of D0… D13.
- When we send a signal on the output pin we get 1
second sound.
- The pitch can be changed with using the slider. (0 -
10KHz)
- There is a text box for comments.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
7 segment Display
- The display will be automatically connecting to the outputs D0
- D6 (D7 = DP not used)
- Depending on the type of display can be choose ‘common
Anode’ or ‘common cathode’.
Use the Analog I/O
Sliders
- There are currently 3 present sliders that can be separately coupled to each of the
six analog inputs A0…A5 (value of 0 <-> 1023)
- The analog value can be read on the simulator.
- There is a text box for comments.
- The combobox change into yellow after
selection.
Sound detector
- The sound detector may be coupled to one of the 6 analog inputs A0…A5 (value of 0
<-> 1023), The combobox change into yellow after selection.
- This detector records no sound just responding to a noise level adjustable with the
slider.
- Once the recording is started it will be nothing more to serve on the screen
because it is continuously listened to the microphone.
- When the noise level is exceeded, the progress bar will show the noise level in
percent.
- Once detection has addressed this value is (value of 0 <-> 1023) sent to the Arduino,
which can also be read on the simulator.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
The analog Outputs
Slider/Bar
- There are 2 analogue outputs which first met slider and one filled progress bar
- Both of these outputs can be coupled separately to one of each analog output 6
PWM 3, 5, 6, 9, 10 and 11 (value of 0 <-> 1023)
- The combobox change into pink after selection.
- There is a text box for comments.
- The analog output can be read on the simulator.
Sound generator
- The sound generator can be coupled to one of the 6 analog outputs PWM 3, 5, 6, 9,
10 and 11
(value of 0 <-> 1023)
- The combobox change into pink after selection.
- There is a text box for comments.
- The analog output of the Arduino can be read on the simulator.
Servo
- The servo is automatically connecting to the output D12 after pressing on the
button.
- There is a text box for comments.
- On the big screen we can see the analog output value (servo mode) from the
Arduino UNO.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
LCD display
- The display connects automatically to the outputs D4-
7 and D11, D12
- The display has 2 rows and functions almost like the
real display.
Attention:
The difference with the real display is the bottom row starts from right to left, this
one should keep in mind during programming. It’s also not possible to separately
control the pixels.
Tone Melody
- The Tone Melody will automatically connection to the output D8.
- Through the Arduino UNO can send a note to the MAC which one can read the
frequency and duration. You can use this for
example in order to create a mini piano by means
of the 8 input buttons.
Squarewave generator
- The squarewave generator can connect to one of the 6 inputs A0 – A5, this in-
puts (A0 – A5) need to declared in a digital input. The Analog pins can be used
as Digital pins, they got the configuration: A0 = D14, A1 = D15, …
- The squarewave generator can make a squarewave with a frequency of 0,1 to
10Hz.
- Attention: The instruction for the squarewave generator is DigitalRead().
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
A few things while preparing the Arduino program
Always upload the sketch to the Arduino UNO.
if the simulator is connected with the Arduino you can’t upload the Arduino pro-
gram. We made a tool 'Disconnect' which closes the connection with the serial port
of the simulator so that you can upload the sketch to the Arduino.
The great advantage of this is that we don’t need to shut down the Simulator
whenever we want to upload the sketch simulator.
After downloading the simulator, we connect again with the serial port and we ini-
tialize the I/O.
Disconnect serial port Choose serial port
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Save and Restore of settings
With “Save” you can save your selected I/O and dictated texts.
the “Restore” button restores the settings to make it easy to use.
We can save the filename of the extension with *.sav or *.txt.
You find the ‘Save and Restore’ function under “File”.
Save Restore
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Screen resolution
We have 6 options:
- 13 inch MacBook pro size
- Resolution: 1024 x 768
- Resolution: 1336 x 768
- Resolution: 1920 x 1080
- Full Screen (iMac)
- Variable resolution (min: 500, max: 2000)
Languages
You can choose the languages: Dutch or English.
Arduino Simulator 1.5 MacOS
Xevro User’s manual installation guide 2018
Working serial message
Everything goes through serial communication (USB) between the Arduino UNO and the
Mac.
The BaudRate and serial port of the Arduino UNO and the simulator should be identical, if
not they can’t connect to each other.
To send and receive data we need to make a type of protocol/structure so that the Mac
and Arduino UNO understand each other. The following protocols are bin used in the
Simulator.
Examples Structure serial message between the Arduino UNO and the Arduino
Simulator (java)
2. Receive digital input 1. (I00…13) Send Analog output Servo.
Forehead: I00 Forehead: S12
Data: "0000" or "1111" Data: 0 - 1023
End of message: LF End of message: LF
3. Send digital output 1. (O00…13) Send Analog PWM output 1. (P03…5,6,9,10,11)
Forehead: O00 Forehead: P03
Data: "0000" of "1111" Data: 0 - 1023
End of message: LF End of message: LF
4. Receive Analog input 1. (A00…5)
Forehead: A00
Data: 0 - 1023
End of message: LF
5. Sending Frequency Tone. (TF8)
Forehead: TF8
Data: 0 - 99999 (Hz)
End of message: LF
6. Sending Tone duration. (TT8)
Forehead: TT8
Data: 0 - 99999 (ms)
End of message: LF
7. Sending text. (txt) LCD 2 rows
Forehead: txt
Data: 0 - 31 (char)
End of message: LF
8. Sending text. (tx1) LCD top row
Forehead: tx1
Data: 0 -15 (char)
End of message: LF
9. Sending text. (tx2) LCD lower row
Forehead: tx2
Data: 0 - 15 (char)
End of message: LF
Arduino Simulator 1.5 MacOS