This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
plugins:bbc_microbit [2016/10/23 16:38] madlyr Added methods table list |
plugins:bbc_microbit [2019/03/04 16:22] (current) |
||
---|---|---|---|
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: | ||
- | < | + | < |
Then you can create the microbit object like this: | Then you can create the microbit object like this: | ||
- | < | + | < |
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: | ||
- | < | + | < |
+ | |||
+ | ===== MicroBit Methods ===== | ||
+ | ^ Method | ||
+ | | [[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 )]] | | | ||
+ | |||
+ | |||
+ | ===== 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( " | ||
+ | |||
+ | //Called when application is started. | ||
+ | function OnStart() | ||
+ | { | ||
+ | //Lock screen orientation to Portrait. | ||
+ | app.SetOrientation( " | ||
+ | |||
+ | //Create our main layout. | ||
+ | lay = app.CreateLayout( " | ||
+ | lay.SetBackColor( "# | ||
+ | |||
+ | //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( " | ||
+ | layButs.SetMargins( 0,0.05,0,0 ); | ||
+ | lay.AddChild( layButs ); | ||
+ | |||
+ | //Create a bluetooth connect button. | ||
+ | btnConnect = app.CreateButton( " | ||
+ | btnConnect.SetTextSize( 66 ); | ||
+ | btnConnect.SetTextColor( "# | ||
+ | btnConnect.SetOnTouch( txtBT_OnTouchDown ); | ||
+ | layButs.AddChild( btnConnect ); | ||
+ | |||
+ | //Create clear button. | ||
+ | btnClear= app.CreateButton( " | ||
+ | btnClear.SetTextSize( 66 ); | ||
+ | btnClear.SetTextColor( "# | ||
+ | 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 ' | ||
+ | function btnClear_OnClick() | ||
+ | { | ||
+ | ctrl.Clear(); | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | ===== 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: | ||
} | } | ||
</ | </ | ||
+ | |||
+ | ===== Troubleshooting ===== | ||
+ | There is a separate article on [[microbit: | ||
+ |