Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New tutorial patches: hardware and patterns sections #1731

Merged
merged 3 commits into from
Apr 4, 2019

Conversation

brusherru
Copy link
Contributor

No description provided.

workspace/welcome-to-xod/100-hardware/patch.xodp Outdated Show resolved Hide resolved
workspace/welcome-to-xod/101-upload/patch.xodp Outdated Show resolved Hide resolved
Copy link
Member

@nkrkv nkrkv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it would be better if 202-206 are functional out of the box and exercises involve tweaking/adjusting/try-to-repeat tasks.

  • 201 is OK, it works already. map-clip is an option
  • 202 the basic alarm should be complete: Tc linked with IN1 of greater and a sane value bound to IN2. The exercise is in adding the pot and trying less instead of greater
  • 203 the alarm should work already. The task might be related to button for resetting. And the buffer+select concept is too large IMO to be just a self-study exercise
  • 204 some links might be bused already and the task is creating another bus
  • 205 ok
  • 206 the defer should be in play already and the task might be in adding/removing states, adjusting trigger (button vs boot) and time

workspace/welcome-to-xod/109-tmp36/patch.xodp Outdated Show resolved Hide resolved
@brusherru brusherru force-pushed the feat-1631-update-tutorial-hardware-patterns-parts branch from 20467ba to 1d86560 Compare April 2, 2019 10:20
@brusherru brusherru requested a review from nkrkv April 2, 2019 10:22
@brusherru brusherru force-pushed the feat-1631-update-tutorial-hardware-patterns-parts branch from 1d86560 to 11504fb Compare April 3, 2019 15:28
{
"comments": [
{
"content": "# Working with Hardware\n\nIn this part of the tutorial, you learn how to upload the program to the board and work with hardware modules.\n\nTo upload programs to Arduino, you need to [install the desktop version](https://xod.show/downloads/) of XOD. The browser version does not have permissions to access USB ports. Nevertheless, you can upload XOD programs even from the browser version if you have the original Arduino IDE installed by [copying and pasting the generated code](#TODO).\n\nIf you have no hardware on hand, skip to `200-patterns` section and go on replacing hardware nodes with `watch`es and `tweak`s.",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Found TODO

},
{
"boundLiterals": {
"B1oqkTnIb": "D13"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What if Pete's Piranha Unlicensed Crappy Clone doesn't have LED or have LED on the different address? I mean, it's ok, but maybe a worth note about it?

@knopki
Copy link
Member

knopki commented Apr 3, 2019

Awesome tutorial. Except for TODOs about schemes :)

Copy link
Member

@nkrkv nkrkv left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

{
"comments": [
{
"content": "# Interactive Session\n\nAs you run a simulation, you can run the interactive session, using `tweak`s and `watch`es, while running the program on the Arduino.\n\n## Instructions\n\n1. Connect the Arduino to your computer.\n\n2. Upload the program with an interactive session. To do this, select Deploy → Upload to Arduino from the main menu and mark \"Debug after upload\" checkbox or just click \"bug\" icon in the deployment pane below.\n\n3. After the interactive session has been started, select `tweak-boolean` and change its value. The built-in LED on the Arduino reacts to these changes.\n\nTo stop the interactive session press \"Stop\" button above, on the green panel. To start the interactive session again, you have to upload the program again.",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • with an interactive session → with the interactive session enabled
  • and mark “Debug after upload” checkbox → and mark the “Debug after upload” checkbox OR and check “Debug after upload”
  • just click "bug" icon → just click the "bug" icon

}
},
{
"content": "## Additional Exercise\n\nPlace `tweak-pulse` and link it with `UPD` pin and start the interactive session again. Now your LED changes the brightness only after you send the puls.",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • send the puls → send a pulse

{
"comments": [
{
"content": "# LED Node\n\nYou already made a blinking LED and controlled it in the interactive session. Let's examine how it works and let's play with its brightness.\n\nThe `LUM` pin on the `led` node accepts values between 0 and 1. The 0 value represents no glow at all, while a value of 1 denotes full brightness.\n\nHowever, you can adjust brightness level by setting values *between* 0 and 1 to the `LUM` pin.\n\nNote that LED can change the brightness only in the PWM output of your board. If you have an Arduino board, find out the port number with the leading \"~\" symbol.",
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Let's examine how it works and let's play
  • The 0 value represents no glow at all, while whereas a the value of 1 denotes
  • LED can change the brightness only in the PWM output if the board output pin supports PWM

@brusherru brusherru force-pushed the feat-1631-update-tutorial-hardware-patterns-parts branch from 9422b0f to 1416cbe Compare April 4, 2019 12:54
@brusherru brusherru merged commit f320286 into master Apr 4, 2019
@brusherru brusherru deleted the feat-1631-update-tutorial-hardware-patterns-parts branch April 4, 2019 13:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants