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
Alan@thetechguru.net
I'd offer to test it but am away for a long weekend and have mountains of work to get done before I go.
ez-db.exe $tempC Out Wall-E
Now, how would I do this from a script. I have tried
Code:
IDK, Will mess with it in the morning. If anyone has any suggestions, please let me know.
Code:
0x22 is the hex code for the ascii "
If you need the comma there too add in + 0x2C before the first 0x22
Use a + between variables to string them together
works. dont know what I was doing wrong before. removed it and re-added it and it works.Code:
I have one question though; What will this do and how can someone like me use it for?
say for example you wanted to make 10 robots work together all over the world. If each could connect to a database via the internet, they could communicate with each other and do things based on what other robots are doing.
another example might be Jarvis by Rich. Jarvis can control parts of Rich's home. It could get the outside temp and humidity from an RSS feed. He then could see what temp the thermostat has been set to in the past when the temp and humidity were similar to what it currently is.
another example would be to log moves in a game and be able to see what the next move normally is based on the move that was just made and the move you are about to make.
there are so many possibilities. I work with databases daily for a large bank. It is in my blood I guess. I really don't know yet exactly what I will do, but the thought of many robots being able to communicate with each other and make decisions based on what the other ones are doing (robotic vacuums or lawn mowers working together) interests me a lot.
Answering from my phone, so don't want to get too deep, but I'll try to come up with some example ideas later to demonstrate.
say you store the points in a path that was taken, and the time it took to take that path. The next 30 days you took other random path and recorded the paths. You would then be able to query the database for the shortest or quickest path or create a different path based off of all of the gathered data.
decisions made off of data gathered is where this becomes powerful.
For instance heating, hot water and external temperature
Aside from a cool chart it also helps when work out when to turn on the heating to make sure it's warm when I get home. Knowing the information has saved me so much in energy bills.
But I digress...
Still, I am glad we have guys like you on here to help us with Windows and other things outside of ARC...
Cheers
Richard
Well, I got the bug that I was having worked out. I am now able to use a script to log data to a database table, and then run a query to retrieve data from the table. Amazing how simple this is in C#, but the issues came in when calling from a script in ARC. Getting the script to call the EZ-DB executable and pass a query as simple as "Select count(*) from Variables" was not easy. ARC doesn't like variables with "(" or ")" in them. So the work around was to put "{" and "}" in your query in place of "(" and ")" but then SQL Server doesn't like the query and some things were getting confused in the code when using "{" and "}" which C# uses. I couldn't use "[" and "]" because those are valid SQL characters. So, I had to use "{" and "}" in the variable in ARC, and have the executable catch and convert these to "(" and ")".
So far, all I have tested is some pretty simple queries, but the use of "(" and ")" is very high in SQL, so I had to get these working somehow.
I will type up some instructions on how to get it setup. It is a first attempt and I will put in the work to make it better as time goes on.
Feel free to contact me at d.cochran@cochranrobotics.com or on this post if you have any questions.
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.