Gadgeteer 101 Hands on Lab BLAKE MCNEILL

Transcription

1 Gadgeteer 101 Hands on Lab BLAKE MCNEILL

2 I have a favor to ask Hopefully this will become a regular introduction class to Gadgeteer taught at all Microsoft Stores world wide (that s the dream). The audience is the General Public, Junior High Students and above, Makers, Developers, Companies etc. Hopefully there will be additional Gadgeteer courses for Networked Devices (IoT using Azure for example), Automation and Robotics. So feedback, suggestions, comments and such definitely appreciated and requested. Please send to mcneillb@zingpow.ca

3 Sponsors

4 Who is Blake McNeill Chief Scientist at Zing Pow working on emerging technologies like Gadgeteer Cutting code since 1977 (FORTRAN IV on punch cards) Involved in a number of successful startup companies Microsoft MVP for the last 12 years Gadgeteer Evangelist

5 You have questions???? Strangely enough I have answers, but if you don t ask, I can t answer, so please feel free to ask questions at any time!!

6 What is Gadgeteer.Net Gadgeteer comes from Microsoft Research in Cambridge UK Designed as a tool for researchers to make it faster and easier to prototype new kinds of devices Since then, it has proven to be of interest to hobbyists and for secondary and tertiary education and of course commercial use Based on Microsoft s.net Micro Framework Now part of Microsoft s IoT product group

7 What is.net Micro Framework for resource-constrained devices with at least 256 KBytes of flash and 64 KBytes of RAM supports development in C#, Visual Basic.NET and debugging (in an emulator or on hardware) using Microsoft Visual Studio. NETMF features a subset of the.net base class libraries (about 70 classes with about 420 methods) implementation of Windows Communication Foundation (WCF) GUI framework loosely based on Windows Presentation Foundation (WPF) Web Services stack based on SOAP and WSDL NETMF also features additional libraries specific to embedded applications Open Source and part of Microsoft s IoT Product Group

8 History of.net Micro Framework Smart Personal Object Technology (SPOT) was developed by Microsoft to personalize household electronics and other everyday devices, through "smart" software and hardware that would make their uses more versatile Smartwatches were the first SPOT-based applications released in 2004

9 Why Gadgeteer Rapid prototyping platform Object-oriented programming Solderless assembly Uses skills and tools you already have Lego for IoT and Device builders Where software meets hardware

10 Gadgeteer Sockets

11 Gadgeteer Sockets

12 Gadgeteer Sockets So socket standards mean you don t have to deal with pins and interrupt level code for example unless you want to. Modules have a driver that contain all the pin level code. Easy for hardware vendors to make and sell modules Makes it attractive for coders to buy and use third party hardware Module/Mainboard Builder guides and templates available on Gadgeteer Site

13 Gadgeteer Module Driver

14 Gadgeteer Module Driver So what does this mean to a software developer? GHI Electronics Source Code including modules available

15 Visual Studio and Gadgeteer Need to install.net Micro Framework Net Micro Framework SDK v4.3 (QFE2-RTM) Install VS20xx Project System for your version of Visual Studio Need to install Gadgeteer Core Install.NET Gadgeteer Core Need to install vendor SDK GHI Electronics NETMF and Gadgeteer Package 2014 R5 Will work with Free versions of Visual Studio

16 Starting a Gadgeteer Project On Visual Studio s Main Menu select File -> New -> Project

17 Starting a Gadgeteer Project Pressing Create will open the Gadgeteer Application Wizard

18 Starting a Gadgeteer Project Visual Studio will now create your project and put in the Designer

19 Gadgeteer Designer Assemble your device

20 Gadgeteer Designer You can rearrange items as you wish on your workspace

21 Connecting Modules Manually Using Socket Labels

22 Connecting Modules Manually Using the Designer

23 Connecting Modules Manually Using the Designer

24 Connecting Modules Automatically using Designer Right Mouse Click

25 Connecting Modules Connecting Modules

