EDIT:
*************THIS PROJECT HAS BEEN ADDED TO EZ-AI******************
This has been updated to include the latest information about this tool.
EZ-DB is a utility that will allow ARC to store and retrieve data from a database. The current databases that are supported are MySQL and MSSQL. EZ-DB can be downloaded from this site.
EZ-DB Pre-Release
The location that you place the folder doesn't matter, as long as you can connect to your ARC application. Unzip the contents of the zip file (the EZ-DB folder) to any location that you would like to have as the applications home. I haven't tested yet to see if this can run on a different computer by using the EZBuilderIP setting in the config file.
CONFIGURING THE APPLICATION
The EZ-DB.exe.config file contains the configuration settings for this application. I have stored a copy of this file in the Backup folder for you, if you make a mistake and need to recover a working version.
This is the contents of this file. As you can see, you should be running .net 4.5. Going down the list under the <appSettings> section you will see the followingCode:
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<startup>
<supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5" />
</startup>
<appSettings>
<add key="Server" value="localhost"/>
<add key="UserName" value="Robot"/>
<add key="Password" value="3Z-R0b0t"/>
<add key="Database" value="robot"/>
<add key="DBServerType" value="MSSQL"/>
<!--add key="DBServerType" value="MySQL"/-->
<add key="TableName" value="Variables"/>
<add key ="EZBuilderPort" value="6666"/>
<add key ="EZBuilderIP" value="127.0.0.1"/>
</appSettings>
</configuration>
Server - Name of the machine housing your database (localhost works if it is on the same computer)
UserName - The user name specified within your database server that has permissions to insert/update and read from the database. If you are going to use stored procedures, they will also need rights to execute the stored procs. Many people will just give this user DBO permissions over this database.
Password - The password for the specified user within your database server.
Database - The database that you will be storing to and querying data from.
DBServerType - There is one for MSSQL and one that is initially commented out for MySQL. Uncomment one and comment out the other. This is done by including the !-- before and -- after the xml element, but within the element starting and ending brackets. Example... <!--ALL OF THIS WILL BE COMMENTED OUT-->
TableName - This is the name of the table that you want to store your data in. Retrieval can be from anywhere on the database server, or using linked servers or replication could come from multiple servers.
EZBuilderPort - The port that the robot you are wanting to have communicate with the database is running on. This is not 23 or 24, but the port TCP port setting. See image below. If multiple robots are running, one of these will handle the database traffic for all robots for one machine.
EZBuilderIP - The IP address of the computer that ARC is running on.
After updating the EZ-DB.exe.Config file, save it and you will be ready to go from the application side.
USING WITH EZ-BUILDER
Some parameters have to be setup for this communication to work.
I add this to my initialization script to set theseCode:
#Starting variables for EZ-DB
$SqlReturn = ""
$SqlCommand = ""
To call the app and store data in the database, you would use a script component like thisCode:
Exec("C:\EZ-DB\EZ-DB.exe","$tempC Out Wall-E")
This will call the EZ-DB.exe application and pass some parameters to it.
The first parameter is the parameter that you want to store the value of. In this example, I am storing the $tempC variable from the ARC application into my database.
The second parameter must be In or Out. Notice the first letter is capitalized. Right now, it must be capitalized so it literally must be either In or Out. This is from the perspective of Ez-Builder. Are you passing something In to ARC or passing something Out of Ez-Builder? In this case, I am passing the variable Out to be stored in the database.
The third variable is the name of your robot. This will also be stored so that if you have multiple robots storing data in the same table, you will be able to identify which one sent the data.
To call the app to retrieve data from the database, you will need to first store your query in the
$SqlCommand variable and then call the application, passing in three parameters.Code:
$SqlCommand = "SELECT AVG{CONVERT{INT,VariableValue}} FROM Variables WHERE VariableName = '$tempC' and RobotName = 'Wall-E' and DateEntered > CONVERT{VARCHAR{10},GETDATE{},101}"
EXEC("C:\EZ-DB\EZ-DB.exe", "$SqlCommand In Wall-E")
If you are familiar with any SQL language, you will realize that all of the ( have been replaced with { and all of the ) has been replaced with }. This is because you're variable in ARC would not be able to be set because of issues with having ( or ) inside of a variable value. EZ-DB converts { to ( and } to ) before the query is executed.
The result of the query will be passed back to the $SqlReturn variable in EZ-Builder. This can then be used to do whatever you want to do with it in EZ-Builder.
I have included a EZB project called EZ-DBExample.ezb in this folder. It might be helpful.
My email address is D.Cochran@CochranRobotics.com. If you have any questions, please let me know.
I will be adding more output data data to display information about what is going on with the app in the ARC panel. Messages like "connecting to database", "Getting Data", "Returning data to EZ-Builder" and stuff like that. I will probably make a configuration setting to enable or disable these messages.
I would appreciate more ideas or features that you might have.
Asked
— Edited
I agree that this might only be used by a couple of people which is why I didn't think that it was a good use of EZ-Robots time to make it. There are a few people that will think its really cool and use it, but most will have no reason to do so. Also, I wanted to have an example of how to create a component for EZ-B using C# for the class I will be teaching next year.
I hope some will use it beyond me, but if not, I will get use of it. I like to share like most in this community, and hope that something that I put out helps others.
Btw, my first computer was a TI-99/4a computer. My first program was written on that computer when I was in the 3rd grade. I have had a lot of exposure to many systems in my life, but have never heard of the Psion. I will have to go check that out.
Sad thing is that when someone asks me to work on their computer, I normally decline. I know myself and know that it would just sit for a while and nothing would be done on it. I don't mind taking care of my stuff, but hate being obligated to others to fix their stuff.
Okay, trip down computer memory lane... I always like those.
Just added the ability to store in MySQL. I know that is the flavor you currently use. Will be testing and will have it available by this weekend. I am not a familiar with MySQL but I am sure it wont be any issue based on the limited amount of changes to this compared to MSSQL. In any event, no need for you to go download and install MSSQL if you are already using MySQL.
This is configurable in the configuration file.
I will also include the scripts to create the table, but the table name configurable in the config file so you should probably change the config file and the script to have the name you want to use. By default it will be Variables
This only does one variable at a time right now. Will working on allowing it to pass more in the near future, but want to get this tested on a couple of other machines to get a base that I know works.
more to come..
There is a sample project, a readme.txt with instructions and some scripts to create the table in your database. The website has the current information on the download page. It is much easier to update. If you have any questions, email me at d.cochran@cochranrobotics.com
Thanks
EZ-DB Pre-Release source code.
I am working (slowly) on the ability to grab all variables and store them in database records. This is one of about 10 projects that I have going right now, so it might be a while.
I am just bored and needed something to keep my mind from pondering the 3d printer debate going on in my head for the past couple of months. Use it and abuse it. Works with MSSQL or MySQL. I dont have a piece in yet to return values from the database back to an array of variables. I didnt have a need for it yet, but when I do, I am sure this will be revisited. The instructions for EZ-DB setup should work fine for EZ-DB Multi. If you have any issues, let me know. I would definately download the project from EZ-Cloud to get you started.
Current project uses EZ-Face to recognize the user of the robot if they are in the catalog of recognized users, and then searches the database using EZ-DBMulti for information about that user. Then in the interaction of the user with the robot, the robot does things like checking to see if it is the users birthday. If so, it wishes them a happy birthday.
So far, tests are good. I dont know other things that it will store in the database yet. maybe the last time that a nursery rhyme was told to a user and limit its retelling of the same rhyme based on the previous tells to that person, or something like that.
This robot is a Teddy Ruxpin that is being setup for my granddaughter. It will be used as a building platform for my inmoov to try to give it some "intelligence". A lot of the same things that I want to accomplish with the Ruxpin will be building blocks for the inmoov. Anyway, I will post on this topic again when I have had more time to test through this project.
Jarvis
My son is doing a project with with a company that shall remain unnamed right now Voice Recognition and database/data cube querying for responses to questions. Its one of the large ones, but the project is just starting. I may be testing some of his code when it gets to that point
My granddaughter is only 1 and barely speaking right now, so I want to use this as a method of teaching through repetition. Things like "Your birthday is..." or "You are now x years old" and things like that. Its more about her specifically but she will have a younger brother in the next few month, so I decided to go ahead and make it database driven so that it could be used by more than one user without rewriting a lot of stuff.
Fun possibilities all the way around. Also, I help an Elementary school with Robotics. It is a really cool way to show what is possible. Having the Teddy put with a very young group of kids and it being able to interact with them differently based on who it is would be the ultimate goal.
Thanks
If you download sql express I would also download sql management tools. It will give you a tool for making changes to the database.