MicroFruit Docs
Hi! And thanks for using the MicroFruit, built by Ben Strout. The MicroFruit is a small desk companion which will update the time, provide a weather forecast for a defined city, and tell you the time. In order to start using your MicroFruit though, you'll need to set up Wifi. You should see something like this when you first plug it in with the supplied USB cable.
The device will create a WiFi hotspot you can connect into named 'MicroFruit'. You should see this in your Wifi hotspot list:
Once connected, you'll need to open your web browser and connect to the captive portal which will allow you to configure your Wi-Fi connection and other parameters.
Once opened, you should see this webpage, click on 'Configure WiFi'.
Once you're on the WiFi configuration page, you'll have various options to set – such as the WiFi network you'd like the MicroFruit use to get weather and time updates, the password for that network, language, geographic location, and time zone information.
Note: Your language, city for weather, weather API token, and time zone will be set based on your shipping address. You can change these to something else if you'd like, see the next section of this guide to learn how to do that, but if you're happy with your current address – don't change these settings.
For now, let's just set up our WiFi network. Click the WiFi network you want to connect to, in our case this will be 'Wifi Connection', and then fill in the password. Once complete, click 'Save'.
Once saved, you should see the following message.
It should at this time, take a few minutes for your MicroFruit to connect to WiFi and then you should be in business. You'll now get a slide show of current weather, weather forecasts, and time/date. Enjoy your new little desk mate. 😊
If you want to change the city, timezone, WiFi settings or anything else you'll need to reset the configuration. This is super easy to do and you can accomplish this by sliding the bottom plate of the MicroFruit back to expose the reset button like this:
To reset, press the reset button once, wait until the "Hello" screen pops up, and press it once more. Do not press it more than two times. Once the "Hello" screen is displayed, you can connect into the WiFi hotspot and then make any changes you might need – the device will save and display your previous settings with the exception of your WiFi connection information.
Like with any changes, if your settings are already configured you'll want to reset the MicroFruit using the 'reset settings' instructions. MicroFruit uses the OpenWeatherAPI to provide weather information. You'll need to locate your new City code from the OpenWeatherMap website. To do this:
- Go to https://openweathermap.org/find?q= and search for a location.
- Go through the result set and select the entry closest to the actual location you want to display data for.
- Look in the URL of the browser – note the number in URL https://openweathermap.org/city/** 2657896 **. That number is the city code you'll need to add to the following field:
If for whatever reason you need to configure a new API key for MicroFruit, you can do so by signing up for one. Here's how you do this:
- Go to the signup page and sign up for a new OpenWeatherMap membership (it's free) https://home.openweathermap.org/users/sign_up
Once you've created and activated your account, you can now open the "API Keys" menu option on the OpenWeatherMap member portal.
To create a key, just type in the name of a key you'd like to generate, in our case let's use "MicroFruit" 
You'll then see a new API key appear. You'll need to copy and use the 'Key' value. Note – this is an example key only, and does not work.
You can change the timezone, but it uses the POSTIX format to determine which timezone you'll be using from the network time servers. There are 461 mappings which are documented here, look up the closest city/time zone from the following location:
https://github.com/nayarsystems/posix_tz_db/blob/master/zones.csv
In column one, there's the name of the time zone, and in column two, there's the code which is used for the time zone. If for example you wanted to set your time zone to EST or New York time, you'd find New York in the list, and copy the code in column two and paste that into the timezone field in the MicroFruit settings.
For common times in America, we've listed them in the application, but for the full list, you'll need to reference the mappings in the link above.