Skip to content

docs: improve ESP32 flashing guide clarity and fix typos#16

Open
jjsilva510 wants to merge 2 commits intoFreedomLabNYC:mainfrom
jjsilva510:docs/improve-esp32-flashing-guide
Open

docs: improve ESP32 flashing guide clarity and fix typos#16
jjsilva510 wants to merge 2 commits intoFreedomLabNYC:mainfrom
jjsilva510:docs/improve-esp32-flashing-guide

Conversation

@jjsilva510
Copy link
Contributor

  • Improve sentence structure and readability
  • Clarify COM port selection instructions
  • Enhance image descriptions

- Fix spelling errors (splash, ensures)
- Improve sentence structure and readability
- Add proper punctuation and consistent capitalization
- Clarify COM port selection instructions
- Enhance image descriptions
6. That's it! A progress bar should show up, and when it's finished, you're ready to set it up.

7. The LilyGo T-Display should show a quick splash screen that says "Jade DIY", after which it should display the following screen:
![alt text](<../assets/freshly flashed DIYJade.jpg>)
Copy link
Member

Choose a reason for hiding this comment

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

same thing with this img. needs to be in the PR. maybe we should start using GIT LFS but that's for a different conversation

Copy link
Member

Choose a reason for hiding this comment

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

in the future, let’s avoid spaces in file names. i’m not sure this will be linked properly


* An existing Lightning Wallet that you can use to fund your LNbits account with.
* A Mobile Phone with NFC support (Only actually works with android).
* A BoltRing or NFC424 enabled device that has not been set up yet (or has been [wiped](./#)).
Copy link
Member

Choose a reason for hiding this comment

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

i’m not sure where this link goes. is this correct?


## Step 1 - Install Bolt Card Creator

If you have an **Android** phone install the **Bolt Card NFC Card Creator App** from Google Play. If you are using an **iPhone** install the **Boltcard NFC Programmer** from the App Store. This doesn't really work well with iPhone.
Copy link
Member

Choose a reason for hiding this comment

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

we should link to these apps


1. Select the **Advanced** tab at the bottom of the start screen of the Bolt Card Creator App.
2. Select the **Read NFC** tab on the stacked menu.

Copy link
Member

Choose a reason for hiding this comment

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

Suggested change

extra new line

Smartphones have their NFC antenna in different places. Usually, it is in the upper third of the back of the phone. While scanning the BoltRing, pay attention to the position the app detects the BoltRing. Knowing the antenna position will give you more confidence when writing the configuration to the BoltRing later.

> **Error: This NFC card has not been formatted.**
> If you get this error, you can use the **NXP TagWriter App** to erase and format your tag as NDEF.
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 link to this app


1. Click on **Manage Extensions** in the left menu.
2. Click **ENABLE** on the **Bolt Cards** tile.

Copy link
Member

Choose a reason for hiding this comment

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

ui screenshots would be great here. there’s also an extra newline above 3

* Click **CREATE CARD**.


3. After clicking **CREATE CARD**, you should see the card service created. Click the **QR Code** in the first column of the list to show the QR code you need in the next step.
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 remove extra lines and add ui screenshots

3. Scan the **QR code** from the LNbits popup (from Step 5) using the app's QR code scanner.
4. The app will show "Bolt Card Service URL received" and populate the write fields.
5. Press the **WRITE** button.
6. Scan your BoltRing by holding it to the back of your phone (at the antenna location you found in Step 1).
Copy link
Member

Choose a reason for hiding this comment

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

add ui screenshots

Copy link
Member

@sat-engineer sat-engineer left a comment

Choose a reason for hiding this comment

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

ideally there would’ve been a separate PR for a new class

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.

2 participants