View source for IOT-GATE-RPi: Raspbian

== Overview ==
IOT-GATE-RPi comes with a Raspbian Linux image.
Raspbian Linux is a free operating system based on Debian optimized for the Raspberry Pi hardware.
It is the official supported operating system for Raspberry Pi.
Raspbian Linux image includes more than 35,000 software packages. Among them:
* Core system
* Debian package management system
* X11 Windowing System
* LXDE desktop manager
* SSH server and client
* Python, Scratch, Sonic Pi, Java and Mathematica
Additional images can be used with IOT-GATE-RPi. All optional images can be found in [https://www.raspberrypi.org/downloads/ Raspberry Pi downloads].
The [[IOT-GATE-RPi: Raspbian: Manual Installation]] page provides a brief introduction on how to install the Rasbian image.

== Using Raspbian Linux on IOT-GATE-RPi ==

=== Connection and Logging In ===
To login into the Linux system, use a keyboard and display or a serial console, connect through the network (ssh).

Use the following username and password to login: 
<pre>
raspberrypi login: pi
Password: raspberry
</pre>

=== Networking ===
For most home networks, no further configuration is required in order to be able to connect to the Internet. For this to work, the router should be configured for DHCP (Dynamic Host
Configuration Protocol).

To configure networking, edit {{filename|/etc/network/interfaces}} and {{filename|/etc/dhcpcd.conf}}.
For more information about Debian Linux network configuration read:
* [http://www.debian.org/doc/manuals/reference/ch05.en.html Network setup] chapter in the [http://www.debian.org/doc/manuals/reference/index.en.html Debian Reference]
* [https://wiki.debian.org/NetworkConfiguration Network Configuration] chapter in the [https://wiki.debian.org/ Debian Wiki]

The majority of network setup can be done via the {{filename|interfaces}} configuration file at {{filename|/etc/network/interfaces}}.
{{Note|'''auto''' line is required for interfaces that have to be brought up at boot time.}}

* Using DHCP to automatically configure the interface
<pre>
auto eth0
allow-hotplug eth0
iface eth0 inet dhcp
</pre>

* Configuring the interface manually
<pre>
auto eth0
    iface eth0 inet static
        address 192.168.1.170
        netmask 255.255.0.0
        gateway 192.0.0.1
</pre>

=== RTC ===
==== Accessing and setting the RTC ====
To access the RTC time and date run:
<pre>
root@cm-debian:~# hwclock
Sat Jan 1 00:00:00 2000 -10.011159 seconds
</pre>

To set the date and write it into the RTC do the following:
<pre>
root@cm-debian:~# date -s "31 JUL 2015 10:00:00"
Fri Jul 31 10:00:00 UTC 2015
root@cm-debian:~# hwclock -w
root@cm-debian:~# hwclock
Fri Jul 31 10:00:13 2015  -1.066224 seconds
</pre>

=== Wifi ===
IOT-GATE-RPi features 802.11b/g/n wireless connectivity solution.

==== WiFi Initialization ====
* WiFi requires no user interaction for being configured. The drivers get loaded automatically.
Make sure that the WiFi drivers are loaded:
<pre>
root@cl-rootfs:~# lsmod
rt2800usb                 18824  0
rt800lib                  80070  1
rt2x00usb                 12798  1
rt2x00lib                 48694  3
</pre>
The WiFi driver can be loaded manually using {{cmd|modprobe}}.

* {{cmd|iwconfig}} command from {{filename|wireless-tools}} package can be used to retrieve detailed information about the WiFi interfaces:
<pre>
root@cl-rootfs:~# iwconfig wlan0
wlan0     IEEE 802.11abgn  ESSID:off/any  
          Mode:Managed  Access Point: Not-Associated   Tx-Power=0 dBm   
          Retry short limit:7   RTS thr:off   Fragment thr:off
          Encryption key:off
          Power Management:on
</pre>
* Activate the interface:
<pre>
root@cl-rootfs:~# ifconfig wlan0 up
</pre>
* Sample WiFi scanning:
<pre>
root@cl-rootfs:~# iwlist wlan0 scan
</pre>
The output will show the list of Access Points and Ad-Hoc cells in range.
For more information about connecting to wireless networks and tuning WiFi interfaces refer to {{filename|wpa_supplicant}} and {{filename|wireless-tools}} man pages.

==== wpa_supplicant ====
* Configuration sample
Please open a {{cmd|wpa_supplicant}} configuration file bellow and put a network name and a password into the "ssid" and "psk" fields respectively.
<pre>
root@cl-rootfs:~# cat /etc/wpa_supplicant/wpa_supplicant.conf
ctrl_interface=/var/run/wpa_supplicant

network={
	ssid="wireless_network_name"
	key_mgmt=WPA-PSK
	psk="wireless_network_password"
}
</pre>
* Sample run
<pre>
root@cl-rootfs:~# ifconfig wlan0 up
root@cl-rootfs:~# wpa_supplicant -B -Dwext -c /etc/wpa_supplicant.conf -i wlan0
root@cl-rootfs:~# dhclient wlan0
</pre>

=== 4G/3G Cellular Modem ===
IOT-GATE-RPi is equipped with an on-board micro-SIM card socket and support cellular communication using 4G/3G cellular modem with USB interface in mini-PCIe form-factor.

{{:Transclusion: Debian: Cellular-modem-1}}
{{Note|{{filename|iot-gate-rpi_raspbian_2018-01-24.zip}} contains the package {{filename|rpi3-modem}} which takes care of all needed package installations.
When using the image burned to the eMMC provided by us, there is no need to install additional packages because {{filename|rpi3-modem}} is allready installed. In both cases continue to the [[#Loading kernel modules | Loading kernel modules]] section.}}

{{:Transclusion: Debian: Cellular-modem-2}}

=== GPIO access ===
{{:Transclusion: Debian: GPIO}}

=== Controller–area network (CAN) ===
IOT-GATE-RPi fitted with FCSD HAT board features MCP2515 stand-alone Controller Area Network interface.

===== Loading CAN modules =====
If the MCP2515 driver and/or Raw CAN protocol compiled as module(s), they must be loaded prior to enabling CAN interface.
* The MCP2515 driver gets loaded automatically. Make sure it is loaded: 
<pre>
root@cl-rootfs:~# lsmod | grep mcp
mcp251x                20480  0
can_dev                24576  1 mcp251x
</pre>
:The MCP2515 driver can be loaded manually:
<pre>
root@cl-rootfs:~# modprobe mcp251x
</pre>
* Load Raw CAN protocol module:
<pre>
root@cl-rootfs:~# modprobe can-raw
</pre>

{{:Transclusion: Debian: CAN Bus: CAN Iface}}

{{:Transclusion: Debian: CAN Bus: CAN Utils}}

=== RS-485 (Modbus) ===
IOT-GATE-RPi can support RS-485 half-duplex serial communications using the EB-RPI-FCSD add-on board.

To use this interface on ''/dev/ttyAMA0'', the login shell over serial must be disabled first:

* Open a terminal and type: <code>$ sudo raspi-config</code>
* Select option 5 "Interfacing options", select option P6 "Serial".
* On "Would you like a login shell to be accessible over serial" select no.
* On "Would you like the serial port hardware to be enabled" select yes.
* Select exit and reboot IOT-GATE-RPi.

==== Libmodbus ====

* Follow the installation instruction as described here: [https://github.com/stephane/libmodbus/wiki/Libmodbus-on-Raspberry-pi Libmodbus on Raspberry pi]

* To create a Modbus RTU context: <code>modbus_new_rtu("/dev/ttyAMA0", 115200, 'N', 8, 1)</code>

* The [https://github.com/dhruvvyas90/libmodbus Raspberry Pi fork] of libmodbus '''does not''' support IOT-GATE-RPi because it was built for GPIO pin based switching instead of automatic rx-tx switching.

==See also==
* [[IOT-GATE-RPi: Raspbian: Manual Installation]]
* [https://www.raspberrypi.org/downloads/ Raspberry Pi downloads]
* [http://www.debian.org/doc/manuals/reference/index.en.html Debian Reference]
* [https://wiki.debian.org/ Debian Wiki]



[[Category:Linux]]
[[Category:IOT-GATE-RPi]]