mirror of
https://github.com/EyeTrackVR/EyeTrackVR-Docs.git
synced 2025-11-04 14:49:44 +08:00
2 lines
7.6 KiB
JavaScript
2 lines
7.6 KiB
JavaScript
import{_ as d,a as h}from"./chunks/index.7dc7ff16.js";import{_ as i,i as r}from"./chunks/index.6e6e7312.js";import{o as l,c as u,k as o,a as t,E as a,l as n,O as s,w as c}from"./chunks/framework.79850ceb.js";const b=JSON.parse('{"title":"Configuring the firmware","description":"","frontmatter":{},"headers":[],"relativePath":"firmware_guide/configure_firmware.md","filePath":"firmware_guide/configure_firmware.md","lastUpdated":1700510338000}'),p={name:"firmware_guide/configure_firmware.md"},P=Object.assign(p,{setup(f){return(m,e)=>(l(),u("div",null,[e[1]||(e[1]=o("h1",{class:"text-[var(--font-accent)]",id:"configuring-the-firmware",tabindex:"-1"},[t("Configuring the firmware "),o("a",{class:"header-anchor",href:"#configuring-the-firmware","aria-label":'Permalink to "Configuring the firmware {.text-[var(--font-accent)]}"'},"")],-1)),e[2]||(e[2]=o("h2",{id:"once-you-have-opened-the-project-you-should-see-something-on-the-left-side-like-this",tabindex:"-1"},[t("Once you have opened the project, you should see something on the left side like this "),o("a",{class:"header-anchor",href:"#once-you-have-opened-the-project-you-should-see-something-on-the-left-side-like-this","aria-label":'Permalink to "Once you have opened the project, you should see something on the left side like this"'},"")],-1)),a(i,{options:n(r).configure_firmware_one},null,8,["options"]),e[3]||(e[3]=o("h2",{id:"open-the-ini-user-config-ini-file",tabindex:"-1"},[t("Open the "),o("code",null,"ini/user_config.ini"),t(" file "),o("a",{class:"header-anchor",href:"#open-the-ini-user-config-ini-file","aria-label":'Permalink to "Open the `ini/user_config.ini` file"'},"")],-1)),a(i,{options:n(r).configure_firmware_two},null,8,["options"]),e[4]||(e[4]=s('<div class="info custom-block"><p class="custom-block-title">INFO</p><p>These settings are applicable only when using Wi-Fi for communication with your computer. If you are using USB, you can skip to reading about <a href="#environments">Environments</a>.</p></div><p>Replace the placeholder text with your correct SSID (WiFi access point name), and password respectively.</p><div class="info custom-block"><p class="custom-block-title">INFO</p><p>Special characters such as <code>!</code> and <code>@</code> are not supported. If you have a special character in your password or ssid, you will need to change it.</p><p>Similarly, spaces are not supported in the SSID and password. If you have a space in either, you will need to change it.</p><p>The firmware supports AP mode, however it is not recommended. If you wish to use AP mode, you will need to set the <code>enableadhoc</code> to <code>1</code>.</p><p>Then, you will need to set the <code>ap_ssid</code> to the name of your AP, and <code>ap_password</code> to the password of your AP.</p><p>You can choose to leave the <code>ap_ssid</code> and <code>ap_password</code> as defaults, but you will need to set the <code>enableadhoc</code> to <code>1</code>.</p><blockquote><p><strong>Note</strong>: If you are enabling AP mode for both ESPs, you will need to set the <code>ap_ssid</code> and <code>ap_password</code> to different values for both ESPs. It is best to set AP mode only for one ESP, and leave the other ESP in STA mode. Connect the other ESP to the AP of the ESP in AP mode. Then connect your computer to the AP of the ESP in AP mode. This will allow you to connect to the ESP in AP mode, and the ESP in STA mode.</p></blockquote></div>',3)),a(d,{options:n(h).parts_list_one},{content:c(()=>e[0]||(e[0]=[o("p",null," Make sure your WiFi router has a 2.4 GHz band. While most do, this is not always the case. Setting each band (5GHz, and 2.4GHz) to different SSIDs is recommended, though not required. ",-1)])),_:1},8,["options"]),e[5]||(e[5]=s('<p>Double check that you have correctly entered your WiFi credentials and that said wifi network has a 2.4GHz band.</p><h3 id="additional-configuration" tabindex="-1">Additional configuration <a class="header-anchor" href="#additional-configuration" aria-label="Permalink to "Additional configuration""></a></h3><h4 id="mdns" tabindex="-1"><code>mDNS</code> <a class="header-anchor" href="#mdns" aria-label="Permalink to "`mDNS`""></a></h4><p>If you do not wish to manually keep track of the ESPs IP addresses and ports, you can enable the mDNS feature. This will allow you to connect to the ESPs using the following format: <code>http://<some_name>.local</code>. This feature only works when you are on the same network as the ESPs and have mDNS enabled on your computer. If you are using Windows, you can enable mDNS by following <a href="./mdns">this guide</a>.</p><h4 id="ota" tabindex="-1"><code>OTA</code> <a class="header-anchor" href="#ota" aria-label="Permalink to "`OTA`""></a></h4><p>The firmware supports OTA updates. This means that you can update the firmware without having to connect to the ESPs. To enable OTA updates, you will need to set the <code>enableota</code> to <code>1</code>. Then, you will need to set the <code>otapassword</code> to the password you wish to use to update the firmware. You will need to use this password to update the firmware. If you do not wish to use a password, you can set the <code>otapassword</code> to nothing. This will allow you to update the firmware without a password. However, this is not recommended, as anyone on your network will be able to update the firmware.</p><p>You will also need to set the <code>otaserverip</code> to the IP address of the ESP you wish to update. This is the IP address of the ESP you wish to update. If you are using mDNS, you can use the mDNS name of the ESP you wish to update. For example, if you are updating the ESP with the dns set to <code>http://esp32.local</code>, you will need to set the <code>otaserverip</code> to <code>http://esp32.local</code>.</p><h4 id="rest-api" tabindex="-1"><code>REST API</code> <a class="header-anchor" href="#rest-api" aria-label="Permalink to "`REST API`""></a></h4><p>The firmware also supports a fully featured REST API. This means that you can control the ESPs using a REST API. This feature is enabled by defauly, and can not be turned off.</p><p>This feature is used more for advanced users, and is not required for basic operation.</p><p>The REST API was developed to be used by our new app (still in development). However, it can be used by any REST API client, you can not send POST requests to the ESPs using a browser though, so some REST API functionality can only be used by tools like <a href="https://www.thunderclient.com/" target="_blank" rel="noreferrer">Thunder Client</a> or <a href="https://www.postman.com/" target="_blank" rel="noreferrer">Postman</a>.</p><p>The full REST API is documented <a href="/firmware_guide/rest_api.html">here</a>.</p><h4 id="environments" tabindex="-1"><code>Environments</code> <a class="header-anchor" href="#environments" aria-label="Permalink to "`Environments`""></a></h4><p>The firmware supports multiple environments. This means that we have full support for multiple types of ESPs. Each ESP is configured to be in a different environment. If you are using a different ESP, you will need to change the environment to the correct one.</p><p>Please reference the <a href="./../firmware_guide/environments">Firmware Enviroments Page</a> for more information.</p><h2 id="now-move-on-to-uploading-the-firmware" tabindex="-1"><a href="/firmware_guide/upload_and_update_firmware.html">Now, move on to uploading the firmware</a> <a class="header-anchor" href="#now-move-on-to-uploading-the-firmware" aria-label="Permalink to "[Now, move on to uploading the firmware](/firmware_guide/upload_and_update_firmware.html)""></a></h2>',16))]))}});export{b as __pageData,P as default};
|