DroidScript Wiki

User Tools

Site Tools

Trace:
plugins:bbc_microbit

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
Next revision Both sides next revision
plugins:bbc_microbit [2016/10/23 16:38]
madlyr Added methods table list 		plugins:bbc_microbit [2016/12/24 12:24]
administrator formatting
Line 12: Line 12:
  
 In order to use the micro:bit, you must first load the plugin at the top of your script using the **LoadPlugin** method like this: In order to use the micro:bit, you must first load the plugin at the top of your script using the **LoadPlugin** method like this:
-<code>app.LoadPlugin( "MicroBit" );</code>+<code javascript>app.LoadPlugin( "MicroBit" );</code>
 Then you can create the microbit object like this: Then you can create the microbit object like this:
-<code>microbit = app.CreateMicroBit();</code>+<code javascript>microbit = app.CreateMicroBit();</code>
 You will need to connect to your micro:bit using Bluetooth and you can scan for it like this: You will need to connect to your micro:bit using Bluetooth and you can scan for it like this:
-<code>microbit = microbit.Scan();</code>+<code javascript>microbit = microbit.Scan();</code> 
 + 
 +===== MicroBit Methods ===== 
 +^ Method                                                                             ^ Description                                     ^ 
 +| [[microbit_analogread|AnalogRead( pin )]]                                          |                                                 | 
 +| [[microbit_connect|Connect( address )]]                                            |                                                 | 
 +| [[microbit_createcontroller|CreateController( size )]]                             |                                                 | 
 +| [[microbit_disconnect|Disconnect()]]                                               |                                                 | 
 +| [[microbit_getimage|GetImage()]]                                                   | Returns full path to micro:bit top view image.  | 
 +| [[microbit_getversion|GetVersion( num, txt )]]                                     |                                                 | 
 +| [[microbit_oncancel|OnCancel()]]                                                   |                                                 | 
 +| [[microbit_onconnect|OnConnect()]]                                                 |                                                 | 
 +| [[microbit_ondevice|OnDevice( name, address, bonded, rssi )]]                      |                                                 | 
 +| [[microbit_ondisconnect|OnDisconnect()]]                                           |                                                 | 
 +| [[microbit_onreceive|OnReceive( data )]]                                           |                                                 | 
 +| [[microbit_onselect|OnSelect( title, body )]]                                      |                                                 | 
 +| [[microbit_reset|Reset()]]                                                         |                                                 | 
 +| [[microbit_save|Save()]]                                                           |                                                 | 
 +| [[microbit_scan|Scan( address )]]                                                  |                                                 | 
 +| [[microbit_scrolltext|ScrollText( text, interval )]]                               |                                                 | 
 +| [[microbit_send|Send( msg )]]                                                      |                                                 | 
 +| [[microbit_sendcode|SendCode( code )]]                                             |                                                 | 
 +| [[microbit_setleds|SetLEDs( bits )]]                                               |                                                 | 
 +| [[microbit_setonbutton|SetOnButton( callback )]]                                   |                                                 | 
 +| [[microbit_setonconnect|SetOnConnect( callback )]]                                 |                                                 | 
 +| [[microbit_setondevice|SetOnDevice( callback )]]                                   |                                                 | 
 +| [[microbit_setondisconnect|SetOnDisconnect( callback )]]                           |                                                 | 
 +| [[microbit_setonevent|SetOnEvent( callback )]]                                     |                                                 | 
 +| [[microbit_setonmotion|SetOnMotion( callback )]]                                   |                                                 | 
 +| [[microbit_setonreceive|SetOnReceive( callback )]]                                 |                                                 | 
 +| [[microbit_setontemp|SetOnTemp( callback )]]                                       |                                                 | 
 +| [[microbit_setsplitmode|SetSplitMode( mode, p1, p2 )]]                             |                                                 | 
 +| [[microbit_startscan|StartScan()]]                                                 |                                                 | 
 +| [[microbit_stopscan|StopScan()]]                                                   |                                                 | 
 +| [[microbit_watchaccelerometer|WatchAccelerometer( precision, interval, cancel )]]  |                                                 | 
 +| [[microbit_watchbutton|WatchButton( name, cancel )]]                               |                                                 | 
 +| [[microbit_watchinput|WatchInput( pin, cancel )]]                                  |                                                 | 
 + 
 + 
 +===== Using MicroBitCtrl Control ===== 
 + 
 +This control shows micro:bit image which shows interactive LED array and Bluetooth indicator. 
 + 
 +In order to use the MicroBitCtrl control, you must first load the plugin and initialize MicroBit object: 
 + 
 +<code javascript> 
 +//Load the MicroBit plugin. 
 +app.LoadPlugin( "MicroBit" ); 
 + 
 +//Called when application is started. 
 +function OnStart() 
 +{ 
 +  //Lock screen orientation to Portrait. 
 +  app.SetOrientation( "Portrait" ); 
 + 
 +  //Create our main layout. 
 +  lay = app.CreateLayout( "Linear", "VCenter,FillXY" ); 
 +  lay.SetBackColor( "#222222" ); 
 + 
 +  //Create the Microbit plugin. 
 +  microbit = app.CreateMicroBit(); 
 + 
 +  //Create MicroBit controller. 
 +  ctrl = microbit.CreateController( 0.9 ); 
 +  lay.AddChild( ctrl ); 
 + 
 +  //Create horizontal layout for buttons 
 +  layButs = app.CreateLayout( "Linear", "Horizontal" ); 
 +  layButs.SetMargins( 0,0.05,0,0 ); 
 +  lay.AddChild( layButs ); 
 + 
 +  //Create a bluetooth connect button. 
 +  btnConnect = app.CreateButton( "[fa-bluetooth-b]", 0.25, 0.15, "FontAwesome" ); 
 +  btnConnect.SetTextSize( 66 ); 
 +  btnConnect.SetTextColor( "#3366ff" ); 
 +  btnConnect.SetOnTouch( txtBT_OnTouchDown ); 
 +  layButs.AddChild( btnConnect ); 
 + 
 +  //Create clear button. 
 +  btnClear= app.CreateButton( "[fa-times]", 0.25, 0.15, "FontAwesome" ); 
 +  btnClear.SetTextSize( 66 ); 
 +  btnClear.SetTextColor( "#ff4444" ); 
 +  btnClear.SetOnTouch( btnClear_OnClick ); 
 +  layButs.AddChild( btnClear ); 
 + 
 +  //Add main layout to the app. 
 +  app.AddLayout( lay ); 
 +} 
 + 
 +//Handle Bluetooth button press. 
 +function txtBT_OnTouchDown() 
 +{ 
 +  microbit.Scan(); 
 +} 
 + 
 +//Handle 'clear' button press. 
 +function btnClear_OnClick() 
 +{ 
 +  ctrl.Clear(); 
 +} 
 +</code> 
 + 
 +===== MicroBitCtrl Methods ===== 
 +| [[microbitctrl_clear|Clear()]] | Clears LEDs to gray color. | 
 +| [[microbitctrl_sendledstates|SendLEDStates()]] | Sends new LED states to micro:bit. | 
 +| [[microbitctrl_setbluetoothstate|SetBluetoothState( connected )]] | If connected is true, then function sets Bluetooth indicator in blue color, if false, in gray color. | 
 +| [[microbitctrl_setled|SetLED( x, y )]] | Sets LED in x and y position (range 0..4). It sets LED in red color. | 
 +| [[microbitctrl_toggleled|ToggleLED( x, y )]] | Toggles LED in x and y position (range 0..4). It sets LED in red or gray color. | 
 +| [[microbitctrl_imgtouch_ontouch|imgTouch_OnTouch( ev )]] | Custom LED array touch handler. | 
  
