1# Toulouse 2 3Toulouse is a nickname for a [Jetway PC](http://www.jetwayipc.com/product/hbjc130f731-series/) that 4Fuchsia developers use as a platform for writing networking software. It has multiple ethernet ports 5and mini-PCIe ports for adding wireless network adapters. 6 7## Toulouse Setup & Configuration 8 9You will need: 10- Toulouse hardware 11- Power supply (included with Toulouse) 12- Ethernet cable(s) 13- USB stick to get started 14- At least one of: 15 - Serial cable (e.g., StarTech USB null modem cable) 16 - HDMI + USB keyboard 17 18Tested Wifi/Bluetooth adapters include: 19* QCA6174A 20* QCA9880 21 22In your `fx set` commandline, add the following arguments: 23* `--board "garnet/boards/toulouse.gni"` 24* `--product "garnet/products/toulouse.gni"` 25* [optional] `--args "always_zedboot=true"` 26 27The last option will always boot to zedboot instead of booting off the paved image. You have to 28press 'm' before the timeout if you want to boot from disk, or re-pave without 29'always_zedboot=true'. One possible workaround is to use 'always_zedboot=true' when preparing the 30USB stick, and leaving the USB stick in when you want to netboot. Without the USB stick it will run 31off disk. 32 33By default the device boots from the internal storage first, and you cannot set USB drives as a 34generic default. 35 36Prepare a USB drive, using `fx mkzedboot` (see the [docs](usb_setup.md) for details, and see 37above for how to make a USB stick that can netboot). 38 39Insert the USB drive before powering on the device. Note: if the drive isn’t recognized, try using 40the other USB port. Some ports are flaky. 41 42On boot, press Esc or Del to enter the BIOS. This works over serial as well once the serial console 43is enabled (see below). 44 45In the "Boot" section, find the entry for USB UEFI and use the '+' key to move it to the top of the 46list. Press F4 to save and reset. 47 48To use the serial port on Debian/Ubuntu Linux, you may need to remove the 'brltty' program that 49wants to take over every serial port: `sudo apt-get remove brltty`. You will need to unplug/replug 50your serial cable after this to get it to work. 51 52## Serial consoles 53 54### Enabling serial for the BIOS 55 56In the "Advanced" section, open the "Serial Port Console Redirection" settings. Enable "Console 57Redirection" and ensure the "Console Redirection Settings" look similar to the following. (You may 58tune these to taste, if you know what you're doing.) 59* Terminal Type: VT-UTF8 60* Bits per second: 115200 61* Data Bits: 8 62* Parity: None 63* Stop Bits: 1 64* Flow Control: Off 65 66The other settings may be left at their default values. 67 68### Example Linux serial consoles (assumes a serial device at /dev/ttyUSB0) 69* screen /dev/ttyUSB0 115200' 70* picocom -b 115200 /dev/ttyUSB0 71* miniterm.py /dev/ttyUSB0 115200 72* minicom -o -t vt100 -b 115200 -D /dev/ttyUSB0 (Supports control chars. Use Ctrl+a q to quit)