RoboRemo User Manual v1.7
Contents
1. option description copy Copies the text log so you can paste it when adding a new item remove Removes the text log set id Sets the text log id string For example if id is dbg and command ending is mn you can append the message qwerty to the text log by sending dbg qwertyn from microcontroller set label Sets the text string to appear under the text log 14 Accelerometer edit options option description copy Copies the item so you can paste it when adding a new item remove Removes the item set x id Sets the id for x axis Accelerometer will periodically send the id followed by a space character or not followed by a floating point number representing the acceleration on that axis You can disable an axis by setting the id to empty string set y id Sets the id for y axis set z id Sets the id for z axis set repeat period Sets the repeat refresh period in ms for accelerometer Default is 20 send space Select if you want the accelerometer to send space character after ids or not don t send space Text field edit options option description copy Copies the text field so you can paste it when adding a new item remove Removes the text field set id Sets the id for the text field For example if id is text1 and command ending is An you can change the text to abc by sending text1 abc n2. LEFT RoboRemo User Manual v1 7 RIGHT DOWN speed Table of Contents General DGGE RL DELON 35 00 oscillante 3 Bluetooth WiFi Ethernet TAAL AAA pide a 4 Avalable interface tis ira 7 Building TIC iessen Al Sa 9 B tton COS A A nesta eons 10 MO Cat r Teno EAEE PE E E AT 11 Slider edit A ON 12 Led edit Options is 13 Meche x e side E e E RA E e AEEA DR a GA ATE 13 Level indicato edib pilates 14 NN A el A RO 14 Accelerometer edit oponse cco gliele 15 Text field edit Options scanio iaia a 15 Plot edi Options ccd aces ceva eases n nO iaa 16 Image edit OP MOINS to 17 Touchpad edit opio ARL 18 FDC COMMECTOR di opt ons cise sade tes decades to di eae 19 Kod conector CRATES gastar Ba ESA A Aaa 19 MEN Opthos eiser oe e e a a E ae easier a 20 RFEFGOMM Se US o e ee so e a o o A a ea 21 Interface menu AS A ue 21 New features and O ili 22 General Description RoboRemo is a user customizable remote control application intended mainly for electronics hobby projects RoboRemo can connect over Bluetooth RFCOMM Internet or WiFi TCP Disclaimer Don t use RoboRemo for life support systems or any other situations where system failure may affect user or environmental safety Please don t use RoboRemo in projects where high level security is required To connect over Bluetooth a remote device must contain a Bluetooth to Serial adapter like BlueSMiRF BTM 222 HC 05 HC 06 etc and a microcontroller programmed
3. set id Sets the led id string set on command Sets the led on command default is 1 set off command Sets the led off command default is 0 set label Sets the text string to appear under the led set color Sets the led color Led examples Led id led ledA ledB Led on command 1 on gt 10 Led off command 0 off lt 10 Interface command ending n ok To turn the led on led in ledA on ledB 100k microcontroller must send or ledB 110k etc To turn the led off led O n ledA off ledB 9ok microcontroller must send or ledB 80k etc 13 Level indicator edit options option description copy Copies the level indicator so you can paste it when adding a new item remove Removes the level indicator set id Sets the level indicator id string For example if id is batt and command ending is An you can set its level to 100 by sending batt 100 n from microcontroller set label Sets the text string to appear under the level indicator You can use the level indicator value inside the label Examples for level indicator with value 100 label temp 0 5 10 C will show temp 40 0 C label batt 1 will show batt 100 set min Sets the minimum value default is 0 set max Sets the maximum value default is 255 set color Sets the level indicator color Text log edit options
4. from microcontroller set text Sets the text to be displayed inside text field set text size Sets the size of the displayed text Note if you want an item to be displayed on top of text field copy the item then remove it then paste it 15 Plot edit options option description copy Copies item so you can paste it when adding a new item remove Removes the item set id Sets the plot id string For example if id is x and command ending is An you can add a new sample with value 100 to the plot by sending x 100 n from microcontroller set label Sets the text string to appear under the plot set min Sets the minimum value default is 0 set max Sets the maximum value default is 255 set length Sets the length number of samples to fit in one frame default is 256 Maximum length is 10000 set display mode Sets the display mode for the plot Scrolling default plot scrolls from right to left new data appears on the right Oscilloscope plot doesn t scroll Data appears from left to right When it reaches the end it waits for trigger event then starts again from the left set trigger Sets the trigger threshold and edge rising falling both none If none edge selected then the trigger is off so it will not wait for trigger event For scrolling display mode there is no trigger The trigger settings are ignored 16 Image edit opti
5. 06 is usually 9600 Bluetooth to serial adapter BlueSMIRF or similar microcontroller Arduino or similar Android device with RoboRemo app Remote device Arduino WiFi Shield or similar F power microcontroller Arduino or similar Android device with RoboRemo app Remote device GSM Arduino Ethernet Shield or similar power microcontroller Arduino or similar Android device with RoboRemo app Remote device Available interface items item name photo description button Buttons can be used for sending commands to the remote button device A button can be configured to send one command when pressed and other command when released slider Sliders can be used to vary remote device parameters for example volume control or motor speed or light intensity led Leds can be used as indicators for remote device states level indicator A level indicator item can be used to display data from remote sensors for example temperature or battery level text log A text log item is a log screen that can be used to display debug messages from the remote device accelerometer The accelerometer can be used for sending periodically the acceleration measured by the phone s accelerometer You can set the ids the 3 axes and the repeat refresh period text field text Text field item to add some text to the interface Note if you want an item to be displayed
6. 2 gray levels 0 is full black and 1 is full white 17 Touchpad edit options option description copy Copies item so you can paste it when adding a new item remove Removes the item set press id Sets the id for press event For example if press id is pressed and command ending is mn when the user touches the touchpad it will send pressed x y n where x and y are the point coordinates For example pressed 316 244 n set drag id Sets the id for drag event Same as press id but for drag events set release id Sets the id for release event Same as press id but for release events set label Sets the text string to appear under the touchpad set X min Sets the x coordinate coresponding to the left border of the touchpad Default is 0 set X max Sets the x coordinate coresponding to the right border of the touchpad Default is 640 set y min Sets the y coordinate coresponding to the top border of the touchpad Default is 0 set y max Sets the y coordinate coresponding to the bottom border of the touchpad Default is 480 18 Kbd connector edit options option description copy Copies item so you can paste it when adding a new item remove Removes the item set id Sets the id for the kbd connector see examples below set label Sets the text string to appear under the kbd connector set local remote Sets if the
7. kbd connector should send the commands back to the interface or should it send to the remote device see examples below send while typing send at enter Sets if the kbd connector should send each character separately or should it wait for enter key see examples below Kbd connector examples Assuming command ending is n id local remote send while typing user is typing Result send at enter kbd remote while typing ab enter Remote device receives kbd a nkbd bin kbd n n kbd remote at enter ab enter Remote device receives kbd ab n empty string remote while typing ab enter cde Remote device receives ab ncde empty string remote at enter ab enter cde Remote device receives ab n and at next enter will receive cde n echo local while typing abc Local interface receives a nb nc n echo local at enter abc enter Local interface receives abc n gt empty string local at enter echo abclenter Local interface receives aban 19 Menu options option description connect disconnect Connects to a remote device disconnects from a remote device To connect to a Bluetooth remote device it has to be paired To pair with a Bluetooth device open Android settings gt Bluetooth search for devices Pin code for Bluetooth to serial adapter is usua
8. and ending fixed interface import export for string inputs from user are interpreted for interfaces with non ASCII characters escape characters W Nb An r f For V fixed text wrapping and auto character enter W scrolling when resizing text logs 1 4 local action interface n same as iface n fixed the bug with Ann string in where n is the interface number 0 to 7 interfaces auto connect option fixed a bug where app crashed if n local actions for connecting and was not an integer in iface n or disconnecting by pressing buttons interface n local action removed exit from menu app can be closed by pressing back key 1 5 option to use the slider or level indicator fixed a bug in processing received value inside their labels commands Now if there are more made slider with send when moved send items with same id all of them will only when the value changes respond to it option to change on and off commands for leds removed the dialog showing error when sending a non integer value to a level indicator undo option in interface editor 1 6 added option to set repeat period for sliders fixed a bug in sliders where slider added text fields with auto return enabled did not send added plots data when it was the same value as improved touch processing algorithm so that before return it will send touch events only to interactive items now you can have butt
9. ase the button RoboRemo will append the command ending to mark the end for each command For local action type Sets the local action to execute when you release the button set repeat delay Sets the button repeat delay in milliseconds When you hold a button pressed it will first repeat after this delay Default is 0 don t repeat set repeat period Sets the button repeat period in milliseconds When you hold a button pressed it will first repeat after delay then after period Default is 0 don t repeat set local set remote Changes button action type from remote to local from local to remote Default is remote 10 Local actions action description iface n or interface n select the nth interface n from 0 to 7 echo abc will simulate the receiving of abc command disconnect disconnect from the remote device connect rfcomm 11 22 33 44 55 66 1 or connect rfcomm 112233445566 1 connect over Bluetooth RFCOMM to the remote device with address 11 22 33 44 55 66 and port 1 connect rfcomm e 112233445566 1 Also use encryption connect rfcomm 112233445566 d Connect using the default UUID connect rfcomm 112233445566 f Connect using the first UUID connect tcp 192 168 0 5 9876 conect over tcp ip to the remote device with ip 192 168 0 5 and port 9876 11 Slide
10. lly 1234 or 0000 Select port 1 To connect over internet or WiFi data connection or WiFi has to be activated from Android settings Then in RoboRemo app choose menu connect gt internet and select the ip and port edit ui don t edit ui Enters exits the interface edit mode interface Opens interface menu help Shows help link about Shows info about the app undo Undo the last modification in the current interface enable disable Enables disables the auto connect option If enabled the app will try to autoconnect connect to the last connected device at next app start if the user did not select disconnect before closing app App disconnects automatically when closed lock unlock autorotate Locks unlocks the screen autorotate function for the app keep don t keep screen on Used to disable the automatic screen lock set char delay Slow microcontrollers need time to process each character received over serial port You can set the char delay so that RoboRemo will wait after each Character sent RFCOMM settings Change RFCOMM settings RFCOMM is the name for the Bluetooth Serial protocol Default settings are manual port selection without encryption 20 RFCOMM settings port channel selection manual will ask each time fixed 1 will use port 1 auto will select automatically UUID for automatic Used only if port selectio
11. n auto Ignored otherwise default use the well known UUID for Bluetooth to Serial modules which is 00001101 0000 1000 8000 00805F9B34FB first use first UUID of the remote device from the local cache encrypted Use don t use encryption Note Some devices may fail to connect with certain settings In this case it is recommended to try different settings Interface menu options option description select Select other interface RoboRemo has 8 interfaces numbered 0 to 7 rename Rename the current interface set connect action Set a command string to be send to the remote devices after connecting set command ending Change the command ending for the current interface The default is An Command ending can also be set to empty string but it is not recommended import Import an interface from file Interfaces are stored in the roboremo folder on the SD card The folder is created automatically at first app start export Export the current interface to a file Interfaces are stored in the roboremo folder on the SD card The folder is created automatically at first app start clear Clear the current interface 21 New features and fixed bugs App version New features Fixed bugs 1 2 accelerometer support Internet WiFi connectivity option for sliders to return to center when released N A 1 3 option to change comm
12. on top of text field copy the item then remove it then paste it plot Plot item can be used to display some signals image Image item can be used to display an image that is sent from the microcontroller available only in RoboRemo Full version touchpad Touchpad item can be used to send position and motion of your finger kbd connector Kbd connector can be used to send commands using the keyboard Building the interface First when you open the RoboRemo app it will look like this To edit the interface click menu gt edit ui Now in edit mode click on blank space to add an item then choose the item type Item will appear on screen You can move it by dragging the top left corner and resize by dragging the bottom right corner To edit item options click on the desired item Button edit options option description copy Copies the button so you can paste it when adding a new item remove Removes the button set text Sets the text that appears on button set press action For remote action type default Sets the string to send to the remote device when you press the button RoboRemo will append the command ending to mark the end for each command For local action type Sets the local action to execute when you press the button set release action For remote action type default Sets the string to send to the remote device when you rele
13. ons option description copy Copies item so you can paste it when adding a new item remove Removes the item set id Sets the image id string For example if id is img and image format is auto and command ending is n you can display an image by sending img len n followed by the image data from microcontroller len must be the size in Bytes of the image data that follows The auto format accepts jpg png and bmp data set label Sets the text string to appear under the image keep don t keep ratio Sets if the image should keep the original w h ratio or should it fill the entire image item filter don t filter Sets if the image should be filtered or not when scaled set image format Sets the image format Default format is auto and accepts jpg png and bmp data For raw image format you can choose RGB_888 w h GRAY_8 w h GRAY_4 w h GRAY_2 w h or GRAY_1 w h where you have to replace w and h with numbers width and height in pixels The pixels are scaned from left to right lines from top to bottom RGB_888 uses 3 bytes per pixel the levels for red green and blue GRAY 8 uses 1 byte per pixel has 256 gray levels GRAY 4 uses 4 bits per pixel 1 byte for 2 pixels and has 16 gray levels GRAY 2 uses 2 bits per pixel 1 byte for 4 pixels and has 4 gray levels GRAY_1 uses 1 bit per pixel 1 byte for 8 pixels and has
14. ons sliders hidden under leds plots etc added menu option to change RFCOMM settings 1 7 added option to set text size for text fields and when command ending is empty text logs added option to set id for text field so that user can change the text remotely string do not apend n at the end in text logs fixed a bug where autoconnect 22 added image item in RoboRemo Full version reduced TCP connect timeout from 90000ms to 5000ms improved menus now they are scrollable added touchpad item added option to keep screen on added kbd connector item dialog could not be cancelled after screen orientation change interface gt clear now also resets the command ending and connect action 23
15. r edit options option description copy Copies the slider so you can paste it when adding a new item remove Removes the slider set id Sets the slider id string For example if id is s1 and you move the slider to the value 100 and command ending is n it will send s1 100 n id followed by space followed by value followed by command ending set label Sets the text string to appear under the slider You can use the slider value inside the label Examples for slider with value 100 label speed 0 1 will show speed 10 0 label x 5 10 cm will show x 490 cm set min Sets the minimum value default is 0 set max Sets the maximum value default is 255 send when moved send when released Sets the slider send mode default mode it to send when released set color Sets the slider color send space don t send space Select if you want the slider to send space character after id or not auto return don t auto return Select if you want the slider to return to its center when released or not set repeat period Set the repeat period in ms for slider 0 don t repeat default When repeat enabled the slider will also send its data periodically in addition to normal operation 12 Led edit options option description copy Copies the led so you can paste it when adding a new item remove Removes the led
16. to interpret commands from RoboRemo You can also find adapters for Wifi or Ethernet All the commands from RoboRemo are text strings ending with command ending which is LF character n hex code 0x0A by default but user can change it For example if you configure a button to send abc when pressed it will send abc n if command ending is n or it will send abcqwerty123 if command ending is qwerty123 The command ending is used by the microcontroller program to know where each command ends RoboRemo also can receive commands for updating some interface items for example you can have a battery level indicator to monitor the battery level of the remote device These input commands also must end with command ending It is not recommended to set command ending to empty string because receiving commands from microcontroller to app will not work properly App will think that command ends after each received character However the commands from app to microcontroller will be sent as expected a button configured to send abc will send abc Bluetooth WiFi Ethernet modules RoboRemo was tested and works with these modules BlueSMiRF HC 05 HC 06 BTM 222 ESP8266 ESP 01 but other modules should work too When using Bluetooth module and microcontroller please make sure the microcontroller uses same BaudRate as the module The default BaudRate for BlueSMiRF is usually 115200 and for HC 05 HC
Download Pdf Manuals
Related Search