Skip to content

Commit 7e91685

Browse files
committed
clarification about hivemq ca file
1 parent f4ae85f commit 7e91685

3 files changed

+9
-1
lines changed

docs/courses/hello-world/1.1-running-the-demo.ipynb

+4
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@
1818
"```{include} ./hardware-note.md\n",
1919
"```\n",
2020
"\n",
21+
"```{warning}\n",
22+
"Recently, HiveMQ Cloud changed such that `hivemq-com-chain.der` (a Certificate Authority (CA) file) is not transferrable across different broker instances. The [latest `hivemq-com-chain.der` file](https://raw.githubusercontent.com/sparks-baird/self-driving-lab-demo/main/src/public_mqtt_sdl_demo/hivemq-com-chain.der) from [`self-driving-lab-demo`](https://github.com/sparks-baird/self-driving-lab-demo) will be hard-coded to the `self-driving-lab-demo` public test credentials (i.e., what is used in Module 1 - Running the Demo), so the *tutorials* should run without issue as long as you are using that file. However, the *assignment* requires you to have your own HiveMQ Cloud broker instance, so you will need to [generate a `hivemq-com-chain.der` file specific to your instance](https://colab.research.google.com/github/sparks-baird/self-driving-lab-demo/blob/main/notebooks/7.2.1-hivemq-openssl-certificate.ipynb) and upload it to your microcontroller in place of the default one.\n",
23+
"```\n",
24+
"\n",
2125
"Learn how to build a Closed-loop Spectroscopy Lab: Light-mixing Demo (CLSLab:Light) to\n",
2226
"perform color matching via RGB LEDs and a light sensor for under 100 USD and less than an hour\n",
2327
"of setup. The tutorial covers ordering parts, verifying prerequisites, software setup, sensor\n",

docs/courses/hello-world/1.4-hardware-software-communication.ipynb

+1-1
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
"## 🔰 Tutorial\n",
1717
"\n",
1818
"```{warning}\n",
19-
"Recently, HiveMQ Cloud changed such that the Certificate Authority (CA) file, `hivemq-com-chain.der`, is not transferrable across different broker instances. The [latest `hivemq-com-chain.der` file](https://raw.githubusercontent.com/sparks-baird/self-driving-lab-demo/main/src/public_mqtt_sdl_demo/hivemq-com-chain.der) from [`self-driving-lab-demo`](https://github.com/sparks-baird/self-driving-lab-demo) will be hard-coded to the `self-driving-lab-demo` public test credentials (i.e., what is used in Module 1 - Running the Demo), so the tutorials should run without issue as long as you are using that file. However, the assignment requires you to create your own HiveMQ Cloud broker instance, so you will need to follow the assignment README instructions there to generate your a `hivemq-com-chain.der` file specific to your instance.\n",
19+
"Recently, HiveMQ Cloud changed such that `hivemq-com-chain.der` (a Certificate Authority (CA) file) is not transferrable across different broker instances. The [latest `hivemq-com-chain.der` file](https://raw.githubusercontent.com/sparks-baird/self-driving-lab-demo/main/src/public_mqtt_sdl_demo/hivemq-com-chain.der) from [`self-driving-lab-demo`](https://github.com/sparks-baird/self-driving-lab-demo) will be hard-coded to the `self-driving-lab-demo` public test credentials (i.e., what is used in Module 1 - Running the Demo), so the *tutorials* should run without issue as long as you are using that file. However, the *assignment* requires you to have your own HiveMQ Cloud broker instance, so you will need to [generate a `hivemq-com-chain.der` file specific to your instance](https://colab.research.google.com/github/sparks-baird/self-driving-lab-demo/blob/main/notebooks/7.2.1-hivemq-openssl-certificate.ipynb) and upload it to your microcontroller in place of the default one.\n",
2020
"```\n",
2121
"\n",
2222
"In this tutorial, you will learn how to send commands to and receive sensor data from a microcontroller using the MQTT protocol.\n",

docs/courses/hello-world/1.6-connecting-the-pieces.ipynb

+4
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,10 @@
1919
"As a temporary workaround to the issue described in https://github.com/orgs/micropython/discussions/15112, add [`urequests_2.py`](https://github.com/AccelerationConsortium/ac-microcourses/blob/main/docs/courses/hello-world/urequests_2.py) [[permalink](https://github.com/AccelerationConsortium/ac-microcourses/blob/e5541ce3ec307a8e5e0f2b20f000c03f040e1f56/docs/courses/hello-world/urequests_2.py)] to your microcontroller, and change `import urequests` to `import urequests_2 as urequests` in the code below. See https://github.com/orgs/micropython/discussions/15112 and https://github.com/micropython/micropython-lib/pull/861 for ongoing updates. The corresponding assignment will also be affected, but this can be addressed using the same workaround.\n",
2020
"```\n",
2121
"\n",
22+
"```{warning}\n",
23+
"Recently, HiveMQ Cloud changed such that `hivemq-com-chain.der` (a Certificate Authority (CA) file) is not transferrable across different broker instances. The [latest `hivemq-com-chain.der` file](https://raw.githubusercontent.com/sparks-baird/self-driving-lab-demo/main/src/public_mqtt_sdl_demo/hivemq-com-chain.der) from [`self-driving-lab-demo`](https://github.com/sparks-baird/self-driving-lab-demo) will be hard-coded to the `self-driving-lab-demo` public test credentials (i.e., what is used in Module 1 - Running the Demo), so the *tutorials* should run without issue as long as you are using that file. However, the *assignment* requires you to have your own HiveMQ Cloud broker instance, so you will need to [generate a `hivemq-com-chain.der` file specific to your instance](https://colab.research.google.com/github/sparks-baird/self-driving-lab-demo/blob/main/notebooks/7.2.1-hivemq-openssl-certificate.ipynb) and upload it to your microcontroller in place of the default one.\n",
24+
"```\n",
25+
"\n",
2226
"You've made it to the final module of this microcourse! Well done 🥳. In this module, you will connect the pieces from previous modules into the \"Hello World\" of self-driving labs, from microcontroller programming and Bayesian optimization to hardware-software communication and data logging.\n",
2327
"\n",
2428
"<img src=\"../../_static/connecting-pieces.png\" width=80%>\n",

0 commit comments

Comments
 (0)