Note: This repo is now archived. It is still available READ ONLY for forking or historical interest.

Description

Data Streamer Connect is an Open Source Project and Sample that demonstrates the following:

1. Wrapping Microsoft MakeCode in a Windows UWP application
2. Adding Blocks and JavaScript for the Arudino UNO using the Windows Provider Model and RemoteArduino built on the Firmata Protocol
3. Adding a Windows AppService to a MakeCode UWP App to communicate with the Microsoft Hacking STEM Data Streamer Excel Plugin
4. Adding example Blocks and JavaScript to communicate with Windows 10 platform API
5. Upgrade Arudino Uno firmware programmatically with a pre-defined hex program

Setting up the development environment

To setup your development machine you will need to install:

1. Visual Studio Community 2017 or better
   • Install the Universal Windows Platform development workload
   • Ensure that the following optional components are selected
     • C++ Universal Windows Platform tools
     • Windows 10 SDK (10.0.15063.0)

Updating the embedded Microsoft MakeCode instance

Data Streamer Connect is built using Microsoft MakeCode. To update the instance you will need to:

1. Clone this repository
   • You should create your own branch to contain any changes
2. Open DataStreamerConnect.sln and build the project (either x86 or x64)
3. Install Node.js
   • Ensure that Node.js is added to the path
4. Install Visual Studio Code
5. Download the Sample PXT target
   • Data Streamer Connect uses the sample PXT implementation as the base for its instance
6. Open the ZIP file and copy the files from the pxt-sample-master folder to the PXT folder in the Data Streamer Connect repository
   • NOTE: There are existing files in this folder that should not be overwritten:
     • package.json
     • pxtarget.json
     • targetconfig.json
     • docs/static/hero.png
     • libs/core/ns.ts
     • sim/api.ts
     • sim/apiwinrt.ts
     • sim/simulator.ts
7. Open the PXT folder in Visual Studio Code and then open a CMD Terminal for that folder location
8. In the terminal window run the following commands:
   • npm install -g pxt
   • npm install
9. Build the static package that Data Streamer Connect uses by running "pxt staticpkg" in the terminal window
   • The first pass will generate a number of "Skipped data-uri" warning. These can be ignored
10. Copy the files from PXT\built\packaged except for index.html into the DataStreamerConnect\DataStreamerConnect (this is the root folder of the UWP JavaScript application)
11. Build the DataStreamerConnect solution or create a Microsoft Store package
    • Only x86 and x64 packages are supported
    • To install the created packages run "Add-AppDevPackage.ps1" with PowerShell and follow the prompts

Streaming data to Microsoft Excel

To use Microsoft Data Streamer you will need to have Microsoft Office installed as well.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.