26 Connecting Modules Connecting Modules

27 Very Brief Introduction to C# In Visual Studio select Program.cs

28 Very Brief Introduction to C#

29 Very Brief Introduction to C# Properties Values that can be read, and sometimes also assigned. _timer.interval example Debug.Print(_timer.Interval.ToString());

30 Very Brief Introduction to C# Methods Built-in functions that can include a number of parameters. _timer.start example _timer.start();

31 Very Brief Introduction to C# Events Notification that something of interest has occurred and what to do about it. _timer.tick example _timer.tick += _timer_tick; void _timer_tick(gt.timer timer) { _flash =!_flash; //toggle the flash Mainboard.SetDebugLED(_flash); //set the LED on the mainboard accordingly }

32 Very Brief Introduction to C# The quick way to use events Type the object s name followed by a period, then select the desired event using the arrow and Enter keys.

33 Very Brief Introduction to C# The quick way to use events Type +=, followed by the Tab key twice The first tab completes the Event assignment line _timer.tick += _timer_tick; The second tab creates the Event handler void _timer_tick(gt.timer timer) { throw new NotImplementedException(); }

34 Very Brief Introduction to C# The quick way to use events Replace throw new NotImplementedException(); With the code you want to run when the event occurs void _timer_tick(gt.timer timer) { _flash =!_flash; //toggle the flash Mainboard.SetDebugLED(_flash); //set the LED on the mainboard accordingly }

35 Writing Code Add the following code

36 Running the Code Plug in the USB cable between the computer and the Red Power Module, you should hear a USB connection notification sound and the Mainboard Red Power light should come on.

37 Running the Code Click the debug button, or press the F5 Key to compile and deploy the code to the mainboard and start a debugging session. You should now see a flashing green LED on the mainboard Congratulations you have created the device equivalent of the Hello World program, a flashing LED.

38 RFID Card Scanner Device Objective Read a RFID card Activate a Relay Control such that a lock could be opened if the RFID card is authorized to do so Display the RFID on a character display and indicate its authorization status Play an audio sound to indicate if permission has been granted or denied Change the color of a LED to indicate status Blue Ready White Administrator Mode Red Access Denied Green Access Granted Use Timers to limit how long status and permissions are granted Create an Administration mode such that RFID cards can have permissions granted or revoked

39 RFID Card Scanner Device Create a new Gadgeteer Application Project

40 RFID Card Scanner Device In the designer select: Button module Character Display module LED 7C module Relay X1 module RFID Reader module Tunes module USB Client SP module

41 RFID Card Scanner Device Arrange and connect

