makeabilitylab / physcomp Goto Github PK

In L5: "Blinking Two LEDs", we should not be using a battery symbol for voltage source since the source is coming from a digital pin. Should be a flat line.

**The Freq should be in Hz i guess its a typo **
the Arduino Uno supplies a "490MHz" PWM waveform at 8 bits. And this is more than fast enough to smoothly fade between different LED brightness levels. So, you can always start there ("490MHz" freq, 8-bit resolution) and then play around.

From student W.Q:

At first I was a bit confused about why CircuitJS is not yielding the same number as my manual calculations, but I realized that the default LED model there doesn’t have the right spec as the one on the LED datasheets. So I had to make a simple model, specify the correct forward voltage and current, and then the numbers are consistent.

I should add this tidbit into the lesson itself!

have them as 220ohm right now. Incorrectly.

I changed quote styling for the landing page (Native American quote) but this broke quote styling for other pages, which a bit weird to me (too big font):

As captured by @EdigaHe. Need to fix for next iteration of class:

The battery symbol in the LED circuit 2 schematics should be flipped vertically？I guess it is supposed to show 5V rather than a battery here. This is confusing to me.

Same as the video below that figure.

I was, perhaps, naive to rely on such an external app https://gist-it.appspot.com/

Moreever, since they serve via http vs. https, Chrome now blocks this embed. Notice how our code is not showing on this smoothing input page.

http://gist-it.appspot.com/https://github.com/makeabilitylab/arduino/blob/master/Filters/MovingAverageFilter/MovingAverageFilter.ino?footer=minimal

Just the Docs is now on version 3.3.3 (though only last updated in Oct 2020 and has lots of awaiting PRs). Still, features from the new version look good and improves accessibiliey:

https://github.com/pmarsceill/just-the-docs

We might want to bump our "Just the Docs" version up given that we are currently stuck at v0.2.8 because we used incompatible customizations.

I was surprised I didn't have a flappy bird video embed here: https://makeabilitylab.github.io/physcomp/advancedio/oled.html

I do have a pong embed.

And I have an overview video here:
https://youtu.be/-dLtvL1bOn8

Just received an the following email:

But then I see that is None is preferred?

https://stackoverflow.com/questions/3257919/what-is-the-difference-between-is-none-and-none

In practice, it's common to debounce with a very slight delay after an initial input change is observed. While this doesn't protect against errant activations due to ESD, it works very well (at least has in my experience for last ~8 years). So, I could/should clarify this in the lesson.

They are too large here.

https://makeabilitylab.github.io/physcomp/arduino/led-on.html

From the onset of creating this website, I wanted to include some optional "info boxes" that allow extra curious or more advanced students to dive deeper into a concept or area but that is optional.

Currently, the optional content isn't nearly as obvious as it needs to be. Liang said this too.

