Software - Revision history

Winston: /* Library Reference */

2011-09-29T15:51:44Z

Library Reference

← Older revision		Revision as of 16:51, 29 September 2011
Line 25:		Line 25:
	== Library Reference ==		== Library Reference ==

	Assembly language programmers can use the file [http://spectrum.alioth.net/svn/filedetails.php?repname=Spectranet&path=%2Ftrunk%~~2From~~%2Fspectranet.~~asm~~ spectranet.~~asm~~] in their projects to get a list of symbolic names for the addresses listed below. For the functions that are made available to the C library, headers are provided (sys/socket.h and netdb.h) containing the function prototypes.		Assembly language programmers can use the file [http://spectrum.alioth.net/svn/filedetails.php?repname=Spectranet&path=%2Ftrunk%2Finclude%2Fspectranet.inc spectranet.inc] in their projects to get a list of symbolic names for the addresses listed below. For the functions that are made available to the C library, headers are provided (sys/socket.h and netdb.h) containing the function prototypes.

	=== The socket library ===		=== The socket library ===

Winston: /* Filesystem programming */

2011-04-18T18:25:56Z

Filesystem programming

← Older revision		Revision as of 19:25, 18 April 2011
Line 62:		Line 62:
	=== Filesystem programming ===		=== Filesystem programming ===

	The following system calls provide access to filesystems and files via Spectranet filesystem modules. By default, at least the TNFS (Tiny Network Filesystem) is available. What's below details the "user mode" part of using filesystems (i.e. how to open, close, read, write files etc), if you are looking for information on how to make a new filesystem module, then see [[Creating a filesystem]]		The following system calls provide access to filesystems and files via Spectranet filesystem modules. By default, at least the TNFS (Tiny Network Filesystem) is available. What's below details the "user mode" part of using filesystems (i.e. how to open, close, read, write files etc), if you are looking for information on how to make a new filesystem module (effectively "kernel mode"), then see [[Creating a filesystem]]

	See the [[Filesystem tutorial]] for a couple of examples of filesystem use.		See the [[Filesystem tutorial]] for a couple of examples of filesystem use.

Winston at 18:21, 18 April 2011

2011-04-18T18:21:13Z

@@ Line 59: / Line 59: @@
 * [[ifconfig_gw]], [[get_ifconfig_gw]] (IXCALL 0x3E43, HLCALL 0x3E75) Configures the default gateway.
 * [[deconfig]] (HLCALL 0x3E57) Deconfigures all IP settings.
 === Memory management ===

Winston: /* Net code tutorial */

2008-11-15T12:54:40Z

Net code tutorial

← Older revision		Revision as of 13:54, 15 November 2008
Line 11:		Line 11:
	* [[Spectranet: Tutorial 5]] - Avoiding blocking and handling multiple sockets at once.		* [[Spectranet: Tutorial 5]] - Avoiding blocking and handling multiple sockets at once.
	* [[Spectranet: Tutorial 6]] - Extending ZX BASIC.		* [[Spectranet: Tutorial 6]] - Extending ZX BASIC.
	* [[Spectranet: Tutorial 7]] - Other useful network functions.		* [[Spectranet: Tutorial 7]] - Writing ROM modules.
			* [[Spectranet: Tutorial 8]] - Other useful network functions.

	== Programmer's Guide ==		== Programmer's Guide ==

Winston at 22:36, 28 August 2008

2008-08-28T22:36:12Z

← Older revision		Revision as of 23:36, 28 August 2008
Line 53:		Line 53:
	A number of functions are provided for configuring the interface. These are used by the after reset/power up routines, and the DHCP client. There are matching routines to get information on how the interface is configured (for example, to allow a program to find the IP address that the interface is set to use).		A number of functions are provided for configuring the interface. These are used by the after reset/power up routines, and the DHCP client. There are matching routines to get information on how the interface is configured (for example, to allow a program to find the IP address that the interface is set to use).

	* [[sethwaddr]], gethwaddr (IXCALL 0x3E51, HLCALL 0x3E54) Sets and reads the MAC address.		* [[sethwaddr]], [[gethwaddr]] (IXCALL 0x3E51, HLCALL 0x3E54) Sets and reads the MAC address.
	* [[ifconfig_inet]], get_ifconfig_inet (IXCALL 0x3E48, HLCALL 0x3E6F) Configures the IP address.		* [[ifconfig_inet]], [[get_ifconfig_inet]] (IXCALL 0x3E48, HLCALL 0x3E6F) Configures the IP address.
	* [[ifconfig_netmask]], get_ifconfig_netmask (IXCALL 0x3E4B, HLCALL 0x3E72) Configures the netmask.		* [[ifconfig_netmask]], [[get_ifconfig_netmask]] (IXCALL 0x3E4B, HLCALL 0x3E72) Configures the netmask.
	* [[ifconfig_gw]], get_ifconfig_gw (IXCALL 0x3E43, HLCALL 0x3E75) Configures the default gateway.		* [[ifconfig_gw]], [[get_ifconfig_gw]] (IXCALL 0x3E43, HLCALL 0x3E75) Configures the default gateway.
	* [[deconfig]] (HLCALL 0x3E57) Deconfigures all IP settings.		* [[deconfig]] (HLCALL 0x3E57) Deconfigures all IP settings.

Winston at 20:43, 28 August 2008

2008-08-28T20:43:35Z

← Older revision		Revision as of 21:43, 28 August 2008
Line 10:		Line 10:
	* [[Spectranet: Tutorial 4]] - Using UDP.		* [[Spectranet: Tutorial 4]] - Using UDP.
	* [[Spectranet: Tutorial 5]] - Avoiding blocking and handling multiple sockets at once.		* [[Spectranet: Tutorial 5]] - Avoiding blocking and handling multiple sockets at once.
	* [[Spectranet: Tutorial 6]] - Other useful ~~Spectranet ROM~~ functions.		* [[Spectranet: Tutorial 6]] - Extending ZX BASIC.
			* [[Spectranet: Tutorial 7]] - Other useful network functions.

	== Programmer's Guide ==		== Programmer's Guide ==

Winston: /* Reference - Guidance */

2008-07-06T17:50:55Z

Reference - Guidance

← Older revision		Revision as of 18:50, 6 July 2008
Line 12:		Line 12:
	* [[Spectranet: Tutorial 6]] - Other useful Spectranet ROM functions.		* [[Spectranet: Tutorial 6]] - Other useful Spectranet ROM functions.

	== ~~Reference - Guidance~~ ==		== Programmer's Guide ==

			The following topics cover subjects not directly related to the socket library. The Spectranet contains some useful hardware features, primarily intended to be used for network programs, but which are also useful for general use.

	* [[Guidance to programmers]] - General advice on the best way to access the hardware.		* [[Guidance to programmers]] - General advice on the best way to access the hardware.

Winston: /* Reference - Guidance */

2008-07-06T17:47:13Z

Reference - Guidance

← Older revision		Revision as of 18:47, 6 July 2008
Line 15:		Line 15:

	* [[Guidance to programmers]] - General advice on the best way to access the hardware.		* [[Guidance to programmers]] - General advice on the best way to access the hardware.
	* [[~~Calling~~ Spectranet ~~ROM routines~~]] - How to ~~access~~ the ~~ROM.~~		* [[Using paged RAM]] - How to use the Spectranet's paged RAM
			* [[Using flash memory]] - How to use the Spectranet's flash memory
			* [[Trapping execution]] - How to use the programmable execution trapper

	== Library Reference ==		== Library Reference ==

Winston at 22:00, 1 July 2008

2008-07-01T22:00:48Z

← Older revision		Revision as of 23:00, 1 July 2008
Line 1:		Line 1:
	There are three main categories of software for the Spectranet; library code (i.e. the socket library and peripheral functions), utility code - things like a configuration user interface, and application code - some of which will be burned into ROM. Current plans call for the following:		There are three main categories of software for the Spectranet; library code (i.e. the socket library and peripheral functions), utility code - things like a configuration user interface, and application code - some of which will be burned into ROM. Current plans call for the following:

	== The ~~Basics~~ ==		== Net code tutorial ==

			A set of tutorials on writing networked programs for the Spectrum, using the Spectranet and its ROM-based socket library. The tutorials include code fragments, demonstrating how the socket library functions are used, as well as a piece of example code that goes along with each tutorial. Open the example code in another browser tab or window so you can see the socket library calls in context while reading the tutorial.

			* [[Spectranet: Tutorial 1]] - A look at network coding on the Spectrum.
			* [[Spectranet: Tutorial 2]] - Writing a simple TCP server program.
			* [[Spectranet: Tutorial 3]] - Writing a simple TCP client program.
			* [[Spectranet: Tutorial 4]] - Using UDP.
			* [[Spectranet: Tutorial 5]] - Avoiding blocking and handling multiple sockets at once.
			* [[Spectranet: Tutorial 6]] - Other useful Spectranet ROM functions.

			== Reference - Guidance ==

	* [[Guidance to programmers]] - General advice on the best way to access the hardware.		* [[Guidance to programmers]] - General advice on the best way to access the hardware.

Winston at 20:04, 19 June 2008

2008-06-19T20:04:58Z

← Older revision		Revision as of 21:04, 19 June 2008
Line 35:		Line 35:
	=== Interface configuration ===		=== Interface configuration ===

	A number of functions are provided for configuring the interface. These are used by the after reset/power up routines, and the DHCP client.		A number of functions are provided for configuring the interface. These are used by the after reset/power up routines, and the DHCP client. There are matching routines to get information on how the interface is configured (for example, to allow a program to find the IP address that the interface is set to use).

	* [[sethwaddr]], gethwaddr (IXCALL 0x3E51, HLCALL 0x3E54) Sets and reads the MAC address.		* [[sethwaddr]], gethwaddr (IXCALL 0x3E51, HLCALL 0x3E54) Sets and reads the MAC address.
	* [[ifconfig_inet]] (IXCALL 0x3E48) Configures the IP address.		* [[ifconfig_inet]], get_ifconfig_inet (IXCALL 0x3E48, HLCALL 0x3E6F) Configures the IP address.
	* [[ifconfig_netmask]] (IXCALL 0x3E4B) Configures the netmask.		* [[ifconfig_netmask]], get_ifconfig_netmask (IXCALL 0x3E4B, HLCALL 0x3E72) Configures the netmask.
	* [[ifconfig_gw]] (IXCALL 0x3E43) Configures the default gateway.		* [[ifconfig_gw]], get_ifconfig_gw (IXCALL 0x3E43, HLCALL 0x3E75) Configures the default gateway.
	* [[deconfig]] (HLCALL 0x3E57) Deconfigures all IP settings.		* [[deconfig]] (HLCALL 0x3E57) Deconfigures all IP settings.