diff options
Diffstat (limited to '_posts')
| -rw-r--r-- | _posts/2025-07-23-set-up-mock-server.markdown | 59 | ||||
| -rw-r--r-- | _posts/2025-07-23-welcome-to-jekyll.markdown | 29 |
2 files changed, 59 insertions, 29 deletions
diff --git a/_posts/2025-07-23-set-up-mock-server.markdown b/_posts/2025-07-23-set-up-mock-server.markdown new file mode 100644 index 0000000..8d2855c --- /dev/null +++ b/_posts/2025-07-23-set-up-mock-server.markdown @@ -0,0 +1,59 @@ +--- +layout: post +title: "Set up a mock server" +date: 2025-07-23 09:06:41 +0800 +--- + +When setting up or pairing your AIRMX Pro with our [setup page][setup-page], +it's important to first configure [the mock API server][server]. This is +necessary because when your device receives the Wi-Fi credentials during +the process, it attempts to connect to the internet and sends a device +registration request to _i.airmx.cn_ for identification. + +Unfortunately, the endpoint is hardcoded in the firmware, and we cannot modify +it during the setup process. Therefore, we need to remap this domain name in +the upstream device—the router. + +Since every router has a different configuration, you can consult your +router's manual or use an open-source DNS tool, or configure a DNAT rule +with IPTables. For instance, if you are using a router running on EdgeOS and +you have set up the mock server on your Raspberry Pi, which is accessible at +_192.168.10.10_, you can use the following commands: + +{% highlight bash %} +set system static-host-mapping host-name i.airmx.cn inet 192.168.10.10 +set system static-host-mapping host-name mqtt.airmx.cn inet 192.168.10.10 +{% endhighlight %} + +It's essential to also configure _mqtt.airmx.cn_, as this is the domain name +for the MQTT broker that the device connects to after completing the +registration request. All device status updates and remote controls are +handled through this broker. Meanwhile, _i.airmx.cn_ is responsible for +processing device registration requests, and the device will periodically sync +the time with this endpoint. + +I am using [Eclipse Mosquitto][mosquitto] as the MQTT broker and configuring +it for **anonymous** access since I only run it on my home network. Here’s the +configuration file `mosquitto.conf` that I use to start the service: + +{% highlight conf %} +listener 1883 +allow_anonymous true +{% endhighlight %} + +Ensure that the network traffic from your AIRMX Pro and your computer is +routed through the configured router. You can test the DNS resolution using +the `ping` command: + +{% highlight bash %} +ping i.airmx.cn +{% endhighlight %} + +If the configuration is correct, you should see that the resolved IP address +is _192.168.10.10_ (replace with your local server's IP). Once confirmed, you +can return to [the setup page][setup-page] and continue pairing your device. + + +[setup-page]: https://github.com/openairmx/setup +[server]: https://github.com/openairmx/server +[mosquitto]: https://mosquitto.org diff --git a/_posts/2025-07-23-welcome-to-jekyll.markdown b/_posts/2025-07-23-welcome-to-jekyll.markdown deleted file mode 100644 index 2f99048..0000000 --- a/_posts/2025-07-23-welcome-to-jekyll.markdown +++ /dev/null @@ -1,29 +0,0 @@ ---- -layout: post -title: "Welcome to Jekyll!" -date: 2025-07-23 09:06:41 +0800 -categories: jekyll update ---- -You’ll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run `jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated. - -Jekyll requires blog post files to be named according to the following format: - -`YEAR-MONTH-DAY-title.MARKUP` - -Where `YEAR` is a four-digit number, `MONTH` and `DAY` are both two-digit numbers, and `MARKUP` is the file extension representing the format used in the file. After that, include the necessary front matter. Take a look at the source for this post to get an idea about how it works. - -Jekyll also offers powerful support for code snippets: - -{% highlight ruby %} -def print_hi(name) - puts "Hi, #{name}" -end -print_hi('Tom') -#=> prints 'Hi, Tom' to STDOUT. -{% endhighlight %} - -Check out the [Jekyll docs][jekyll-docs] for more info on how to get the most out of Jekyll. File all bugs/feature requests at [Jekyll’s GitHub repo][jekyll-gh]. If you have questions, you can ask them on [Jekyll Talk][jekyll-talk]. - -[jekyll-docs]: https://jekyllrb.com/docs/home -[jekyll-gh]: https://github.com/jekyll/jekyll -[jekyll-talk]: https://talk.jekyllrb.com/ |