[NTLK] Another thing for Newton

From: anrp_at_irulethe.net
Date: Sun Apr 21 2002 - 00:17:08 EDT


Hello,

I'm going to post this a bit earlier than I thought, but I was
pretty sure of how well it worked so I decided that it would be
released a bit sooner (and also at Paul Guyot's request =)

<start README>
-----
README for newton_connection_library
-----

To build this on a little endian machine, type:
make "ENDIANNESS=-DLITTLE_ENDIAN -UBIG_ENDIAN" all
(Little endian is x86)

To build this on a big endian machine, type:
make all
(Big endian is ppc, m68k) (yeah, I have macs...)

It should compile on Linux. It *might* compile on Mac OS X.
I'll be damned if it compiles on Windows.

I ought to automate this. Can anyone tell me how the f*** to use
the auto* tools!?

To try it out:
cd test
make
./test

will build a test program that uses the library and listens on
port 49252 for a connection from a newton (you did load
DockTrnspTCPIP.pkg onto your newton, right?) The test
program does nothing more than try to load a package
to your newton, but it doesn't work (Connection error -4).
Any ideas on that would be appreciated! It does, however,
print out the exchange of packets.

-----
ABOUT
-----

This library is useful for encoding/decoding newton dock packets.
It does NOT implement MNP, so it won't work as a serial connection
tool. It *might* work over IrDA, but I haven't tried. It does
work over TCP/IP, i.e. the Internet.

This library is implemented as a static C library; however, the
hooks are in place for C++ so I think it will work there too.

Another closely related library I am working on is a Newton Streamed
Object Decoder/Encoder. It it about half done (decoding is almost
complete, and encoding is ~25% done).

Send mail to <anrp_at_irulethe.net> to encourage further development!
Also send bug reports, feature requests, flames, etc... I just
would like to know how many people would use it.

-----
USAGE
-----

Basic Rules:
free_newton_packet(thePacket) after read_newton_packet_* or create_newton_packet*
   *and* you're done with the packet (same for below)
free_newton_binary_packet(theBPacket) after read_newton_binary_packet_* or
    create_newton_binary_packet*

...unless you want a 'leaky' program.

Read the headers. They're pretty helpful. It's really quite simple. But I would
appreciate anyone using the library to contribute some documentation!

-----
AUTHORS
-----
Andrew Patrikalakis <anrp_at_irulethe.net>
(hopefully more people will be added to this list)

-----
THANKS
-----
SONiC RANGE for hours of listening enjoyment

-----
VERSION HISTORY
-----
12:02 AM EST Sunday April 21, 2002
  - Initial release.
<end README>

Ultimately, it might turn into a Newton Connection Utilities
replacement that works over TCP/IP! (forget about network
devices that drop AppleTalk packets! nobody drops TCP/IP!)

It's at http://anrp.irulethe.net/newt/ - and it's FREE (i.e. GPL free).

Enjoy,
Andrew Patrikalakis

-- 
Read the List FAQ/Etiquette: http://www.newtontalk.net/faq.html
Read the Newton FAQ: http://www.guns-media.com/mirrors/newton/faq/
This is the NewtonTalk mailing list - http://www.newtontalk.net



This archive was generated by hypermail 2.1.2 : Sun May 05 2002 - 14:04:35 EDT