Fix RGB mapping, add to docs

Author: grega

examples/interstate75/README.md

@@ -10,12 +10,15 @@ Follow Pimoroni's guide: https://learn.pimoroni.com/article/getting-started-with
 
 (be sure to utilise the "... with filesystem" firmware)
 
-Once connected to the device:
-  - Copy the `flight_display.py` file onto the device
+This example was tested on Interstate 75 firmware version `0.0.5`.
+
+Once connected to the I75 device:
+  - Copy the `flight_display.py` file onto the device (optionally rename it to `main.py` to run on boot)
   - Set `API_URL` in `flight_display.py`
-  - Configure the location by editing `LATITUDE`, `LONGITUDE` and `RADIUS` in `flight_display.py`
+  - Set the config options towards the top of `flight_display.py`, including the location `LATITUDE`, `LONGITUDE` and `RADIUS`
   - Optionally adjust the quiet time settings in `flight_display.py` (show nothing on the display between these times)
     - Be sure to set `UTC_OFFSET` to correctly calculate quiet time based on your timezone
+  - Note the line `color_order=Interstate75.COLOR_ORDER_GRB` in `flight_display.py` - this was required for the specific panel tested, but you may need to change it back to `COLOR_ORDER_RGB` or another value depending on your panel
   - Create a `secrets.py` file containing:
 
     ```python

examples/interstate75/flight_display.py

@@ -6,7 +6,8 @@
 import urequests
 from interstate75 import Interstate75, DISPLAY_INTERSTATE75_64X32
 
-i75 = Interstate75(display=DISPLAY_INTERSTATE75_64X32)
+# the specific panel this was tested on had "RGB" values flipped to "GRB"; you might need to swap back to `COLOR_ORDER_RGB` (or another value)
+i75 = Interstate75(display=DISPLAY_INTERSTATE75_64X32, color_order=Interstate75.COLOR_ORDER_GRB)
 display = i75.display
 
 WIDTH  = i75.width # 64 pixels
@@ -31,15 +32,15 @@
 QUIET_END_HOUR     = 7
 QUIET_END_MINUTE   = 0
 
-# colors (RGB values are weirdly off, it's more like "GBR" - bug in I75 v0.0.5?)
+# colours, see `color_order=Interstate75.COLOR_ORDER_GRB` above (specifically `COLOR_ORDER_GRB`)
 BLACK   = display.create_pen(0, 0, 0)
 WHITE   = display.create_pen(*((255, 255, 255) if BRIGHT_MODE else (200, 200, 200)))
-RED     = display.create_pen(*((64, 64, 255) if BRIGHT_MODE else (32, 32, 128)))
-GREEN   = display.create_pen(*((255, 64, 64) if BRIGHT_MODE else (128, 32, 32)))
-BLUE    = display.create_pen(*((64, 255, 64) if BRIGHT_MODE else (32, 128, 32)))
-CYAN    = display.create_pen(*((255, 255, 64) if BRIGHT_MODE else (128, 128, 32)))
-MAGENTA = display.create_pen(*((64, 255, 255) if BRIGHT_MODE else (32, 128, 128)))
-YELLOW  = display.create_pen(*((255, 64, 255) if BRIGHT_MODE else (128, 32, 128)))
+BLUE    = display.create_pen(*((64, 64, 255) if BRIGHT_MODE else (32, 32, 128)))
+RED     = display.create_pen(*((255, 64, 64) if BRIGHT_MODE else (128, 32, 32)))
+GREEN   = display.create_pen(*((64, 255, 64) if BRIGHT_MODE else (32, 128, 32)))
+CYAN    = display.create_pen(*((0, 255, 255) if BRIGHT_MODE else (0, 128, 128)))
+MAGENTA = display.create_pen(*((255, 0, 255) if BRIGHT_MODE else (128, 0, 128)))
+YELLOW  = display.create_pen(*((255, 255, 0) if BRIGHT_MODE else (128, 128, 0)))
 
 # font
 display.set_font("bitmap8")