42 RFID Card Scanner Device In Program.cs add to the Program class public partial class Program { private Hashtable _rfidhashtable = new Hashtable(); //store RFIDs that have permission private GT.Timer _denytimer = new GT.Timer(2000); private GT.Timer _unlocktimer = new GT.Timer(3000);

43 RFID Card Scanner Device In Program.cs modify ProgramStarted button.buttonpressed += button_buttonpressed; button.mode = Button.LedMode.ToggleWhenPressed; //so we don't need track it _unlocktimer.tick += _unlocktimer_tick; //connect the timer events _denytimer.tick += _denytimer_tick; rfidreader.idreceived += rfidreader_idreceived; //connect the RFID Scanner lockdoor(); //by default lock the door

44 RFID Card Scanner Device In Program.cs create lockdoor routine private void lockdoor() { relayx1.turnoff(); led7c.setcolor(led7c.color.blue); characterdisplay.clear(); characterdisplay.print("ready"); }

45 RFID Card Scanner Device In Program.cs add code to rfidreader_idreceived (created when you created the event rfidreader.idreceived += rfidreader_idreceived; void rfidreader_idreceived(rfidreader sender, string e) { if (_unlocktimer.isrunning _denytimer.isrunning) return; //if the device is busy processing a previous event //clear the text display and display the RFID number characterdisplay.clear(); characterdisplay.print(e); //an argument pass in to the event handler characterdisplay.setcursorposition(1,0); //go to the second line of the display

46 RFID Card Scanner Device In Program.cs continue adding code to rfidreader_idreceived if (button.isledon) //Are we in Administration Mode { if (!_rfidhashtable.contains(e)) { //if the hash table doesn t have the RFID, then add it _rfidhashtable.add(e, 1); characterdisplay.print("adding"); }

47 RFID Card Scanner Device In Program.cs continue adding code to rfidreader_idreceived else { //remove exiting RFID _rfidhashtable.remove(e); characterdisplay.print("removing"); } } //end of Administrative Mode

48 RFID Card Scanner Device In Program.cs continue adding code to rfidreader_idreceived else //Operational Mode check if RFID is approved { opendoor(_rfidhashtable.contains(e)); }

49 RFID Card Scanner Device In Program.cs create OpenDoor routine private void opendoor(bool open) { if (open) { characterdisplay.print("enter"); tunes.play(1000, 500); led7c.setcolor(led7c.color.green); relayx1.turnon(); //energize relay _unlocktimer.start(); //start timer to keep door unlocked for limited time }

50 RFID Card Scanner Device In Program.cs continue OpenDoor routine else { characterdisplay.print("denied"); tunes.play(200,1000); led7c.setcolor(led7c.color.red); relayx1.turnoff(); //ensure relay is not energized _denytimer.start(); //start timer to display denied status for limited time }

51 RFID Card Scanner Device In Program.cs hook up timer tick event handlers void _denytimer_tick(gt.timer timer) { _denytimer.stop(); lockdoor(); } void _unlocktimer_tick(gt.timer timer) { _unlocktimer.stop(); lockdoor(); }

52 RFID Card Scanner Device In Program.cs hook up button pressed event handler void button_buttonpressed(button sender, Button.ButtonState state) { characterdisplay.clear(); if (button.isledon) { led7c.setcolor(led7c.color.white); characterdisplay.print("learning Mode"); } else { lockdoor(); } }

53 RFID Card Scanner Device Run the Program Click the debug button, or press the F5 Key to compile and deploy the code to the mainboard and start a debugging session. Your LED Module should be blue and Ready appears in the character display

54 RFID Card Scanner Device Try swiping a RFID Card over the reader Should buzz and LED turn Red and message appear in Character Display Should then return to Ready state Press Button to go into Administration Mode LED should turn White Red LED on Button should turn on Character Display Learning Mode Swipe RFID card Character Display shows RFID number and if the card is being added or removed

55 RFID Card Scanner Device Press button to return to Ready mode Swipe Added RFID card LED should turn Green Character Text Displays RFID number and Enter Relay energizes Should return to Ready state Try swiping your cards on other RFID Devices

56 RFID Card Scanner Device Setting Break Points, toggle on/off

57 RFID Card Scanner Device Swipe a Card over the RFID Reader

58 RFID Card Scanner Device F10 to Single Step through code, F11 to Step Into routines, F5 to Continue

59 RFID Card Scanner Device Shift F5 to Stop Debugging Device will keep running

60 RFID Card Scanner Device Press Reset Button on Mainboard or unplug and replug in the USB cable, what happens?

61 RFID Card Scanner Device Experiment/Play Time Questions? Discussion

62 QUFFLUh XEzb2-0k Gadgeteer Links Gadgeteer Forum (I am Duke Nukem on this forum) Sample Projects GHI Gadgeteer Catalog ILOVEGADGETEER gives you 15% off of everything for attending this session My YouTube Gadgeteer Video Channel (Duke Nukem Gadgeteer) The RFID Project can be found here Calgary.Net User Group

63 QUFFLUh XEzb2-0k More Links Microsoft White Papers Building the Internet of Things: Early learnings from architecting solutions focused on predictive maintenance Understanding Internet of Things (IoT) Device Choices Facebook

64 QUFFLUh XEzb2-0k Gadgeteer Hands On Lab Comments Questions Suggestions