Basic applications


Who uses AVG (or other similar antivirus) mayAntivirus2.gif (400× 400)well be false alarms.

Do not use commercial antivirus, cause unnecessary worries and then let the real virus. Read this page.

Our advice is to only use Defender, I have never betrayed.

In the case of false positives check the wires downloaded using a service online, for example this: HTTPS://www.virustotal.com/it

The virustotal service go about 60 antivirus and it is quite normal that one or two of them may be wrong. But if there are 58 or 59 which give a positive result you can trust. Who just don't trust can explore the source and recompile them himself on his computer. Anyway do not worry, We have better things to do than write viruses.


HAL – Hardware Abstraction Layer

Theremino HAL

The HAL connects the hardware of InOut with high-level software via USB and Slots

If you use the USB hardware modules, then the HAL is indispensable and must remain powered on, You can minimize it, but must remain in operation.

If you do not use USB hardware, then the HAL is not necessary, System applications can communicate with each other, through the slots, even without HAL.

The application HAL standardizes the sensor data in a range of easily usable and provides testing and debugging graphic (Oscilloscope).

HAL cap keys with velocity - Theremino System

Tips for getting started: The application “Theremino_HAL.exe”, does not require installation and can be run in any folder on your system – Double clicking on a line opens the window graphic that shows the progress of the signal on that line – With a single click on a line and clicking on another line you can see them at the same time – All spin boxes are editable using the keyboard, with the mouse up/down, with the mouse wheel and with the arrows up and down – Finally, during the tests, It is very convenient to change the values in the column “Value” with the mouse (Press the left button on a column number “Value”, hold it down and move the mouse up and down)
Transient errors caused by surges on Input pins: Sometimes, touching the pins with your fingers, the HAL program stops communicating with hardware, writes a red line with the message "disconnected" and you have to press "Recognize". This will occur if the body is charged with static electricity and emits a small electric shock. All components are carefully chosen and never break, But even if you don't see the spark, It's always tension of many thousands of Volts, who send haywire temporarily serial communication and USB port. During the tests we take special care to handle forms only from off, or touch before the mass (for example the USB connector). The final project should always provide an insulated container that prevents users from touching metal parts under voltage.

– – – – – –

Release notes for Http://www.theremino.com/downloads/foundations

Notes for previous versions (from 2.0 the 7.4) collected in files:
OldVersions_ITA.rtf
OldVersions_ENG.rtf
Version 7.5
– Adding zero calibration at startup.
– Correct label MinValue MaxValue and others to change language
– Deleted configuration error Adc24 Pins in the absence
– If you try to edit a SlotNames file does not exist it is created
– Trimming the value by clicking on each point of the line of the Pin
– The name of the slot (If there is) shows the details of the Pin
– After “Edit configuration” the configuration is reloaded correctly

Attention: The first Master (with firmware from 1.0 to 2.0) do not work with latest HAL.

The latest versions of HAL can be used with the firmware from 1.0 to 2.0, are as follows:
Theremino_HAL_V4.6.zip
Theremino_HAL_V4.6_WithSources.zip

If you have still the Master with older versions of firmware can send them back to Lello (lello@thereminoshop.com), that free upgrades them to version 5.


Downloads by Theremino HAL – Version 7.5
Theremino_HAL_V 7.5
Theremino_HAL_V 7.5 _WithSources (for programmers)