-===== Methods ===== 
-^ Method ^ Description ^ 
-| [[microbit_analogread|AnalogRead( pin )]] | | 
-| [[microbit_connect|Connect( address )]] | | 
-| [[microbit_createcontroller|CreateController( size )]] | | 
-| [[microbit_disconnect|Disconnect()]] | | 
-| [[microbit_getimage|GetImage()]] | | 
-| [[microbit_getversion|GetVersion( num, txt )]] | | 
-| [[microbit_oncancel|OnCancel()]] | | 
-| [[microbit_onconnect|OnConnect()]] | | 
-| [[microbit_ondevice|OnDevice( name, address, bonded, rssi )]] | | 
-| [[microbit_ondisconnect|OnDisconnect()]] | | 
-| [[microbit_onreceive|OnReceive( data )]] | | 
-| [[microbit_onselect|OnSelect( title, body )]] | | 
-| [[microbit_reset|Reset()]] | | 
-| [[microbit_save|Save()]] | | 
-| [[microbit_scan|Scan( address )]] | | 
-| [[microbit_scrolltext|ScrollText( text, interval )]] | | 
-| [[microbit_send|Send( msg )]] | | 
-| [[microbit_sendcode|SendCode( code )]] | | 
-| [[microbit_setleds|SetLEDs( bits )]] | | 
-| [[microbit_setonbutton|SetOnButton( callback )]] | | 
-| [[microbit_setonconnect|SetOnConnect( callback )]] | | 
-| [[microbit_setondevice|SetOnDevice( callback )]] | | 
-| [[microbit_setondisconnect|SetOnDisconnect( callback )]] | | 
-| [[microbit_setonevent|SetOnEvent( callback )]] | | 
-| [[microbit_setonmotion|SetOnMotion( callback )]] | | 
-| [[microbit_setonreceive|SetOnReceive( callback )]] | | 
-| [[microbit_setontemp|SetOnTemp( callback )]] | | 
-| [[microbit_setsplitmode|SetSplitMode( mode, p1, p2 )]] | | 
-| [[microbit_startscan|StartScan()]] | | 
-| [[microbit_stopscan|StopScan()]] | | 
-| [[microbit_watchaccelerometer|WatchAccelerometer( precision, interval, cancel )]] | | 
-| [[microbit_watchbutton|WatchButton( name, cancel )]] | | 
-| [[microbit_watchinput|WatchInput( pin, cancel )]] | | 
 =====Examples===== =====Examples=====
  
Line 218: Line 292:
 } }
 </code> </code>
 +
 +===== Troubleshooting =====
 +There is a separate article on [[microbit:troubleshooting|Troubleshooting]] this plugin.
 +
plugins/bbc_microbit.txt · Last modified: 2019/03/04 16:22 (external edit)

Page Tools

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki