# Lattice1 Firmware Reference

> **For Lattice firmware v0.18.9**

### Status Icons

Various icons appear in the status bar at the top of the Lattice firmware screen and are used to indicate various system statuses.

<table><thead><tr><th width="86" align="center">Icon</th><th>Description</th></tr></thead><tbody><tr><td align="center"><img src="/files/2T46dewdFUKT3wZqUV7I" alt="" data-size="line"></td><td><strong>Security mesh is armed</strong> and intact. Any break in the circuit will permanently lock the device.</td></tr><tr><td align="center"><img src="/files/BZITwi6bIfTyfmCFKokX" alt="" data-size="line"></td><td><strong>Security mesh is disarmed</strong> or has not been configured. The device will not permanently lock, but may be susceptible to intrusion attempts while disarmed. It cannot ever be re-armed if the circuit is broken while in this state.</td></tr><tr><td align="center"><img src="/files/GTtCbajXkNfbqwr7kgLU" alt="" data-size="line"></td><td>Device is connected to the Internet via <strong>WiFi</strong>.</td></tr><tr><td align="center"><img src="/files/OeaTAoHMDPXj8nzgHteP" alt="" data-size="line"></td><td>Device is connected to the Internet by a <strong>wired connection (Ethernet)</strong>.</td></tr><tr><td align="center"><img src="/files/HyeFLRBUMCcefCrtBLNy" alt="" data-size="line"></td><td>Device is <strong>not</strong> connected to the Internet.</td></tr><tr><td align="center"><img src="/files/Ihz1n3zIvCY6IJVIw0bB" alt="" data-size="line"></td><td><strong>Secure system has not yet connected to the router</strong>. It takes about a minute from boot for the two systems to connect.</td></tr><tr><td align="center"><img src="/files/vOjUXqSSCFOvr8u8mZKO" alt="" data-size="line"></td><td><strong>Secure system failed to connect to the router</strong>. There may be an issue with the device.</td></tr></tbody></table>

### Menus and Options

This section outlines different menus and options you will encounter in Lattice firmware.

#### Homescreen

<table><thead><tr><th width="94" align="center">Icon</th><th width="194">Label</th><th>Description</th></tr></thead><tbody><tr><td align="center"><p><img src="/files/bQf9T35RRRzLAxSQaZQq" alt="" data-size="line"></p><p> <img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"> </p></td><td><p><strong>Lattice1 Wallet</strong></p><p><strong>SafeCard Wallet</strong></p></td><td>View addresses related to the active wallet. Will read "SafeCard Wallet" if a card is inserted and unlocked, or "Lattice1 Wallet" otherwise. You can find your <a href="/pages/Gl5bzqtj0RaGpF7DSKgg"><strong>ETH staking keys</strong></a> here and also <a href="/pages/4Vu7zQqLOGRp1t9BG4nR"><strong>view the seed phrase</strong></a>.</td></tr><tr><td align="center"><a href="#manage-wallets"><img src="/files/aBfQOq0Ob6JVo553pqMd" alt="" data-size="line"> </a></td><td><a href="#manage-wallets"><strong>Manage Wallets</strong></a></td><td>Various actions related to the Lattice and/or SafeCard wallet. Options you can find here explained below.</td></tr><tr><td align="center"><a href="#permissions"><img src="/files/vQ7W8149Cnb8QQLA8Q6K" alt="" data-size="line"> </a></td><td><a href="#permissions"><strong>Permissions</strong></a></td><td>Manage permissions for connected applications.</td></tr><tr><td align="center"><a href="#system-preferences"><img src="/files/f884ug8r6Q6vhIbldNXt" alt="" data-size="line"> </a></td><td><a href="#system-preferences"><strong>System Preferences</strong></a></td><td>Manage settings, security configurations, and do advanced user things.</td></tr><tr><td align="center"><img src="/files/eHbaOkCrRht6wqavCxVh" alt="" data-size="line"> </td><td><strong>Device ID</strong></td><td>View the Device ID, which is needed to connect to external applications.</td></tr></tbody></table>

#### <img src="/files/aBfQOq0Ob6JVo553pqMd" alt="" data-size="line"> Manage Wallets

{% hint style="info" %}
For more details and a couple of examples, please see [**SafeCard Operations**](https://docs.gridplus.io/safecards/safecard-operations).
{% endhint %}

<table><thead><tr><th width="144" align="center">Icon</th><th width="214">Label</th><th>Description</th></tr></thead><tbody><tr><td align="center"><img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/bQf9T35RRRzLAxSQaZQq" alt="" data-size="line"> </td><td><strong>Restore from SafeCard</strong></td><td>With an unlocked SafeCard inserted, this copies that card's wallet to the Lattice. <strong>This will remove your current Lattice wallet</strong>.</td></tr><tr><td align="center"><img src="/files/bQf9T35RRRzLAxSQaZQq" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"> </td><td><strong>Backup to SafeCard</strong></td><td>Backup the Lattice wallet onto a SafeCard that has no wallet. This process must be started without a SafeCard inserted.</td></tr><tr><td align="center"><img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"> </td><td><strong>Copy SafeCard</strong></td><td>With an unlocked SafeCard inserted, this copies that card's wallet to a different SafeCard that has no wallet.</td></tr><tr><td align="center"><img src="/files/bQf9T35RRRzLAxSQaZQq" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/a8BG92Ik64XHi8J6ZIJe" alt="" data-size="line"> </td><td><strong>Change Lattice PIN</strong></td><td>Change the PIN for your Lattice device's system.</td></tr><tr><td align="center"><img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/a8BG92Ik64XHi8J6ZIJe" alt="" data-size="line"> </td><td><strong>Change SafeCard PIN</strong></td><td>Change the PIN for an unlocked and inserted SafeCard.</td></tr><tr><td align="center"><img src="/files/bQf9T35RRRzLAxSQaZQq" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/asFZ4v7VXiL65XOOphcs" alt="" data-size="line"> </td><td><strong>Reset Lattice Wallet</strong></td><td>Removes the current Lattice wallet.</td></tr><tr><td align="center"><img src="/files/gKbPQHHQZCq2Dt81PXhz" alt="" data-size="line"><img src="/files/uWVCgNrVlwQwWDlvwxPq" alt="" data-size="line"><img src="/files/asFZ4v7VXiL65XOOphcs" alt="" data-size="line"> </td><td><strong>Reset SafeCard Wallet</strong></td><td>Removes SafeCard wallet for card that is inserted and unlocked.</td></tr></tbody></table>

#### <img src="/files/vQ7W8149Cnb8QQLA8Q6K" alt="" data-size="line"> Permissions

The **Permissions menu** contains a list of connected applications (if any). These items are added when you pair an app with a Lattice and can be removed in this menu at any time.

Currently all connected apps have permission to make any type of request, but all signing requests must be authorized by the user by approving on the device screen.

#### <img src="/files/f884ug8r6Q6vhIbldNXt" alt="" data-size="line"> System Preferences

<table><thead><tr><th width="89" align="center">Icon</th><th width="178">Label</th><th>Description</th></tr></thead><tbody><tr><td align="center"><a href="#system-settings"><img src="/files/f884ug8r6Q6vhIbldNXt" alt="" data-size="line"> </a></td><td><a href="#system-settings"><strong>System Settings</strong></a></td><td>Manage various settings for the device.</td></tr><tr><td align="center"><a href="#security-and-privacy"><img src="/files/ErUwa7k0AhQcDevUB8WA" alt="" data-size="line"></a></td><td><a href="#security-and-privacy"><strong>Security &#x26; Privacy</strong></a></td><td>Manage security settings and reset subsystems.</td></tr><tr><td align="center"><a href="#wifi"><img src="/files/GTtCbajXkNfbqwr7kgLU" alt="" data-size="line"> </a></td><td><a href="#wifi"><strong>WiFi</strong></a></td><td>Setup WiFi or change network.</td></tr><tr><td align="center"><a href="#software-update"><img src="/files/sK8rI6scpJBVjyn8V9ws" alt="" data-size="line"> </a></td><td><a href="#software-update"><strong>Software Update</strong></a></td><td>Check for Lattice software updates.</td></tr><tr><td align="center"><img src="/files/eHbaOkCrRht6wqavCxVh" alt="" data-size="line"> </td><td><strong>Device Info</strong></td><td>Displays info such as software versions and SSH settings.</td></tr><tr><td align="center"><img src="/files/6lGo0eVTILVgHyW3s8Rb" alt="" data-size="line"> </td><td><strong>Help</strong></td><td>Scan a QR code to launch the docs page (i.e. this).</td></tr></tbody></table>

#### <img src="/files/f884ug8r6Q6vhIbldNXt" alt="" data-size="line"> System Settings

<table><thead><tr><th width="106" align="center">Icon</th><th width="183">Label</th><th>Description</th></tr></thead><tbody><tr><td align="center"><p><img src="/files/AEcgRh7DSDjJSdsXV87d" alt="" data-size="line"></p><p><img src="/files/pY4vDgBnKwgO5OPiozKC" alt="" data-size="line"> </p></td><td><strong>Confirm Mnemonic</strong></td><td><em><strong>Required</strong></em> or <em><strong>Not Required</strong></em>. If required, user must confirm four words for each newly generated mnemonic before the wallet can be setup with it. Does not apply to restore/backup/copy operations.</td></tr><tr><td align="center"><p><img src="/files/AEcgRh7DSDjJSdsXV87d" alt="" data-size="line"></p><p><img src="/files/pY4vDgBnKwgO5OPiozKC" alt="" data-size="line"> </p></td><td><strong>bech32 addresses</strong></td><td><em><strong>Enabled</strong></em> or <em><strong>Disabled</strong></em>. If enabled, bech32 style addresses will be the default for Bitcoin. Otherwise, wrapped segwit addresses will be the default. Note that any address type may be requested by an app regardless of this setting.</td></tr><tr><td align="center"><img src="/files/LOHsz9TmtZRZ80n8ePzc" alt="" data-size="line"> </td><td><strong>Screen Brightness</strong></td><td>Adjust the brightness of all screens.</td></tr><tr><td align="center"><img src="/files/ovAIVSxVWly1Qv02yFfd" alt="" data-size="line"> </td><td><strong>Sleep Timer</strong></td><td>Adjust the time it takes for the screen to go to sleep and lock (4 - 60 minutes).</td></tr></tbody></table>

#### <img src="/files/ErUwa7k0AhQcDevUB8WA" alt="" data-size="line"> Security & Privacy

<table><thead><tr><th width="86" align="center">Icon</th><th width="230">Label</th><th>Description</th></tr></thead><tbody><tr><td align="center"></td><td><strong>Encryption Password</strong></td><td>Used for exporting secure data, currently only useful for <a href="/pages/Gl5bzqtj0RaGpF7DSKgg"><strong>staking ETH</strong></a>.</td></tr><tr><td align="center"><img src="/files/ZVCnvOwWfJG1K6zepVqF" alt="" data-size="line"> </td><td><strong>Verify Lattice</strong></td><td>Verify the authenticity of your Lattice device. Read more about <a href="https://docs.gridplus.io/lattice1-guides/how-to-verify-that-your-lattice1-is-authentic"><strong>this feature and how it works here</strong></a>.<br><br>You can also claim a unique <a href="https://docs.gridplus.io/lattice1/lattice1-guides/how-to-claim-your-verified-lattice1-owner-poap"><strong>Lattice owner POAP</strong></a> via this feature!</td></tr><tr><td align="center"><img src="/files/cBLCJhQ91jDhb0XSQNCN" alt="" data-size="line"> </td><td><strong>Configure Security Mesh</strong></td><td>Arm or disarm the security mesh. If the mesh is armed, any break in the circuit will permanently lock the device. This is designed to prevent physical intrusion attempts.</td></tr><tr><td align="center"><img src="/files/0r3YX8SolkRGaMftjypW" alt="" data-size="line"> </td><td><strong>Reset Router</strong></td><td>Perform a factory reset on your router module. Will remove wifi network and generate a new <strong>Device ID</strong>. This may result in an automatic update to sync with the latest router software version. <br><br>This action will <strong>NOT</strong> reset your crypto wallet currently stored on the Lattice.</td></tr><tr><td align="center"><img src="/files/ErUwa7k0AhQcDevUB8WA" alt="" data-size="line"> </td><td><strong>Reset Secure System</strong></td><td>Perform a factory reset on your <strong>secure system</strong> module. <strong>Will erase your Lattice wallet</strong>, system PIN, and all secure data.<br><br><strong>Only</strong> do this if you have a <strong>backup</strong> of your wallet - seed phrase and/or SafeCard!</td></tr></tbody></table>

#### <img src="/files/GTtCbajXkNfbqwr7kgLU" alt="" data-size="line"> WiFi

The WiFi menu allows you to view your current WiFi network, forget your current WiFi network, and/or connect to a new network. The device may only connect to one WiFi network at a time and may not connect to WiFi if a wired (Ethernet) connection was established when the device booted.

#### <img src="/files/sK8rI6scpJBVjyn8V9ws" alt="" data-size="line"> Software Update

This menu option will check for the latest versions of Lattice software.

<table><thead><tr><th width="150">Software Type</th><th width="268">Description</th><th width="183">Installation Method</th><th width="166">Latest Version</th></tr></thead><tbody><tr><td><strong>Firmware</strong></td><td>Runs the Lattice UI and all secure systems.</td><td>User approval required</td><td>0.18.9</td></tr><tr><td><strong>Bootloader</strong></td><td>Secure bootloader for Lattice firmware. Ensures firmware updates are signed and valid.</td><td>User approval required</td><td>0.3.3</td></tr><tr><td><strong>Router</strong></td><td>Routes encrypted messages from the Internet to firmware. This software exists on a different physical chip than the secure system.</td><td>Automatic</td><td>0.49.0</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gridplus.io/lattice1/lattice1-firmware-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