I know this. I tried for an hour or two to address this but couldn't figure it out (I'm still learning Jekyll, Kramdown, and scss). One of the Jekyll templates I considered has great support for differently styled infoboxes, like this (but I just don't know how to get this to work with my template, which is called "Just the Docs"). Here's a screenshot of the minimal mistakes info boxes:

Thanks @EdigaHe

On the Arduino and Leonardo, the ADC is 10 bits. So, it converts voltages between 0 and V c c ( 5 V ) t o a Vcc(5V)toa 2^{10}$$ range (0-1023). Thus, the resolution between readings is 5V / 1024 or 0.0049 volts (4.9 mV).

Looks like it's related to: just-the-docs/just-the-docs#365. I'm having the exact same problem.

just-the-docs.js:6 Uncaught TypeError: Cannot read property 'attachEvent' of null
    at Object.jtd.addEvent (just-the-docs.js:6)
    at initNav (just-the-docs.js:40)
    at HTMLDocument.<anonymous> (just-the-docs.js:439)

Looks like this on Chrome on my Mac:

https://makeabilitylab.github.io/physcomp/arduino/led-fade.html#pulse-width-modulation-pwm

https://makeabilitylab.github.io/physcomp/arduino/force-sensitive-resistors.html

Static site generator options

Python

• mkdocs.org.

Rust

• mdbook. Examples below:
  • Intro to Reverse Engineering

Jekyll

Jekyll is built in Ruby.

To build the docs with Jekyll,

• Open iTerm in /physcomp/docs
• > bundle
• > bundle exec jekyll serve (actually, use > bundle exec jekyll serve --baseurl '')
• Follow directions for web address, typically: https://127.0.0.1:4000

The Salae website has a very nice lil feedback widget on their webpage for "was this page useful" Not sure how we could collect such things without a backend server, however.

In "Intro to Arduino L2", the code links on Brett Hagman's tone library are not valid anymore. I suggest using Brett's GitHub page instead: https://github.com/bhagman/Tone.

To compile the library on the ATmegaA32U4 boards such as the Leonardo board, we need to modify Tone.cpp. Below describes the steps to use the library.

1. To use the advanced library, go to Brett's GitHub repository and download the files as a zip package.
2. Upon downloaded, unzip the package in \Arduino\libraries\ and rename the folder with "Tone".
3. Replace Tone.cpp with a revised version (thanks to Kwok Leong).
4. Now the library is ready.

Student commented that our diagrams are all showing Uno but students have Leonardo boards. Should make it clear in initial lesson that it doesn't matter (and what these differences are). I covered this in lecture but should be re-iterated in lessons.

From: https://electronics.stackexchange.com/questions/622129/can-anybody-explain-these-examples

Have a "DIY FSR" lesson with graphite pencil. Could also do one with conductive thread, etc.

https://makeabilitylab.github.io/physcomp/arduino/force-sensitive-resistors.html

Extracted from website-dev.md

Website TODOs

• Make all videos hosted on YouTube rather than direct embeds to reduce website size
• [done] Add in incremental build option
• [Done] Update format for blockquote in "just the docs" to https://codepen.io/cliftwalker/pen/XJaEXY
  • Need to modify the css style:
  • See: https://aregsar.com/blog/2019/how-to-customize-your-github-pages-blog-style-in-five-minutes/
  • https://pmarsceill.github.io/just-the-docs/docs/customization/#override-styles
  • Here's miminimal mistakes version: https://raw.githubusercontent.com/mmistakes/minimal-mistakes/master/docs/_posts/2013-01-11-markup-html-tags-and-formatting.md
    • And the scss: https://github.com/mmistakes/minimal-mistakes/blob/0cf1a2e1144336b5e026d13b5fd87dc2af02fe8c/_sass/minimal-mistakes/_base.scss
• [Done] Add in Discussion support. Update: OK, did this with disqus platform
• Add in 'info box` support like minimal mistakes
  • See: https://mmistakes.github.io/minimal-mistakes/docs/utility-classes/
  • https://github.com/mmistakes/minimal-mistakes/blob/e749af9ff82014b6523ee19a2057d5fe6971d427/_sass/minimal-mistakes/_notices.scss
• Add in auto-TOC (Table of contents) with sticky support.
  • Working on this in a branch with: https://tscanlin.github.io/tocbot/
• Add in figure captioning support (minimal mistakes also has this)
• Explore how to add custom css in markdown
• Possible to add last modified date into file?
• Update all arduino code in github to include link back to website
• [Done] Embedding code from github repo into jekyll post
  • https://blog.revathskumar.com/2012/08/embed-files-from-github-repository-into-webpage.html
  • https://flowerinthenight.com/blog/2017/11/28/embed-github-code
• Have citation manager for references on each page?
  • https://www.amirasiaee.com/dailyreport/jekyll-scholar/
  • https://github.com/inukshuk/jekyll-scholar
  • Unfortunately, Jekyll Scholar plugin is not compatible with GitHub Pages
• Maybe have a top-level link for UW Courses?
• How to hide headers in tables in markdown?
  • https://stackoverflow.com/questions/17536216/create-a-table-without-a-header-in-markdown
• Make Next/Previous buttons same size like in Minimal Mistakes?
• Make it so if you left-click on an image, it shows up as a pop-up with a description below?
• Make YouTube videos responsive
  • https://avexdesigns.com/responsive-youtube-embed/
  • https://embedresponsively.com/
• Serve images responsively with jekyll plugin: https://github.com/rbuchberger/jekyll_picture_tag
• Add build script (in ruby?) to inject google analytics into the html-ized .pynbs
• Interactive dtw visualization in p5s. Maybe have user draw the two signals and run dtw, fill out table, and show heat plot? Could also select from some predefined signals
• This goes along with my interactive convoultion idea too.
• Jupyter Notebook with interactive visualization widgets: https://plotly.com/python/chart-events/
• [done] Add in acknowledgments in Jupyter Notebook: "open education statement + written by Jon Froehlich" Maybe at end of notebooks or as an H2 in Intro part?

Two typos:

Intro to Arduino (Input) - L2: "An-8 bit" -> "An 8-bit"

Intro to Arduino (Input) - L3: Delete the redundant "the"

Found by Mikael.

From L.W.:

The last row of the Common SI Prefixes Table repeats nano; I believe this should be pico at 10^-12!

For many of the Intro to Arduino pages, we designed Tinkercad simulation but do not yet link to them. Consider doing so?

It would be good if there was detail on how to:

• create new .h or .cpp files from within the Arduino IDE?
• make them appear in the editor

It sounds like doing this through the 'new tab' functionality works; I didn't know about this before asking about it in class, so it could be good for it to be included in the lesson instructions

Related to this Stackoverflow post:

https://stackoverflow.com/questions/18860693/mathjax-multi-line-equation-rendering-issue

I'd like to nicely left-align around the equal sign so I don't have to repeat RTotal and so this is not rendered in middle of screen:

From:
https://search.google.com/search-console/index?resource_id=https%3A%2F%2Fmakeabilitylab.github.io%2Fphyscomp%2F

On this page: Lesson 1: Intro to the CPX, the first ¶ contains a few documentation errors:

1. The name of the platform is "Circuit Playground Express", not "Circuit Express Playground".
2. It is a collaboration between Adafruit and Microsoft (who developed the original base platform MakeCode), not code.org.

Arduino as a mouse/keyboard.

I've made lots of examples (originally for HCID521)

ITP NYU has a tutorial:

• https://itp.nyu.edu/physcomp/labs/labs-mouse-control/lab-mouse-control-with-joystick/

Just parking this stuff here for now

https://github.com/cbteeple/docs
https://docs.cbteeple.com/

Need automatic table of contents on Jekyll-produced pages to make them more navigable:

https://tscanlin.github.io/tocbot/

I tried doing this in a branch but didn't get far because I'm still such a JavaScript/HTML no0b.

When you visit Google Analytics, you receive a message:

Universal Analytics will no longer process new data in standard properties beginning July 1, 2023. Prepare now by setting up and switching over to a Google Analytics 4 property.

One thing that worries me is that the Google support website says:

After July 1, 2023, you'll be able to access your previously processed data in your Universal Analytics property for at least six months. We know your data is important to you, and we strongly encourage you to export your historical reports during this time

So, like, would we still be able to access all previous visit logs, etc.

https://fab.cba.mit.edu/classes/863.20/doc/index.html

Good suggestion.

Installation notes from @EdigaHe. Need to incorporate into website-install.md

From a student:

The serial plotter is also very cool, but initially it is not clear that I have to print out the RGB values. I looked at the documentation online and it seems like Arduino handles the plotting automatically when the output is structured in a specific format.