Embedded Xinu - User contributions [en]

Main Page

2024-03-23T23:13:19Z

AGebhard:

= Welcome SIGCSE 2024! =
To find RISC-V assignments and writeups, see [https://github.com/a1g3/riscv-xinu-hw]. We have instructions for running Embedded Xinu on the Sipeed Nezha below. Check out "Building an Embedded Xinu Laboratory". For solutions to homework assignments, please email dennis (dot) brylow (at) marquette.edu or alexander (dot) gebhard (at) marquette.edu.

= Introduction =
'''Embedded Xinu''' is an ongoing research and implementation project in the area of Operating Systems and Embedded Systems. Its original goal was to re-implement and port the [[Xinu|Xinu Operating System]] to several embedded MIPS platforms, such as the Linksys [[WRT54GL]] router. Since then, Embedded Xinu has been ported to other platforms, such as the [[mipsel-qemu|QEMU MIPSel virtual environment]] and the [[Raspberry Pi]]; see the [[list of supported platforms]]. Although Embedded Xinu is still being developed and ported to new platforms, a laboratory environment and curriculum materials are already in use for courses in Operating Systems, Hardware Systems, Embedded Systems, Networking, and Compilers at Marquette University and other colleges/universities.

The Embedded Xinu project was conceived and is supervised by [https://www.cs.mu.edu/~brylow/ Dr. Dennis Brylow] and is being conducted by both graduate and undergraduate students in the [[Systems Laboratory]] in the [https://www.cs.mu.edu/ Computer Science] department of [https://www.mu.edu/ Marquette University] in Milwaukee, Wisconsin. The first major phase of work on Embedded Xinu began in the Summer of 2006.

Our project partners include [https://www.cse.buffalo.edu/~bina/ Dr. Bina Ramamurthy] at University of Buffalo (with whom we shared an [https://www.nsf.gov/pubs/2009/nsf09529/nsf09529.html NSF CCLI] grant), [https://cs.olemiss.edu/~ruth/wiki/doku.php Dr. Paul Ruth] at University of Mississippi, and [https://www.cs.purdue.edu/people/comer Dr. Doug Comer] (father of Xinu) at Purdue University.

== Teaching With Embedded Xinu ==

* For curriculum guidance on adopting or adapting Embedded Xinu for undergraduate coursework, see [[Teaching With Xinu]].
* Workshops have been held regarding teaching with Embedded Xinu. For example, the [https://www.cs.olemiss.edu/acmse2010/pdf/xinu.pdf Teaching With Embedded Xinu Workshop] at [https://www.cs.olemiss.edu/acmse2010/Home.htm ACMSE 2010] in Oxford, Mississippi (Ole Miss campus) shared ready-made curriculum resources that have been used successfully to teach hardware systems, operating systems, realtime/embedded systems, networking, and compilers with the Embedded Xinu platform at several colleges/universities.

== Building an Embedded Xinu Laboratory ==

In this section we are developing instructions so that other groups can benefit from the work we are doing. These guides can be followed more or less in order to create a relatively inexpensive platform for a custom operating system. As our work develops further, there will be more Xinu-specific information.

# Obtain a [[List of supported platforms|supported platform]].
# (Required if using a Linksys/Asus router) [[HOWTO:Modify the Linksys hardware|Modify the Linksys hardware]] or [[HOWTO:Modify the ASUS hardware|Modify the ASUS hardware]]
## [[HOWTO:Connect to a modified router|Connect to a modified router]]
# [[HOWTO:Build Xinu|Build Xinu]]
# [[HOWTO:Deploy Xinu|Deploy Xinu]]
# (Optional) [[HOWTO:Build Backend Pool|Build a pool of backends]]
# (Recommended) [[HOWTO:Backup your router|Backup your router's factory configuration]]

== Other Embedded Xinu Information ==

* MIPS [[processor]]
* Main [[memory]]
* [[Exception and Interrupt Handling]]
* [[UART driver]]
* [[TTY driver]]
* [[Switch driver]]
* [[Networking]]
* [[Flash memory]]
* [[Flashing firmware]]
* [[EJTAG|Enhanced Joint Test Action Group]] debugger
* [[Standard library]]
* [[XinuPhone]] Internet telephony
* [[Router Recovery]] aka "Debricking"
* [[Development]]
* [[Contributors]]

----

The Xinu Lab is brought to you in part by [[XMMS|M&M's]].
__NOTOC____NOEDITSECTION__

Main Page

2024-03-23T23:12:58Z

AGebhard:

= Welcome SIGCSE 2024! =
To find RISC-V assignments and writeups, see [https://github.com/a1g3/riscv-xinu-hw]. We have instructions for running Embedded Xinu on the Sipeed Nezha below. Check out "Building an Embedded Xinu Laboratory". For solutions to homework assignments, please email dennis (dot) brylow (at) marquette.edu or alexander (dot) gebhard (at) marquette.edu.

= Introduction =
'''Embedded Xinu''' is an ongoing research and implementation project in the area of Operating Systems and Embedded Systems. Its original goal was to re-implement and port the [[Xinu|Xinu Operating System]] to several embedded MIPS platforms, such as the Linksys [[WRT54GL]] router. Since then, Embedded Xinu has been ported to other platforms, such as the [[mipsel-qemu|QEMU MIPSel virtual environment]] and the [[Raspberry Pi]]; see the [[list of supported platforms]]. Although Embedded Xinu is still being developed and ported to new platforms, a laboratory environment and curriculum materials are already in use for courses in Operating Systems, Hardware Systems, Embedded Systems, Networking, and Compilers at Marquette University and other colleges/universities.

The Embedded Xinu project was conceived and is supervised by [https://www.cs.mu.edu/~brylow/ Dr. Dennis Brylow] and is being conducted by both graduate and undergraduate students in the [[Systems Laboratory]] in the [https://www.cs.mu.edu/Computer Science] department of [https://www.mu.edu/ Marquette University] in Milwaukee, Wisconsin. The first major phase of work on Embedded Xinu began in the Summer of 2006.

Our project partners include [https://www.cse.buffalo.edu/~bina/ Dr. Bina Ramamurthy] at University of Buffalo (with whom we shared an [https://www.nsf.gov/pubs/2009/nsf09529/nsf09529.html NSF CCLI] grant), [https://cs.olemiss.edu/~ruth/wiki/doku.php Dr. Paul Ruth] at University of Mississippi, and [https://www.cs.purdue.edu/people/comer Dr. Doug Comer] (father of Xinu) at Purdue University.

== Teaching With Embedded Xinu ==

* For curriculum guidance on adopting or adapting Embedded Xinu for undergraduate coursework, see [[Teaching With Xinu]].
* Workshops have been held regarding teaching with Embedded Xinu. For example, the [https://www.cs.olemiss.edu/acmse2010/pdf/xinu.pdf Teaching With Embedded Xinu Workshop] at [https://www.cs.olemiss.edu/acmse2010/Home.htm ACMSE 2010] in Oxford, Mississippi (Ole Miss campus) shared ready-made curriculum resources that have been used successfully to teach hardware systems, operating systems, realtime/embedded systems, networking, and compilers with the Embedded Xinu platform at several colleges/universities.

== Building an Embedded Xinu Laboratory ==

In this section we are developing instructions so that other groups can benefit from the work we are doing. These guides can be followed more or less in order to create a relatively inexpensive platform for a custom operating system. As our work develops further, there will be more Xinu-specific information.

# Obtain a [[List of supported platforms|supported platform]].
# (Required if using a Linksys/Asus router) [[HOWTO:Modify the Linksys hardware|Modify the Linksys hardware]] or [[HOWTO:Modify the ASUS hardware|Modify the ASUS hardware]]
## [[HOWTO:Connect to a modified router|Connect to a modified router]]
# [[HOWTO:Build Xinu|Build Xinu]]
# [[HOWTO:Deploy Xinu|Deploy Xinu]]
# (Optional) [[HOWTO:Build Backend Pool|Build a pool of backends]]
# (Recommended) [[HOWTO:Backup your router|Backup your router's factory configuration]]

== Other Embedded Xinu Information ==

* MIPS [[processor]]
* Main [[memory]]
* [[Exception and Interrupt Handling]]
* [[UART driver]]
* [[TTY driver]]
* [[Switch driver]]
* [[Networking]]
* [[Flash memory]]
* [[Flashing firmware]]
* [[EJTAG|Enhanced Joint Test Action Group]] debugger
* [[Standard library]]
* [[XinuPhone]] Internet telephony
* [[Router Recovery]] aka "Debricking"
* [[Development]]
* [[Contributors]]

----

The Xinu Lab is brought to you in part by [[XMMS|M&M's]].
__NOTOC____NOEDITSECTION__

MediaWiki:Sidebar

2024-03-23T02:27:43Z

AGebhard:

Main Page

2024-03-22T16:34:07Z

AGebhard:

= Welcome SIGCSE 2024! =
To find RISC-V assignments and writeups, see [https://github.com/a1g3/riscv-xinu-hw]. We have instructions for running Embedded Xinu on the Sipeed Nezha below. Check out "Building an Embedded Xinu Laboratory". For solutions to homework assignments, please email dennis (dot) brylow (at) marquette.edu or alexander (dot) gebhard (at) marquette.edu.

= Introduction =
'''Embedded Xinu''' is an ongoing research and implementation project in the area of Operating Systems and Embedded Systems. Its original goal was to re-implement and port the [[Xinu|Xinu Operating System]] to several embedded MIPS platforms, such as the Linksys [[WRT54GL]] router. Since then, Embedded Xinu has been ported to other platforms, such as the [[mipsel-qemu|QEMU MIPSel virtual environment]] and the [[Raspberry Pi]]; see the [[list of supported platforms]]. Although Embedded Xinu is still being developed and ported to new platforms, a laboratory environment and curriculum materials are already in use for courses in Operating Systems, Hardware Systems, Embedded Systems, Networking, and Compilers at Marquette University and other colleges/universities.

The Embedded Xinu project was conceived and is supervised by [http://www.mscs.mu.edu/~brylow/ Dr. Dennis Brylow] and is being conducted by both graduate and undergraduate students in the [[Systems Laboratory]] in the [http://www.mscs.mu.edu/ Math, Statistics, & Computer Science] department of [http://www.mu.edu/ Marquette University] in Milwaukee, Wisconsin. The first major phase of work on Embedded Xinu began in the Summer of 2006.

Our project partners include [http://www.cse.buffalo.edu/~bina/ Dr. Bina Ramamurthy] at University of Buffalo (with whom we shared an [http://www.nsf.gov/pubs/2009/nsf09529/nsf09529.html NSF CCLI] grant), [http://cs.olemiss.edu/~ruth/wiki/doku.php Dr. Paul Ruth] at University of Mississippi, and [http://www.cs.purdue.edu/people/comer Dr. Doug Comer] (father of Xinu) at Purdue University.

== Teaching With Embedded Xinu ==

* For curriculum guidance on adopting or adapting Embedded Xinu for undergraduate coursework, see [[Teaching With Xinu]].
* Workshops have been held regarding teaching with Embedded Xinu. For example, the [http://www.cs.olemiss.edu/acmse2010/pdf/xinu.pdf Teaching With Embedded Xinu Workshop] at [http://www.cs.olemiss.edu/acmse2010/Home.htm ACMSE 2010] in Oxford, Mississippi (Ole Miss campus) shared ready-made curriculum resources that have been used successfully to teach hardware systems, operating systems, realtime/embedded systems, networking, and compilers with the Embedded Xinu platform at several colleges/universities.

== Building an Embedded Xinu Laboratory ==

In this section we are developing instructions so that other groups can benefit from the work we are doing. These guides can be followed more or less in order to create a relatively inexpensive platform for a custom operating system. As our work develops further, there will be more Xinu-specific information.

# Obtain a [[List of supported platforms|supported platform]].
# (Required if using a Linksys/Asus router) [[HOWTO:Modify the Linksys hardware|Modify the Linksys hardware]] or [[HOWTO:Modify the ASUS hardware|Modify the ASUS hardware]]
## [[HOWTO:Connect to a modified router|Connect to a modified router]]
# [[HOWTO:Build Xinu|Build Xinu]]
# [[HOWTO:Deploy Xinu|Deploy Xinu]]
# (Optional) [[HOWTO:Build Backend Pool|Build a pool of backends]]
# (Recommended) [[HOWTO:Backup your router|Backup your router's factory configuration]]

== Other Embedded Xinu Information ==

* MIPS [[processor]]
* Main [[memory]]
* [[Exception and Interrupt Handling]]
* [[UART driver]]
* [[TTY driver]]
* [[Switch driver]]
* [[Networking]]
* [[Flash memory]]
* [[Flashing firmware]]
* [[EJTAG|Enhanced Joint Test Action Group]] debugger
* [[Standard library]]
* [[XinuPhone]] Internet telephony
* [[Router Recovery]] aka "Debricking"
* [[Development]]
* [[Contributors]]

----

The Xinu Lab is brought to you in part by [[XMMS|M&M's]].
__NOTOC____NOEDITSECTION__

Main Page

2024-03-22T16:31:59Z

AGebhard:

= Welcome SIGCSE 2024! =
To find RISC-V assignments and writeups, see [https://github.com/a1g3/riscv-xinu-hw]. We have instructions for running Embedded Xinu on the Sipeed Nezha below. Check out "Building an Embedded Xinu Laboratory"

= Introduction =
'''Embedded Xinu''' is an ongoing research and implementation project in the area of Operating Systems and Embedded Systems. Its original goal was to re-implement and port the [[Xinu|Xinu Operating System]] to several embedded MIPS platforms, such as the Linksys [[WRT54GL]] router. Since then, Embedded Xinu has been ported to other platforms, such as the [[mipsel-qemu|QEMU MIPSel virtual environment]] and the [[Raspberry Pi]]; see the [[list of supported platforms]]. Although Embedded Xinu is still being developed and ported to new platforms, a laboratory environment and curriculum materials are already in use for courses in Operating Systems, Hardware Systems, Embedded Systems, Networking, and Compilers at Marquette University and other colleges/universities.

The Embedded Xinu project was conceived and is supervised by [http://www.mscs.mu.edu/~brylow/ Dr. Dennis Brylow] and is being conducted by both graduate and undergraduate students in the [[Systems Laboratory]] in the [http://www.mscs.mu.edu/ Math, Statistics, & Computer Science] department of [http://www.mu.edu/ Marquette University] in Milwaukee, Wisconsin. The first major phase of work on Embedded Xinu began in the Summer of 2006.

Our project partners include [http://www.cse.buffalo.edu/~bina/ Dr. Bina Ramamurthy] at University of Buffalo (with whom we shared an [http://www.nsf.gov/pubs/2009/nsf09529/nsf09529.html NSF CCLI] grant), [http://cs.olemiss.edu/~ruth/wiki/doku.php Dr. Paul Ruth] at University of Mississippi, and [http://www.cs.purdue.edu/people/comer Dr. Doug Comer] (father of Xinu) at Purdue University.

== Teaching With Embedded Xinu ==

* For curriculum guidance on adopting or adapting Embedded Xinu for undergraduate coursework, see [[Teaching With Xinu]].
* Workshops have been held regarding teaching with Embedded Xinu. For example, the [http://www.cs.olemiss.edu/acmse2010/pdf/xinu.pdf Teaching With Embedded Xinu Workshop] at [http://www.cs.olemiss.edu/acmse2010/Home.htm ACMSE 2010] in Oxford, Mississippi (Ole Miss campus) shared ready-made curriculum resources that have been used successfully to teach hardware systems, operating systems, realtime/embedded systems, networking, and compilers with the Embedded Xinu platform at several colleges/universities.

== Building an Embedded Xinu Laboratory ==

In this section we are developing instructions so that other groups can benefit from the work we are doing. These guides can be followed more or less in order to create a relatively inexpensive platform for a custom operating system. As our work develops further, there will be more Xinu-specific information.

# Obtain a [[List of supported platforms|supported platform]].
# (Required if using a Linksys/Asus router) [[HOWTO:Modify the Linksys hardware|Modify the Linksys hardware]] or [[HOWTO:Modify the ASUS hardware|Modify the ASUS hardware]]
## [[HOWTO:Connect to a modified router|Connect to a modified router]]
# [[HOWTO:Build Xinu|Build Xinu]]
# [[HOWTO:Deploy Xinu|Deploy Xinu]]
# (Optional) [[HOWTO:Build Backend Pool|Build a pool of backends]]
# (Recommended) [[HOWTO:Backup your router|Backup your router's factory configuration]]

== Other Embedded Xinu Information ==

* MIPS [[processor]]
* Main [[memory]]
* [[Exception and Interrupt Handling]]
* [[UART driver]]
* [[TTY driver]]
* [[Switch driver]]
* [[Networking]]
* [[Flash memory]]
* [[Flashing firmware]]
* [[EJTAG|Enhanced Joint Test Action Group]] debugger
* [[Standard library]]
* [[XinuPhone]] Internet telephony
* [[Router Recovery]] aka "Debricking"
* [[Development]]
* [[Contributors]]

----

The Xinu Lab is brought to you in part by [[XMMS|M&M's]].
__NOTOC____NOEDITSECTION__

Template:Note

2024-03-22T16:28:49Z

AGebhard: Created page with " <span style="border:1px; border-style:solid; border-radius: 7px; border-color:#ddffdd; background-color:#f2fff2; padding:0.1em; margin:0.1em; display: inli..."

[[File:Bulbgraph.png|18px|Note|link=]] '''Note:'''  {{{1|}}}<noinclude>

Riscv-nezha

2024-03-22T01:17:42Z

AGebhard:

This page lists details about the Sipeed Nezha .

== Hardware Info ==

=== General ===
As report by [https://linux-sunxi.org/Allwinner_Nezha Linux Sunxi]
{| class="wikitable" style="font-weight:bold;"
|- style="font-weight:normal;"
! Device
! Note
|-
| SOC
| style="font-weight:normal;" | Allwinner D1 @1.0Ghz
|-
| DRAM
| style="font-weight:normal;" | 512MiB/1GiB/2GiB DDR3 @ 792MHz, 2× H5TQ4G63EFR
|-
| NAND
| style="font-weight:normal;" | 256MB, MX35LF2GE4AD
|-
| Power
| style="font-weight:normal;" | DC 5V @ 2A (via OTG or dedicated USB Type-C connector)
|-
| Video
| style="font-weight:normal;" | HDMI (Type A - full), LVDS
|-
| Audio
| style="font-weight:normal;" | 3.5mm headphone plug, HDMI, microphone array board connector, I2S
|-
| Network
| style="font-weight:normal;" | WiFi 802.11 b/g/n (XRadioTech XR829), 10/100/1000Mbps Ethernet (Realtek RTL8211F)
|-
| Storage
| style="font-weight:normal;" | µSD, SPI NAND
|-
| USB
| style="font-weight:normal;" | 1 USB2.0 Host, 1 USB Type-C OTG
|-
| Other
| style="font-weight:normal;" | Power LED, RGB LED, OK & FEL buttons
|-
| Headers
| style="font-weight:normal;" | 40-pin GPIO, DEBUG
|}

=== Serial Header ===
The Sipeed Nezha follows the Raspberry Pi line in terms of the pins for the serial header. The serial header pins are 5V power (pin 4), ground (pin 6), TXD (pin 8), and RXD (pin 10).

The following setting can be used to connect to the Sipeed Nezha. The serial terminal shall be enabled by default.

* Speed (baud rate): 115200
* Bits: 8
* Parity: None
* Stop Bits: 1
* Flow Control: None

== Software Info ==
By default, Nezhas ship with Debian or a Debian-like operating system called [[https://github.com/Tina-Linux/ TinaLinux]] on the SD card. A version of the operating system also exists in the device's NAND memory. Embedded Xinu will not overwrite the operating system in NAND, however the SD card will need to be overwritten to boot Embedded Xinu.

Nezhas ship with a version of U-Boot preinstalled. This version of U-Boot, however, does not support network booting. We recommended network booting as it doesn't require students to write their operating system the SD cards (which can wear them out). See [https://xinu.cs.mu.edu/index.php/Build_Backend_Pool#TFTP_Daemon here] for more information on TFTP in a Xinu lab.

To install an updated version of U-Boot on the SD card:

1. Get the WIP U-Boot code for the Nezha

git clone https://github.com/smaeul/u-boot -b d1-wip
pushd u-boot

2. Make the configuration file

make CROSS_COMPILE=riscv64-linux-gnu- nezha_defconfig

3. Make U-Boot

make CROSS_COMPILE=riscv64-linux-gnu-

4. Write U-Boot to SD card. Note, change "x" to the drive of the SD card.
sudo dd if=nboot/boot0_sdcard_sun20iw1p1.bin of=/dev/sdX bs=8192 seek=16
sudo dd if=nboot/boot0_sdcard_sun20iw1p1.bin of=/dev/sdX bs=8192 seek=256

5. The SD card shall now have the WIP version of U-Boot. Insert the SD-card back into the Nezha.

== See also ==
* [[WRT54G]]

2024-03-21T20:17:49Z

AGebhard:

Riscv-nezha

2024-03-21T20:17:21Z

AGebhard:

Riscv-nezha

2024-03-21T20:12:57Z

AGebhard: Created page with "This page lists details about the Sipeed Nezha . == Hardware Info == === General === As report by [https://linux-sunxi.org/Allwinner_Nezha Linux Sunxi] {| class="wikitable"..."

List of supported platforms

2024-03-21T19:58:25Z

AGebhard:

== Summary ==
This page lists the platforms currently supported by the Embedded Xinu operating system (or at least in development).

== Supported Platforms ==
{|border="1" cellpadding="5" cellspacing="0"
|-
!width="18%"|Platform
!width="15%"|Status
!Comments
|-
|[[riscv-nezha|RISC-V Nezha]] [http://www.qemu.org/]
|Experimental
|This is the first port of Embedded Xinu to a RISC-V platform; development began in summer 2022.
|-
|[[Raspberry Pi model 3B+]] [http://www.raspberrypi.org]
|Experimental
|This is the first multi-core port of Embedded Xinu, and has been in use on Marquette campus since 2017.
|-
|[[Raspberry Pi model 1A and 1B]] [http://www.raspberrypi.org]
|Supported
|This was the primary development platform for Embedded Xinu 2014-2018.
|-
|[[WRT54GL|Linksys WRT54GL]] [http://www.linksys.com/servlet/Satellite?c=L_Product_C2&childpagename=US%2FLayout&cid=1133202177241&pagename=Linksys%2FCommon%2FVisitorWrapper]
|Supported - Legacy
|This is was the primary development platform for Embedded Xinu 2007-2013.
|-
|[[WRT54G|Linksys WRT54G]] v8 [http://www.linksys.com/servlet/Satellite?c=L_Product_C2&childpagename=US%2FLayout&cid=1149562300349&pagename=Linksys%2FCommon%2FVisitorWrapper]
|Supported - Legacy
|Tested and running at the Embedded Xinu Lab.
|-
|[[WRT54G|Linksys WRT54G]] v4 [http://www.linksys.com/servlet/Satellite?c=L_Product_C2&childpagename=US%2FLayout&cid=1149562300349&pagename=Linksys%2FCommon%2FVisitorWrapper]
|Probably Supported
|The v4 is apparently the version on which WRT54GL is based, and so although the Embedded Xinu Lab has not explicitly tested it, it probably works.
|-
|[[WRT160NL|Linksys WRT160NL]] [http://www.linksys.com/servlet/Satellite?c=L_Product_C2&childpagename=US%2FLayout&cid=1149562300349&pagename=Linksys%2FCommon%2FVisitorWrapper]
|Supported - Legacy
|Newer model of router. Full O/S teaching core functioning, including wired network interface.
|-
|[[mipsel-qemu]] [http://www.qemu.org/]
|Supported
|Full O/S teaching core functioning, network support incomplete.
|}