{"id":13414429,"url":"https://github.com/mongoose-os-apps/aws-uart","last_synced_at":"2025-07-12T16:06:58.321Z","repository":{"id":78166430,"uuid":"94149961","full_name":"mongoose-os-apps/aws-uart","owner":"mongoose-os-apps","description":null,"archived":false,"fork":false,"pushed_at":"2020-08-20T19:02:53.000Z","size":20,"stargazers_count":6,"open_issues_count":0,"forks_count":3,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-23T21:44:35.223Z","etag":null,"topics":["aws","esp8266","iot","mongoose-os","uart"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mongoose-os-apps.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-06-12T23:38:52.000Z","updated_at":"2019-10-24T11:00:17.000Z","dependencies_parsed_at":"2023-04-26T07:32:38.491Z","dependency_job_id":null,"html_url":"https://github.com/mongoose-os-apps/aws-uart","commit_stats":null,"previous_names":[],"tags_count":53,"template":false,"template_full_name":null,"purl":"pkg:github/mongoose-os-apps/aws-uart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongoose-os-apps%2Faws-uart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongoose-os-apps%2Faws-uart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongoose-os-apps%2Faws-uart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongoose-os-apps%2Faws-uart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mongoose-os-apps","download_url":"https://codeload.github.com/mongoose-os-apps/aws-uart/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mongoose-os-apps%2Faws-uart/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265017192,"owners_count":23698438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","esp8266","iot","mongoose-os","uart"],"created_at":"2024-07-30T21:00:21.066Z","updated_at":"2025-07-12T16:06:58.292Z","avatar_url":"https://github.com/mongoose-os-apps.png","language":"JavaScript","funding_links":[],"categories":["Awesome Mongoose OS [![Awesome](https://awesome.re/badge.svg)](https://awesome.re)"],"sub_categories":["Official Examples"],"readme":"# Mongoose OS \u0026 AWS IoT - UART and Thing Shadow example (Javascript)\n\n## Overview\nThis app does two things.\n- Reading UART 0 of ESP8266 and sending it to AWS IoT\n- Sending device metadata and two pins state to AWS IoT\n\n## How to install this app\n\n## Step 1: Import\n\n##### Via MOS UI tool\n- Install and start [mos tool](https://mongoose-os.com/software.html)\n- Switch to the Project page, find and import this app(if available otherwise follow the steps below), build and flash it:\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://mongoose-os.com/images/app1.gif\" width=\"75%\"\u003e\n\u003c/p\u003e\n\n##### Flash the app through command line\n\n- Clone this repo ```git clone https://github.com/mongoose-os-apps/aws-uart```\n- Go into the directory `aws-uart` and run `mos build --arch esp8266` ( Change the arch respectively )\n- After that, you should see a **build** directory in the current directory which will have the `fw.zip` binary\n- Run ```mos flash``` which flashes the current build\n- Run ```mos console``` and check\n\n## Step 2: Set up Wi-Fi\n\n- You can do this via mos tool UI or use command `mos wifi WIFI_NAME WIFI_PASSWORD`\n\nNote that `mos` talks to the device using RPC mechanism.\nRPC can talk over serial (uart), http, mqtt. By default, `mos` talks via uart.\nbut aws-uart example takes over uart, therefore mos RPC does not work.\nYou need to use another RPC channel - for example websocket. Therefore,\nupdate `mos.yml`, put your wifi credentials there, then build/flash,\nsee what IP address is assigned to your board, and start mos as\n`mos --port ws://IP_ADDRESS/rpc`.\n\n## Step 3: Set up and Provision AWS IoT thing, Policy\n\n- You can do this via mos tool UI or use command `mos aws-iot-setup --aws-iot-policy mos-default`\n- Create a thing in AWS IoT and you are done\n- Test this by going into AWS IoT MQTT test Console by subscribing to `mos/#` with QoS 1\n\n### Video\n[![Mongoose OS + AWS IoT](https://s3.amazonaws.com/mongoose-os/video-shot.png)](https://www.youtube.com/watch?v=2zZWANSQKqg \"Mongoose OS + AWS IoT\")\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongoose-os-apps%2Faws-uart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmongoose-os-apps%2Faws-uart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmongoose-os-apps%2Faws-uart/lists"}