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)