Theremino_HAL_CSharp_V 7.5 _WithSources (C # programming)
For all systems from Windows XP to Windows 10, both 32 which in 64 bit (Linux and OSX with Wine)

The C # version facilitates the “Porting”, towards Android and Mac, who prefer the C-Like syntax. This version, It works just like the original. For normal use, However, we recommend that you not use it, Since it is less tested and slightly less efficient, because of the harder string handling, C-Like languages.

– – – – – –

Update your applications with the latest version of HAL

Many applications using the HAL, for example Theremino CNC and Theremino Dolfrang, may contain older versions of HAL. These applications can continue to use the older version with no problems. But if you want to update them with the latest version of HAL you can do it easily. You just have to be careful not to cover even their own configuration file.

How to update applications that contain an earlier version of HAL:
– Download the zip version of HAL.
– Open the folder of your application to update.
– Find the location of the file "Theremino_HAL.exe" with its "Docs" folder.
– Replace the file "Theremino_HAL.exe" and "Docs" with all the files in the ZIP.

The file "Theremino_HAL_ConfigDatabase.txt" and "SlotNames.txt" should not be replaced because they contain their own configurations.

Those who want to use Visual Studio to inspect, modify and rebuild the application, should also replace all files in the folder “Sources”.

– – – – – –

Downloading books in ODT format
Those who know these languages, could open the file in Open Office, fix them and send them to us. For other languages, you can take the file and have it translated to English: onlinedoctranslator that is great, a breeze and respects the formatting.

ThereminoHAL_Documentation_ENG_ITA_ESP_JPN


ArduHAL – Use Arduino modules instead of the Master

Theremino ArduHAL

The ArduHAL application allows you to easily use the Arduino modules. All types of the most common Input Output are ready. Why you should not schedule, just configure the inputs and outputs and suffered the direct link between the software on the PC and the sensors.

Arduino Nano

The Arduino, using the ArduHAL application, can use the over one hundred applications System theremino, all free and Open Source, to read the data and control outputs. By generators Oscilloscopes, the thermostats, musical applications, the games, etc..

In order to know quickly the characteristics of ArduHAL read This article. Otherwise, read the documentation that you download below.

ATTENTION : We use Arduino modules as output for PC input devices. Then the credits that we do not have a judgment about Arduino but apply only in this particular area of use, read this post .

Arduino modules that work best (in the particular way in which we use them ourselves) are the Arduino Nano with chip CH340. The CH340 chip is on the bottom of the Nano and recognize it because it has many fewer pins of FT232 (16 PIN against 28).

From version 1.4 by ArduHAL you can also use the Arduino with the FT232 chip but the frequency of communication is a 30% bottom, because they can be used in multithread. Read page eight of the file “Theremino_ArduHAL_Help”


Download documentation
Theremino_ArduHAL_Help_ITA.pdf
Theremino_ArduHAL_Help_ENG.pdf
Theremino_ArduHAL_Reading_I2C_Sensors_ITA.pdf
Theremino_ArduHAL_Reading_I2C_Sensors_ENG.pdf

Original documentation file in ODT format
ArduHAL_Docs_ODT.zip


Notes for versions of ArduHAL
Version 1.1 – This is the first published version.
Versions 1.2 and 1.3 – Small fixes
Version 1.4 – The ways “Async and “Polling” are easily selectable from ArduHAL application without having to change the firmware and recompile it. The way “Polling” allows you to use all sorts of Arduino with the FT232 chip.

Download the application Theremino ArduHAL Version 1.4
Theremino_ArduHAL_V 1.4
Theremino_ArduHAL_V _WithSources 1.4 (for programmers)
For all systems from Windows XP to Windows 10, both 32 which in 64 bit (Linux and OSX with Wine)


Notes for versions of the Arduino library
Version 1.0 – To set the asynchronously was need to edit the file “Theremino.CPP”
Version 1.1 – To set the asynchronously just add the call to setAsyncMode in the file “.INO”. – Read the comments on asynchronously in the README file located in “libraries/Theremino/src”
Version 1.2 – Asynchronously speed has increased to over 200 exchanges per second. Servo signals stability now is perfect even if you use the asynchronously.
Version 1.3 – The functions GenericRead16 and GenericRead24 do not interrupt the output through reinsertion. Some variables are now declared “volatile” and this could, in some cases, increase the stability of operation.
Version 1.4 – The ways “Async and “Polling” are easily selectable from ArduHAL application without having to change the firmware and recompile it. The way “Polling” allows you to use all sorts of Arduino with the FT232 chip.
Replace the library with a new version
– Browse to the location of the Arduino library folder with the menu “File / Settings”.
– Close the Arduino IDE
– Open the library folder and delete the folder Theremino
– Extract from the zip file to the folder Theremino and copy it to the Arduino library folder.
– Reopen the Arduino IDE

Arduino library – Version 1.4
ArduinoLibrary_Theremino_V1.4.zip (read the documentation of ArduHAL)


NetHAL – Communicate by radio with NetModule

Theremino NetHAL

The NetHAL connects the NetModule high-level software, via WiFi and network.

Open chance not achievable with the Master, for example, place a room at ions or a hard-to-reach locations with geiger in a signal cable. Or build vehicles controlled via Wifi, as seen in the video Mars mission.

– – – – – – –

The design of the PCB of NetModule, It also includes 3D images and diagrams of the NetModule and WemosD1 mini, I download it with this link:
NetModuleV1.zip

– – – – – – –

– ATTENTION –
If you use a form Wemos D1 mini, without the printed circuit of NetModule,
You must add a resistor from 4.7 k between D0 and mass,
otherwise the form would take place always SoftAP.

– ATTENTION –
Our firmware has no relation with what is on the net
for the ESP8266 (NodeMcu, LUA, Arduino, Zbasic, Python and the like).
We wrote from scratch the firmware according to the manufacturer's specifications ExpressIf,
so all you read on the net about the ESP8266 is useless and misleading.

– ATTENTION –
If the module connects, but it does not appear in the lists of NetHAL and NetModuleProgrammer,
or the operating system does not create a COM port when you connect it to the USB port,
follow the advice of the last page of the document Theremino_NetHAL_Help_ITA.pdf
(the document must be at least 26 January 2018
otherwise reset your browser's cache and riscaricatelo)

– – – – – – –

Special thanks to Fabrizio,
without him all this would not have been possible.

– – – – – – –

The firmware and software are finished and operating at 100%. The documentation is nearly complete and the hardware components are already available on eBay and thereminoshop.

Prakash thereminoshop can supply the modules already programmed and can help make them run in all ways (Softap, Station DHCP and Static Station) .
http://www.thereminoshop.com
lello@thereminoshop.com


The documentation is nearly complete, pubblicheremo ancora un file di aiuto per chi avesse difficoltà con il Firewall.

Theremino System - Download documentation (01-02-2018)
Theremino_NetHAL_Help_ITA.pdf
Theremino_NetModuleFeatures_ITA.pdf
Theremino_NetModuleProgrammer_Help_ITA.pdf

Theremino_NetModule_UsbProgramming_ITA.PDF
(to download the latest versions may need to clear your Browser's cache)

Theremino System - Documentation files download (01-02-2018)
Theremino_NetHAL_Help_ENG.pdf
Theremino_NetModuleFeatures_ENG.pdf
Theremino_NetModuleProgrammer_Help_ENG.pdf

Theremino_NetModule_UsbProgramming_ENG.pdf
(to download the last versions sometimes could be necessary to clear the browser cache)

Theremino System -Theremino System - Original documents in ODT format (01-02-2018)
Theremino_NetModules_Docs.zip


Notes for versions of the NetHAL
Version 1.0 – This was the first published version, still lacked the ability to use static IP and to program the firmware via radio..
Version 1.3 – Fixed IP, DHCP, AP software and firmware programming via radio. Fully functional. Just missing the documentation.
Version 1.4 – In some cases the forms were listed twice, resulting error messages (as you can see in this picture). The version 1.4 delete this problem.
Version 1.5 – The names that appear in the Firewall now begin with Theremino and so it's easier to find them. Those who have already used earlier versions might find the old names in your firewall, for example, “Hardware Abstraction Layer for NET and INTERNET” in place of “Theremino NetHAL”. The only way to convince Windows to use the new names is open RegEdit, look for the old string and delete it.

Download the application Theremino NetHAL Version 1.5
Theremino_NetHAL_V 1.5
Theremino_NetHAL_V 1.5 _WithSources (for programmers)

For all systems from Windows XP to Windows 10, both 32 which in 64 bit (Linux and OSX with Wine)


Notes for versions of NetModule programmer:
Version 1.0 – Fully functional. It also contains the files to be used with the USB programmer for the first programming (at the factory). Just missing the documentation.
Version 1.1 – The names that appear in the Firewall now begin with Theremino and so it's easier to find them. Those who have already used earlier versions might find the old names in your firewall, for example, “Hardware Abstraction Layer for NET and INTERNET” in place of “Theremino NetHAL”. The only way to convince Windows to use the new names is open RegEdit, look for the old string and delete it.

Download the application Theremino NetModuleProgrammer Version 1.1
Theremino_NetModuleProgrammer_V 1.1
Theremino_NetModuleProgrammer_V 1.1 _WithSources (for programmers)

For all systems from Windows XP to Windows 10, both 32 which in 64 bit (Linux and OSX with Wine)


This firmware does not need to use the NetModule – Don't download it –
Might be useful only to those who think to improve our implementation. Who is going to be present to do so should also consider that any changes must be coordinated with the NetHAL application and documentation.

Download source code to recompile the firmware to Wemos D1 mini and compatible
MasterESP8266 (0.14B1).zip


The file SlotNames.txt

Theremino HAL With Notes Theremino SlotViewer With Notes

The application HAL (from version 5.5 onwards) and the SlotViewer (from version 2.6 onwards), can also display the name of the Slot (or annotations or comments).

The names are written in a file, that should be called “SlotNames.txt” and that must be in the same folder as “Theremino_HAL.exe” and “Theremino_SlotViewer.exe”. If the file “SlotNames.txt” There is no comment field will remain empty.

The file “SlotNames.txt” you edit with NotePad or WordPad. The posting rules are simple and are shown in the sample, located in the latest versions of HAL and SlotViewer.

Important to note that the names are not related to physical Pin, but the slots.

Each line of the file begins with the number of Slots, followed by a space and the text to be displayed. The line can also continue with a comment, that does not appear, preceded by a single quote.

If you want to use the same file of comments, both HAL and the SlotViewer, you have to keep the files “SlotNames.txt”, “SlotViewer.exe” and “HAL.exe”, all in the same folder.


Application modularity

The modular design of the software of the system Theremino you get, in an unconventional way, with running many applications. Each application handles only tasks for which it was designed and runs as smoothly as possible. In this way applications can be simple, efficient and with fewer defects. System Theremino many simple applications communicate with each other and work together to perform complex tasks.

Depending on your needs you can use two different methods:
– Isolated applications
– Groups of isolated applications

This does not mean that isolated applications cannot communicate with other. Modular communication is always possible and is done through the slots, that are shared for all applications.

To avoid using the same slot for different tasks we defined a main diagram.

Experimental 100 slots     000 - 099
- - -
Theremino_Theremin         100 - 199
Theremino_SlotsToMidi      200 - 349
Theremino_MidiToSlots      350 - 499
Theremino_MusicKeys        500 - 549
- - -
250 free slots             550 - 799
- - -
Theremino_OilMeter         800 - 809
Theremino_EEG              810 - 819
Theremino_Meteo            820 - 839
Theremino_Arm              840 - 849
10 free slots              850 - 859
10 free slots              860 - 869
10 free slots              870 - 879
Theremino_EmotionMeter     880 - 889
Theremino_geiger           900 - 909
Theremino_Bridge           900 - 909
Theremino_GEO              910 - 919
Theremino_GeoPreampTester  920 - 929
Theremino_Radar            930 - 939
10 free slots              940 - 949
10 free slots              950 - 959
10 free slots              960 - 969
10 free slots              970 - 979
10 free slots              980 - 989
10 free slots              990 - 999
This scheme is only indicative. You can use the slots as desired, just the same PC do not use the same slot, for two different tasks. If you get it wrong it doesn't break anything, but data overlap with undefined results.


Isolated applications with private HAL

Some applications of the system Theremino launch a private copy of HAL, located in the same folder of the application. These private and HAL have settings and configurations, generally, are locked with key “Master Locks” so it must be connected only to their hardware modules. For more information read the instructions of HAL.

The applications for this configuration are applications with a precise task, such as: Theremino_geiger, Theremino_OilMeter, Theremino_Meteo, Theremino_Theremin, Theremino_Arm, Theremino_Geo and Theremino_EmotionMeter.


Application groups with Theremino Starter

The Theremino Starter start all applications with name “Theremino_xxx.exe” subfolders that are located at the side of the file “Start_ALL_Theremino_Apps.vbs”.

To build a “application group” It begins with a root folder (with the name of the project that you are creating) Inside the main folder, each application should have its own specific folder containing the executable, supporting files and subfolders. If you use multiple copies of the same application is good to add a final number folder names. As shown in the following example:

Folder: "Multiplayer"

      Folder: "ThereminoSoundPlayer_1"
            Folder: "Media"
            Application: "Theremino_SoundPlayer.exe"

      Folder: "ThereminoSoundPlayer_2"
            Folder: "Media"
            Application: "Theremino_SoundPlayer.exe"

      Folder: "ThereminoVideoPlayer_1"
            Folder: "Media"
            Folder: "Media2"
            Application: "Theremino_VideoPlayer.exe"

      Folder: "Http://www.theremino.com/downloads/foundations"
            Application: "Theremino_Hal.exe"
            File: "Theremino_HAL_ConfigDatabase.txt"
            File: "Theremino_HAL_INI.txt"

      Folder: "Theremino_Helper"
            File: "CustomControlsLib.dll"
            Application: "Theremino_Helper.exe"

      File: "Start_ALL_Theremino_Apps.vbs"

Groups of applications like this can also contain dozens of applications. When placed in separate folders, each application maintains its own settings, and even the window positions independently. You can even create multiple groups of applications and run them all at once, maintaining an adequate separation between applications and ensuring that each application communicates only with its sensors and its actuators. But at the same time you can also make them communicate all, or in groups, between them. To communicate using the slots, Learn how to make good use of the slots is critical.

The little script “Start_ALL_Theremino_Apps” deals to launch all the applications of a group with just one click. We recommend that you create a shortcut to this on your desktop “Starter”.

The current version (updated on 18-07-2017) contains a small improvement. If the file name contains “obj” or “vshost” the file does not start. This allows you to use full versions of projects, avoiding intermediate files accidentally start, that Visual Studio uses when compiling.

Theremino Starter
Start_ALL_Theremino_Apps
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.


Theremino SlotViewer

Theremino SlotViewer a simple and handy slot explorer and editor.

The slots are the heart's modular system Theremino. It is often convenient to keep an eye on their value or edit it manually. This small “Explorer of slots” is very flexible, can see the slots in various ways and dimensions, vertically or horizontally and with the color scheme of your choice.

Theremino SlotViewer a simple and handy slot explorer and editor. Theremino SlotViewer a simple and handy slot explorer and editor.

Theremino SlotViewer a simple and handy slot explorer and editor. Theremino SlotViewer a simple and handy slot explorer and editor. Theremino SlotViewer a simple and handy slot explorer and editor.

You can view groups of any number of slots, even by selecting from different areas. You can edit the values with the mouse, arrow keys, PageUp, PageDown method. The CTRL and SHIFT keys allow you to change the values faster and you can also use the mouse wheel.

Notes for versions
Version 1.6:
In earlier versions the slot adjustment with keyboard arrows did not work well, now is in place.
Version 1.7: Changing “NUM slots” Sometimes it appeared a small white box, now no longer happens.
Version 1.8: Fixed small defects were born during the transition from XP to Windows7.
Version 1.9: Changes to work with Mono on Linux.
Version 2.0: Significant reduction in the consumption of CPU in order to facilitate the operation on Raspberry Pi.
Version 2.1: Changes for a better operation with multiple instances.
Version 2.3: Improved overall functioning and visibility of written. Now you can set the minimum and maximum (which were previously fixed at zero and a thousand). You can also use intervals with negative numbers (for example, from -1000 to +1000), or very small intervals (from zero to one), or very large (from – 100 000 to +100 000).
Version 2.4: Correct the size even on systems with font size changed both 125% which in 150%.
Version 2.5: Correct inaccuracies in the setting with the mouse and eliminated the flashes on startup. This version contains the new class “Slots”. New option to fine tune and quickly, with the up and down arrows, in combination with the ALT, SHIFT and CTRL.
Version 2.6: By popular demand we have also implemented the comments. For instructions read HERE.
Version 2.7: The “CustomControlsLib.DLL” has become part of the sources, so there is a problem at least for Linux and MacOsx.
Version 2.8: Improved alignment of comments.
Version 2.9: Added the display of non-message number “NAN_MasterError”. This is a mechanism that allows applications to automate guarantee that all masters are in operation. In case of malfunction or disconnection of one of Master the HAL issues a “NAN_MasterError” zero slot.

Downloads from Theremino SlotViewer – Version 2.9
Theremino_SlotViewer_V 2.9

Theremino_SlotViewer_V 2.9 _WithSources
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.


Theremino SignalScope

Theremino SignalScope

When the simple viewer of Http://www.theremino.com/downloads/foundations is not enough you can use this Signal Scope.

Attention: This is not an oscilloscope but Slot signals Viewer, they have a maximum resolution of a millisecond and then a maximum bandwidth (theoretical) by 500 Hz. In practice, however, the phenomenon of aliasing limit the range of frequencies to 100 Hz or so. If you want a true oscilloscope with 22 KHz of bandwidth and 192 KHz sampling download “Theremino DAA” from this page.

Features:

  • Storage of signals of two slots for the last 30 minutes maximum resolution.
  • Ability to scroll backward signals (Delta time) to locate and zoom in on particular events.
  • Two adjustable sliders with the mouse to measure widths, times and frequencies.
  • Both the sliders that the delta time can be adjusted with the mouse and also with the TouchScreen.
  • Continuous display of instantaneous values and peak-to-peak in the status bar.
  • Ability to save and restore the event buffer.
  • Ability to save images for documentation.
  • Storing all functions and restore on reboot.
  • Possibility to program the stop sampling after a number of events have occurred, by setting a threshold value and a counter.

Recommendations:

  • Enable “Trigger” only for fast repetitive signals, otherwise the display is very slow.
  • Keep “Delta Time” zero if not in use, otherwise the signals do not appear immediately but only after the milliseconds set.
  • Keep “Stop If” disabled if not in use, otherwise, sampling could stop unintentionally.
  • Edit the file “Slot names” to give a meaningful name to its Slot.
  • Copy the executable executable ’ ’ this application next to dell ’ HAL and Viewer share the same Slot “Slot Names”.

Notes for versions
Version 1.2:
This is the first published version.
Version 1.3: When the slot names Panel is visible only if space allows.
Version 1.4: The parameter “Delta” is reset each time you press “RUN” so you don't forget.
Version 1.5: Deleted the error in closing if the folder was missing “Buffers”.
Version 1.6: Deleted the error in closing if the RUN time was greater than the length of the buffer that stores the data. Extended storage buffer 24 hours. Beware that with very long buffer time to save loading can be quite long.
Version 1.7
If cursors are enabled then is saved only the area between the two sliders.

The Trigger is greatly improved.
Deletes a waveform instability happening randomly.
The buffer is again limited to 1 now (for log Logger applications are used).
Save and load buffer takes at most 2 seconds.
The DeltaTime be changed quickly using CTRL and SHIFT + Mouse.
Version 1.8
Deleted error with very large input values.

Downloads Theremino SignalScope – Version 1.8
Theremino_SignalScope_V 1.8

Theremino_SignalScope_V 1.8 _WithSources
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.


Easy access to slots with: “WriteSlot” and “ReadSlot”

To communicate with the Slots you call functions: “WriteSlot” and “ReadSlot” and their initialization functions.

Download: A very simple application to make the first experiments, you download from here:
http://www.theremino.com/downloads/notes-on-software#emptyapp

Download: Module_MemoryMappedFiles_VbNet_CSharp_Python_Pascal_VB6.zip
This file contains modules for VbNet, CSharp, Python, Pascal and VB6, for C++ refer to the examples of MemoryMappedFiles of the next section. If you need practical examples, almost all applications in the system Theremino using the functions WriteSlot and ReadSlot.

Download: Class_ThereminoSlots_VbNet_CSharp.zip
This is the new class to access the slots. This class is better than previous forms “Memorymappedfiles”, and will gradually be included, in all new versions of our applications. Includes only those versions VbNet and CSharp, then those who use other languages, must get by a little, and make a mix with previous versions. This class does not require initialization, you initialize alone when it instantiates an object Slots. Functions for accessing slots have become Slots Write() and Slots Read(). This class also includes the functions to create and compare numbers signaling NAN (operation that everyone said was impossible, We have searched the web for years and eventually the solution we had to invent from scratch)


Interprocess Communications and
Memorymappedfiles

Communication via SLOT is based on the MemoryMappedFiles (Windows) and the SharedMemory (Linux). These examples explain how they work with data of all kinds.

For simple communication with the slots on the system Theremino, don't use these examples, but the more practical WriteSlot and ReadSlot, the previous chapter.

These examples also show how to use strings, integers, float in 64 bit arrays that are not needed to communicate with the system Theremino, but it might be useful to communicate efficiently (a few microseconds for each transfer) several programs created by users, even in languages different from each other.

The source code in C++, CSharp, VBNET and VB6, may be useful to non-Windows systems experts to do translations and experiments in various versions of Linux and Mac.

We recommend that you start the tests by launching multiple versions of these programs in different languages, or even all in the same language, and communication experiments by writing strings and numbers, sending them with and receiving them with GET

Communications in system Theremino, use numbers only “Single” (floating point in 32 bit), in positions 0 to 1000 (offset from 0 to 4000), the MemoryMappedFile with name Theremino1. Communication between applications, could also use files with different names from Theremino1 and not engage the slots on the system Theremino.

Download
Theremino_MemoryMappedFiles_V 1.2
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.


Software to communicate with Max/MSP

These are examples of bi-directional communication between the slots on the system Theremino and Max/MSP

Interactive help for Max/MSP version 4. x


Interactive help for Max/MSP version 5. x

Using a MXE (External module for MAX) you get extremely fast communication (direct calls to a DLL – a few microseconds for each transfer)
Note that through the slots on the system Theremino multiple patches in Max/MSP can communicate with each other very efficiently this possibility might be useful to the makers of complex systems that, currently, for communication between Patches only have much slower methods. (We're not big experts from Max so if anyone knows other efficient methods we communicate and we will correct these notes)


Max Install
In this file all you need to communicate between Max/MSP with the slots and the MemoryMappedFiles system Theremino.

Theremino_Max_Installer_V 1.0
Theremino_Max_Sources_V 1.0 (version for programmers)

Using these sources you can recompile the patch Theremino.mxe. With the necessary changes, It should be possible also interface with PureData and similar programs (VVVV, Processing, Eyesweb, etc…)

For Linux and MAC this project should be changed both in the MemoryMappedFiles and in how to install the files in the folders of Max/MSP.


Software to communicate via UDP with OSC messages

This is an example of bi-directional communication between the slots on the system Theremino and the environment Max/MSP with the Open Sound Control Protocol

Help UDP communication interactive – OSC for Max/MSP version 5. x

This example shows a Max/MSP Patch that sends on UDP port 7401 the request slot values 0 and 56, receives UDP port 7400 and shows them with two VU-Meters.

The Theremino_OSC application receives requests UDP port 7401 and sends the values of slots on UDP port 7400

Application that implements access to slots system Theremino via UDP with OSC messages



On the right side of the sample Patch view, with a similar proceeding, How to write numeric values into the slots of the system Theremino.

Communication options via UDP
OSC Protocol over UDP is slower compared to the previous method (with the DLL “External” by MAX, call MXE) but allows for a much more flexible communication, both on the local network or through the Internet

Through our Slots, ThereminoOSC, Max/MSP, Processing and PureData you can connect seemingly incompatible hardware and operating systems in an easy and immediate. Without writing a single line of code.

With a little experience in programming, you can also change our examples (all freeware and with complete sources) Our software is all written in an extremely simple and modular so you can be a base for the development of applications with special requirements.

Theremino OSC V 1.5 and sample Patch for Max/MSP
Theremino_OSC_V 1.5
Theremino_OSC_V 1.5 _WithSources
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.


Theremino Script


Theremino Script allows you to write small programs in VbNet or CSharp without installing VisualStudio.

The communication features and MemoryMappedFiles (Interprocess Communication) are implemented at the system level, so just write WriteSlot and ReadSlot to communicate efficiently (a few micro seconds) with the slots on the system Theremino.

The language is compiled and relies on DotNet for which execution is very fast (from our trials VbNet is faster than CSharp and C++), VbNet also has a set of mathematical functions and graphics absolutely complete.

Compiled programs are usable even without Theremino_Script and can be deployed as a regular file “EXE”.

The Theremino_Script is a little’ the younger son of Microsoft Visual Studio Express but it doesn't go quite as well, is slower, contain certainly more bugs and glitches and doesn't have the Visual editor of forms, for which the program you write everything in text. The only advantages are that you should not install Visual Studio Express and write a few lines looks, at the beginning, easier.

We recommend to use the real Visual Studio that you download from here: downloads/notes-on-software # instruments. Visual Studio allows you to easily continue even when programs become large. But many users have asked for an easy way to access to slots, System Theremino, to write things like “I turn on an led – I look forward to 10 seconds – I turn off the led”. So we tried to simplify and hide every complication. It is said that this route is valid, try it and let us know how you are.

If you are not comfortable with Theremino Script and you don't want to use Visual Studio, then another good solution, Max/Msp environments could be, PureData and Processing.

A language even simpler?
Theremino Automation: downloads/automation

Translate the examples to VbNet in C #
– From one of the examples in C # running
– Give it a new name and save it
– Take (with copy and paste) VbNet functions which you are interested
(even more features, but be careful controls and events, they are mistranslated)
– Translate with this utility: http://www.carlosag.net/Tools/CodeTranslator
– Or with this: http://www.developerfusion.com/tools/convert/vb-to-csharp
– And finally paste the translated code in C # application

Notes for versions
Version 2.1:
First version of Theremino_Script with access to integrated SLOT.

Version 2.2: Improved suggestions (IntelliSense) they now have more choices.– The tips are selected by clicking on the list with a double mouse click.– Editing is easier and faster.– No longer happens accidentally choose work from list of suggestions.– Added a sample that simulates the clicks of a Geiger with variable frequency, useful to try the program Theremino_Geiger.
Version 2.3: The mouse wheel now scrolls so decent, fast and progressive.– Added an example that flashes an LED connected to “Slot 1”, useful for those who make their first steps with the slots, the Master and the Hal program.
Version 2.4:
– Complete access to slots is in VB which in c #
The functions you call to access the slots are:
— WriteSlot(Slot, Value)
— ReadSlot(Slot)
— ReadSlot_WithNans(Slot)
– In VB calling MemoryMappedFile_Init is no longer needed (If you call does not give error).
– In c # all
the MemoryMappedFile initialization is no longer needed. You must delete all the rows in the initialization block, otherwise give errors.
– In c # the main class should no longer be called “class Script” but “partial class Script”
– CSharp lovers and for those who were accustomed to Arduino, We added the examples: Example1, Example2, Example3 Example4 and. These examples explain how to add buttons and text boxes and how to use their property and their events.
Version 2.5: Added the example “Temp Meter” in the folder “Theremino SLOT Examples”. Here he is seen as a function: https://www.youtube.com/watch?v=0erUqTAiixs
Version 2.6: Fixed many small defects were born during the transition from XP to Windows-7/8.
Version 2.7:
Added the menu “Files” “Open application folder”
The FileOpen dialog box in addition to opening the Vb and C # can also launch executable files.
The FileOpen dialog box are also permitted multiple selections, comfortable for moving and copying files.
The FileOpen dialog box does not create more problems in the case of multiple ThereminoScript in different folders.
Open the File menu now also contains the MOST RECENTLY USED list, with the recently used files.
Added the current language in Google searches, Bing and MSDN
SaveAs Panel full path made it hard to change the name, Now you see the name of the file without path.
The basic keywords are automatically converted, with uppercase and lowercase letters.
Version 2.8: Fixed small bugs and added many sample scripts.

Theremino Script downloads – Version 2.9
Theremino_Script_V 2.9

Theremino_Script_V 2.9 _WithSources (version for programmers)
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.


Theremino Office

Theremino Slots To Office

Many know Excel and know how to use VBA (Visual Basic for Applications). You can write and read the Slot from VBA paves the way towards the economic management of sensors and actuators. Just a Master module that you can also build in DIY and you will get the same results that in the past required expensive National systems, MATHLAB or similar.

But most of all those who know VBA will appreciate the simplicity of this implementation, There are only two features, easy to remember, “WriteSlot” and “ReadSlot”. With these two functions accessing sensors, move servo motors, driving relays and Excel charts move externally controlled in real time.

The communication speed is great, to write or read a Slot with Libre Office and Open Office only takes 70 uS, While with Microsoft Office on your own or. 3 uS. This speed can actually be helpful because not only charts with VBA. You can do real applications even with heavy algorithms that need maximum efficiency.


Tips for programmers

Theremino Slots To OfficeAll the magic is in the form “ThereminoSlots” that should never be edited. This module exposes the two functions “WriteSlot” and “ReadSlot” that can be used in all modules, and macros in the document.

To get that all macros of all documents can use functions “WriteSlot” and “ReadSlot”, just copy the form “ThereminoSlots” in “My macros” or in “Office macros”

If you write in a cell while the macro activates Microsoft Excel tries to stop the macro (unpleasant behavior, Libreoffice and OpenOffice do not). If the macro contains a DoEvents and calls him very often when Microsoft Excel tries to stop the macro goes in error. The solution is to call DoEvents at regular times so as to advance the UI but not too often, Let's say every 30 milliseconds.


Arduino

The system theremino connecting the Arduino modules directly with Excel (and with all the other applications System theremino). With the application ArduHAL You can read sensors, move engines or control temperatures, directly from Excel, or by other Office applications.


Download

Examples for Microsoft Office, Libre Office and Open Office:
Theremino_SlotsToOffice.zip

All the examples are in this zip file contains the module “ThereminoSlots” It is written so that we can work on Microsoft Office, Libre Office and Open Office without change even a comma.

ATTENTION – The new version of the. “ThereminoSlots” It also contains the numbers NANs that serve to communicate messages with l & #8217; HAL through the Slot zero. This version only works on Microsoft Office because on Libre Office and Open Office cannot initialize NAN numbers. Those who do not use Microsoft Office will have to do without the NAN and use the file “Theremino Slots” lying in & #8217; example “ThereminoSlots_LibreOffice_OpenOffice.ods”.

The same is not possible for samples for which we have prepared an example for LibreOffice and OpenOffice (with extension “ODS” and some examples for Microsoft Office (with extension “xlsm”).

In the ZIP file you will also find a text file with some explanations and a file “TestFunctions” with the features we've used to try the communication speed.


Theremino Buttons

This application is the fastest method provided by the system theremino to create control panels to use with your Mouse or with Touch Screen.

You don't need to know a programming language, just type the text you want to appear on the buttons and adjust some options. Everyone can quickly learn to create new buttons and text boxes. And change colors, the size and also arrange controls on one or more columns and rows.

Here are some examples of panels that can be created.

Thremino Buttons Examples

To edit the controls you hold down the CTRL key on your keyboard while you click with the left mouse button on a button or a button-free zone.

The following screen appears and its commands modify the controls, you change the text displayed, changing the colors and properties of writing and reading of the signals of the slots. You arrange your controls across multiple rows and columns, If they create new and delete.

Theremino Buttons 2.0

The version 2.0 has greatly improved. You can also manually rearrange buttons, by dragging them with the mouse or use the arrow keys to resize with SHIFT. There are new types of movement and editor also allows you to do the Undo to go back when you are wrong. To discover all the news read the instructions.


Full instructions are in the documentation files.

Documentation in Italian and English
Theremino_Buttons_ITA.pdf

Theremino_Buttons_ENG.pdf

A sample app (rotational speed for internal combustion engines)
RpmMeter_ITA.pdf
RpmMeter_ENG.pdf

A sample app (a simple Rover) — UNDER CONSTRUCTION —
Theremino_Buttons_SimpleRover_ITA.pdf
Theremino_Buttons_SimpleRover_ENG.pdf

For an example of how you can drive a Rover watch video Mars mission.
For this video we used an old Smartphone transformed into camera WiFi using the App. Ip-Cam. Paying two or three euros the inscriptions are deleted and you can use it on three phones. To use the App. IP-Cam the SIM is not required.

A sample app (BrickRobot) — NOT updated to V 2.1 —
This example shows how to compose a complete environment composed of multiple applications of the system, start them together with “Start_ALL.vbs” and close all of them, together with the middle mouse button (Thanks to the Helper application).
Theremino_Buttons_V2.0_BrickRobot.zip

In this video you can see the moving BrickRobot. Note that anyone can add buttons and servo motors. You can also easily change the movements just change the destinations in the buttons. All without programming a single line of software. http://www.theremino.com/files/BrickRobot2.mp4


Downloads of Theremino Buttons – Version 2.1
Theremino_Buttons_V2.1.zip
Theremino_Buttons_V2.1_WithSources.zip (version for programmers)

For all Windows systems to 32 and 64 bit (for Raspberry Pi, Linux, Android and OSX, read the installation notes.


Theremino SimpleLogger (with Theremino Script)

This is a sample script Theremino Script. Use it only as an example and as a test of Viewer KST. To build a data logger you should use the Theremino Logger that is found in the next chapter.

Even the less programming expertise can adapt this script to their needs. The LOG.csv file is created in the same folder that contains programs “exe”. By changing the first four lines of the file “ThereminoLogger. vb” You can vary the range of acquisition and channels to be scanned. Once edited at will, You can launch directly the compiled version “ThereminoLogger.exe”, no more having to “ThereminoScript”.

– Notes for the new version –
There are some examples of interactive viewing with KST. To use KST first of all you have to install it from the WEB and then proceed as described in the file “Readme – KST Install Notes.rtf”

We have also added the compiled versions (exe), so you should not even open Theremino Script to compile them. The three precompiled versions logging every second, ten times per second and one hundred times per second.
KST files allow you to view logs in various ways, While you are logging. They're just examples. With patience and enquiring on the WEB you can make KST every kind of view and filter. Probably you can also use the WEB to send MySql file KST. Use KST is not easy at all, is a great software and the great results you must pay with a lot of patience.
– Fix –
We moved the files to the same folder as the LOG.csv KST. It seems that KST had a defect that prevents him from reading the LOG if it is in a different folder. If you have not downloaded this latest version manually move them out close to the LOG.csv.

– – – – – –

Downloads of Theremino SimpleLogger – Version 2.0
Theremino_SimpleLogger_With_KST_Examples_V 2.0
For all Windows systems to 32 and 64 bit. For Raspberry Pi, Linux, Android and OSX, read the installation notes.

– – – – – –

Theremino SimpleLogger – Version 3.0
The script Theremino Logger is changed in version 3.0, to collect data from some weather sensors. The version 3 Converts values from 0 to 1000, in temperatures, UV index, Millivolt and Volt and you download from here:

http://www.theremino.com/hardware/inputs/meteorology-sensors#logger


Theremino Logger

Theremino Logger V 3.3

This Datalogger and simple to use but with great performance. The base, concise and intuitive, has been studied by Marco Russiani. Then we supplemented with calculations to measure resistances and temperatures, with the PT100, Pt500 and PT1000 three or four wires.

The temperature calculation from the resistance of Platinum resistors (PTxxx) is done by means of a polynomial formula, with an average absolute error of 0.015% throughout the temperature range, from -200° to +850° C.

Are also implemented the calculations for probes:

  • Lm35 – From 0° C to 150° C with an accuracy of +/-0.5° C)
  • TSIC501 – From -10° C to 60° C with an accuracy of +/-0.2° C
  • UVM-30A – UV index from 0 to 11
  • ML8511 – UV from 0 to 15 MW

For probes LM35, TSIC501, UVM-30A and ML8511 might be enough a Theremino Master. But for high precision measurements and especially for RTD (PT100 and 1000) It is good Add a Theremino Adc24.

Learn more about sensors in These paginand and in Adc24 documentation.


LSI Radio DataloggerA Datalogger controllable via radio
With the Theremino Logger on a Tablet TCU you get a system similar to these without spending thousands of dollars. The result is a complete datalogger controllable via radio, You can store data for years, consuming only 2 Watts (less than 500 but to 5 Volts). The complete system can be enclosed in a watertight container, without ever needing to open it. The radio is controlled via TeamViewer and your data is accessible on your local network, through Windows folders.


Mini Instructions

  • The Log file is written next to the executable and can be viewed with KST (as explained in the previous “Theremino Simple Logger”). Currently the only one who knows well enough KST is Marco Russiani, If you have trouble configuring it let him know.
  • The sampling interval can be very frequent (currently the maximum is 60 samples per second) but under the second you do not have a great precision and get tired enough the CPU. To reduce the work to the CPU is good to keep the application minimized.
  • Each line of LOG (also presented in the second row of the application), consists of the date, followed by the Julian date (in days and fractions) and followed by the values of the sensors are enabled. The field separator is a semicolon.
  • The line “Value” view individual sensor readings. See them in real time is useful in trials.
  • In row “Slot” you set the slots for individual sensors. These numbers must correspond to the numbers of slots that you set in the HAL.
  • In row “Type” you set the sensor type.
  • In row “Multiply” you set the multiplication factor, for fine adjustment of the gain (the slope of the calibration curve). Normally this value is “1”. See the schematic Adc24 documentation.
  • In row “Trim value” you set the factor of addition, for fine adjustment of final value (you move the calibration curve up or down).
  • The new buttons “Zero set” We are from version 3.3 onwards to the “Tara” easily. Mostly it is used for linear transducers and load cells. Using them is easy, moves the sensor in the zero position and the button is pressed.

Special notes for channels with the types “RES-3” or “Res-4” or “PTxxx”

  • With these types using two Slots.
  • The first Slot is written in the line box “Slot” (for example, 10).
  • The second Slot is the Slot following (for example, 11).
  • The first slot is the voltage value measured.
  • The second Slot is the value of the measured current divided by the current measuring resistor (normally 10 k).
  • In row “Multiply” do not set “1”, as with other sensors, but you set the value of the current measurement resistor (usually 10000).

Display data with KST

Datalogger visualization with KST Datalogger visualization with KST

KST is a great OpenSource Viewer for LOG files. View log files in real time, While they are written, as shown in This video.

KST also supports huge files and displays them and filters in every possible way. It is also very easy zoom and browse the files in the past. The perfect solution for all needs scientific logging. With patience, enquiring on the Web and possibly asking for help in Marco Russiani, You can make all kinds of visualization KST. Probably you can also use it to send files MySql on WEB. Use KST is not easy at all, is a great software and the great results you must pay with patience.


Download documentation on KST prepared by Marco Russiani
KST2_Help_for_Theremino_Logger_ENG.pdf


Theremino Logger downloads – Version 3.3
Theremino_Logger_V3.3.zip
Theremino_Logger_V3.3_WithSources.zip (version for programmers)

For all Windows systems to 32 and 64 bit (for Raspberry Pi, Linux, Android and OSX, read the installation notes.


Theremino SeriHAL V 2.2

SeriHal V 2.2

Theremino_SeriHal lets you send to slots data from a serial port and send the data to the serial port of the Slot.

Communication SLOTS <-> Serial (Real or virtual) is bi-directional and, If desired also the transmission, This can be either synchronous or asynchronous.

You can then connect to PC any Hardware or Software interface that sends and receives data through a serial port. And you can send data to and receive numerical data to one or more slots. The data can then be processed by other applications in the world Thereminico and, for example,, displayed with the SlotViewer and the SignalScope or registered with the Theremino_Logger.

By now the world thereminico can communicate not only with Arduino and Processing, But even with Octave (the poor cousin and free of MatLab), with Python and other SW still: just need load their serial plugins. Think about what you can do by managing the OpenCV computer vision functions via Python/Numpy and dialoguing with the slots Theremino-HAL and Master/Slave modules: facial recognition, mechanical/optical tracking, real-time image processing and other graphics of the highest level within the reach of (almost) all.

The instructions and the communication protocol are in the file “SeriHal_v 2.2 _eng” you will find in the folder “Docs”.

Aalso this is a brilliant application of Marco Russiani. In the DOCS folder there are two small files in Italian and English. Had nothing but Marco has recently discovered the supernova SN2017gfh. It's not every day you have a friend who has discovered a star, We had to write it!

Claudio S. deserves a special thank you, Having reviewed the documentation by adding some examples for integrated use, via serial, of various components of the world Thereminico, with each other and/or with the “the rest of the world”. In the DOCS folder there are some examples for using Arduino and also an example to check our application Theremino SDR from the outside with Arduino and Processing.
Downloads from Theremino SeriHAL – Version 2.2
Theremino_SeriHAL_V2.2_WithSources.zip
For all Windows systems to 32 and 64 bit (for Raspberry Pi, Linux, Android and OSX, read the installation notes)


Theremino Terminal

Theremino Terminal

This application allows you to Exchange characters with a serial port. Type applications “Terminal” are primarily used to communicate with the firmware of the micro-controllers, during the trial operation and when writing firmware.

During the development of the firmware of NetModule (see This page) We had to check the debug data from the micro, through the virtual serial and USB port. Initially we used applications downloaded from the internet such as “PuTTY”. But they are complex and uncomfortable. Then we wrote this application that made it so simple.

The theremino Terminal are in a single executable from 50 k, It is easy to use and requires no installation. A good example of simplicity and minimalism, What are the main features of the system theremino.

Downloads at Theremino Terminal – Version 1.1
Theremino_Terminal_V1.1.zip

Theremino_Terminal_V1.1_WithSources.zip (version for programmers)
For all Windows systems to 32 and 64 bit (for Raspberry Pi, Linux, Android and OSX, read the installation notes)

Legal notice

ITALIANO – HARDWARE: NEI LIMITI PREVISTI DALLA LEGGE il sistema Theremino VIENE FORNITO “COSÌ COM’È”, E NON RILASCIA GARANZIA ESPLICITA O IMPLICITA, RISPETTO ALLA SUA FUNZIONALITA’, OPERATIVITA’, O USO, INCLUSE, SENZA LIMITAZIONE, LE GARANZIE IMPLICITE DI COMMERCIABILITÀ, IDONEITÀ PER UNO SCOPO PARTICOLARE O VIOLAZIONE. SI DECLINANO ESPRESSAMENTE OGNI RESPONSABILITÀ PER DANNI DIRETTI, INDIRETTI, CONSEQUENZIALI, INCIDENTALI O SPECIALI, INCLUSI, SENZA LIMITAZIONI, MANCATI GUADAGNI, PERDITE DI PROFITTI, PERDITE DERIVANTI DA INTERRUZIONE DI ATTIVITA’ O PERDITE DI DATI, INDIPENDENTEMENTE DALLA FORMA DI AZIONE O TEORIA LEGALE SOTTO CUI LA RESPONSABILITA’ VIENE ASSERITA, ANCHE SE NON INFORMATI DELLA POSSIBILITA’ O RISCHIO DI TALI DANNI.
ITALIANO – SOFTWARE: IL SOFTWARE del sistema Theremino E’ UN SOFTWARE LIBERO: E’ POSSIBILE RIDISTRIBUIRLO E/O MODIFICARLO SECONDO I TERMINI DELLA LICENZA “GNU General Public License” COME PUBBLICATA DALLA “Free Software Foundation”, NELLA VERSIONE 3, O QUALSIASI VERSIONE SUCCESSIVA. È POSSIBILE OTTENERE UNA COPIA DELLA LICENZA “GNU General Public License” DA: http://www.gnu.org/licenses
ENGLISH – HARDWARE: THE PRODUCT Theremino System IS PROVIDED TO YOU “AS IT IS”, AND WE MAKE NO EXPRESS OR IMPLIED WARRANTIES WHATSOEVER WITH RESPECT TO ITS FUNCTIONALITY, OPERABILITY, OR USE, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR INFRINGEMENT. WE EXPRESSLY DISCLAIM ANY LIABILITY WHATSOEVER FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, INCIDENTAL OR SPECIAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST REVENUES, LOST PROFITS, LOSSES RESULTING FROM BUSINESS INTERRUPTION OR LOSS OF DATA, REGARDLESS OF THE FORM OF ACTION OR LEGAL THEORY UNDER WHICH THE LIABILITY MAY BE ASSERTED, EVEN IF NOT ADVISED OF THE POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.
ENGLISH – SOFTWARE: THE Theremino System SOFTWARE IS FREE SOFTWARE: YOU CAN REDISTRIBUTE IT AND/OR MODIFY IT UNDER THE TERMS OF THE “GNU General Public License” AS PUBLISHED BY THE “Free Software Foundation”, EITHER VERSION 3 OF THE LICENSE, OR ANY LATER VERSION. YOU CAN GET A COPY OF THE “GNU General Public License” FROM: http://www.gnu.org/licenses

Comments are closed.